sphinx.yml

# Github Actions workflow to generate documentation
# Uses the following shared task definitions:
# - (checkout, upload artifact) from Github
# - sphinx-action maintained by @ammaraskar
name: Sphinx build

# Controls when the action will run.
# Triggers the workflow on push or pull request events.
on:
- push
- pull_request

# A workflow run is made up of one or more jobs that can run sequentially or in parallel
jobs:
  # This workflow contains a single job called "build"
  build:
    # The type of runner that the job will run on
    runs-on: ubuntu-latest

    # Steps are a sequence of tasks that will be executed as part of the job
    steps:
    # Check out repository under $GITHUB_WORKSPACE
    - uses: actions/checkout@v3
    # Builds docs using sphinx
    - uses: ammaraskar/sphinx-action@master
      with:
        docs-folder: "doc/"
        pre-build-command: pip3 install sphinx_markdown_builder
        build-command: "sphinx-build -b html . _build"
    # Create an artifact out of the generated HTML
    - uses: actions/upload-artifact@v3
      with:
        name: UserGuideHTML
        path: "doc/_build/html/"