Deutsch
Über dieses Handbuch

Dieses Handbuch gehört zur Vorlage Example für QuartzControl. Es erklärt die Vorlage und führt zugleich alles vor, was sie kann.

Der Text hier kommt aus einer Markdown-Datei, nicht aus der Konfiguration.

Zuletzt geändert

Von Haus aus

Eine Liste der zuletzt bearbeiteten Seiten mit Datum, Beschreibung und Tags.

In dieser Vorlage

Auf fünf Einträge begrenzt, durch Haarlinien getrennt, und auf eine Zeile Titel plus Datum eingedampft.

Gemessen vor dem Eindampfen: Ein Eintrag war 113 px hoch, fünf davon füllten 700 px einer Leiste, die auch noch den Baum und die Notiz-Box trug. Heute sind es 54 px je Eintrag und 320 px für den ganzen Kasten.

Zwei der drei Zeilen waren ein Versehen. Die Regel für die Überschrift der Box lautete .recent-notes h1, h2, h3 — und jeder Eintragstitel ist eine h3, also wurden alle fünf in Versalien und Sperrung gesetzt. Der Selektor nennt jetzt das eigene Kind der Box (> h3) und nichts Tieferes. Beschreibung und Tag-Pillen sind ganz weg: Die eine wiederholt den Titel bei halber Lesbarkeit, die anderen sind höher als der Eintrag, den sie beschriften.

Ein dritter Abstand kam vom li selbst. Quartz gibt jedem Listeneintrag 1 rem oben und unten, die Rückverweise nehmen ihn zurück, dieser Kasten tat es nicht — 32 px je Eintrag, die niemand bestellt hatte, 160 von 408 px insgesamt. Deshalb stand er kopfhoch neben dem Kasten daneben, und der Abstand unter der Überschrift las sich wie ein Einzug.

Wo er steht

Unter dem Text, nicht in der Seitenleiste, und dort in einer Reihe mit den Rückverweisen — zwei Kästen nebeneinander, oberhalb der Smartphone-Breite immer zweispaltig, darunter untereinander. Bis zum 10.09.2026 stand er links oben in der Seitenleiste unter dem Explorer; dort war er eine dritte Liste in einer Spalte, die schon zwei trug.

Er ist damit auch nicht mehr auf den Desktop beschränkt. Ein Kasten unter dem Artikel ist auf einem Smartphone kein Hindernis mehr, sondern das, was nach dem Lesen kommt.

Ordnerseiten stehen nicht drin

hideFolderPages: true nimmt jede …/index-Seite aus der Liste, die zwei Startseiten eingeschlossen. Ohne diese Option war der Kasten die Spitze der Gliederung statt einer Liste von Notizen: vier Ordner- und Startseiten von fünf, und auf der Startseite führte er sie selbst auf, zweimal, weil beide Sprachen „Example“ heißen.

Das ist die Folge davon, dass die Dateizeiten dieses Vaults der Gliederung folgen — sie sind gestaffelt, damit die Liste überhaupt eine Reihenfolge hat, und oben steht dann eben das Inhaltsverzeichnis. Ein Kasten, der „zuletzt bearbeitet“ heißt, soll Notizen zeigen.

Ein Fund beim Bauen

Diese Komponente benutzt dieselben Klassennamen wie die Ordner- und Tag-Listen: .section, .meta, .desc, .tags. Die Listenregeln der Vorlage waren zunächst nicht eingegrenzt und landeten deshalb auch hier — in der damals noch schmalen Seitenleiste stapelte das dreispaltige Raster Datum und Titel übereinander.

Seitdem sind alle Listenregeln auf .page-listing eingegrenzt. Die Lehre: Ein Klassenname gehört nicht der Komponente, in der man ihn zuerst gesehen hat.

Beide Sprachen in einer Liste

Die Liste entsteht aus jeder Seite des Builds, eine englische Seite kann also im Kasten einer deutschen auftauchen. Einen Sprachfilter gibt es nicht — die Option dafür ist eine Funktion und lässt sich in einer YAML-Konfiguration nicht schreiben. Wie beim Suchindex trennte das nur ein Build je Sprache — siehe Wo die zwei Sprachen aufhören.

Welche Variablen hier greifen

Diese 13 Variablen liest der Abschnitt aside-recent-notes in components-note.scss. Ändern lassen sie sich in QuartzControl unter Stile → Variablen — ohne eine Zeile CSS.

VariableWertgilt außerdem für
--bodyFont"Noto Sans", system-ui, "Segoe UI", Robot…3 weitere Komponenten
--darkgray#333333 · dunkel #DDDDDD18 weitere Komponenten
--gray#5F5F5F · dunkel #A1A1A122 weitere Komponenten
--headerFont"Noto Sans", system-ui, "Segoe UI", Robot…15 weitere Komponenten
--secondary#1463A3 · dunkel #699DC319 weitere Komponenten
--tpl-leading-snug1.4rem4 weitere Komponenten
--tpl-rulevar(--lightgray) = #DDDDDD19 weitere Komponenten
--tpl-rule-width1px25 weitere Komponenten
--tpl-space-2xs0.25rem16 weitere Komponenten
--tpl-space-xs0.5rem20 weitere Komponenten
--tpl-text-sm0.875rem20 weitere Komponenten
--tpl-text-xs0.78rem10 weitere Komponenten
--tpl-tracking-label0.08em9 weitere Komponenten

Diese Tabelle ist erzeugt: Sie wird aus den Stylesheets gelesen, nicht von Hand gepflegt.

Weiterlesen

Diese Seite gehört zu Example — der Beispielvorlage für QuartzControl. Ein Überblick über alle Bereiche steht auf der Startseite.

Auf einem schmalen Bildschirm ist die Navigation oben eingeklappt.