sphinx.yml

---
name: Documentation Build (Sphinx)
on:
  push:
    branches:
      - main

env:
  DEFAULT_BRANCH: "main"
  SPHINXOPTS: "-W --keep-going -T"

jobs:
  build-and-deploy:
    name: Build and gh-pages
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
        with:
          fetch-depth: 0
      - name: Install Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.10'
      - name: Install poetry dependencies
        uses: abatilo/actions-poetry@v2
        with:
          poetry-version: "1.2.2"
      - name: Install dependencies
        run: |
          poetry config virtualenvs.create false
          poetry export --dev --format requirements.txt -o requirements.txt
          pip install --user -r requirements.txt
      - name: Build and commit
        uses: sphinx-notes/pages@v2
        with:
          documentation_path: docs/
      - name: Push changes
        uses: ad-m/github-push-action@master
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          branch: gh-pages