Der Content-Ordner ist der Ordner content/ im
Projekt. Aus dem, was darin liegt, entsteht die Website. Er ist entweder ein echter Ordner oder
eine Verknüpfung auf einen Ordner außerhalb. Er steht
ganz oben unter Konfiguration → Website.
Der Content-Ordner oben im Tab Website, hier als Verknüpfung auf einen Vault außerhalb des Projekts.
Die beiden Zustände
Dort steht, welcher gerade gilt — Echter Ordner oder Symbolischer Link, mit Pfad und Dateizahl.
Echter Ordner. Die Notizen liegen im Projekt. Sie gehören dazu, reisen mit ihm in ein Repository und werden von einem Snapshot mitgesichert, wenn man das einschaltet.
Verknüpfung. Die Notizen liegen woanders — typischerweise in einem Vault. Geschrieben wird dort, in Obsidian; Quartz liest durch die Verknüpfung hindurch. Das Projekt enthält dann keine einzige Notiz, nur den Verweis darauf.
Steht hinter dem Pfad „(Ziel existiert nicht)“, ist der Vault verschoben, umbenannt oder auf einem Laufwerk, das gerade nicht eingebunden ist. Die Verknüpfung selbst ist noch da; sie zeigt nur ins Leere.
Die Startseite
Quartz macht aus index.md oben im Content-Ordner die Seite unter der Adresse der Website. Fehlt
sie, zeigt die Vorschau dort eine 404-Seite — für jeden Unterordner erzeugt Quartz eine
Übersicht, nur für den obersten nicht. Ein verknüpfter Vault hat fast nie eine index.md, deshalb
ist das der häufigste Grund, warum die erste Vorschau „nicht öffentlich oder existiert nicht“ sagt.
QuartzControl sagt es an drei Stellen: in dieser Gruppe, auf der Übersicht
und auf Vorschau & Build. Startseite anlegen… fragt nach
einem Titel — ohne ihn hieße die Seite „index“ — und legt die Datei mit einer Liste der Ordner und
Notizen an, die gerade oben im Content-Ordner liegen. Die Liste wird danach nicht aktualisiert; sie
ist ein Anfang, den man selbst weiterschreibt. Eine vorhandene index.md wird nie überschrieben.
Bei einem verknüpften Vault landet die Datei im Vault, und das Fenster nennt den Ordner, bevor es
etwas schreibt.
Welche Ordner und Notizen in die Liste kommen, entscheiden Quartz’ eigene Ausschlussregeln — wie beim
Build. Ist im Projekt noch kein npm install gelaufen, fehlen die, und die Liste entsteht ohne sie.
Die Gruppe sagt das danach: Die Liste kann dann Ordner nennen, die die Website nicht hat.
Was die Verknüpfung für Snapshots bedeutet
Ein verknüpfter Vault wird nicht mitgesichert. Im Snapshot landet die Verknüpfung, keine einzige Notiz. QuartzControl sagt das auf der Seite Snapshots ausdrücklich, und es ist kein Mangel, sondern die richtige Aufteilung: Der Vault ist eine eigene Datenquelle mit eigener Sicherung — und ein Snapshot würde ihn ohnehin nie überschreiben.
Wer beides will, sichert den Vault selbst: mit einem eigenen Repository, mit Obsidian Sync oder womit auch immer.
Die Quelle ändern
Zwei Felder, und darüber der Satz, dass nichts gelöscht wird.
Quelle ändern… öffnet einen Dialog mit zwei Feldern: dem neuen Quellordner und der Strategie.
| Strategie | Was passiert |
|---|---|
| Verknüpfen | content/ wird ein Verweis auf den gewählten Ordner. Nichts wird kopiert. |
| Kopieren | Der Inhalt des gewählten Ordners wird einmal hineinkopiert; content/ wird ein echter Ordner. |
Über beiden steht der Satz, auf den es ankommt:
Der bisherige Content-Ordner wird vor der Änderung beiseitegelegt statt gelöscht. Unter Snapshots lässt er sich zurückholen.
Es geht also nichts verloren. Der alte Ordner wandert ins Projekt an eine Stelle, die die Seite Snapshots kennt, und lässt sich von dort zurückholen oder endgültig löschen (siehe 7.4).
Beim Kopieren zeigt QuartzControl den Fortschritt in Dateien — bei einem großen Vault dauert das seine Zeit.
Was dabei nicht geht
Der Quellordner darf nicht im Content-Ordner des Projekts liegen. Der wird beim Wechsel zuerst beiseitegelegt — die Quelle würde also mitwandern, während aus ihr kopiert wird. QuartzControl lehnt das ab und sagt es.
Nach dem Wechsel
Zwei Dinge lohnen sich:
- Die Wikilink-Einstellung prüfen. Wie die Ziele geschrieben sind — kürzeste Form, absolut, relativ —, muss zu den neuen Notizen passen, sonst finden die Links nichts.
- Neu bauen, damit die Vorschau den neuen Inhalt zeigt.