DX: run linkcheck on GitHub Actions

See also ComPWA/policy#57
redeboer · Jan 19, 2023 · 5664d34 · 5664d34
1 parent dee5b5d
commit 5664d34
Show file tree

Hide file tree

Showing 2 changed files with 22 additions and 0 deletions.
diff --git a/.cspell/this-project.txt b/.cspell/this-project.txt
@@ -14,6 +14,7 @@ latexmk
 LATEXMKOPTS
 LATEXOPTS
 latexpdf
+linkcheck
 lualatex
 MAINT
 Mikhasenko

diff --git a/.github/workflows/ci-docs.yml b/.github/workflows/ci-docs.yml
@@ -68,11 +68,32 @@ jobs:
           name: latex
           path: docs/_build/latex
 
+  linkcheck:
+    name: Check external links
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/cache@v3
+        with:
+          key: |
+            ${{ github.workflow }}-${{ github.job }}-${{ runner.os }}-${{ hashFiles('.constraints/py3.*.txt', 'setup.cfg') }}
+          path: |
+            ~/.cache/pip/
+      - uses: actions/setup-python@v4
+        with:
+          python-version: "3.8"
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -c .constraints/py3.8.txt -e .[doc] tox
+      - run: tox -e linkcheck
+
   documentation:
     name: Run notebooks and build documentation
     needs:
       - html-fast
       - pdf-fast
+      - linkcheck
     if: github.event_name != 'pull_request'
     runs-on: ubuntu-22.04
     steps: