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.

Der Titel

Von Haus aus setzt Quartz die Seitenüberschrift in derselben Größe wie eine h1 im Text.

In dieser Vorlage ist sie größer und enger gesperrt (letter-spacing: -0.02em), und ihre Zeilen werden ausgeglichen statt gefüllt (text-wrap: balance): Ein Titel wird überflogen, nicht Zeile für Zeile gelesen, und einer, der nach vier Wörtern umbricht, sieht aus wie ein Versehen.

Auf schmalen Bildschirmen sinkt er eine Stufe — bei 390 px wäre die volle Größe der halbe Bildschirm.

Datum und Lesezeit

Von Haus aus eine Zeile in Textfarbe.

In dieser Vorlage gedämpft, kleiner, und die Teile sind durch einen Mittelpunkt getrennt, der noch blasser ist als der Text. Die Werte sind der Inhalt, die Zeichensetzung tritt zurück.

Woher das Datum kommt

Aus dem Frontmatter, sonst aus dem Dateisystem — in dieser Reihenfolge, eingestellt beim Plugin Created modified date.

Ein Symlink nimmt Quartz die git-Daten

Von Haus aus steht dort frontmatter → git → filesystem, und git wäre die bessere Quelle: Ein Commit-Datum überlebt ein Kopieren, ein Wiederherstellen und ein frisches Auschecken, die Änderungszeit einer Datei nicht. Hier fehlt es trotzdem. Der Inhalt dieser Website liegt in einem Obsidian-Vault, auf den content/ per Symlink zeigt; das Plugin folgt dem Symlink und findet auch das git des Vaults, rechnet den Dateipfad danach aber weiter gegen das Projektverzeichnis — und fragt so nach einem Pfad, der aus dem Vault wieder herausführt. Jede Abfrage scheitert. Für 250 der 254 Seiten stand deshalb „isn’t yet tracked by git, dates will be inaccurate“ im Bauprotokoll; stumm blieben nur die vier Seiten, die ein lastmod im Frontmatter tragen und git daher gar nicht erst fragen. Das Datum kam die ganze Zeit aus dem Dateisystem, git in der Liste war nur Lärm. Der Fehler ist gemeldet; sobald er behoben ist, gehört git wieder davor.

Das Format folgt der Seite, nicht der Website

Quartz formatiert Daten site-weit nach configuration.locale, hier also deutsch. Das localizeDates des Mehrsprachigkeits-Plugins formatiert jedes <time>-Element im Browser in der Sprache der Seite nach — eine englische Seite zeigt damit ein englisches Datum.

Welche Variablen hier greifen

Diese 7 Variablen liest der Abschnitt meta-title-and-date in content.scss. Ändern lassen sie sich in QuartzControl unter Stile → Variablen — ohne eine Zeile CSS.

VariableWertgilt außerdem für
--gray#5F5F5F · dunkel #A1A1A122 weitere Komponenten
--tpl-rule-strongvar(--gray) = #5F5F5F8 weitere Komponenten
--tpl-space-2xs0.25rem16 weitere Komponenten
--tpl-space-xs0.5rem20 weitere Komponenten
--tpl-text-2xl1.75rem6.4 – Variablen
--tpl-text-3xl2.25rem6.4 – Variablen, Fehlerseite
--tpl-text-sm0.875rem20 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.