Gérer les pages
Les pages forment un arbre. Comment les slugs découlent des parents, ce que contrôle un type de page, et le cycle brouillon-publication.
Les pages forment un arbre, pas une liste. Chacune a un parent, et ce seul fait décide de son URL, de son layout et de sa place dans la navigation.
Les slugs découlent de l'arbre
Vous ne saisissez pas un chemin complet. Vous donnez à une page un segment feuille, et le slug complet se compose à partir de ses ancêtres :
/docs feuille : docs
/docs/blocks feuille : blocks
/docs/blocks/fields feuille : fieldsDonc déplacer une page déplace son URL - et toutes les URL en dessous. Rattacher /docs/blocks à une autre section recalcule le slug de chaque enfant, petit-enfant et ainsi de suite, en une opération.
C'est exactement ce qu'on veut lors d'une restructuration, et exactement ce qui pique quand on ne s'y attendait pas. Avant de rattacher une branche, sachez ce qui pointe dessus : rien dans cmssy ne vous arrêtera, car l'opération est correcte - c'est le monde extérieur qui a les anciennes URL.
Le layout est hérité
Une page possède son en-tête et son pied, ou les hérite de son parent. Définissez-les une fois à la racine et tout l'arbre les a.
Ne redéfinissez que là où une section diffère vraiment. Chaque redéfinition est un endroit qui cesse de recevoir les futures modifications du layout partagé : un site plein de redéfinitions est un site où mettre à jour l'en-tête demande de visiter douze pages.
Types de pages
Un type de page est un modèle avec des règles. Les types existants dépendent de l'espace de travail ; une paire de départ courante ressemble à ceci :
- Page -
allowChildren: true. Le type polyvalent ; peut avoir des enfants, donc servir de section. - Post -
allowChildren: false. Une feuille. Les billets ne s'imbriquent pas, et le type l'impose au lieu de compter sur la discipline.
Deux autres propriétés comptent :
urlPrefix- préfixe un segment fixe à chaque page du type, si bien qu'un type peut vivre sous/blogsans que chaque page le porte.- Champs personnalisés - des valeurs structurées appartenant à la page plutôt qu'à un bloc : date de publication, référence d'auteur, temps de lecture. Les blocs affichent du contenu ; les champs personnalisés décrivent la page elle-même.
Brouillon et publication
Chaque modification atterrit dans un brouillon. L'API publique ne renvoie que du publié : une page inachevée reste invisible jusqu'à ce que vous en décidiez autrement.
- Publier - fait passer le brouillon en ligne, contenu et layout ensemble.
- Dépublier - retire la page du site public. Elle existe toujours et reste modifiable.
- Revenir au publié - jette le brouillon courant et restaure la version en ligne. C'est l'annulation pour « j'ai modifié la mauvaise page ».
Le retour arrière supprime définitivement le travail du brouillon. Si le brouillon contient quoi que ce soit d'utile, copiez-le avant : il n'y a pas de seconde copie derrière.
Ce qui casse en silence
Un parent dépublié ne masque pas ses enfants. L'état de publication est par page. Un enfant publié sous un parent dépublié reste accessible à son URL complète, et cette URL contient toujours le segment du parent. Si vous vouliez retirer une section, retirez tout le sous-arbre.
Étapes suivantes
- Éditeur de pages - modifier les blocs d'une page.
- Layouts - comment l'héritage s'affiche.
- Aperçu brouillon - montrer un brouillon avant publication.