O modelo guarda a forma da página; o Markdown guarda o conteúdo e diz para qual bloco vai cada trecho.

Uma página composta é diagramada a partir de um modelo: blocos com nome (uma faixa de título, um texto, uma caixa com a sua foto), grupos que se movem juntos e uma decoração, tudo definido na configuração, em pageTemplates. O Markdown da página é um contêiner cercado que nomeia o seu modelo e distribui o conteúdo pelos blocos, pelo nome de cada um. Nenhuma posição ou tamanho é escrito no Markdown, e nenhum texto do conteúdo é escrito na configuração, então uma tradução é o mesmo modelo com outras palavras.

Esta página trata do Markdown. Nesta versão o analisador já lê as páginas compostas e as verificações de slots rodam, de modo que o painel Verificações e o postext check apontam uma página que não bate com o seu modelo. A diagramação do modelo na página chega na próxima versão; até lá, o conteúdo de uma página composta é composto no texto corrido, na ordem do Markdown e em páginas próprias, então nada do que se escreve nela se perde. Um documento sem páginas compostas é diagramado exatamente como antes.

#A cerca 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…
::::

Uma página composta abre com uma linha de quatro dois-pontos seguida de page e dos seus atributos, e fecha com uma linha que só tem o mesmo número de dois-pontos. Dentro dela, os contêineres de três dois-pontos (:::frame, :::callout, :::figure, :::columns, :::paper) abrem e fecham como sempre, então um ::: sozinho fecha o mais interno deles e nunca a página. Uma página escrita com cinco dois-pontos (:::::page) fecha com cinco, e uma linha de quatro dois-pontos dentro dela passa a ser texto comum.

Atributo	Efeito
`template="…"`	Obrigatório. O id de uma entrada de `pageTemplates`.
`spread`	A página é uma página dupla, que ocupa duas páginas frente a frente; o modelo também precisa ser de página dupla.
`id="…"`, `#id`	Uma âncora: um `:ref` que aponta para ela imprime a página em que a página composta cai.
qualquer outro	Um valor que o modelo lê como `{attr.name}`, por exemplo uma imagem de fundo escolhida página a página: `fondo="banda-retos"` com `resourceId: "{attr.fondo}"` na decoração.

Uma página composta sempre começa uma página nova (ou uma página dupla), e o texto depois da sua cerca de fechamento começa na seguinte.

O :::page{split=…} de três dois-pontos é uma página de quadrinhos (veja Quadrinhos) e mantém esse sentido. Um :::page de três dois-pontos que traz template= continua sendo lido como página de quadrinhos, e o aviso pageFenceLength diz que uma página composta precisa de quatro dois-pontos.

Quando falta uma cerca, o analisador se recupera sem perder texto:

uma página que fica aberta vai até o fim do capítulo e é assinalada como contêiner não fechado na sua linha de abertura;
uma linha ::::page encontrada com uma página aberta fecha antes, ali mesmo, a página aberta (e é assinalada do mesmo jeito);
a cerca de fechamento fecha qualquer bloco ou boxe que ainda esteja aberto dentro da página, e assinala cada um;
uma cerca de fechamento com outro número de dois-pontos não é a da página: ela fica no texto, à vista.

#Blocos e 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**…
:::

Um slot é o nome que um trecho de conteúdo pede, e corresponde ao nome de um bloco do modelo. :::frame{slot="…"} manda para esse bloco tudo o que está dentro dele. O seu corpo é Markdown completo: parágrafos, listas, títulos, chips, inserções ::resource, referências :ref, notas de rodapé, :::columns e boxes aninhados. label e title dão as palavras da aba ou do título do bloco, como num :::callout; a aparência do bloco vem do estilo de boxe que o modelo atribui a ele.

Um elemento avulso também pode nomear o seu próprio slot:

