build.yaml

# This is a basic workflow to help you get started with Actions

name: CI


# Controls when the workflow will run
on:
  # Triggers the workflow on push or pull request events but only for the "main" branch
  push:
    branches: [ "main" ]

  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    permissions:
      id-token: write
      pages: write
      contents: read
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v4
      - name: build
        run: |
          pip3 install sphinx
          pip3 install sphinx_rtd_theme
          pip3 install pyyaml
          pip3 install sphinxcontrib-video
          npm install -g jsdoc
          git fetch --tags
          cd docs
          mkdir build
          python3 build_docs.py
      - name: Setup Pages
        uses: actions/configure-pages@v3
      - name: Upload artifact
        uses: actions/upload-pages-artifact@v2
        with:
          # Upload entire repository
          path: './pages'
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v2
        with:
          token: ${{ secrets.GITHUB_TOKEN }}