La plantilla guarda la forma de la página; el Markdown guarda su contenido y dice a qué marco va cada trozo.

Una página compuesta se maqueta a partir de una plantilla: marcos con nombre (una banda de título, un texto, una caja con su foto), grupos que se mueven juntos y una decoración, todo ello definido en la configuración, en pageTemplates. El Markdown de la página es un bloque con valla que nombra su plantilla y vierte el contenido en los marcos por su nombre. En el Markdown nunca se escribe una posición ni un tamaño, y en la configuración nunca se escribe texto del contenido, así que una traducción es la misma plantilla con otras palabras.

Esta página trata del Markdown. En esta versión el analizador ya lee las páginas compuestas y las comprobaciones de slots se ejecutan, de modo que el panel Revisión y postext check señalan una página que no casa con su plantilla. La maquetación de la plantilla sobre la página llega en la próxima versión; hasta entonces, el contenido de una página compuesta se compone en el texto corrido, en el orden del Markdown y en páginas propias, así que no se pierde nada de lo que se escribe en ella. Un documento sin páginas compuestas se maqueta exactamente igual que antes.

#La valla de página

::::page{template="tema-cajas" fondo="banda-retos"}
# La actividad económica y el dinero
 
Las personas utilizan :chip[recursos]{style="clave"} que se obtienen de la naturaleza…
::::

Una página compuesta se abre con una línea de cuatro dos puntos seguida de page y sus atributos, y se cierra con una línea que solo lleva el mismo número de dos puntos. Dentro, los contenedores de tres dos puntos (:::frame, :::callout, :::figure, :::columns, :::paper) se abren y se cierran como siempre, así que un ::: suelto cierra el más interior de ellos y nunca la página. Una página escrita con cinco dos puntos (:::::page) se cierra con cinco, y una línea de cuatro dos puntos dentro de ella pasa a ser texto normal.

Atributo	Efecto
`template="…"`	Obligatorio. El id de una entrada de `pageTemplates`.
`spread`	La página es una doble página que ocupa dos páginas enfrentadas; la plantilla también tiene que ser de doble página.
`id="…"`, `#id`	Un ancla: un `:ref` que apunta a ella imprime la página en la que cae la página compuesta.
cualquier otro	Un valor que la plantilla lee como `{attr.name}`, por ejemplo una imagen de fondo elegida página a página: `fondo="banda-retos"` con `resourceId: "{attr.fondo}"` en la decoración.

Una página compuesta empieza siempre una página nueva (o una doble página), y el texto que sigue a su valla de cierre empieza en la siguiente.

El :::page{split=…} de tres dos puntos es una página de cómic (véase Cómics) y conserva ese sentido. Un :::page de tres dos puntos que lleva template= se sigue leyendo como página de cómic, y el aviso pageFenceLength indica que una página compuesta necesita cuatro dos puntos.

Cuando falta una valla, el analizador se recupera sin perder texto:

una página que se queda abierta llega hasta el final del capítulo y se señala como contenedor sin cerrar en su línea de apertura;
una línea ::::page que aparece con una página abierta cierra antes ahí la página abierta (y se señala de la misma manera);
la valla de cierre cierra cualquier marco o caja que siga abierto dentro de la página, y señala cada uno;
una valla de cierre con otro número de dos puntos no es la de la página: se queda en el texto, a la vista.

#Marcos y slots

:::frame{slot="dinero" label="El dinero"}
Es el instrumento utilizado como medio de pago…
 
Hasta hace pocos años, lo más normal era pagar con dinero en **efectivo**…
:::

Un slot es el nombre que pide un trozo de contenido, y coincide con el nombre de un marco de la plantilla. :::frame{slot="…"} envía a ese marco todo lo que contiene. Su cuerpo es Markdown completo: párrafos, listas, encabezados, chips, inserciones ::resource, referencias :ref, notas al pie, :::columns y recuadros anidados. label y title ponen las palabras de la pestaña o del título del marco, como en un :::callout; el aspecto del marco sale del estilo de recuadro que le asigna la plantilla.

Un bloque suelto también puede nombrar su propio slot:

