pages.yml

name: Build Pages
on:
    push:
        branches:
            - main
            - docs-setup
    workflow_dispatch:

# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
concurrency:
  group: "pages"
  cancel-in-progress: false

# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
permissions:
    contents: read
    pages: write
    id-token: write

jobs:
  pages:
    runs-on: ubuntu-latest
    steps:
      -
        name: Checkout
        uses: actions/checkout@v4
      -
        name: Setup
        run: |
            sudo apt update -q
            sudo apt install -yy python3 python3-pip graphviz
            pip install -r tools/requirements.txt
      -
        name: Docs
        run: |
            ./tools/schema-merge.py
            ./tools/mkdocs build -d site
      -
        name: Setup Pages
        uses: actions/configure-pages@v4
      -
        name: Upload artifact
        uses: actions/upload-pages-artifact@v2
        with:
            path: 'site'
      -
        name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v3