Theme-Dateien schreiben: Ablage, Zweige und Grenzen

Wo die Dateien liegen, wie das Live-Theme davon getrennt bleibt und welche Grenzen beim Speichern gelten.

Für Entwickler

Voraussetzungen

  • Recht: website:write
  • Plan mit Theme-Code-Editor

Ein Theme besteht aus zwei Schichten: der mitgelieferten Vorlage auf der Platte und Ihren Änderungen in einem Git-Zweig. Beim Rendern wird die Vorlage geladen und Ihre Änderungen darübergelegt. Der Zweig wird beim ersten Schreibzugriff angelegt; das Live-Theme arbeitet auf `main`, jedes andere auf einem eigenen Zweig.

Kann der Zweig nicht gelesen werden, wird still die Vorlage von der Platte ausgeliefert. Die Seite bleibt also stehen — Ihre Änderungen sind dann aber unsichtbar. Wenn gespeicherte Änderungen nicht erscheinen, ist das die erste Stelle zum Nachsehen.

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.

Übergelegt werden nur Textdateien. Binärdateien im Zweig werden nicht übernommen — noch ein Grund, Bilder über die Mediathek einzubinden statt sie ins Theme zu legen.

Arbeiten Sie nie am Live-Theme, wenn Sie gefahrlos ausprobieren wollen: Gespeichert heisst hier veröffentlicht. Duplizieren Sie das Theme vorher.

Schritt für Schritt

  1. Code-Editor öffnen

    Seitenleiste „Website" → „Themes", im Menü der Theme-Karte auf „Code bearbeiten". Die Kopfzeile nennt den Zweig und den Pfad der offenen Datei.

  2. Speichern

    Oben auf „Speichern" oder mit Strg+S beziehungsweise Cmd+S. Der Vermerk „ungespeichert" muss danach verschwinden.

  3. Ergebnis ansehen

    Über „Vorschau" die gerenderte Seite öffnen.

Wo im Dashboard

/restaurant/[slug]/website/themes/[id]/code

Im Dashboard öffnen

Meldungen, die hierher gehören

Siehe auch

← Zurück zu Theme-Entwicklung