Seiten verwalten
Seiten bilden einen Baum. Wie Slugs aus den Eltern entstehen, was ein Seitentyp steuert und wie der Entwurf-Veröffentlichen-Zyklus läuft.
Seiten sind ein Baum, keine Liste. Jede hat einen Elternknoten, und diese eine Tatsache bestimmt ihre URL, ihr Layout und ihren Platz in der Navigation.
Slugs entstehen aus dem Baum
Du tippst keinen vollen Pfad. Du gibst einer Seite ein Blattsegment, der volle Slug wird aus den Vorfahren zusammengesetzt:
/docs Blatt: docs
/docs/blocks Blatt: blocks
/docs/blocks/fields Blatt: fieldsDas heißt: Eine Seite zu verschieben verschiebt ihre URL - und jede URL darunter. /docs/blocks unter einen anderen Bereich zu hängen berechnet den Slug jedes Kindes, Enkels und so weiter neu, in einem Vorgang.
Beim Umbau ist das genau richtig, und unerwartet ist es genau das, was wehtut. Bevor du einen Ast umhängst, wisse, was darauf verlinkt: Nichts in cmssy hält dich auf, denn der Vorgang ist korrekt - die alten URLs hat die Außenwelt.
Layout wird vererbt
Eine Seite besitzt Header und Footer selbst oder erbt sie vom Elternknoten. Einmal an der Wurzel gesetzt, hat sie der ganze Baum.
Überschreibe nur, wo ein Bereich wirklich abweicht. Jede Überschreibung ist eine Stelle, die künftige Änderungen am geteilten Layout nicht mehr bekommt - eine Site voller Überschreibungen ist eine, in der ein Header-Update zwölf Seitenbesuche bedeutet.
Seitentypen
Ein Seitentyp ist eine Vorlage mit Regeln. Welche Typen existieren, ist pro Workspace verschieden; ein häufiges Startpaar sieht so aus:
- Page -
allowChildren: true. Der Allzwecktyp; kann Kinder haben und damit als Bereich dienen. - Post -
allowChildren: false. Ein Blatt. Blogeinträge verschachteln nicht, und der Typ erzwingt das, statt auf Disziplin zu setzen.
Zwei weitere Eigenschaften zählen:
urlPrefix- stellt jedem Seitentyp ein festes Segment voran, sodass ein Typ unter/blogleben kann, ohne dass jede Seite es einzeln trägt.- Custom Fields - strukturierte Werte, die zur Seite gehören statt zu einem Block: ein Publikationsdatum, eine Autorenreferenz, eine Lesedauer. Blöcke rendern Inhalt; Custom Fields beschreiben die Seite selbst.
Entwurf und Veröffentlichung
Jede Bearbeitung landet in einem Entwurf. Die öffentliche API liefert nur Veröffentlichtes, eine unfertige Seite bleibt also unsichtbar, bis du etwas anderes sagst.
- Veröffentlichen - hebt den Entwurf live, Inhalt und Layout zusammen.
- Depublizieren - nimmt die Seite von der öffentlichen Site. Sie existiert weiter und bleibt bearbeitbar.
- Auf Veröffentlichtes zurücksetzen - verwirft den aktuellen Entwurf und stellt die Live-Version wieder her. Das ist das Rückgängig für „ich habe die falsche Seite bearbeitet“.
Das Zurücksetzen verwirft Entwurfsarbeit endgültig. Hält der Entwurf etwas, das du behalten willst, kopiere es vorher heraus - dahinter liegt keine zweite Kopie.
Was lautlos bricht
Ein depublizierter Elternknoten versteckt seine Kinder nicht. Der Veröffentlichungsstatus gilt pro Seite. Ein veröffentlichtes Kind unter einem depublizierten Elternknoten bleibt unter seiner vollen URL erreichbar, und die URL enthält weiterhin das Elternsegment. Wolltest du einen Bereich offline nehmen, nimm den ganzen Teilbaum offline.
Nächste Schritte
- Seiten-Editor - die Blöcke einer Seite bearbeiten.
- Layouts - wie die Vererbung rendert.
- Entwurfsvorschau - einen Entwurf vor der Veröffentlichung zeigen.