nixos-wiki-infra/checks/linkcheck
phanirithvij 2f1118f2a1 linkcheck: allow few urls
Signed-off-by: phanirithvij <phanirithvij2000@gmail.com>
2024-09-18 11:12:37 +05:30
..
pkgs ci: add broken link checker action 2024-09-17 09:51:24 +02:00
.envrc ci: add broken link checker action 2024-09-17 09:51:24 +02:00
.gitignore ci: add broken link checker action 2024-09-17 09:51:24 +02:00
allowed.links linkcheck: allow few urls 2024-09-18 11:12:37 +05:30
lychee.sh linkcheck: download xmldump conservatively 2024-09-18 11:12:16 +05:30
main.py linkcheck: sort csv in python 2024-09-17 10:57:42 +02:00
README.md linkcheck: simplify instructions 2024-09-17 10:57:42 +02:00

What

wiki.nixos.org dead links checker gha powered by lychee

Runs twice a week, can be adjusted in the github action cron job. Need to manually edit links in wiki, nothing automated.

Initial run gave ~100 results and were fixed manually, see the entries before 16 Sep here.

Why

Dead links if detected early have a chance to prevent linkrot.

  • Why not use a broken-link-checker github action?
    • wrote this so that it is not tied in to gha (works locally)
    • gha will only call the script and upload artifact

Instructions

./checks/linkcheck/lychee.sh

The report will be generated at /path/to/checks/linkcheck.

As usual, nix fmt works inside linkcheck dir.

TODO/Roadmap

  • archive all links found in lychee scan (see lychee --dump)
    • Since these links are prone to deletion it is our duty to archive them.
    • There was a cli tool for this, forgot what it is, rediscover it