Zarządzanie stronami
Strony tworzą drzewo. Jak slugi wynikają z rodziców, co kontroluje typ strony i jak działa cykl draft-publikacja.
Strony to drzewo, nie lista. Każda ma rodzica, a ten jeden fakt decyduje o jej URL-u, layoucie i miejscu w nawigacji.
Slugi wynikają z drzewa
Nie wpisujesz pełnej ścieżki. Podajesz stronie segment liścia, a pełny slug składa się z przodków:
/docs liść: docs
/docs/blocks liść: blocks
/docs/blocks/fields liść: fieldsTo znaczy, że przeniesienie strony przenosi jej URL - i każdy URL pod nią. Przepięcie /docs/blocks pod inną sekcję przelicza slug każdego dziecka, wnuka i tak dalej, w jednej operacji.
To dokładnie to, czego chcesz przy restrukturyzacji, i dokładnie to, co gryzie, gdy się tego nie spodziewałeś. Przed przepięciem gałęzi sprawdź, co do niej linkuje: nic w cmssy Cię nie zatrzyma, bo operacja jest poprawna - to świat na zewnątrz ma stare URL-e.
Layout jest dziedziczony
Strona albo posiada własny header i footer, albo dziedziczy je po rodzicu. Ustaw je raz w korzeniu, a ma je całe drzewo.
Nadpisuj tylko tam, gdzie sekcja naprawdę się różni. Każde nadpisanie to miejsce, które przestaje dostawać przyszłe zmiany współdzielonego layoutu - więc serwis z nadpisaniami wszędzie to serwis, w którym aktualizacja headera oznacza odwiedzenie dwunastu stron.
Typy stron
Typ strony to szablon z regułami. To, jakie typy istnieją, zależy od workspace'u; typowa para na start wygląda tak:
- Page -
allowChildren: true. Typ ogólnego przeznaczenia; może mieć dzieci, więc może działać jako sekcja. - Post -
allowChildren: false. Liść. Wpisy blogowe się nie zagnieżdżają, a typ to egzekwuje, zamiast liczyć na dyscyplinę.
Dwie kolejne właściwości mają znaczenie:
urlPrefix- doklej a stały segment do każdej strony tego typu, więc typ może żyć pod/blogbez noszenia tego przez każdą stronę z osobna.- Pola własne - wartości strukturalne należące do strony, a nie do żadnego bloku: data publikacji, referencja do autora, czas czytania. Bloki renderują treść; pola własne opisują samą stronę.
Draft i publikacja
Każda zmiana ląduje w draftcie. Publiczne API zwraca wyłącznie treść opublikowaną, więc niedokończona strona jest niewidoczna, dopóki nie powiesz inaczej.
- Publish - promuje draft na żywo, treść i layout razem.
- Unpublish - zdejmuje stronę z publicznego serwisu. Dalej istnieje i dalej jest edytowalna.
- Revert to published - wyrzuca bieżący draft i przywraca go do wersji żywej. To jest cofnij dla "edytowałem nie tę stronę".
Revert kasuje pracę w draftcie bezpowrotnie. Jeśli draft trzyma cokolwiek, czego możeś chcieć, skopiuj to najpierw - za nim nie ma drugiej kopii.
Co psuje się po cichu
Nieopublikowany rodzic nie ukrywa swoich dzieci. Stan publikacji jest per strona. Opublikowane dziecko pod nieopublikowanym rodzicem pozostaje osiągalne pod swoim pełnym URL-em, a URL dalej zawiera segment rodzica. Jeśli chciałeś zdjąć sekcję z sieci, zdejmij całe poddrzewo.
Następne kroki
- Edytor stron - edycja bloków wewnątrz strony.
- Layouty - jak renderuje się dziedziczenie.
- Podgląd roboczy - pokazanie draftu przed publikacją.