Configuração: páginas compostas

#Modelos de página

Uma página composta é uma página que tira a forma de um modelo de página da configuração e o conteúdo do Markdown de um bloco ::::page{template="…"}. O modelo dá nome a retângulos, chamados quadros; o Markdown manda cada parte do conteúdo para um quadro pelo nome (o seu encaixe). A geometria nunca aparece no Markdown, e o texto do conteúdo nunca aparece no modelo. A propriedade pageTemplates guarda os modelos do livro:

const config: PostextConfig = {
  calloutStyles: [{ id: 'caja-azul' }, { id: 'tab-titulo' }],
  pageTemplates: [
    {
      id: 'tema-cajas',
      decoration: {
        elements: [
          { kind: 'image', id: 'fondo', resourceId: '{attr.fondo}', decorative: true,
            placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { width: 'fill', height: 'fill' } } },
        ],
      },
      frames: [
        { name: 'titulo', takes: 'h1', style: 'tab-titulo' },
        { name: 'texto', flow: true },
        { name: 'dinero', style: 'caja-azul', padding: { right: { value: 62, unit: 'mm' } } },
        { name: 'dinero-fotos', layer: 2, width: { value: 60, unit: 'mm' },
          placement: { anchor: { to: '#dinero', edge: 'top-right' } } },
      ],
      groups: [
        { name: 'pagina', kind: 'stack', gap: { value: 6, unit: 'mm' }, frames: ['titulo', 'texto', 'dinero'] },
      ],
    },
  ],
};

Um modelo que define só o seu id e um quadro é uma página inteira com esse quadro ocupando a área de texto. Todos os outros campos são opcionais:

#Quadros

Um quadro é um retângulo com nome que recebe conteúdo diagramado. O seu name é o encaixe que o Markdown pede, e é único no seu modelo (um grupo também não pode ter o nome de um quadro, já que as âncoras nomeiam os dois do mesmo jeito).

Um quadro é posicionado pela sua célula de grid quando o modelo tem grade e, senão, pelo seu placement, que funciona como o de um elemento de design: uma âncora ('container' é a área, 'page', 'bleed', ou '#name' para outro quadro ou grupo), uma borda, um deslocamento e um tamanho. Um quadro ancorado a outro se move com ele. Sem nenhum dos dois, o quadro ocupa a área inteira.

#Grupos

Um grupo é uma pilha (de cima para baixo) ou uma fileira (do início ao fim) de quadros que dividem o espaço e se movem juntos. Dentro de um grupo, a posição própria dos quadros na direção do grupo é ignorada: o grupo os arranja em ordem, com gap entre eles. Quando o texto de um quadro cresce, os quadros que vêm depois se deslocam. Um grupo é uma caixa à qual quadros e decoração podem se ancorar ('#pagina').

#Herança e variantes

Um modelo com extends parte do modelo que nomeia (que por sua vez pode estender outro) e muda só o que escreve:

• Um campo como area, header ou overflowTemplate substitui o do pai. grid é mesclado chave a chave. spread, gutter e role também são herdados; id, name e extends são do próprio modelo.
• frames e groups são mesclados pelo nome: uma entrada com o nome de uma herdada muda os campos que escreve e mantém o resto (fit, overflow e padding são mesclados chave a chave; placement é substituído inteiro); remove: true a remove; um nome novo é acrescentado depois dos herdados.
• Os elementos de decoração são mesclados por id do mesmo jeito; um elemento com um id novo, ou sem id, é acrescentado.

variants.recto e variants.verso são escritos como um modelo e mesclados do mesmo jeito, numa página ímpar ou numa par. Eles se aplicam depois de toda a cadeia de extends, primeiro a variante da raiz. Uma página dupla tem os dois lados, então nenhuma variante se aplica a ela.

pageTemplates: [
  { id: 'tema', frames: [{ name: 'texto', flow: true }, { name: 'margen', width: { value: 30, unit: 'mm' },
      placement: { anchor: { to: 'container', edge: 'top-left' } } }],
    variants: { recto: { frames: [{ name: 'margen', placement: { anchor: { to: 'container', edge: 'top-right' } } }] } } },
  { id: 'tema-sin-margen', extends: 'tema', frames: [{ name: 'margen', remove: true }] },
]

Quando o Sandbox salva um modelo, um valor igual ao padrão nunca é descartado: num modelo que estende outro, ou numa variante, esse valor substitui o do pai.

No código, resolvePageTemplate(config, id, { parity }) devolve um modelo com a cadeia mesclada, a variante do lado aplicada, todos os padrões preenchidos e cada referência resolvida como os avisos abaixo descrevem; validatePageTemplates(config) devolve os avisos.

#Estilos de rótulo

A propriedade labelStyles dá nome às aparências dos rótulos colocados sobre uma imagem: os mares e as cidades de um mapa, as partes de um esquema. Um rótulo fica numa âncora da imagem (um ponto guardado com o recurso, como os falantes de quadrinhos) e usa o estilo que a âncora ou o rótulo nomeia.

labelStyles: [
  { id: 'mar', fontStyle: 'italic', textTransform: 'uppercase', letterSpacing: 0.12,
    color: { hex: '#2b6ca3', model: 'hex' } },
  { id: 'ciudad', fontWeight: 600, halo: { color: { hex: '#ffffff', model: 'hex' }, width: { value: 0.6, unit: 'pt' } } },
]

#Campos de rótulo de uma âncora

As âncoras de uma imagem (Resource.anchors, os pontos que os quadrinhos usam para os falantes) aceitam alguns campos opcionais para rótulos. São frações da imagem, então valem em todos os idiomas e com qualquer recorte da imagem. Os quadrinhos os ignoram.

#Avisos dos modelos de página

No resto da configuração, o motor ignora uma chave que não conhece. Os modelos de página e os estilos de rótulo, por outro lado, são verificados, e cada problema é um aviso de configuração no postext check e no painel Verificações do Sandbox. O campo path desses avisos é um ponteiro JSON para o campo com problema: /pageTemplates/3/frames/2/style, /pageTemplates/0/variants/recto/frames/1/next, /resources/4/anchors/0/style. Quando o campo foi herdado, o ponteiro nomeia o modelo que o escreveu. Um aviso que nomeia um id ou um nome inexistente também sugere o existente mais parecido.

Uma chave digitada errado de um modelo, quadro, grupo, grade, fit, overflow, variante ou estilo de rótulo é um unknownConfigKey; uma palavra fora das opções de um ajuste (area, verticalAlign, exclude, takes, kind, align, writingMode, direction, fontStyle, textTransform) é um unknownConfigValue, e o ajuste mantém o seu padrão. Um modelo sem id, ou um quadro ou grupo sem name, é ignorado com um unknownConfigValue nesse campo.

A versão da configuração é a 15 desde os modelos de página (pacotes escritos antes continuam carregando sem mudanças: nada do que uma configuração anterior diz muda de sentido).