Configuració: pàgines compostes

#Plantilles de pàgina

Una pàgina composta és una pàgina que pren la forma d'una plantilla de pàgina de la configuració i el contingut del Markdown d'un bloc ::::page{template="…"}. La plantilla dona nom a uns rectangles, anomenats marcs; el Markdown envia cada peça de contingut a un marc pel seu nom (el seu buit). La geometria mai no apareix al Markdown, i el text del contingut mai no apareix a la plantilla. La propietat pageTemplates conté les plantilles del llibre:

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'] },
      ],
    },
  ],
};

Una plantilla que només fixa el seu id i un marc és una pàgina sencera amb aquest marc ocupant l'àrea de text. Tots els altres camps són opcionals:

#Marcs

Un marc és un rectangle amb nom que rep contingut compost. El seu name és el buit que demana el Markdown, i és únic a la seva plantilla (un grup tampoc no pot portar el nom d'un marc, perquè els ancoratges anomenen tots dos de la mateixa manera).

Un marc es col·loca per la seva cel·la de grid quan la plantilla té retícula i, si no, pel seu placement, que funciona com el d'un element de disseny: un ancoratge ('container' és l'àrea, 'page', 'bleed', o '#name' per a un altre marc o grup), una vora, un desplaçament i una mida. Un marc ancorat a un altre es mou amb ell. Sense cap dels dos, el marc ocupa tota l'àrea.

#Grups

Un grup és una pila (de dalt a baix) o una filera (del principi al final) de marcs que es reparteixen l'espai i es mouen junts. Dins d'un grup s'ignora la posició pròpia dels marcs en la direcció del grup: el grup els col·loca en ordre, amb gap entre ells. Quan creix el text d'un marc, els marcs que van darrere es desplacen. Un grup és una caixa a la qual es poden ancorar marcs i decoració ('#pagina').

#Herència i variants

Una plantilla amb extends parteix de la plantilla que anomena (que al seu torn en pot estendre una altra) i canvia només el que escriu:

• Un camp com area, header o overflowTemplate substitueix el del pare. grid es combina clau a clau. spread, gutter i role també s'hereten; id, name i extends són propis de la plantilla.
• frames i groups es combinen per nom: una entrada amb el nom d'una d'heretada canvia els camps que escriu i conserva la resta (fit, overflow i padding es combinen clau a clau; placement se substitueix sencer); remove: true la treu; un nom nou s'afegeix darrere dels heretats.
• Els elements de decoració es combinen per id de la mateixa manera; un element amb un id nou, o sense id, s'afegeix.

variants.recto i variants.verso s'escriuen com una plantilla i es combinen igual, en una pàgina senar o en una parell. S'apliquen després de tota la cadena d'extends, primer la variant de l'arrel. Una doble pàgina té els dos costats, de manera que no se li aplica cap variant.

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 }] },
]

Quan el Sandbox desa una plantilla, mai no descarta un valor igual al valor per defecte: en una plantilla que n'estén una altra, o en una variant, aquest valor substitueix el del pare.

Des del codi, resolvePageTemplate(config, id, { parity }) retorna una plantilla amb la seva cadena combinada, la variant del costat aplicada, tots els valors per defecte omplerts i cada referència resolta com descriuen els avisos de més avall; validatePageTemplates(config) retorna els avisos.

#Estils de rètol

La propietat labelStyles dona nom als aspectes dels rètols que es posen sobre una imatge: els mars i les ciutats d'un mapa, les parts d'un esquema. Un rètol se situa en un ancoratge de la imatge (un punt desat amb el recurs, com els parlants d'un còmic) i pren l'estil que anomena l'ancoratge o el rètol.

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' } } },
]

#Camps de rètol d'un ancoratge

Els ancoratges d'una imatge (Resource.anchors, els punts que fan servir els còmics per als parlants) admeten uns quants camps opcionals per a rètols. Són fraccions de la imatge, de manera que valen en totes les llengües i amb qualsevol retall de la imatge. Els còmics els ignoren.

#Avisos de les plantilles de pàgina

A la resta de la configuració, el motor ignora una clau que no coneix. Les plantilles de pàgina i els estils de rètol, en canvi, es comproven, i cada problema és un avís de configuració a postext check i al tauler Revisió del Sandbox. El camp path d'aquests avisos és un punter JSON al camp que falla: /pageTemplates/3/frames/2/style, /pageTemplates/0/variants/recto/frames/1/next, /resources/4/anchors/0/style. Quan el camp és heretat, el punter anomena la plantilla que el va escriure. Un avís que anomena un id o un nom que no existeix proposa a més l'existent que s'hi assembla més.

Una clau mal escrita d'una plantilla, un marc, un grup, una retícula, fit, overflow, una variant o un estil de rètol és un unknownConfigKey; una paraula fora de les opcions d'un paràmetre (area, verticalAlign, exclude, takes, kind, align, writingMode, direction, fontStyle, textTransform) és un unknownConfigValue, i el paràmetre conserva el seu valor per defecte. Una plantilla sense id, o un marc o un grup sense name, s'ignora amb un unknownConfigValue en aquest camp.

La versió de la configuració és la 15 des de les plantilles de pàgina (els paquets escrits abans es continuen carregant sense canvis: res del que diu una configuració anterior no canvia de significat).