Skip to content

Fix lychee link-check failures for root-relative paths#20

Merged
MasonEgger merged 2 commits into
pytexas:mainfrom
graffhyrum:fix-lychee-root-relaltive-links
Apr 10, 2026
Merged

Fix lychee link-check failures for root-relative paths#20
MasonEgger merged 2 commits into
pytexas:mainfrom
graffhyrum:fix-lychee-root-relaltive-links

Conversation

@graffhyrum

Copy link
Copy Markdown
Contributor

Summary

  • Fix root-relative path resolution: Add symlink approach (ln -sfn site 2026) so lychee can resolve /2026/ prefixed URLs when checking local HTML files. MkDocs generates these paths from site_url, but lychee has no way to map them without a root directory hint.
  • Fix broken schedule anchor: Correct --jupyterlite to -jupyterlite in data/schedule.yaml — MkDocs strips & entirely rather than converting to -.
  • Fix spaker typo: Correct field name to speaker in schedule data (pre-existing bug, silent due to .get() usage).
  • Ignore false-positive links: Add g.page (Google Maps 302 redirects) and local-only post-mortem pages to .lycheeignore.

Test plan

  • just clean && just check passes with 0 errors
  • grep 'python-in-the-browser-building-interactive-documentation-with-mkdocs-jupyterlite' site/schedule/index.html confirms anchor fix
  • Verify no 2026 symlink remains after just link-check completes

🤖 Generated with Claude Code

@MasonEgger MasonEgger merged commit ab8ca71 into pytexas:main Apr 10, 2026
graffhyrum added a commit to graffhyrum/2026 that referenced this pull request May 14, 2026
… syntax (pytexas#20)

Co-authored-by: Mason Egger <mason@masonegger.com>
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.

2 participants