Bloque	Cómo se escribe
Un encabezado	`## Retos {slot="retos-titulo"}`
Una inserción de recurso	`::resource{id="dinero-pago" slot="dinero-fotos"}` (los dos atributos, en cualquier orden)
Un listado de código	```js {slot="codigo"}
Un recuadro o cualquier otro contenedor	`:::callout{type="nota" slot="aside"}`: el recuadro entero va al slot
Una figura	`:::figure{resource="mapa" slot="mapa"}` (véase más abajo)

Cómo se reparte el contenido:

Varios trozos con el mismo slot se juntan en el orden del Markdown.
El contenido sin slot va al marco de flujo de la plantilla (el que lleva flow).
Un encabezado sin slot va primero al marco que toma su nivel (takes: "h1"), si la plantilla tiene alguno, así que el título de un tema de un libro de texto es un simple # Título al principio de la página.
El contenido que nombra un slot que la plantilla no tiene va al marco de flujo y se señala (slotUnknown).

Un slot fuera de una página compuesta se lee y no cambia nada.

#Figuras con rótulos

:::figure{resource="mapa-europa" slot="mapa"}
::label[OCÉANO ATLÁNTICO]{at="atlantico" style="mar"}
::label[**Madrid**]{at="madrid"}
::label[Mar Negro]{at="62% 48%"}
:::

:::figure{resource="…"} coloca un recurso, con su pie y su número, como hace ::resource, y enumera los rótulos que van sobre la imagen: una línea ::label[TEXTO]{…} por rótulo, con líneas en blanco permitidas entre ellas.

at nombra un ancla del recurso (un punto que se define una sola vez sobre la imagen y que comparten todos los idiomas), o da un punto en porcentajes de la imagen, at="x% y%", para un rótulo sin ancla.
style nombra un estilo de rótulo y se impone al del ancla.
El texto entre corchetes es Markdown en línea: negrita, cursiva, chips.

Una figura funciona tanto en el texto corrido como en un marco. Los rótulos se leen y se guardan junto con su posición en el Markdown; dibujarlos sobre la imagen llega con la maquetación de plantillas, y hasta entonces la figura se compone igual que su recurso. Una línea dentro de una figura que no es un rótulo ni está en blanco termina una figura a la que le falta el ::: de cierre, y se señala como contenedor sin cerrar.

#Ejemplo

La página de un libro de texto escolar, con una banda de título, un texto con su lista y tres cajas de colores, cada una con su foto al lado:

::::page{template="tema-cajas" fondo="banda-retos"}
# La actividad económica y el dinero
 
## La actividad económica
 
Las personas utilizan :chip[recursos]{style="clave"} que se obtienen de la naturaleza…
 
- Las :chip[empresas.]{style="clave"} Ofrecen bienes y servicios a cambio de un beneficio.
- Las :chip[personas y familias.]{style="clave"} Adquieren lo que ofrecen las empresas…
 
:::frame{slot="dinero" label="El dinero"}
Es el instrumento utilizado como medio de pago, ya que su valor es conocido…
:::
 
::resource{id="dinero-pago" slot="dinero-fotos"}
 
:::frame{slot="gasto" label="El gasto"}
- **Fijo:** es el que se produce todos los meses…
- **Variable:** puede cambiar según las necesidades…
:::
 
::resource{id="gasto-compras" slot="gasto-fotos"}
 
:::frame{slot="ahorro" label="Préstamos y ahorro"}
Si necesitas o quieres comprar algo muy caro…
:::
 
::resource{id="ahorro-balanza" slot="ahorro-fotos"}
::::

El título va al marco que toma h1; el subtítulo, el párrafo y la lista, al marco de flujo; cada caja y cada foto, al marco de su slot. La edición en catalán son las mismas líneas con otras palabras: la plantilla, los slots y las fotos no cambian.

#Avisos

Las comprobaciones leen el Markdown y la configuración antes de maquetar nada, así que aparecen en el panel Revisión mientras escribes, en postext check y en los contentWarnings del documento, cada una con el rango de origen de lo que señala (véase Configuración › Avisos del documento).

Tipo	Causa	Solución
`templateUnknown`	La valla de la página nombra una plantilla que no está en `pageTemplates`, o no nombra ninguna. Sus slots no se comprueban.	Corrige el id o añade la plantilla a la configuración.
`slotUnknown`	Un `slot="…"` no nombra ningún marco de la plantilla de la página (cuentan los marcos heredados con `extends` y los de una página de `variants`). El contenido va al marco de flujo.	Corrige el nombre del slot o añade a la plantilla un marco con ese nombre.
`slotEmpty`	Un marco de la plantilla no recibe nada en esta página: ningún slot lo nombra, no toma ningún encabezado y, si es el marco de flujo, no queda contenido sin slot. No se señala un marco que solo recibe lo que otro marco continúa en él (`next`). `postext check` lo lista como nota.	Escribe contenido para ese marco con su slot, o márcalo como `optional: true` en la plantilla.
`pageFenceLength`	Un `:::page` de tres dos puntos lleva `template=`. Se lee como página de cómic, igual que antes.	Abre la página con cuatro dos puntos, `::::page{template="…"}`, y ciérrala con `::::`.
`unclosedContainer`	Una página compuesta, un marco o una figura no se cierra nunca (véanse las reglas de recuperación de más arriba). El panel Revisión llama `::::page` a la página compuesta.	Añade la valla de cierre: tantos dos puntos como la línea de apertura de la página, o `:::` para un marco o una figura.

#Desde el código

composedPages(blocks) lee los bloques analizados de un capítulo (parseMarkdownWithIssues(markdown).blocks) y devuelve un nodo por cada valla de página, en orden: su template, spread, attrs con el rango de origen de cada valor (attrSources), su fenceIndex (el ordinal de la valla en el capítulo, el mismo en todos los idiomas), slots (los índices de los bloques de cada slot, en el orden del Markdown), unassigned (los bloques sin slot) y el rango de origen de la página entera. Un bloque lleva el slot que nombra en ContentBlock.slot, con el rango de origen del valor; una figura es un resourceBlock cuyo figure guarda sus atributos y sus rótulos, cada rótulo con su texto, sus tramos en línea y un mapa de origen que remite al Markdown. checkComposedSlots(pages, config) devuelve los tres avisos de slot de esas páginas.

Páginas compuestas

En pocas palabras