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.

7.4 – Bekannte Grenzen

Alles hier ist an der gebauten Website gemessen, nicht vermutet. Die meisten Punkte sind Grenzen von Quartz oder eines Plugins, die eine Vorlage nicht beheben, nur umgehen kann; ein paar sind Grenzen von QuartzControl, und die sind gemeldet. Die verlinkte Seite hat jeweils die Einzelheiten.

Beim Schreiben

GrenzeWas stattdessenWo
Inline-Fußnoten ^[…] bleiben Rohtextdie Fußnote mit [^1] schreibenVarianten
Pfeile wie --> werden nicht zu →das Zeichen → direkt schreibenPfeile und Emoji
Ein Tag im Fließtext hat einen kaputten Link — ein Fehler in QuartzTags ins FrontmatterPfeile und Emoji
Ein Bild hat entweder eine Größe oder einen Alternativtext, nicht beidesGröße über HTML setzen, wenn beides nötig istBilder
Ein eingebettetes PDF beginnt immer auf Seite 1den Seitenanker nur im Link nutzenDokumente
Eine eingebettete Seite bringt ihre Überschriften-Kennungen mit; heißt eine Überschrift wie eine der einbettenden Seite, springt der Verweis im Inhaltsverzeichnis auf die falsche und die Fortschrittslinie bekommt ein Locheine der beiden Überschriften umbenennenEinbettungen
Definitionslisten gibt es nichteine HTML-Liste <dl>HTML
Mermaid ignoriert fast alle Farben der Vorlage; jede eigene Regel braucht !importantdas mitgelieferte Stylesheet, das genau das tut6.1 – Etwas ändern

Bases, Canvas, Zeichnungen

GrenzeWas stattdessenWo
Bases sprechen Englisch: „Showing 45 of 45 entries“ und englische Spaltenköpfe kommen aus dem Plugin und lassen sich nicht übersetzendie Zeile ist leise gesetzt statt entfernt3.1 – Bases
Eine Base kann nicht nach einer Formel gruppierennach einem Frontmatter-Feld gruppierenWie eine Base aufgebaut ist
Links in einem Canvas-Dateiknoten bekommen den Ordner noch einmal vorangestellt und führen je nach Tiefe der Notiz ins Leere — ein Fehler im PluginKnoten aus zweiter oder dritter Ebene wählen; sonst den Knotentitel anklicken3.2 – Canvas
Eine .base- oder .canvas-Datei hat kein Frontmatter und kann keine Übersetzung verknüpfender Umschalter bietet die Startseite der anderen SpracheWo die zwei Sprachen aufhören
Eine Excalidraw-Seite hat weder Seitenleisten noch Sprachumschalter—3.3 – Excalidraw
GrenzeWas stattdessenWo
Der Explorer startet zugeklappt; die Option folderDefaultState: open wird vom Plugin nicht gelesenoffen sind die Ordner auf dem Weg zur aktuellen SeiteExplorer
Der Explorer sortiert nach Titel, nicht nach Dateiname, und die Sortierung ist aus der Konfiguration nicht änderbarNummern im TitelExplorer
Der Explorer lässt sich nicht aus der Konfiguration nach Sprache filternein Stylesheet blendet den fremdsprachigen Ast ausWo die zwei Sprachen aufhören
Die Oberfläche — Explorer, Suche, Rückverweise, Graph — spricht site-weit eine Sprache; Suche, Graph und „Zuletzt geändert“ mischen beide Sprachen; es gibt eine Fehlerseite für beidedie Layout-Boxen sprechen beide Sprachen; ein Build je Sprache würde den Rest lösenWo die zwei Sprachen aufhören
Auf einer Ordnerseite zeigt der Graph nur einen Punkt, auch wenn die Seite verlinkt ist — ein Fehler im Plugindie Rückverweise darunter zeigen dieselben VerbindungenGraph
Quartz rendert keinen Skip-Link; per Tastatur kostet der Weg zum Text einen Tabstopp je Baumzeiledie Gestaltung dafür liegt bereit6.6 – Barrierefreiheit
Das Datum einer Seite kommt nicht aus git, weil content/ ein Symlink ist — ein Fehler im PluginDatum im Frontmatter4.1 – Titel, Beschreibung, Datum

In QuartzControl

GrenzeWas stattdessenWo
Der Baustein Übersetzungen erreicht die Überschriften der Komponenten nicht—6.8 – Das Vorlagenpaket
Snapshots enthalten den Inhalt nicht, wenn content/ ein Symlink istder Vault sichert sich über sein eigenes git1.3 – Von der Notiz zur Website
QuartzControl schreibt @font-face-Regeln ohne unicode-rangedie Vorlage ersetzt den erzeugten Block6.3 – Schriften
Im Frame-Editor darf ein Wert kein Komma enthalten, und Längen stehen als Zahl, nicht als Variablecalc() ohne Komma; Zahlen6.5 – Seitenraster
Drei Blöcke in custom.scss schreibt QuartzControl bei jedem Speichern neueigene Regeln außerhalb der Markierungen oder in eine eigene Datei6.1 – Etwas ändern

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.