Eine Vorlage reist als eine Datei mit der Endung .qtpl. QuartzControl schreibt sie unter
Vorlagen aus einem Projekt heraus (Export) und liest sie in ein anderes hinein (Import). Die
Datei ist ein Archiv, in dem zwölf Bausteine liegen können — jeder ein abgegrenzter Teil dessen,
was ein Projekt ausmacht. Beim Import wählt man aus, welche davon man übernimmt.
Die Bausteine
| Baustein | Was er trägt | In dieser Vorlage |
|---|---|---|
| Farben & Schriften | die neun Farbrollen für hell und dunkel, die drei Schriftrollen, woher Schriften geladen werden | gefüllt — 6.2, 6.3 |
| CSS-Variablen | eigene Werte für Variablen, getrennt nach hell und dunkel | 66 Variablen — 6.4 |
| Eigenes CSS | custom.scss und alle eigenen Stylesheets samt Ladereihenfolge | 30 Stylesheets — Kapitel 5 |
| Schriftdateien | mitgebrachte Schriftdateien und ihre @font-face-Regeln | vier Dateien, 157 KB — 6.3 |
| Statische Dateien | alles unter quartz/static/ außer den Schriften: Logos, Bilder, Textschnipsel | zwei Schnipsel — Die Instanzen |
| Layout | welche Komponente wo erscheint, je Seitentyp, und die Umbruchbreiten | gefüllt — 1.4 |
| Eigene Frames | selbst gebaute Seitenraster; werden im Ziel neu registriert, nicht kopiert | vier — 6.5 |
| Plugins | alle Plugin-Einträge mit Optionen, Reihenfolge und Position | gefüllt, darunter sieben Layout-Boxen — 5.5 |
| Übersetzungen | Texte, die in Quartz’ Sprachdateien geändert wurden | gefüllt, mit einer Einschränkung (unten) |
| Theme-Presets | gespeicherte Zusammenstellungen von Farben und Schriften | zwei: hell und dunkel |
| Community-Theme | ein installiertes Theme mit seinen Einstellungen | leer — diese Vorlage ist selbst das Theme |
| Inhalt | die Notizen selbst | leer — der Inhalt liegt im Vault |
Der Import zeigt vorher, welche Bausteine das Paket enthält und was im Projekt dadurch ersetzt wird, und legt einen Snapshot an — eine Sicherung, zu der man zurückkehren kann.
Was mitreist und was nicht
Von den Dateien eines Projekts trägt ein Paket alles unter quartz/styles/ (Eigenes CSS) und
alles unter quartz/static/ — die Schriftdateien in ihrem eigenen Baustein, Logos, Bilder und
Schnipsel-Dateien im Baustein Statische Dateien.
Dass letzterer existiert, ist neu: Bis zum 06.09.2026 blieb alles außer den Schriften zurück, und
eine Layout-Box mit file: kam im Zielprojekt mit einem Verweis ins Leere an — gemessen erschien
layout-box-note auf 0 von 334 Seiten. Seitdem kommen die zwei Schnipsel-Dateien mit, und im
Zielprojekt rendern alle Boxen.
Der Baustein rechnet dabei mit, was Quartz selbst mitbringt: Von den sechs Dateien unter
quartz/static/ sind vier byteweise Quartz’ eigenes Gerüst (icon.png, og-image.png, zwei
giscus-Stylesheets) und nur die zwei Schnipsel gehören der Vorlage. Die Vorschau meldet deshalb
zwei Ergänzungen statt sechs Konflikten, und ein Zielprojekt bekommt nie das Gerüst eines anderen
übergestülpt.
Sechs der sieben Layout-Boxen holen ihren Inhalt trotzdem aus der Konfiguration (html:) und die
Wortmarke ist ein Inline-SVG. Das ist seit dem 06.09.2026 keine Notwendigkeit mehr, sondern eine
Entscheidung: Markup im Konfigurationseintrag kann ohne diesen Eintrag gar nicht erst ankommen. Die
eine file:-Box — „Über dieses Handbuch“ — zeigt den anderen Weg. Fehlt ihre Datei doch einmal,
ist das kein Fehler: Das Plugin protokolliert eine Warnung und rendert nichts; im Dev-Server
erscheint ein gestrichelter Platzhalter mit dem erwarteten Pfad.
Der Inhalt reist nicht mit — mit Absicht. Eine Vorlage ist eine Gestaltung; die eigenen Notizen kommen aus dem eigenen Vault. Den Baustein Inhalt gibt es für den seltenen Fall einer Vorlage, die sich selbst erklärt; diese hier tut das über den Vault.
Eine bekannte Einschränkung
Der Baustein Übersetzungen ändert keine Komponenten-Überschriften
„Backlinks“, „Graphansicht“, „Zuletzt bearbeitete Seiten“ kommen aus den Plugins selbst, die ihre Sprachdateien mitbringen. Was man in QuartzControl unter Konfiguration → Übersetzungen ändert, erreicht alles, was der Quartz-Kern beschriftet — die Komponenten-Überschriften nicht. Gemessen an der gebauten Seite: Alle drei blieben nach der Änderung stehen. Der Mechanismus ist richtig, seine Reichweite kleiner, als man erwartet.
Die Vorlage selbst weitergeben
Wer diese Vorlage verändert hat und das Ergebnis weitergeben will, exportiert unter Vorlagen ein neues Paket — mit den Bausteinen, die sich geändert haben. Der Empfänger importiert es in sein Projekt und wählt dieselben Bausteine. Was er dabei überschreibt, sagt ihm QuartzControl vorher.