build_and_deploy_docs.yml

name: Build and Deploy Docs

on:
  push:
    branches:
      - 'master'

permissions:
  contents: write

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ["3.7"]
    steps:
      - uses: actions/checkout@v3

      - name: Set up Python ${{ matrix.python-version }}
        uses: actions/setup-python@v4
        with:
          python-version: ${{ matrix.python-version }}

      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install -r share/python_requirements/requirements-github-build-and-deploy-docs.txt

      - name: Building Sphinx Documentation
        run: |
          ./scripts/internal/build_docs.bash

      # https://github.com/marketplace/actions/deploy-to-github-pages
      - name: Deploy to GitHub Pages
        uses: JamesIves/github-pages-deploy-action@v4.4.1
        with:
          branch: gh-pages  # The branch the action should deploy to.
          folder: docs/build_linux_maya/html  # The folder the action should deploy.
          dry-run: false  # Enable when testing with 'true'.