Deutsch
Über dieses Handbuch

Dieses Handbuch gehört zu QuartzControl in der Fassung 1.1.0 und erklärt jeden seiner Bildschirme; jeder Bildschirm verweist auf seine Seite hier.

Wie man Notizen schreibt, damit daraus gute Seiten werden, steht im Example-Handbuch.

3.2 – Titel, Adresse und Verhalten

Der Tab Website unter Konfiguration ist die Grundeinstellung der Seite. Die Felder landen in quartz.config.yaml und werden erst mit Speichern wirksam; Content-Ordner und Projektbild darüber wirken sofort.

Farben stehen nicht mehr hier

Farben und Schriften sind zu den Stilen umgezogen. Dort bilden sie die Basis-Ebene, auf der Themes, Variablen und eigenes CSS aufbauen — was sich nur dort erklären lässt, wo alle vier nebeneinanderliegen.

Ganz oben auf dem Tab steht der Content-Ordner, also woher die Website ihre Notizen bekommt (3.4). Darunter folgt das Projektbild — für QuartzControl, das Favicon und auf Wunsch den Kopfbereich der Website. Es hat eine eigene Seite: 3.3.

Konfiguration → Website.

Titel

Die Seiteneinstellungen: Titel, Basis-URL, Sprache und die zwei Schalter für das Verhalten.

Seitentitel — der Name der Website. Er steht im Browser-Tab, im RSS-Feed und meist oben in der Seitenleiste.

Titel-Zusatz — wird im Browser-Tab hinter den Titel der einzelnen Seite gehängt, etwa Meine Notiz · Mein Wiki. Auf der Seite selbst erscheint er nicht.

Basis-URL

Die Adresse, unter der die Website erreichbar sein wird — ohne https://, also notizen.example.com. Quartz baut daraus die Links, den RSS-Feed und die Vorschaubilder.

Sie ist wichtiger, als sie aussieht: Ohne sie schlägt der Build fehl, sobald Schriften selbst ausgeliefert werden — dann müssen nämlich die Schrift-URLs auf sie umgeschrieben werden. Solange sie unbekannt ist, bleibt localhost stehen; die Übersicht meldet das dann unter Handlungsbedarf.

Sprache der Website

Bestimmt die festen Textbausteine — „Suche“, „Zuletzt geändert“, „Graph-Ansicht“. Zur Auswahl stehen die Sprachdateien, die dieses Projekt mitbringt; ein Eintrag, der nicht dabei ist, wird als solcher gekennzeichnet.

Gemeint ist die Sprache der Website, nicht die von QuartzControl. Die steht in den Einstellungen.

Wer einzelne dieser Textbausteine anders formulieren will, tut das im Tab Übersetzungen.

Zwei Schalter für das Verhalten

Seitenwechsel ohne Neuladen — beim Klick auf einen internen Link wird nur der Inhalt ausgetauscht statt die ganze Seite neu geladen. Das fühlt sich schneller an; ohne JavaScript funktioniert die Website trotzdem.

Vorschau beim Zeigen auf einen Link — beim Überfahren eines internen Links erscheint ein kleines Fenster mit dem Anfang der Zielseite.

Notizen ausschließen

Ein Muster pro Zeile. Was passt, kommt gar nicht erst in die Website — privat/** etwa oder *.excalidraw.md.

Das betrifft nur den Build. Was bereits auf dem Server liegt, verschwindet dadurch nicht; wer etwas vom Veröffentlichen ausnehmen will, tut das am Ziel (siehe 6.7).

Statistik

Bindet das Zählskript eines Anbieters in jede Seite ein. Ohne Anbieter wird nichts geladen und nichts gemessen — das ist die Voreinstellung.

Je nach Anbieter kommen ein bis zwei Felder dazu (Mess-ID, Website-ID, bei selbst gehosteten Instanzen die eigene Adresse). Fehlt eines davon, sagt die Karte welches: Ein halb ausgefülltes Skript sendet nichts, sieht aber nach Betrieb aus.