sphinx.yml

name: Sphinx-docs

on:
  push:
    branches:
      - main
      - documentation-staging
  workflow_dispatch:

jobs:
  pages:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4

    - name: Install Pandoc
      uses: pandoc/actions/setup@v1
      with:
        version: 3.5

    - name: Install dependencies
      run: pip install -r docs/requirements.txt

    - name: Build HTML
      run: python -m sphinx.cmd.build -M html docs/source docs/build

    - name: Upload artifacts
      uses: actions/upload-artifact@v4
      with:
        name: html-docs
        path: docs/build/html/

    # - name: Deploy
    #   uses: sphinx-notes/pages@v3
    #   with:
    #     publish: true
    
    - name: Deploy
      uses: peaceiris/actions-gh-pages@v3
      with:
        github_token: ${{ secrets.DOCSITE_TOKEN }}
        publish_branch: gh-pages
        publish_dir: docs/build/html