Quartz 5 SSOT 🛠️

Target: quartz-ssot/content/skills/gurus/QuartzGuru.md Context: Quartz 5 SSOT configurations, deployment, local plugins, routing.

💡 Best Practices (Patterns)

• Folder Labels: Use index.md with title: "Emoji Name" in a directory to set its 🧭 Explore sidebar label.
• Directory Linking: Link to folder notes using their path, e.g., [[skills/gurus|🧙 Skill Docs]].
• Git-Driven Dates: Use defaultDateType: modified. Rely completely on Git for accurate modified timestamps.
• Alias Redirects: Keep aliases: ["<old-slug>"] in frontmatter when moving pages to preserve inbound links via alias-redirects.
• Local Plugin Vendoring: Place community forks in quartz/local-plugins/<name>/, reference via source: ./quartz/local-plugins/<name> in quartz.config.yaml.
• Commit Dist Folders: Run npm install && npm run build inside local plugins and commit the dist/ folder. Quartz loader symlinks it; zero rebuild on deploy.
• Centralized Styling: Isolate site-wide style overrides (colors, fonts, Mermaid/SVG vars) in quartz/styles/custom.scss.

🚨 Gotchas / Warnings (Anti-patterns)

• Fake Timestamps: 🚫 NEVER hand-add or fake modified dates in frontmatter.
• Invalid Date Keys: 🚫 NEVER use lastmod, updated, or date. Use ONLY created, modified, or published.
• Editing Built Artifacts: 🚫 NEVER edit CSS/JS inside a vendored plugin’s dist/ directory; it will be overwritten on the next build.
• Generic Base URLs: 🚫 NEVER use example.com for baseUrl. MUST be explicitly set to ssot.0rk.de.
• Mermaid Init Overrides: 🚫 NEVER add %%{init}%% directives inside Mermaid blocks.

🔧 Configuration / Deployment

• Deploy Script: Execute ~/deploy.sh to build to public/ and deploy to ssot.0rk.de. (Main agent only).
• Nginx Routing: Clean URLs REQUIRE an Nginx fallback. Configure try_files $uri $uri/ $uri.html =404; for .html resolution.
• LLM Feeds: Run node generate-llmstxt.js to emit /llms.txt and /llms-full.txt.
• Plugin Keys: When configuring local plugins, the configuration option key MUST exactly match the plugin’s directory basename.