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.

Von Haus aus

Ein Kasten mit der lokalen Umgebung, dazu ein Symbol zum Öffnen der Gesamtansicht.

In dieser Vorlage

Der Graph zeichnet sich selbst und holt seine Farben zur Laufzeit aus den CSS-Variablen. Die Vorlage gestaltet deshalb nur den Kasten darum, nicht die Zeichnung:

  • ein quadratisches Feld (aspect-ratio: 1) — der lokale Graph ist rund, ein breiter Kasten verschenkt die Seitenleiste
  • Rahmen und getönte Fläche wie bei den anderen Panels
  • das Symbol für die Gesamtansicht ist 44 px groß und sitzt rechts in der Überschriftenzeile
  • die Gesamtansicht bekommt denselben Schatten wie die Suche — beide schweben wirklich

Ein halb umgefärbter Graph wäre schlechter als ein fremdfarbiger: Die Zeichnung löst ihre Farben selbst auf, und ein Stylesheet, das dagegen arbeitet, trifft immer nur die Hälfte.

Auf schmalen Bildschirmen wird er ausgeblendet (display: desktop-only) — ein Netz aus Punkten in einer 390 px breiten Spalte zeigt nichts.

Was auf Ordnerseiten fehlt

Auf einer Ordner- oder Kapitelseite steht im Kasten nur ein einzelner Punkt, auch wenn die Seite verlinkt ist. Das ist ein Fehler im Plugin und von einer Vorlage aus nicht zu beheben.

Das Skript rechnet Adressen an zwei Stellen um und an jeder anders. Seinen Datensatz schlüsselt es mit simplifySlug: Das schneidet ein index am Ende ab und lässt den Schrägstrich davor stehen, aus 2-formatierung/01-text/index wird also 2-formatierung/01-text/. Die Mitte des Graphen holt es dagegen aus der Adresszeile und schneidet den Schrägstrich dort ab. Für jede Seite, deren Adresse auf einen Schrägstrich endet — und das sind genau die Ordnerseiten — sucht es damit einen Knoten, den es selbst nie angelegt hat: keine Kanten, ein Punkt.

Dieselbe Seite über …/01-text/index aufgerufen zeigt neun Knoten und acht Kanten. Ein Zeichen Unterschied.

Ausblenden lässt der Kasten sich dort nicht: Quartz’ Bedingung not-index meint nur die Startseite, und alles Feinere braucht Code statt Konfiguration. Was die Verbindungen einer Ordnerseite trotzdem zeigt, sind die Rückverweise und die Liste im Text darüber.

Welche Variablen hier greifen

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

VariableWertgilt außerdem für
--dark#17171A · dunkel #FCFCFA13 weitere Komponenten
--gray#5F5F5F · dunkel #A1A1A122 weitere Komponenten
--headerFont"Noto Sans", system-ui, "Segoe UI", Robot…15 weitere Komponenten
--light#FCFCFA · dunkel #16171A14 weitere Komponenten
--tpl-radius-lg14px3 weitere Komponenten
--tpl-radius-md8px17 weitere Komponenten
--tpl-radius-sm4px10 weitere Komponenten
--tpl-rulevar(--lightgray) = #DDDDDD19 weitere Komponenten
--tpl-rule-controlcolor-mix(in srgb, var(--gray) 70%, var(-…11 weitere Komponenten
--tpl-rule-width1px25 weitere Komponenten
--tpl-shadow0 6px 24px rgba(23, 23, 26, 0.10) · dunkel 0 6px 24px rgba(0, 0, 0, 0.55)5 weitere Komponenten
--tpl-space-xs0.5rem20 weitere Komponenten
--tpl-surfacevar(--lightgray) = #DDDDDD6 weitere Komponenten
--tpl-surface-tintvar(--highlight) = rgba(42, 78, 108, 0.10)14 weitere Komponenten
--tpl-target44px12 weitere Komponenten
--tpl-text-sm0.875rem20 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.