QuartzControl ist die Oberfläche für Quartz. Ohne sie bedient man Quartz über die Kommandozeile und bearbeitet seine Konfigurationsdatei im Texteditor; mit ihr klickt man.
Was sie einem abnimmt
Ein Quartz-Projekt besteht aus einer Konfigurationsdatei, einem Ordner voller Notizen, einer Handvoll Stylesheets und einer Liste installierter Plugins. Alles davon ist eine Textdatei, und alles davon lässt sich von Hand bearbeiten. QuartzControl gibt jedem dieser Dinge einen Bildschirm:
- Ein neues Projekt anlegen, ohne git und npm selbst zu bedienen.
- Die Konfiguration bearbeiten, ohne YAML zu schreiben — mit einem Hinweis unter jedem Feld, das erklärungsbedürftig ist.
- Den Content-Ordner verknüpfen, auch direkt mit einem Obsidian-Vault — und zwischen „echter Ordner“ und „Verknüpfung“ wechseln, ohne dabei Notizen zu verlieren.
- Plugins installieren und einstellen, aus einem durchsuchbaren Marktplatz statt aus einer Liste in der Dokumentation.
- Farben, Schriften und Abstände ändern, in vier Ebenen, die in der Reihenfolge nebeneinander liegen, in der sie sich gegenseitig überschreiben.
- Das Seitenraster bauen, in einem Editor mit der Maus statt in CSS.
- Die Vorschau starten und die Website bauen, mit der Ausgabe im selben Fenster.
- Veröffentlichen, auf sechs Wegen, mit einer Vorschau dessen, was übertragen wird.
- Zurückkommen, wenn etwas schiefgegangen ist — QuartzControl legt vor jeder größeren Änderung von selbst einen Snapshot an.
Was sie nicht tut
Sie ist kein Editor. Notizen werden woanders geschrieben — in Obsidian, in einem Texteditor, irgendwo. QuartzControl fasst den Inhalt des Content-Ordners nicht an; es baut daraus eine Website.
Sie ersetzt Quartz nicht. Was auf der fertigen Seite erscheint, entscheidet Quartz und entscheiden dessen Plugins. Wo dieses Handbuch bei „das macht Quartz so“ aufhört, geht die Quartz-Dokumentation weiter.
Sie versteckt die Dateien nicht. Jede Änderung landet in genau der Datei, in der sie auch gelandet wäre, wenn man sie von Hand gemacht hätte. Ein Projekt, das mit QuartzControl eingerichtet wurde, lässt sich jederzeit wieder von Hand weiterführen — und umgekehrt.
Für wen
Für jemanden, der Notizen schreibt und daraus eine Website machen will. Vorkenntnisse in Quartz sind nicht nötig; Vorkenntnisse in git auch nicht, obwohl git an drei Stellen vorkommt (siehe 1.2 – Die Werkzeuge).
Wer Quartz schon benutzt, findet hier vor allem eins: dieselben Dateien, aber mit einer Vorschau neben jedem Schalter — und einen Weg zurück, wenn ein Update etwas kaputt macht.