35 lines
1.1 KiB
YAML
35 lines
1.1 KiB
YAML
name: Build & test docs
|
|
on: [workflow_dispatch, workflow_call]
|
|
jobs:
|
|
docs:
|
|
runs-on: ubuntu-24.04
|
|
steps:
|
|
- uses: actions/checkout@v7
|
|
with:
|
|
fetch-depth: 0
|
|
- uses: actions/setup-python@v6
|
|
with:
|
|
python-version: "3.x"
|
|
- name: Install libs
|
|
run: |
|
|
sudo apt update
|
|
sudo apt install latexmk texlive-xetex
|
|
- name: Install dependencies
|
|
run: |
|
|
pip install --upgrade setuptools pip
|
|
pip install --upgrade .[docs]
|
|
- name: Building docs
|
|
run: |
|
|
sphinx-build --color -W --keep-going -b html docs build/sphinx/html
|
|
sphinx-build --color -W --keep-going -b latex docs build/sphinx/latex
|
|
make -C build/sphinx/latex all-pdf
|
|
env:
|
|
NO_COLOR: 1 # workaround for sphinx-contrib/autoprogram#76
|
|
COLUMNS: 80 # also enable line wrapping for argparse
|
|
- uses: actions/upload-artifact@v7
|
|
with:
|
|
name: docs
|
|
path: |
|
|
build/sphinx/html/
|
|
build/sphinx/latex/mpmath.pdf
|