update yaml file #79
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
| name: documentation | |
| on: | |
| push: | |
| branches: [ main, data-fetch-docs-build ] | |
| paths: | |
| - sed/**/* | |
| - tutorial/** | |
| - .github/workflows/documentation.yml | |
| workflow_dispatch: | |
| permissions: | |
| contents: read | |
| pages: write | |
| id-token: write | |
| concurrency: | |
| group: "pages" | |
| cancel-in-progress: false | |
| jobs: | |
| build: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Maximize build space | |
| uses: easimon/maximize-build-space@master | |
| with: | |
| root-reserve-mb: 2048 | |
| swap-size-mb: 1024 | |
| remove-dotnet: 'true' | |
| remove-codeql: 'true' | |
| remove-android: 'true' | |
| remove-docker-images: 'true' | |
| - name: Check out the repository | |
| uses: actions/checkout@v4 | |
| with: | |
| lfs: true | |
| - name: Setup Python, Poetry and Dependencies | |
| uses: packetcoders/action-setup-cache-python-poetry@main | |
| with: | |
| python-version: 3.8 | |
| poetry-version: 1.2.2 | |
| - name: Install notebook dependencies | |
| run: poetry install -E notebook --with docs | |
| - name: Install pandoc | |
| run: | | |
| sudo wget https://github.com/jgm/pandoc/releases/download/3.1.8/pandoc-3.1.8-1-amd64.deb | |
| sudo dpkg -i pandoc-3.1.8-1-amd64.deb | |
| - name: Remove SXP notebook | |
| run: | | |
| rm $GITHUB_WORKSPACE/docs/tutorial/5_sxp_workflow.ipynb | |
| - name: Cache notebook outputs | |
| id: cache-notebooks | |
| uses: actions/cache@v3 | |
| with: | |
| path: | | |
| _build/ | |
| docs/tutorial/*ipynb | |
| docs/tutorial/tutorial_checksums.txt | |
| key: ${{ runner.os }}-notebook-outputs-${{ hashFiles('tutorial_checksums.txt') }} | |
| restore-keys: | | |
| ${{ runner.os }}-notebook-outputs- | |
| - name: Compute notebook checksums | |
| id: compute-checksums | |
| run: | | |
| find tutorial -name "*.ipynb" | sort | xargs sha256sum > tutorial_checksums.txt | |
| - name: Move cached executed notebooks | |
| if: steps.cache-notebooks.outputs.cache-hit == 'true' | |
| run: python docs/move_executed_notebooks.py | |
| # - name: Build Flash parquet files | |
| # run: | | |
| # cd $GITHUB_WORKSPACE/docs | |
| # poetry run python build_flash_parquets.py | |
| - name: Build Sphinx docs | |
| run: poetry run sphinx-build -b html $GITHUB_WORKSPACE/docs $GITHUB_WORKSPACE/_build | |
| - name: Cache built documentation | |
| id: cache-docs | |
| uses: actions/cache@v3 | |
| with: | |
| path: _build | |
| key: ${{ runner.os }}-docs-${{ hashFiles('tutorial_checksums.txt') }} | |
| restore-keys: | | |
| ${{ runner.os }}-docs- | |
| - name: Setup Pages | |
| uses: actions/configure-pages@v4 | |
| - name: Upload artifact | |
| uses: actions/upload-pages-artifact@v3 | |
| with: | |
| path: '_build' | |
| deploy: | |
| environment: | |
| name: github-pages | |
| url: ${{ steps.deployment.outputs.page_url }} | |
| runs-on: ubuntu-latest | |
| needs: build | |
| steps: | |
| - name: Deploy to GitHub Pages | |
| id: deployment | |
| uses: actions/deploy-pages@v4 |