Update documentation workflow

- Add 'workflow_dispatch' target
- Force output to use colour
- Print traceback on error
- Use parallel building
This commit is contained in:
Adam Turner 2023-05-09 16:51:52 +01:00
parent ba7408209e
commit 2b1c106bbf

View File

@ -1,6 +1,9 @@
name: Build document
name: Render documentation
on: [push, pull_request]
on:
push:
pull_request:
workflow_dispatch:
permissions:
contents: read
@ -9,6 +12,9 @@ concurrency:
group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
cancel-in-progress: true
env:
FORCE_COLOR: "1"
jobs:
build:
runs-on: ubuntu-latest
@ -27,11 +33,11 @@ jobs:
python -m pip install .[docs]
- name: Render the documentation
run: >
python
-X dev
-X warn_default_encoding
-m sphinx
sphinx-build
-M html ./doc ./build/sphinx
-T
-W
--jobs=auto
-n
-vvv
--keep-going