🪨 QuartzGuru

How to run the 0rk SSOT site specifically — not generic Quartz. Background: 🪨 Quartz 5. Pre-flight gate: ✅ Quartz Checklist. Canon: 📜 SSOT Bible.

1. 📁 Folders

Folder notes drive the Explorer labels.

• A folder’s index.md title (with its emoji) becomes that folder’s label in the 🧭 Explore sidebar — set title: "🧙 Skill Docs" in skills/gurus/index.md to rename the node.
• The folder note is also the landing page for /skills/gurus/. Link folders by directory path: [[skills/gurus|🧙 Skill Docs]].

2. 🗓️ Dates

The created-modified-date plugin reads git, so don’t fake timestamps.

• Recognized frontmatter date keys are created / modified / published only. Rename lastmod/updated → modified, date → created.
• Never hand-add a modified date — git supplies the real value down to HH:mm (defaultDateType: modified).
• Moved pages keep aliases: ["<old-slug>"] so alias-redirects preserves inbound links.

3. 🔌 Fork

Recipe to vendor a community plugin as a local fork (how canvas-page, explorer, comments, agent-bubble, content-meta already live here).

• Step 1 — Place the plugin source under quartz/local-plugins/<name>/.
• Step 2 — Point config at it: source: ./quartz/local-plugins/<name> in quartz.config.yaml.
• Step 3 — Build it once: npm install && npm run build inside the plugin dir so it emits a prebuilt dist/.
• Step 4 — Commit dist/. The Quartz loader symlinks the local dir and reads its committed dist/ at site build — no rebuild on deploy.
• Step 5 — Note the option key = directory basename. Options/layout live under that plugin entry exactly like a github: plugin.

flowchart LR
  A["quartz/local-plugins/<name>"] -->|"source: ./..."| B["quartz.config.yaml"]
  A -->|"npm install && npm run build"| C["dist/ (committed)"]
  B -->|"loader symlinks + reads"| C
  C -->|"site build"| D["public/"]

4. 🎨 Styles

• Site-wide overrides go in quartz/styles/custom.scss — theme colors, fonts, and the CSS variables Mermaid/SVG inherit (see 🧜 MermaidGuru, 🎨 SvgGuru).
• Edit there, not inside vendored plugin dist/ — plugin builds overwrite their own output.

5. 🚀 Deploy

Build, emit the LLM feed, publish — the main agent runs these, content agents never do.

• 🛠️ ~/deploy.sh — production build to public/ and publish to ssot.0rk.de.
• 📄 node generate-llmstxt.js — regenerate /llms.txt and /llms-full.txt.
• 🌐 baseUrl is ssot.0rk.de — never example.com; clean URLs need the Nginx try_files ... $uri.html fallback (see 🪨 Quartz 5).

6. ✅ Verify

• Frontmatter uses only created/modified/published; no hand-set modified.
• New local plugin has a committed dist/ and an option key = its dir basename.
• Folder index.md titles render the intended Explorer labels.
• Mermaid blocks carry no init directive; full gate in ✅ Quartz Checklist.