Nachschlagewerk, nicht Lesestoff. Wo ein Begriff in diesem Handbuch das erste Mal auf einer Seite vorkommt, führt ein Link hierher.
Wie man Notizen schreibt — Callouts, Bases, Canvas, Frontmatter-Felder —, erklärt das Handbuch der Beispielvorlage Example mit einem eigenen, größeren Glossar. Hier steht, was QuartzControl selbst sagt.
Basis-URL
Die Adresse, unter der die fertige Website erreichbar sein wird, ohne https:// — etwa
notizen.example.com. Quartz baut daraus alle Links, den RSS-Feed und die Vorschaubilder. Steht
unter Einrichtung → Konfiguration; solange sie unbekannt ist, bleibt localhost stehen.
Baustein
Ein Teil eines Vorlagenpakets. Zwölf gibt es: Farben und Schriften, Community-Theme, Plugins, Layout, Frames, Presets, Übersetzungen, Stylesheets, Schriften, statische Dateien, CSS-Variablen und der Inhalt. Beim Export wie beim Import wird jeder einzeln an- oder abgewählt.
Was auf der Seite erscheint, heißt dagegen Plugin oder Komponente — QuartzControl sagte bis zum 2026-09-07 an einer Stelle auch dazu „Baustein“.
Branch
Ein Strang in der Geschichte eines Repositorys. Ein
Projekt steht immer auf genau einem; Push und Pull beziehen sich darauf. Beim Veröffentlichen über
GitHub Pages ist der Ziel-Branch üblicherweise gh-pages und ausdrücklich nicht der, auf dem
gearbeitet wird — er wird bei jedem Deploy vollständig ersetzt.
Build
Der Vorgang, bei dem Quartz aus dem Content-Ordner eine
fertige Website macht: aus Markdown wird HTML, dazu Suchindex, Graph und Stylesheets. Das Ergebnis
landet in einem Ausgabeordner, üblicherweise public. Jeder Build leert diesen Ordner
zuerst vollständig — deshalb fragt QuartzControl nach, wenn dort etwas liegt, das nicht nach einem Build
aussieht.
Commit
Ein gespeicherter Stand in der Geschichte eines Repositorys, mit Datum, Urheber und Beschreibung. Ein Snapshot ist technisch auch einer — aber in einer eigenen Geschichte, die nur QuartzControl kennt.
Community-Theme
Ein fertiges Farbschema aus dem @quartz-themes-Ökosystem, installiert und aktiviert über Stile →
Community-Themes. Es liegt in der zweiten der vier Ebenen: Es überschreibt die Basisfarben, wird
aber von deinen eigenen CSS-Variablen und deinem eigenen CSS überschrieben.
Content-Ordner
Der Ordner content/ im Projekt, in dem die Markdown-Dateien liegen, aus denen die Website gebaut
wird. Er ist entweder ein echter Ordner oder eine
Verknüpfung auf einen Ordner außerhalb des Projekts — zum
Beispiel auf einen Vault.
CSS-Variable
Ein benannter Wert, den ein Stylesheet an vielen Stellen einsetzt — eine Farbe, ein Abstand, eine Schriftgröße. Ändert man ihn einmal, ändert sich alles, was ihn benutzt. Quartz leitet viele Variablen aus wenigen Grundfarben ab; der Variablen-Tab zeigt zu jeder, woher ihr Wert kommt und was daran hängt.
Dev-Server
Ein Programm, das die Website baut, sie unter http://localhost:<Port> ausliefert und bei jeder
Änderung an einer Notiz neu baut. Die Vorschau in QuartzControl ist genau das. Er läuft weiter,
wenn das Fenster geschlossen wird, und wird nicht von selbst beendet.
Frame
Das Raster einer Seite: welche Bereiche es gibt — Kopfbereich, Seitenleisten, Inhalt, Fußzeile —, wo sie liegen und wie breit sie sind. Quartz bringt drei mit (Standard, Volle Breite, Minimal); eigene baut man im Layout-Editor, für je drei Bildschirmbreiten. Was in den Bereichen erscheint, entscheidet ein anderer Tab.
Frontmatter
Der Block zwischen zwei Zeilen aus drei Bindestrichen ganz oben in einer Markdown-Datei. Darin stehen Titel, Beschreibung, Datum, Schlagwörter und alles andere, was eine Seite über sich selbst sagt.
Git-Sync
Der Abgleich des Projekts mit einem Repository — Hochladen (Push) und Herunterladen (Pull). Zum Teilen und für den zweiten Rechner gedacht. Nicht zu verwechseln mit einem Snapshot, der zum Zurückholen da ist, und nicht mit dem Veröffentlichen, das die fertige Website verschickt.
Host-Key
Der Fingerabdruck, mit dem sich ein Server beim Verbinden über SFTP oder rsync ausweist. Beim ersten Mal fragt QuartzControl danach und merkt ihn sich. Ändert er sich später, bricht es ab: Das kann ein neu aufgesetzter Server sein — oder jemand, der sich dazwischengeschaltet hat.
Markdown
Eine einfache Schreibweise für Text, in der **fett** fett wird und # Überschrift eine
Überschrift. Jede Notiz ist eine Textdatei mit der Endung .md.
Marktplatz
Die Liste der Plugins aus der quartz-community-Organisation auf GitHub, durchsuchbar und mit
einem Klick installierbar. Plugins von anderswo fügt man über owner/repo hinzu.
Plugin
Ein Baustein von Quartz, der eine Aufgabe hat: Einer baut den Explorer links, einer das
Inhaltsverzeichnis rechts, einer die Suche, einer liest das Datum einer Datei. Manche erscheinen
sichtbar auf der Seite, andere verändern nur den Inhalt im Hintergrund. Welche aktiv sind und wie
sie eingestellt sind, steht in quartz.config.yaml.
Preset
Eine gespeicherte Zusammenstellung von Theme-Einstellungen unter einem eigenen Namen. Nützlich, um zwei Farbwelten nebeneinander auszuprobieren, ohne die eine zu verlieren.
Projekt
Ein Ordner mit einer Quartz-Installation: die Konfiguration, der Content-Ordner, die Stylesheets, die Plugins. QuartzControl kann mehrere davon verwalten; alles außer der Startseite und den Einstellungen gilt jeweils für eines davon.
Quartz
Der Static-Site-Generator, den QuartzControl bedient. Er versteht Obsidians Schreibweise und baut daraus eine Website mit Rückverweisen, Graph-Ansicht und Volltextsuche.
Repository
Ein Ordner, dessen Geschichte git aufzeichnet. Liegt er zusätzlich auf einem Server — etwa bei GitHub —, kann man ihn von mehreren Rechnern aus benutzen.
Schlüsselbund
Der verschlüsselte Speicher des Betriebssystems für Passwörter (macOS: Schlüsselbund, Windows: Anmeldeinformationsverwaltung, Linux: gnome-keyring oder KWallet). QuartzControl legt Passwörter und Token dort ab, nicht in einer eigenen Datei. Fehlt er auf einem Linux-System, sagt die Startseite das ausdrücklich.
Seitentyp
Eine Art von Seite, die Quartz unterscheidet: die gewöhnliche Inhaltsseite, die Startseite, eine Tag-Seite, eine Ordnerseite. Jedem Seitentyp lässt sich ein eigener Frame zuweisen.
Snapshot
Eine Kopie dieses Projekts, die nur QuartzControl kennt. Sie bleibt im Projekt, wird nie hochgeladen und rührt die eigene git-Geschichte nicht an. Vor jeder größeren Änderung legt QuartzControl von selbst einen an; zurückholen lässt sich das ganze Projekt oder eine einzelne Datei.
Static-Site-Generator
Ein Programm, das aus einem Ordner voller Textdateien einen Ordner voller fertiger HTML-Seiten macht. Das Ergebnis braucht keine Datenbank und kein Programm auf dem Server — es liegt einfach da und wird ausgeliefert.
Token
Ein Passwortersatz für eine Schnittstelle, hier: für GitHub. Ohne einen ist der
Marktplatz nach wenigen Anfragen erschöpft; zum Anlegen
eines Repositorys und für GitHub Pages braucht er zusätzlich die Berechtigung repo.
Vault
Ein Ordner voller Notizen, wie Obsidian ihn verwaltet. Ein Content-Ordner kann direkt darauf verweisen — dann schreibt man in Obsidian und die Website folgt.
Veröffentlichen
Die fertige Website an ihren Bestimmungsort bringen — über GitHub Pages, SFTP, rsync, FTP, in einen Ordner oder über einen Webhook. Dazu gehören zwei Dinge: ein Zugang und ein Ziel.
Verknüpfung
Ein Eintrag im Dateisystem, der auf einen anderen Ordner zeigt, ohne ihn zu kopieren — technisch ein symbolischer Link. Der Content-Ordner kann so gebaut sein: Er ist dann der Vault, und wer dort schreibt, schreibt an der Quelle.
Vorlagenpaket
Eine einzelne Datei mit der Endung .qtpl, die die Gestaltung eines Projekts enthält — Farben,
Theme, Stylesheets, Schriften, Layout, Frames, Plugins, Übersetzungen — und sie in ein anderes
Projekt bringt. Zusammengesetzt aus zwölf Bausteinen, die
sich einzeln an- und abwählen lassen.
Wikilink
Ein Link in doppelten eckigen Klammern, [[so]], wie Obsidian ihn schreibt. Quartz löst ihn beim
Bauen auf. Wie die Ziele geschrieben sind — kürzeste Form, absolut oder relativ —, muss in der
Konfiguration zu den Notizen passen, sonst finden die Links nichts.
Ziel
Wohin dieses Projekt veröffentlicht: der Serverpfad, das Löschverhalten, die Ausschlüsse — und welcher Zugang dafür benutzt wird. Ein Ziel gehört zu einem Projekt.
Zugang
Eine Anmeldung bei einem Anbieter: Server, Benutzername, Passwort oder Schlüssel. Ein Zugang gehört zu QuartzControl, nicht zu einem Projekt — dasselbe Webspace-Konto kann mehrere Websites tragen, und ein Passwortwechsel ist dann eine Änderung statt einer pro Projekt.