docs.yml

name: Build and Deploy docs

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]
  release:
    types:
      - created

jobs:
    docs:
      name: build and deploy docs
      runs-on: ubuntu-latest

      steps:      
        - name: Checkout code
          uses: actions/checkout@v2
          with:
            fetch-depth: 0
        - name: Set system to non-interactive mode
          run: export DEBIAN_FRONTEND=noninteractive
        - name: install dependencies
          run: |
            pip install sphinx
            pip install sphinx-rtd-theme
            pip install sphinx-multiversion
            pip install sphinx-copybutton
        - name: build docs
          run: |
            echo "Repo = ${GITHUB_REPOSITORY}"
            cd doc/sphinx
            # throw warnings as error to make sure docs properly build
            make multiversion SPHINXOPTS="-W --keep-going -n"
        - name: Deploy
          if: ${{ (github.event.pull_request.head.repo.full_name == github.repository) || (github.ref == 'refs/heads/main') }}
          uses: peaceiris/actions-gh-pages@v3.7.3
          with:
            github_token: ${{ secrets.GITHUB_TOKEN }}
            publish_dir: ./doc/sphinx/_build/html
            force_orphan: true