name: "Sphinx: Render docs"

on: push

jobs:
  build:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
    - uses: actions/checkout@v4
      with:
        persist-credentials: false
    # - name: upgrade pip
    #   run: sudo python -m pip install --upgrade pip
    # - name: Build HTML
    #   uses: ammaraskar/sphinx-action@master
    #   with:
    #     pre-build-command: pip install -e
    - name : Direct sphinx build
      run : |
        pip install --upgrade pip
        pip install -r docs/requirements.txt
        sphinx-build -D todo_include_todos=0 docs ./docs/_build/html/
    - name: Upload artifacts
      uses: actions/upload-artifact@v4
      with:
        name: html-docs
        path: docs/_build/html/
    - name: Deploy
      uses: peaceiris/actions-gh-pages@v3
      if: github.ref == 'refs/heads/main'
      with:
        github_token: ${{ secrets.GITHUB_TOKEN }}
        publish_dir: docs/_build/html