Eine Quartz-Website besteht aus Komponenten: dem Explorer, der Suche, dem Inhaltsverzeichnis, den Brotkrumen, der Fußzeile — jede von einem Plugin gebaut, jede mit einem eigenen Aussehen. Dieses Kapitel geht sie der Reihe nach durch, sortiert nach ihrem Ort auf der Seite; die Orte sind in 1.4 – So ist eine Seite aufgebaut benannt.
Wie jede Seite aufgebaut ist
Jede Seite behandelt eine Komponente und hat zwei Absätze:
Von Haus aus — was Quartz ohne Zutun macht. In dieser Vorlage — was hier anders ist, und warum.
Der Vergleich steht direkt bei dem Element, das man dabei ansieht. Wer seine eigene Website mit dieser vergleicht, findet so den Unterschied benannt. Und wer ihn ändern will, findet unten auf derselben Seite die Tabelle „Welche Variablen hier greifen“: die Variablen, die das Stylesheet dieser Komponente liest, mit ihrem Wert und der Angabe, was sich sonst noch mit ändert. Diese Tabellen sind erzeugt, nicht von Hand gepflegt; sie können den Stylesheets nicht widersprechen.
Ein Stylesheet ist die Datei, in der das Aussehen beschrieben ist — in der Sprache CSS, hier in ihrer Erweiterung SCSS. Diese Vorlage hat zwölf davon — eins fürs Layout, eins für den Inhalt, eins für die Callouts, eins je Art von Komponente und eins je eigenem Plugin —, und jede Seite hier nennt den Abschnitt, in dem ihre Komponente steht. Ändern lassen sie sich in QuartzControl unter Stile → Eigenes CSS; wann das nötig ist und wann eine Variable reicht, steht in 6.1 – Etwas ändern.
Die Abschnitte
| Abschnitt | Komponenten |
|---|---|
| 5.1 – Navigation | Navigation, Explorer, Suche, Farbschema, Lesemodus, Kopfbereich, Fußzeile, Sprachumschalter |
| 5.2 – Über dem Inhalt | Brotkrumen, Titel und Datum, Eigenschaften, Tags |
| 5.3 – Im Inhalt | Fließtext, Callouts, Code, Tabellen und Medien |
| 5.4 – Neben dem Inhalt | Inhaltsverzeichnis, Rückverweise, Graph, Zuletzt geändert |
| 5.5 – Layout-Boxen | ein Plugin, siebenmal eingesetzt |
| 5.6 – Erzeugte Seiten | Ordner- und Tag-Seiten, Suchergebnisse, Link-Vorschau, Fehlerseite |
Zwei Komponenten stehen woanders, weil ihr Stylesheet zu einem Abschnitt in Kapitel 2 gehört: die Diagramme unter 2.9 – Diagramme und die Formeln unter 2.8 – Mathematik. Und was unter allem liegt — Farben, Schriften, Variablen, Seitenraster, Barrierefreiheit — ist Kapitel 6 – Anpassen.
Die drei Entscheidungen, die alles andere tragen
- Die Breite entscheidet das Raster — der Frame, an einer Stelle, nicht zusätzlich der Absatz.
- Farben sind gemessen. 93 Paare, alle über der WCAG-Schwelle, in beiden Modi.
- Farbe und Maß stehen nicht in den Stylesheets, sondern in 66 Variablen, die in QuartzControl bearbeitbar bleiben. Was doch literal dasteht, ist benannt und begründet.