Fix ALL Sphinx warnings #71
Workflow file for this run
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # As much as possible, this file should be kept in sync with | |
| # https://github.com/napari/napari/blob/main/.github/workflows/build_docs.yml | |
| name: Build PR Docs | |
| on: | |
| push: | |
| branches: | |
| - main | |
| tags: | |
| - 'v*' | |
| pull_request: | |
| branches: | |
| - main | |
| workflow_dispatch: | |
| concurrency: | |
| group: ${{ github.workflow }}-${{ github.ref }} | |
| cancel-in-progress: true | |
| jobs: | |
| build-and-upload: | |
| name: Build & Upload Artifact | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Clone docs repo | |
| uses: actions/checkout@v4 | |
| with: | |
| path: docs # place in a named directory | |
| - name: Clone main repo | |
| uses: actions/checkout@v4 | |
| with: | |
| path: napari # place in a named directory | |
| repository: napari/napari | |
| # ensure version metadata is proper | |
| fetch-depth: 0 | |
| - uses: actions/setup-python@v5 | |
| with: | |
| python-version: "3.10" | |
| cache-dependency-path: | | |
| napari/pyproject.toml | |
| docs/requirements.txt | |
| - uses: tlambert03/setup-qt-libs@v1 | |
| - name: Install Dependencies | |
| run: | | |
| python -m pip install --upgrade pip | |
| python -m pip install "napari/[all]" | |
| env: | |
| PIP_CONSTRAINT: ${{ github.workspace }}/napari/resources/constraints/constraints_py3.10_docs.txt | |
| - name: Testing | |
| run: | | |
| python -c 'import napari; print(napari.__version__)' | |
| python -c 'import napari.layers; print(napari.layers.__doc__)' | |
| - name: Create fallback videos | |
| run: | | |
| sudo apt-get update && sudo apt-get install -y ffmpeg | |
| cd docs | |
| make fallback-videos | |
| - name: Build Docs | |
| uses: aganders3/headless-gui@v2 | |
| env: | |
| GOOGLE_CALENDAR_ID: ${{ secrets.GOOGLE_CALENDAR_ID }} | |
| GOOGLE_CALENDAR_API_KEY: ${{ secrets.GOOGLE_CALENDAR_API_KEY }} | |
| PIP_CONSTRAINT: ${{ github.workspace }}/napari/resources/constraints/constraints_py3.10_docs.txt | |
| with: | |
| run: make -C docs docs | |
| # skipping setup stops the action from running the default (tiling) window manager | |
| # the window manager is not necessary for docs builds at this time and it was causing | |
| # problems with screenshots (https://github.com/napari/docs/issues/285) | |
| linux-setup: "echo 'skip setup'" | |
| linux-teardown: "echo 'skip teardown'" | |
| - name: Upload artifact | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: html | |
| path: docs/docs/_build/html/ | |
| deploy: | |
| name: Download & Deploy Artifact | |
| needs: build-and-upload | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Download artifact | |
| uses: actions/download-artifact@v4 | |
| with: | |
| name: html | |
| path: html | |
| - name: show files | |
| run: ls -lR | |
| - name: get directory name | |
| # if this is a tag, use the tag name as the directory name else dev | |
| run: | | |
| if [[ "${{ github.ref }}" == "refs/tags/"* ]]; then | |
| echo "branch_name=${{ github.ref_name }}" >> $GITHUB_ENV | |
| else | |
| echo "branch_name=dev" >> $GITHUB_ENV | |
| fi | |
| - name: Deploy Docs | |
| if: github.event_name == 'push' && (startsWith(github.ref, 'refs/tags/v') || startsWith(github.ref, 'refs/heads/main')) | |
| uses: peaceiris/actions-gh-pages@v3 | |
| with: | |
| deploy_key: ${{ secrets.ACTIONS_DEPLOY_KEY }} | |
| external_repository: napari/napari.github.io | |
| publish_dir: ./html | |
| publish_branch: gh-pages | |
| destination_dir: ${{ env.branch_name }} | |
| cname: napari.org |