sphinx.yml

name: Sphinx

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build:

    runs-on: ubuntu-latest
    env:
      python-version: '3.10'
    strategy:
      matrix:
        sphinx-version: [ '5.3.0', '6.2.1', '7.*' ]

    steps:
    - uses: actions/checkout@v4

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

    - name: Set up Sphinx ${{ matrix.sphinx-version }}
      run: |
        python -V
        python -m pip install --upgrade pip
        pip install -r tests/requirements.txt
        pip install "sphinx==${{ matrix.sphinx-version }}"

    - name: Tests
      run: |
        python -m sphinx tests tests/_build/ -b html -W -C -D master_doc=index -D extensions=sphinxcontrib.katex
        python -m sphinx tests tests/_build/ -c docs/ -b latex -W