Skip to content

Add PDF export, migrate to uv, and add CI markdown linting#2

Merged
kraker merged 1 commit intomainfrom
pdf-support
Apr 1, 2026
Merged

Add PDF export, migrate to uv, and add CI markdown linting#2
kraker merged 1 commit intomainfrom
pdf-support

Conversation

@kraker
Copy link
Copy Markdown
Owner

@kraker kraker commented Apr 1, 2026

Summary

  • Add mkdocs-to-pdf plugin for PDF generation (gated behind ENABLE_PDF_EXPORT env var)
  • Migrate from pip/requirements.txt to uv/pyproject.toml for dependency management
  • Add CI markdown lint job with markdownlint v0.45.0 (matching rhcsa project)
  • Add .markdownlint.yaml config and update pre-commit hook to v0.45.0 with --fix
  • Add pdf_event_hook.py workaround for mkdocs-to-pdf readthedocs theme bug
  • Add templates/styles.scss for proper code block rendering in PDF output
  • Add PDF download link to docs homepage

Test plan

🤖 Generated with Claude Code

- Add mkdocs-to-pdf plugin for PDF generation of the study guide
- Migrate from pip/requirements.txt to uv/pyproject.toml for dependency management
- Add CI lint job with markdownlint v0.45.0 matching rhcsa project pattern
- Add .markdownlint.yaml config (replacing .mdl_config.yaml)
- Update pre-commit markdownlint hook to v0.45.0 with --fix
- Add pdf_event_hook.py workaround for mkdocs-to-pdf theme handler bug
- Add templates/styles.scss for proper code block rendering in PDF
- Add PDF download link to docs homepage
- Ignore vagrant/collections/ in markdownlint (third-party code)

Co-Authored-By: Claude Opus 4.6 <[email protected]>
@kraker kraker merged commit 3edb2cc into main Apr 1, 2026
4 checks passed
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