Merge pull request #899 from MetOffice/893_update_documentation #430
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
| name: Documentation | |
| on: | |
| push: | |
| branches: | |
| - "main" | |
| workflow_dispatch: | |
| # Allow only one concurrent deployment | |
| concurrency: | |
| group: "pages" | |
| cancel-in-progress: true | |
| jobs: | |
| build-docs: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout code | |
| uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 | |
| - name: Cache conda environment | |
| id: conda-env-cache | |
| uses: actions/cache@6849a6489940f00c2f30c0fb92c6274307ccb58a | |
| with: | |
| key: conda|${{runner.os}}-${{runner.arch}}|${{hashFiles('requirements/locks/py312-lock-linux-64.txt')}} | |
| path: | | |
| ~/conda-env | |
| ~/.local/share/cartopy | |
| - name: Create conda environment | |
| if: steps.conda-env-cache.outputs.cache-hit != 'true' | |
| run: | | |
| # Check cache hasn't pulled a partial key match. | |
| test ! -e "${HOME}/conda-env" | |
| conda create --prefix="${HOME}/conda-env" --file=requirements/locks/py312-lock-linux-64.txt | |
| - name: Add conda environment to PATH | |
| run: echo "${HOME}/conda-env/bin" >> $GITHUB_PATH | |
| - name: Build documentation | |
| run: | | |
| # Install module so it can be imported during docs generation. | |
| echo '::group::Installing local package' | |
| python3 -m pip install . | |
| echo '::endgroup::' | |
| # Generate the documentation | |
| echo '::group::Building the documentation' | |
| sphinx-build -b html --color "docs/source" "docs/build/html" | |
| echo '::endgroup::' | |
| - uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 | |
| with: | |
| name: html-docs | |
| path: docs/build/html/ | |
| retention-days: 1 | |
| if-no-files-found: error | |
| pages-deploy: | |
| permissions: | |
| pages: write | |
| id-token: write | |
| environment: | |
| name: github-pages | |
| url: ${{ steps.deployment.outputs.page_url }} | |
| runs-on: ubuntu-latest | |
| needs: build-docs | |
| steps: | |
| - uses: actions/download-artifact@fa0a91b85d4f404e444e00e005971372dc801d16 | |
| with: | |
| name: html-docs | |
| - uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa | |
| with: | |
| path: "." | |
| - name: Deploy to GitHub Pages | |
| id: deployment | |
| uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e |