Zer0-Mistakes Documentation¶
Welcome to the Zer0-Mistakes Jekyll theme documentation. This section contains user-facing guides for installing, configuring, and customizing the theme.
Two-tier documentation system: This site (
/docs/) contains user guides — how to use the theme. For contributor and maintainer references (architecture, release automation, system internals), see thedocs/directory in the repository.
Getting Started¶
New to Zer0-Mistakes? Start here:
| Guide | Description | Time |
|---|---|---|
| Installation | Set up the theme with Docker or Ruby | 10 min |
| Quick Start | Multiple installation paths | 15 min |
| Theme Guide | Complete setup and customization | 30 min |
Core Documentation¶
Configuration¶
- Front Matter — Page metadata and options
- Jekyll Configuration — Site settings and options
Features¶
Enable powerful features for your site:
| Feature | Description | Front Matter |
|---|---|---|
| Mermaid Diagrams | Flowcharts, sequence diagrams | mermaid: true |
| MathJax Math | Mathematical equations | mathjax: true |
| Giscus Comments | GitHub Discussions comments | comments: true |
| PostHog Analytics | Privacy-first analytics | (site-wide) |
| Keyboard Navigation | Accessibility shortcuts | (always on) |
Customization¶
Make the theme your own:
- Layouts — Page templates
- Styles — CSS customization
- Navigation — Menus and sidebars
Deployment¶
Publish your site:
- GitHub Pages — Free hosting with GitHub
- Netlify — Advanced hosting features
- Custom Domain — Use your own domain
Technology Guides¶
Reference documentation for the underlying technologies:
- Jekyll — Static site generator
- Bootstrap — CSS framework
- Liquid — Template language
- Ruby — Programming language
- Docker — Development environment
Troubleshooting¶
Having issues? Check the Troubleshooting Guide.
For Developers¶
Looking to contribute to the theme? See the developer documentation in the repository's docs/ directory for:
- Architecture documentation
- Development setup
- Testing guides
- Release process
Quick Navigation¶
- Installation — Get started
- Features — Enable features
- Customization — Make it yours
- Deployment — Go live
Last Updated: January 2026
See also¶
- [[Installation]]
- [[Features]]
- [[Customization]]
- [[Deployment]]
- [[Obsidian Vault Integration]]
- [[Jekyll]]
- [[Docker]]
- [[Bootstrap Integration]]