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.

7.1 – Snapshots

Ein Snapshot ist eine Kopie dieses Projekts, die nur QuartzControl kennt. Sie bleibt im Projekt, wird nie hochgeladen und rührt die eigene git-Geschichte nicht an.

Die Seite Snapshots mit der Liste der Snapshots.

Snapshot ist nicht Git-Sync

Der Unterschied steht ganz oben auf der Seite, weil er der häufigste Irrtum ist:

SnapshotGit-Sync
Wofürzum Zurückholenzum Teilen
Wohinbleibt auf diesem Rechnerauf GitHub, und damit auf andere Rechner
Brauchtnichts — geht auch, wenn das Projekt gar kein Repository istein Repository

Beides schließt sich nicht aus. Man kann und sollte beides benutzen.

Was ein Snapshot enthält

Der Content-Ordner ist ein eigener Schalter — hier gesperrt, weil er verknüpft ist.

Alles, was einem in diesem Projekt gehört: Konfiguration, die Sperrdatei der Plugins, die Frames, die eigenen Stylesheets, die Übersetzungen, die Veröffentlichungsziele.

Nicht enthalten: die Abhängigkeiten, der Build-Ordner und die installierten Plugin-Dateien — die entstehen beim nächsten Build ohnehin neu.

Der Content-Ordner ist ein eigener Schalter, und der hängt daran, wie er gebaut ist:

  • Echter Ordner: mitsicherbar, und QuartzControl empfiehlt es — Markdown ist klein genug, um immer mitzulaufen.
  • Verknüpft: nicht mitsicherbar. Im Snapshot landet die Verknüpfung, keine einzige Notiz. Der Vault ist eine eigene Datenquelle mit eigener Sicherung — und ein Snapshot würde ihn ohnehin nie überschreiben.

Wann von selbst einer entsteht

Vor jeder größeren Änderung, und die Liste steht auch in QuartzControl:

  • vor einem Kern-Update
  • vor einer Plugin-Änderung
  • vor einem Content-Wechsel
  • vor dem Import eines Vorlagenpakets
  • vor einer Wiederherstellung
  • vor einer Konfigurations-Änderung

Jeder Snapshot trägt seine Herkunft als Etikett — Von dir, Vor Kern-Update, Vor Plugin-Änderung und so weiter. Das macht die Liste lesbar, wenn zwanzig darin stehen.

Selbst angelegte bekommen auf Wunsch einen Namen: „vor dem Theme-Wechsel“ ist in drei Wochen mehr wert als ein Zeitstempel.

Vergleichen

Ein Snapshot gegen den heutigen Stand.

Vergleichen stellt einen Snapshot dem heutigen Stand gegenüber: wie viele Dateien sich unterscheiden, und zu jeder der Textunterschied. Drei Zustände je Datei — geändert, seitdem neu, seitdem gelöscht.

Bei einem verknüpften Vault sagt QuartzControl dazu, was der Vergleich nicht umfasst: alles außer dem Content-Ordner.

Exportieren

Als ZIP exportieren legt einen Snapshot als gewöhnliche Datei ab — für ein Archiv außerhalb des Projekts oder um ihn jemandem zu schicken.