Quartz 5

Quartz Wiki

Properties1
tagsmeta, quartz, wiki, ssot

3 min read

Quartz Wiki — Operations

URL: https://q.freundeskreis.family/

Dieses Wiki ist die SSOT (Single Source of Truth) des Freundeskreis Großkarlbach. Es wird mit Quartz 5 generiert — ein statischer Site-Generator für verlinkte Notizen.

Architektur

content/*.md → npx quartz build → public/*.html → Apache (Plesk)
                                                    ↓
                                    q.freundeskreis.family
  • Verzeichnis: ~/httpdocs/quartz-wiki/
  • Content: content/ (Markdown-Dateien)
  • Output: public/ (statisches HTML)
  • Config: quartz.config.yaml
  • SPA Navigation: enabled mit Popovers
  • Locale: de-DE
  • Base URL: q.freundeskreis.family

Subdomain-Setup und Nginx/Apache-Konfiguration → Plesk & Subdomains.

Build & Deploy

cd ~/httpdocs/quartz-wiki
./rebuild-wiki.sh

Das Script:

  1. Pulled git changes (falls git-repo)
  2. Baut mit npx quartz build
  3. Stellt .htaccess wieder her (Quartz löscht public/ beim Build)
  4. Loggt nach ~/logs/wiki-build.log

Build-Verlauf und bekannte Probleme → Build-Log.

Dual-Zone-Struktur

ZonePfadInhalt
Contentcontent/*.mdVerein, Ort, Events
Metacontent/meta/*.mdEntwicklung, AI, Tooling
Raw Sourcescontent/raw-sources/Archivierte Quellen (unlisted)

Zonen-Navigation und SSOT-Architektur → Meta Hub.

Plugin Inventory

Alle Plugins aus quartz.config.yaml, gruppiert nach Funktion:

Transformer Plugins

PluginStatusNotes
created-modified-date✅Priority: frontmatter → git → filesystem
syntax-highlighting✅Themes: github-light / github-dark
obsidian-flavored-markdown✅Checkboxes enabled
github-flavored-markdown✅
table-of-contents✅Right sidebar
crawl-links✅Shortest resolution
description✅
latex✅KaTeX renderer
fonts✅Schibsted Grotesk / Source Sans Pro / IBM Plex Mono
note-properties✅Shows description, tags, aliases
remove-draft✅
unlisted-pages✅
encrypted-pages✅600k iterations, available

Emitter Plugins

PluginStatusNotes
alias-redirects✅
content-index✅Sitemap + RSS
favicon✅
og-image✅
cname✅

Page Generator Plugins

PluginStatusNotes
canvas-page✅
content-page✅
folder-page✅
tag-page✅
bases-page✅

Layout / UI Plugins

PluginStatusNotes
explorer✅Left sidebar
graph✅Right sidebar
search✅Left toolbar group
backlinks✅Right sidebar
darkmode✅Left toolbar group
reader-mode✅Left toolbar group
breadcrumbs✅Before body (not on index)
article-title✅Before body
content-meta✅Before body
page-title✅Left sidebar
spacer✅Left, mobile-only
footer✅Links: freundeskreis.family, quartz

Disabled Plugins

PluginNotes
citations
hard-line-breaks
ox-hugo
roam
stacked-pages
tag-list
recent-notes
commentsgiscus provider configured but disabled
explicit-publish

Layout

┌──────────────────────────────────────────────────────┐
│  Left Sidebar          Body              Right Sidebar│
│ ┌────────────┐  ┌──────────────────┐  ┌─────────────┐│
│ │ page-title │  │ breadcrumbs      │  │ graph       ││
│ │ [toolbar]  │  │ article-title    │  │ toc         ││
│ │  search    │  │ note-properties  │  │ backlinks   ││
│ │  spacer    │  │ content-meta     │  │             ││
│ │  darkmode  │  │ ─── body ───     │  │             ││
│ │  reader    │  │ footer           │  │             ││
│ │ explorer   │  │                  │  │             ││
│ └────────────┘  └──────────────────┘  └─────────────┘│
└──────────────────────────────────────────────────────┘
  • Toolbar group: search + spacer (mobile-only) + darkmode + reader-mode — row layout, 0.5rem gap
  • Explorer: left sidebar, below toolbar
  • Graph / TOC / Backlinks: right sidebar
  • Breadcrumbs: before body, hidden on index pages
  • 404 pages: no sidebars, no beforeBody
  • Folder/Tag pages: no right sidebar, no reader-mode

Theme Colors

TokenLight ModeDark Mode
light#faf8f8 (warm white)#161618 (deep dark)
lightgray#e5e5e5#393639
gray#b8b8b8#646464
darkgray#4e4e4e#d4d4d4
dark#2b2b2b#ebebec
secondary#284b63#7b97aa
tertiary#84a59d#84a59d
highlightrgba(143,159,169,0.15)rgba(143,159,169,0.15)

Typography: Schibsted Grotesk (headers) / Source Sans Pro (body) / IBM Plex Mono (code) — Google Fonts mit CDN-Caching.

Ignored Patterns

In quartz.config.yaml → ignorePatterns:

  • private — private Notizen
  • templates — Obsidian-Templates
  • .obsidian — Obsidian-Konfiguration
  • raw-sources — archivierte Quell-Dateien
  • SCHEMA.md — Schema-Dokumentation (nur intern)

Frontmatter-Schema

Jede Seite benötigt:

title: string
type: concept | decision | bug | open-question | source | reference | synthesis | stub
updated: YYYY-MM-DD
sources: [path-or-url, ...]

Optional: tags, reliability, unlisted, aliases, description

Vollständiges Schema → content/SCHEMA.md (intern, nicht publiziert).

See also

Graph View

Backlinks