static.yml

name: Build and Deploy Furo Themed Sphinx Homepage

on:
  push:
    branches: ["main"]
  workflow_dispatch:

env:
  PYTHON: '3.14'

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: "pages"
  cancel-in-progress: false

jobs:
  deploy:
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6

      - name: Select Python
        uses: actions/setup-python@v6
        with:
          python-version: ${{ env.PYTHON }}

      - name: Install Sphinx Dependencies
        run: |
          pip install -r docs/requirements.txt
          sudo apt-get install -y graphviz

      - name: Build Homepage
        run: |
          pip install .
          sphinx-build -M html docs/source docs/build

      - name: Setup Pages
        uses: actions/configure-pages@v6

      - name: Upload Artifact
        uses: actions/upload-pages-artifact@v5
        with:
          path: docs/build/html

      - name: Deploy to GitHub Pages
        uses: actions/deploy-pages@v5
        id: deployment