summaryrefslogtreecommitdiff
path: root/.github/workflows/docs.yml
diff options
context:
space:
mode:
Diffstat (limited to '.github/workflows/docs.yml')
-rw-r--r--.github/workflows/docs.yml61
1 files changed, 12 insertions, 49 deletions
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index bfa4f9cb52..188dbd5359 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -22,7 +22,9 @@ permissions:
jobs:
docs:
runs-on: ubuntu-24.04
- name: spelling
+ defaults:
+ run:
+ working-directory: docs
timeout-minutes: 60
steps:
- name: Checkout
@@ -35,51 +37,12 @@ jobs:
python-version: '3.14'
cache: 'pip'
cache-dependency-path: 'docs/requirements.txt'
- - run: python -m pip install -r docs/requirements.txt
- - name: Build docs
- run: |
- cd docs
- sphinx-build -b spelling -n -q -W -d _build/doctrees -D language=en_US -j auto . _build/spelling
-
- blacken-docs:
- runs-on: ubuntu-latest
- name: blacken-docs
- timeout-minutes: 60
- steps:
- - name: Checkout
- uses: actions/checkout@v5
- with:
- persist-credentials: false
- - name: Set up Python
- uses: actions/setup-python@v6
- with:
- python-version: '3.14'
- - run: python -m pip install blacken-docs
- - name: Build docs
- run: |
- cd docs
- make black
- RESULT=`cat _build/black/output.txt`
- if [ "$RESULT" -gt 0 ]; then
- echo "💥 📢 Code blocks in documentation must be reformatted with blacken-docs 📢 💥"
- fi;
- exit $RESULT
-
- lint-docs:
- runs-on: ubuntu-latest
- name: lint-docs
- timeout-minutes: 60
- steps:
- - name: Checkout
- uses: actions/checkout@v5
- with:
- persist-credentials: false
- - name: Set up Python
- uses: actions/setup-python@v6
- with:
- python-version: '3.14'
- - run: python -m pip install sphinx-lint
- - name: Build docs
- run: |
- cd docs
- make lint
+ - name: Install system spell checker
+ run: sudo apt update && sudo apt install -y aspell aspell-en
+ - run: python -m pip install -r requirements.txt
+ - name: Lint
+ run: make lint
+ - name: Black
+ run: make black
+ - name: Spelling
+ run: SPHINXOPTS="-q -W" make spelling