Skip to content

Linkcheck

Linkcheck #83

Workflow file for this run

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later
name: Linkcheck
on:
push:
paths:
- docs/**.rst
- .github/workflows/linkcheck.yml
pull_request:
paths:
- docs/**.rst
- .github/workflows/linkcheck.yml
schedule:
- cron: 30 5 * * *
permissions:
contents: read
jobs:
linkcheck:
runs-on: ubuntu-24.04
name: Linkcheck
steps:
- uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
with:
persist-credentials: false
- name: Set up Python
uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
with:
python-version: '3.13'
- uses: astral-sh/setup-uv@557e51de59eb14aaaba2ed9621916900a91d50c6 # v6.6.1
- name: Install apt dependencies
run: |
sudo apt update
sudo apt install -y graphviz
- name: Install Python dependencies
run: uv sync --only-group docs --frozen
- name: Sphinx linkcheck
run: |
. .venv/bin/activate
./ci/run-docs linkcheck
- name: Sphinx linkcheck collect
if: always()
run: |
echo "::add-matcher::.github/matchers/sphinx-linkcheck.json"
echo "::add-matcher::.github/matchers/sphinx-linkcheck-warn.json"
sed 's@^@docs/@' docs/_build/linkcheck/output.txt
echo "::remove-matcher owner=sphinx::"
echo "::remove-matcher owner=sphinx-warn::"
- uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
if: always()
with:
name: Linkcheck report
path: docs/_build/linkcheck/output.txt