Elemento	Como se escreve
Um título	`## Retos {slot="retos-titulo"}`
Uma inserção de recurso	`::resource{id="dinero-pago" slot="dinero-fotos"}` (os dois atributos, em qualquer ordem)
Uma listagem de código	```js {slot="codigo"}
Um boxe ou qualquer outro contêiner	`:::callout{type="nota" slot="aside"}`: o boxe inteiro vai para o slot
Uma figura	`:::figure{resource="mapa" slot="mapa"}` (veja abaixo)

Como o conteúdo é distribuído:

Vários trechos com o mesmo slot são juntados na ordem do Markdown.
O conteúdo sem slot vai para o bloco de fluxo do modelo (o que está marcado com flow).
Um título sem slot vai primeiro para o bloco que recebe o seu nível (takes: "h1"), se o modelo tiver um, então o título de um tema de livro didático é só um # Título no alto da página.
O conteúdo que nomeia um slot que o modelo não tem vai para o bloco de fluxo e é assinalado (slotUnknown).

Um slot fora de uma página composta é lido e não muda nada.

#Figuras com 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 um recurso, com a sua legenda e o seu número, como faz ::resource, e lista os rótulos que vão sobre a imagem: uma linha ::label[TEXTO]{…} por rótulo, com linhas em branco permitidas entre elas.

at nomeia uma âncora do recurso (um ponto definido uma única vez sobre a imagem e compartilhado por todos os idiomas), ou dá um ponto em porcentagens da imagem, at="x% y%", para um rótulo sem âncora.
style nomeia um estilo de rótulo e passa por cima do estilo da âncora.
O texto entre colchetes é Markdown em linha: negrito, itálico, chips.

Uma figura funciona tanto no texto corrido quanto dentro de um bloco. Os rótulos são lidos e guardados junto com a sua posição no Markdown; desenhá-los sobre a imagem chega com a diagramação de modelos, e até lá a figura é composta como o seu recurso. Uma linha dentro de uma figura que não é um rótulo nem está em branco encerra uma figura que ficou sem o ::: de fechamento, e é assinalada como contêiner não fechado.

#Exemplo

A página de um livro didático, com uma faixa de título, um texto com a sua lista e três caixas coloridas, cada uma com a sua foto ao 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"}
::::

O título vai para o bloco que recebe h1; o subtítulo, o parágrafo e a lista, para o bloco de fluxo; cada caixa e cada foto, para o bloco do seu slot. A edição em catalão são as mesmas linhas com outras palavras: o modelo, os slots e as fotos não mudam.

#Avisos

As verificações leem o Markdown e a configuração antes de qualquer diagramação, então aparecem no painel Verificações enquanto você digita, no postext check e nos contentWarnings do documento, cada uma com o intervalo de origem daquilo que aponta (veja Configuração › Avisos no documento).

Tipo	Causa	Correção
`templateUnknown`	A cerca da página nomeia um modelo que não está em `pageTemplates`, ou não nomeia nenhum. Os slots da página não são verificados.	Corrija o id ou acrescente o modelo à configuração.
`slotUnknown`	Um `slot="…"` não nomeia nenhum bloco do modelo da página (contam os blocos herdados por `extends` e os de uma página de `variants`). O conteúdo vai para o bloco de fluxo.	Corrija o nome do slot ou acrescente ao modelo um bloco com esse nome.
`slotEmpty`	Um bloco do modelo não recebe nada nesta página: nenhum slot o nomeia, ele não recebe nenhum título e, se for o bloco de fluxo, não sobra conteúdo sem slot. Um bloco que só recebe o que outro bloco continua nele (`next`) não é assinalado. O `postext check` o lista como nota.	Escreva conteúdo para esse bloco com o slot dele, ou marque-o como `optional: true` no modelo.
`pageFenceLength`	Um `:::page` de três dois-pontos traz `template=`. Ele é lido como página de quadrinhos, como antes.	Abra a página com quatro dois-pontos, `::::page{template="…"}`, e feche com `::::`.
`unclosedContainer`	Uma página composta, um bloco ou uma figura fica sem fechamento (veja as regras de recuperação acima). O painel Verificações chama a página composta de `::::page`.	Acrescente a cerca de fechamento: tantos dois-pontos quanto a linha de abertura da página, ou `:::` para um bloco ou uma figura.

#No código

composedPages(blocks) lê os blocos analisados de um capítulo (parseMarkdownWithIssues(markdown).blocks) e devolve um nó por cerca de página, em ordem: o seu template, spread, attrs com o intervalo de origem de cada valor (attrSources), o seu fenceIndex (o ordinal da cerca no capítulo, o mesmo em todos os idiomas), slots (os índices dos blocos de cada slot, na ordem do Markdown), unassigned (os blocos sem slot) e o intervalo de origem da página inteira. Um bloco traz o slot que nomeia em ContentBlock.slot, com o intervalo de origem do valor; uma figura é um resourceBlock cujo figure guarda os seus atributos e rótulos, cada rótulo com o seu texto, os seus trechos em linha e um mapa de origem que leva de volta ao Markdown. checkComposedSlots(pages, config) devolve os três avisos de slot dessas páginas.

Páginas compostas

Em poucas palavras