Skip to content

ci: check rendered links on pull requests#601

Open
Haleshot wants to merge 8 commits into
2i2c-org:mainfrom
Haleshot:haleshot/improve-link-checking-ci
Open

ci: check rendered links on pull requests#601
Haleshot wants to merge 8 commits into
2i2c-org:mainfrom
Haleshot:haleshot/improve-link-checking-ci

Conversation

@Haleshot

@Haleshot Haleshot commented Apr 21, 2026

Copy link
Copy Markdown
Contributor

After #599, I had a closer look at the link-checking setup to see if breakage could be caught earlier.

First looked at whether it made sense to run lychee directly on source Markdown, but for this repo that seems to be the wrong level to validate. Hugo resolves and renders links in ways that make source-level checking much noisier than it looks.

This changes CI so built HTML is also checked on pull requests, which should catch the same class of internal-link regression before merge.
I also folded the shared lychee settings into lychee.toml so the local and CI behavior stays in sync.

Ahh, sorry, I hadn’t synced my remote fork correctly, so a some unrelated commits got pulled into this PR.

CC: @choldgraf

Comment thread .github/workflows/linkcheck.yml Outdated
- name: Link Checker (internal, offline)
uses: lycheeverse/lychee-action@v2.7.0
with:
args: --offline --no-progress --root-dir "${{ github.workspace }}/public" --exclude '^file://.*/public/roadmap/?$' public/**/*.html

@Haleshot Haleshot Apr 21, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I hesitated a bit over hardcoding this but I feel it makes sense. /roadmap is intentionally served from the separate roadmap repo rather than from this site build (as noted here). This exclude is only here to stop the PR check from treating it as a missing local file.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant