Theme-Dateien schreiben: Revisionen und Grenzen

Jede Speicherung erzeugt eine vollständige Theme-Revision im Revisionsspeicher. Der Entwurf und die veröffentlichte Fassung haben getrennte Zeiger. Beim manuellen Speichern eines Live-Themes werden beide auf die neue Revision gesetzt; bei einem inaktiven Theme wird nur der Entwurf aktualisiert. Die mitgelieferte Vorlage auf der Platte ist nur Ausgangsmaterial für ein Theme ohne gespeicherte Revision. Ein gelöschtes Theme-File lebt nicht aus der Vorlage wieder auf.

Wenn Änderungen in der Vorschau fehlen, prüfen Sie zuerst, ob der Code-Editor die neue Revision gespeichert hat und ob Sie die Entwurfs- statt der öffentlichen Ansicht betrachten. Bei gleichzeitigem Speichern meldet die API einen Konflikt; laden Sie den neuen Stand und übernehmen Sie Ihre Änderung erneut.

Beim Speichern gelten harte Grenzen: Ein Pfad darf höchstens 300 Zeichen lang sein, keine `..` enthalten, nicht mit `/` beginnen und keinen Backslash tragen. Eine Datei darf höchstens 2 MB gross sein, und ein Speichervorgang umfasst höchstens 100 Dateien. Ein hochgeladenes Theme-Archiv darf 50 MB nicht überschreiten.

Der Revisionsspeicher nimmt UTF-8-Textdateien auf. Binärdateien gehören in die Mediathek; im Theme steht ihre URL. Der direkte ZIP-Import lehnt Binärdateien ausdrücklich ab.

Manuelle Änderungen an einem Live-Theme werden beim Speichern sofort veröffentlicht. Arbeiten Sie in einer Theme-Kopie, wenn Sie den neuen Stand zuerst prüfen möchten. Cloutschi arbeitet automatisch in einer Theme-Kopie. Aus dem Verlauf wiederhergestellte Stände bleiben zunächst Entwürfe. Eine optionale GitHub-Verbindung synchronisiert einen ausgewählten Branch zusätzlich, ersetzt aber nicht den internen Revisionsspeicher.