Gestionar páginas

Las páginas son un árbol, no una lista. Cada una tiene un padre, y ese solo hecho decide su URL, su layout y su lugar en la navegación.

Los slugs salen del árbol

No escribes una ruta completa. Le das a la página un segmento hoja, y el slug completo se compone desde sus ancestros:

/docs                 hoja: docs
  /docs/blocks        hoja: blocks
    /docs/blocks/fields   hoja: fields

Es decir, mover una página mueve su URL y todas las URL bajo ella. Reubicar /docs/blocks bajo otra sección recalcula el slug de cada hijo, nieto y sucesivos, en una sola operación.

Eso es justo lo que quieres en una reestructuración y justo lo que muerde cuando no lo esperabas. Antes de reubicar una rama, sabe qué enlaza hacia ella: nada dentro de cmssy te detendrá, porque la operación es correcta; es el mundo exterior el que tiene las URL viejas.

El layout se hereda

Una página posee su cabecera y pie o los hereda del padre. Defínelos una vez en la raíz y los tiene todo el árbol.

Sobrescribe solo donde una sección difiera de verdad. Cada sobrescritura es un sitio que deja de recibir los cambios futuros del layout compartido: un sitio lleno de sobrescrituras es uno donde actualizar la cabecera significa visitar doce páginas.

Tipos de página

Un tipo de página es una plantilla con reglas. Qué tipos existen depende de cada workspace; un par inicial habitual es este:

• Page: allowChildren: true. El tipo general; puede tener hijos, así que puede actuar como sección.
• Post: allowChildren: false. Una hoja. Las entradas de blog no anidan, y el tipo lo impone en vez de confiar en la disciplina.

Otras dos propiedades importan:

• urlPrefix: antepone un segmento fijo a cada página de ese tipo, de modo que un tipo puede vivir bajo /blog sin que cada página lo lleve.
• Campos propios: valores estructurados que pertenecen a la página y no a un bloque: fecha de publicación, referencia de autor, tiempo de lectura. Los bloques renderizan contenido; los campos propios describen la página en sí.

Borrador y publicación

Cada edición aterriza en un borrador. La API pública solo devuelve lo publicado, así que una página sin terminar es invisible hasta que digas lo contrario.

• Publicar: sube el borrador a producción, contenido y layout juntos.
• Despublicar: retira la página del sitio público. Sigue existiendo y sigue siendo editable.
• Revertir a publicado: descarta el borrador actual y restaura la versión en vivo. Es el deshacer para "edité la página equivocada".

Revertir descarta el trabajo del borrador de forma permanente. Si el borrador guarda algo que puedas querer, cópialo antes: no hay una segunda copia detrás.

Qué se rompe en silencio

Un padre despublicado no oculta a sus hijos. El estado de publicación es por página. Un hijo publicado bajo un padre despublicado sigue siendo alcanzable en su URL completa, y esa URL sigue conteniendo el segmento del padre. Si querías sacar una sección de línea, saca el subárbol entero.

Siguientes pasos

• Editor de páginas: editar los bloques dentro de una página.
• Layouts: cómo se renderiza la herencia.
• Vista previa: mostrar un borrador antes de publicar.