Documentation Site #2
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
| # https://jupyterbook.org/en/stable/publish/gh-pages.html | |
| name: quarto-pages | |
| on: | |
| push: | |
| #branches: | |
| #- main | |
| # If your git repository has the Jupyter Book within some-subfolder next to | |
| # unrelated files, you can make this run only if a file within that specific | |
| # folder has been modified. | |
| # | |
| #paths: | |
| #- docs/** | |
| pull_request: | |
| #branches: [ "main" ] | |
| # make this workflow manually runnable | |
| # https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#workflow_dispatch | |
| workflow_dispatch: | |
| jobs: | |
| deploy-book: | |
| runs-on: ubuntu-latest | |
| permissions: | |
| pages: write | |
| id-token: write | |
| steps: | |
| - uses: actions/checkout@v3 | |
| # | |
| # PYTHON STUFF | |
| # | |
| - name: Install Python 3.11 | |
| uses: actions/setup-python@v4 | |
| with: | |
| python-version: 3.11 | |
| # PACKAGE DEPENDENCIES | |
| #- name: Install dependencies | |
| # run: | | |
| # pip install -r requirements.txt | |
| # INSTALL DOCUMENTATION DEPENDENCIES | |
| #- name: Install docs dependencies | |
| # run: | | |
| # pip install -r docs/requirements.txt | |
| # TODO: use poetry instead! | |
| # https://github.com/marketplace/actions/python-poetry-action | |
| # poetry install --with test,docs | |
| - name: Install Poetry | |
| uses: snok/install-poetry@v1 | |
| # https://python-poetry.org/docs/managing-dependencies/#dependency-groups | |
| - name: Install dependencies with Poetry | |
| run: | | |
| poetry install --with docs | |
| # | |
| # QUARTO STUFF | |
| # | |
| # INSTALL QUARTO | |
| # https://github.com/quarto-dev/quarto-actions/blob/main/examples/quarto-publish-example.yml | |
| - name: Set up Quarto | |
| uses: quarto-dev/quarto-actions/setup@v2 | |
| #env: | |
| # GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} | |
| with: | |
| # To install LaTeX to build PDF book | |
| # (to get past errors on the CI build) | |
| tinytex: true | |
| # uncomment below and fill to pin a version | |
| # version: SPECIFIC-QUARTO-VERSION-HERE | |
| # RENDER WEBSITE CONTENTS TO DOCS/_BUILD | |
| - name: Build the docs | |
| run: | | |
| quarto render docs/ | |
| # | |
| # GITHUB PAGES STUFF | |
| # | |
| # UPLOAD CONTENTS OF DOCS/_BUILD | |
| - name: Upload artifact | |
| uses: actions/upload-pages-artifact@v2 | |
| with: | |
| path: "docs/_build" | |
| # DEPLOY WEBSITE CONTENTS TO GITHUB PAGES | |
| - name: Deploy to GitHub Pages | |
| id: deployment | |
| uses: actions/deploy-pages@v2 |