test_build_docs.yml

name: build

on: [push, pull_request]

jobs:

  build:

    runs-on: "ubuntu-22.04"
    strategy:
      fail-fast: false
      matrix:
        python-version: ["3.9", "3.10", "3.11", "3.12"]
        docs-dir: ["doc", "doc_copybutton"]
        sphinx-ver: ["4.5.0", "5.3.0", "6.2.1", "7.2.6"]

    steps:

    - uses: actions/checkout@v4

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

    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        python -m pip install sphinx==${{ matrix.sphinx-ver }}
        pip install .
        pip install -r ${{ matrix.docs-dir }}/requirements.txt

    - name: Build ${{ matrix.docs-dir }}
      run: |
        cd ${{ matrix.docs-dir }}
        make html

    - name: Upload artifact
      uses: actions/upload-artifact@v4
      with:
        name: docs-${{ matrix.docs-dir }}-py${{ matrix.python-version }}-sph${{ matrix.sphinx-ver }}
        path: ./${{ matrix.docs-dir }}/_build/html