PROJECT // Jasper // Libraries
Modular structured guide, book, and documentation compiler for Crystal docs.
Jasper compiles modular multi-track technical books, guides, and tutorials into standard crystal docs output.
Features:
- Native Crystal Docs Integration: In-page Method Summary navigation tables, deep links, and automated search indexing in
search-index.js. - Dual Authoring Formats: Author guides in clean YAML hierarchies under
docs_src/or programmatically in Crystal code via the fluentJasper.define_trackDSL. - Zero Overhead in Release: Compiles documentation modules wrapped in
{% unless flag?(:release) %}guards to ensure documentation is completely stripped from production release binaries. - Table Auto-Transformation: Converts Markdown pipe tables (
| col |) into standard HTML<table>elements for robust cross-browser rendering. - Extensible Plugin System: Section handlers for Mermaid architecture diagrams and benchmark comparison matrices.