Skip to content

Conversation

@jstirnaman
Copy link
Contributor

Summary

Update link-checker to v1.2.5 which adds --root-dir support for lychee v0.22.0+.

Problem

Lychee v0.22.0 (released Dec 5, 2025) introduced a breaking change in PR #1864 where root-relative links in local files now require --root-dir to be specified. Previously these were silently ignored, but now they produce errors like:

Cannot convert path '/telegraf/v1/output-plugins/redistimeseries/' to a URI: 
To resolve root-relative links in local files, provide a root dir

This was causing CI failures for PRs touching /telegraf/v1 and /influxdb3/explorer paths.

Solution

Link-checker v1.2.5 now automatically sets --root-dir to the Hugo public/ directory when checking local HTML files in a Hugo project. This allows lychee to properly resolve root-relative links to their corresponding files.

Test plan

Update link-checker to v1.2.5 which adds --root-dir support for lychee v0.22.0+.

This fixes CI failures caused by lychee v0.22.0 (released Dec 5, 2025)
requiring --root-dir to resolve root-relative links in local files.
The link-checker now automatically sets --root-dir to the Hugo public/
directory when checking local HTML files.

Fixes failures for PRs touching /telegraf/v1 and /influxdb3/explorer paths.
@jstirnaman jstirnaman merged commit ebbb0d4 into master Dec 10, 2025
1 check passed
@jstirnaman jstirnaman deleted the jts-docs-link-checker-failures branch December 10, 2025 15:52
jstirnaman added a commit that referenced this pull request Dec 22, 2025
Update link-checker to v1.2.5 which adds --root-dir support for lychee v0.22.0+.

This fixes CI failures caused by lychee v0.22.0 (released Dec 5, 2025)
requiring --root-dir to resolve root-relative links in local files.
The link-checker now automatically sets --root-dir to the Hugo public/
directory when checking local HTML files.

Fixes failures for PRs touching /telegraf/v1 and /influxdb3/explorer paths.
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