Estimated reading time: 2 minutes
Page Improvements
- Improve Page Polish content, structure, and presentation of this page
- Expand Page Add depth, examples, and missing sections to this page
- Update Page Refresh outdated content, versions, links, and screenshots
- Fix Page Issue Report a typo, broken link, layout glitch, or content bug
- SEO Optimize Improve discoverability, metadata, and structured data
- Accessibility Audit Audit this page for WCAG 2.1 AA compliance
Site Improvements
- UI/UX Improvement Propose a design or UX refinement for the theme
- New Feature Propose a new site-wide feature or capability
- Component Enhancement Improve a Jekyll layout, include, or shared component
- Performance Optimization Improve load time, Core Web Vitals, and asset delivery
Table of Contents
SCHEMA — pages
The Obsidian vault that IS the Jekyll source (
source: pages) — content collections, the wiki, theme data, bridge plugins, and assets; layouts and includes come from the jekyll-theme-zer0 gem.
Structure
| entry | kind | purpose | rules |
|---|---|---|---|
.obsidian/ |
dir | Obsidian app/vault configuration (plugins, appearance, CSS snippets) — managed by Obsidian | terminal |
.raw/ |
dir | Drop zone for raw source material awaiting /wiki-ingest — excluded from the build | terminal |
.vault-meta/ |
dir | claude-obsidian vault bookkeeping (locks, metadata) — machine-managed | terminal |
.jekyll-cache/ |
dir | Jekyll incremental-build cache (gitignored) | generated |
_data/ |
dir | Live site + theme data — navigation, authors, UI text, skins (Jekyll never loads _data from theme gems) | |
_docs/ |
dir | Docs collection — topic-organized documentation published under /docs/ | |
_includes/ |
dir | Local include overrides for bugs/behaviour still present in the theme gem | |
_kb/ |
dir | Knowledge-base collection — standalone knowledge bases (1987, 2005), one folder each, published under /kb/ | |
_moc/ |
dir | Maps of Content collection — dashboard pages published under /moc/ | |
_notes/ |
dir | Notes collection — quick-reference cheatsheets published under /notes/ | |
_plugins/ |
dir | Obsidian→Jekyll bridge plugins (wikilinks, callouts, Dataview, graph index) | |
_posts/ |
dir | Posts collection — dated articles organized into category subdirectories | |
_templates/ |
dir | Obsidian Templater templates for wiki page types — excluded from the build | |
assets/ |
dir | Site-owned static assets — CSS/JS override hooks, images, background textures | |
wiki/ |
dir | The claude-obsidian knowledge base — concepts, entities, sources, plus index/log/hot-cache | |
CLAUDE.md |
file | Vault-scoped Claude guidance (authoring conventions) — excluded from the build | |
archives.md |
file | /archives/ page — post archives by year | |
categories.md |
file | /categories/ page — posts grouped by category | |
favicon.ico |
file | Site favicon | |
index.md |
file | Site landing page (/) | |
notes.md |
file | /notes/ landing page for the notes collection | |
posts.md |
file | /posts/ landing page for the posts collection | |
tags.md |
file | /tags/ page — content grouped by tag |
Placement
- New content routes by type: post →
_posts/<category>/, doc →_docs/<topic>/, cheatsheet →_notes/, wiki page →wiki/, knowledge-base article →_kb/<name>/<category>/. - New top-level page →
<name>.mdhere withpermalink:frontmatter; add it to_data/navigation/main.ymlif it belongs in the navbar. - Navigation or theme data changes →
_data/(this copy is live, not the theme gem’s).