diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 4bb79ca..3aa3190 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -104,40 +104,40 @@ jobs: files: | packages/timew* - #docs: - #name: Release docs - #needs: [create_release] - #runs-on: ubuntu-20.04 - - #steps: - #- uses: actions/checkout@v4 - #with: - #fetch-depth: 0 - - #- uses: actions/setup-python@v5 - #with: - #python-version: '3.9' - - #- name: Add python requirements - #run: | - #python -m pip install --upgrade pip - #pip install tox - - #- name: Build docs - #run: | - #tox -e ldocs,docs - - #- uses: actions/upload-artifact@v4 - #with: - #name: ApiDocsHTML - #path: "docs/_build/html/" - - #- name: set nojekyll for github - #run: | - #sudo touch docs/_build/html/.nojekyll - - #- name: Deploy docs to gh-pages - #if: ${{ github.event_name == 'push' }} - #uses: JamesIves/github-pages-deploy-action@v4 - #with: - #folder: docs/_build/html/ + docs: + name: Release docs + needs: [create_release] + runs-on: ubuntu-22.04 + + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - uses: actions/setup-python@v5 + with: + python-version: '3.9' + + - name: Add python requirements + run: | + python -m pip install --upgrade pip + pip install tox + + - name: Build docs + run: | + tox -e ldocs,docs + + - uses: actions/upload-artifact@v4 + with: + name: ApiDocsHTML + path: "docs/build/html/" + + - name: set nojekyll for github + run: | + sudo touch docs/build/html/.nojekyll + + - name: Deploy docs to gh-pages + if: ${{ github.event_name == 'push' }} + uses: JamesIves/github-pages-deploy-action@v4 + with: + folder: docs/build/html/ diff --git a/.github/workflows/sphinx.yml b/.github/workflows/sphinx.yml new file mode 100644 index 0000000..7860e82 --- /dev/null +++ b/.github/workflows/sphinx.yml @@ -0,0 +1,47 @@ +name: Docs +on: + workflow_dispatch: + pull_request: + push: + branches: + - main + +jobs: + build: + runs-on: ubuntu-20.04 + + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - uses: actions/setup-python@v5 + with: + python-version: '3.9' + + - name: Add python requirements + run: | + python -m pip install --upgrade pip + pip install tox + + - name: Build docs + run: | + tox -e ldocs,docs + + - uses: actions/upload-artifact@v4 + with: + name: ApiDocsHTML + path: "docs/build/html/" + + - name: set nojekyll for github + run: | + sudo touch docs/build/html/.nojekyll + + - name: Deploy docs to gh-pages + if: ${{ github.event_name == 'push' }} + uses: JamesIves/github-pages-deploy-action@v4 + with: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + BRANCH: gh-pages + FOLDER: docs/build/html/ + SINGLE_COMMIT: true