Quartz baut jede Seite aus Komponenten: Explorer, Inhaltsverzeichnis, Brotkrumen, Fußzeile. Jede davon hat eine Aufgabe und füllt sich aus dem Inhalt der Site. Was es nicht gibt, ist eine Komponente für das hier — den Satz unter dem Websitenamen, das Logo, den Hinweis, dass die Seite im Aufbau ist.
Wer so etwas will, hat ohne dieses Plugin zwei Wege, und beide taugen wenig:
- Ins Theme schreiben. Dann steht der Text in einer
.tsx-Datei, das Ändern eines Kommas braucht einen Übersetzungslauf, und beim nächsten Quartz-Update kollidiert er. - In jede Seite schreiben. Dann steht er 200-mal im Vault und wird 200-mal falsch, sobald sich etwas ändert.
Die Layout-Box ist der dritte Weg: ein Schnipsel, an einer Stelle gepflegt, an einer Stelle des Layouts eingesetzt.
Was sie tut
Sie nimmt ein Stück HTML oder Markdown und stellt es an die Stelle des Layouts, die man ihr nennt —
linke oder rechte Spalte, Kopfbereich, Fußzeile, vor oder nach dem Seiteninhalt. Der Text kommt
entweder aus einer Datei unter quartz/static/snippets/ oder direkt aus der Konfiguration.
Alles geschieht beim Bauen. Was im Browser ankommt, ist fertiges HTML; das Plugin liefert kein JavaScript aus, und eine Box kostet die Seite nichts an Ladezeit.
Was sie nicht tut
Sie ist kein Baustein für Inhalt. Was auf einer einzelnen Seite steht, gehört in diese Seite. Die Box ist für das, was auf vielen Seiten gleich ist.
Sie rendert keine Obsidian-Syntax. Ein Markdown-Schnipsel läuft nicht durch die Inhaltspipeline von Quartz — Wikilinks in doppelten eckigen Klammern und Callouts bleiben stehen, wie sie geschrieben sind. Warum das so ist und was stattdessen geht, steht unter 2.3 – Markdown-Schnipsel.
Und sie filtert nichts. Ein Schnipsel wird eingesetzt, wie er dasteht; wer fremdes HTML einbindet, bindet fremdes HTML ein. Siehe 9.3 – Grenzen.
Wann sich der Aufwand lohnt
Die Faustregel
Sobald dasselbe Stück Markup auf mehr als einer Seite stehen soll und nicht Teil des Textes ist, gehört es in eine Layout-Box.
Sieben Beispiele, die alle auf dieser Website zu sehen sind, stehen in Kapitel 8. Das kürzeste davon ist die Zeile in der Fußzeile mit dem Namen der Site; das aufwendigste die Wortmarke oben links, die zwischen hellem und dunklem Farbschema umschaltet, ohne dass eine Zeile JavaScript daran beteiligt wäre.