servius/sukr
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add cross-references and fix nav ordering

Browse Source 
Link feature names in architecture.md to feature docs pages.
Add See Also section to configuration.md with related pages.
Add getting-started prerequisite link to deployment.md. Adjust
page weights for user journey sidebar order: Getting Started
(0) → Deployment (1) → Content Organization (2) → Config (3).
This commit is contained in:
Timothy DeHerrera
2026-02-12 13:27:23 -07:00
parent 44e51cbdb7
commit ef173ec092
5 changed files with 17 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
docs/content/architecture.md
View File

@@ -68,12 +68,12 @@ This pattern avoids buffering the entire document. Each code block is processed
Traditional SSGs ship JavaScript for:
| Feature | Typical Approach | sukr Approach |
| :------------------ | :--------------------- | :------------------------------------------------ |
| Syntax highlighting | Prism.js, Highlight.js | Tree-sitter at build-time → `<span class="hl-*">` |
| Math rendering | MathJax, KaTeX.js | KaTeX at build-time → MathML (browser-native) |
| Diagrams | Mermaid.js | mermaid-rs at build-time → inline SVG |
| Mobile nav | JavaScript toggle | CSS `:has()` + checkbox hack |
| Feature | Typical Approach | sukr Approach |
| :------------------------------------------------------- | :--------------------- | :------------------------------------------------ |
| [Syntax highlighting](features/syntax-highlighting.html) | Prism.js, Highlight.js | Tree-sitter at build-time → `<span class="hl-*">` |
| [Math rendering](features/math.html) | MathJax, KaTeX.js | KaTeX at build-time → MathML (browser-native) |
| [Diagrams](features/mermaid.html) | Mermaid.js | mermaid-rs at build-time → inline SVG |
| Mobile nav | JavaScript toggle | CSS `:has()` + checkbox hack |
The result: **zero bytes of JavaScript** in the output. Pages load instantly, work without JS enabled, and avoid the complexity of client-side hydration.