Skip to content

docs

docs #23

Workflow file for this run

name: website
# build the documentation whenever there are new commits on main
on:
push:
branches:
- main
# Alternative: only build for m tags.
# tags:
# - '*'
permissions:
contents: write
pages: write
id-token: write
jobs:
# Build the documentation and upload the static HTML files as an artifact.
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: '3.11'
- run: pip install -e .
- run: python docs/make.py
- run: git config user.name 'github-actions[bot]' && git config user.email 'github-actions[bot]@users.noreply.github.com'
- run: mkdocs gh-deploy --force
- uses: actions/upload-pages-artifact@v3
with:
path: site/
# Deploy the artifact to GitHub pages.
# This is a separate job so that only actions/deploy-pages has the necessary permissions.
deploy:
needs: build
runs-on: ubuntu-latest
permissions:
pages: write
id-token: write
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- id: deployment
uses: actions/deploy-pages@v4