Create deployment.md how-to page covering local preview, GitHub Pages, Netlify, Cloudflare Pages, and generic static hosts. Add cross-links from homepage and getting-started Next Steps. Reference security.md for CSP headers.
1.3 KiB
1.3 KiB
title, description
| title | description |
|---|---|
| sukr | Minimal static site compiler — suckless, Rust, zero JS |
sukr
sukr transforms Markdown into high-performance static HTML. No bloated runtimes, no client-side JavaScript, just clean output.
Why sukr?
Most static site generators punt rich content to the browser. sukr doesn't.
- Tree-sitter highlighting — Proper parsing, not regex. Supports language injection (Nix→Bash, HTML→JS/CSS).
- Build-time math — KaTeX renders LaTeX to static HTML. No 300KB JavaScript bundle.
- Build-time diagrams — Mermaid compiles to inline SVG. Diagrams load instantly.
- Flexible templates — Runtime Tera templates, no recompilation needed.
- Monorepo-ready — Multiple sites via
-cconfig flag.
Ready to try it? Start with the Getting Started guide.
Learn More
- Getting Started — install sukr and build your first site
- Deployment — deploy your site to GitHub Pages, Netlify, or any static host
- Configuration —
site.tomlreference and CLI options - Content Organization — how directories map to site structure
- Architecture — how sukr works under the hood
Browse the Features section in the sidebar for syntax highlighting, math, diagrams, and more.