Configurazione: pagine composte

#Modelli di pagina

Una pagina composta è una pagina la cui forma viene da un modello della configurazione e il cui contenuto viene dal Markdown di un blocco ::::page{template="…"}. Il modello dà un nome a dei rettangoli, chiamati cornici; il Markdown manda ogni parte del contenuto a una cornice per nome (il suo slot). La geometria non compare mai nel Markdown, e il testo del contenuto non compare mai nel modello. La proprietà pageTemplates contiene i modelli del libro:

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

Un modello che imposta solo il suo id e una cornice è una pagina intera in cui quella cornice riempie l’area del contenuto. Tutti gli altri campi sono facoltativi:

#Cornici

Una cornice è un rettangolo con un nome che riceve contenuto composto. Il suo name è lo slot che chiede il Markdown, ed è unico nel suo modello (nemmeno un gruppo può prendere il nome di una cornice, perché gli ancoraggi indicano entrambi allo stesso modo).

Una cornice si colloca con la sua cella grid quando il modello ha una griglia, altrimenti con il suo placement, che funziona come quello di un elemento di progetto grafico: un ancoraggio ('container' è l’area, 'page', 'bleed', o '#name' per un’altra cornice o un altro gruppo), un bordo, uno scostamento e una dimensione. Una cornice ancorata a un’altra si sposta con essa. Senza né l’una né l’altro, la cornice occupa tutta l’area.

#Gruppi

Un gruppo è una pila (dall’alto in basso) o una fila (dall’inizio alla fine) di cornici che si dividono lo spazio e si spostano insieme. Dentro un gruppo, la posizione propria delle cornici lungo la direzione del gruppo viene ignorata: il gruppo le dispone in ordine, con gap tra l’una e l’altra. Quando il testo di una cornice cresce, le cornici che la seguono si spostano. Un gruppo è un riquadro a cui si possono ancorare cornici e decorazione ('#pagina').

#Ereditarietà e varianti

Un modello con extends parte dal modello che indica (che a sua volta può estenderne un altro) e cambia solo ciò che scrive:

• Un campo come area, header o overflowTemplate sostituisce quello del genitore. grid si unisce chiave per chiave. Anche spread, gutter e role si ereditano; id, name ed extends sono propri del modello.
• frames e groups si uniscono per nome: una voce con il nome di una ereditata cambia i campi che scrive e tiene gli altri (fit, overflow e padding si uniscono chiave per chiave; placement si sostituisce per intero); remove: true la elimina; un nome nuovo si aggiunge dopo quelli ereditati.
• Gli elementi della decorazione si uniscono per id allo stesso modo; un elemento con un id nuovo, o senza id, si aggiunge.

variants.recto e variants.verso si scrivono come un modello e si uniscono allo stesso modo, su una pagina di destra o di sinistra. Si applicano dopo tutta la catena di extends, prima la variante della radice. Una doppia pagina ha entrambi i lati, quindi nessuna variante vale per essa.

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

Un valore uguale a un predefinito non viene mai scartato quando la Sandbox salva un modello: in un modello che ne estende un altro, o in una variante, sostituisce il valore del genitore.

Dal codice, resolvePageTemplate(config, id, { parity }) restituisce un modello con la catena unita, la variante del lato applicata, ogni valore predefinito compilato e ogni riferimento risolto come descrivono gli avvisi più sotto; validatePageTemplates(config) restituisce gli avvisi.

#Stili delle etichette

La proprietà labelStyles dà un nome agli aspetti delle etichette messe su un’immagine: i mari e le città di una carta, le parti di uno schema. Un’etichetta sta in un ancoraggio dell’immagine (un punto salvato con la risorsa, come i personaggi dei fumetti) e prende lo stile che indica l’ancoraggio o l’etichetta.

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

#Campi di etichetta di un ancoraggio

Gli ancoraggi di un’immagine (Resource.anchors, i punti che i fumetti usano per i personaggi) accettano alcuni campi facoltativi per le etichette. Sono frazioni dell’immagine, quindi valgono in ogni lingua e con qualunque ritaglio dell’immagine. I fumetti li ignorano.

#Avvisi dei modelli di pagina

Altrove il motore ignora una chiave che non conosce. I modelli di pagina e gli stili delle etichette invece vengono verificati, e ogni problema diventa un avviso di configurazione in postext check e nel pannello Verifiche della Sandbox. Il path di questi avvisi è un puntatore JSON al campo in errore: /pageTemplates/3/frames/2/style, /pageTemplates/0/variants/recto/frames/1/next, /resources/4/anchors/0/style. Quando il campo è stato ereditato, il puntatore indica il modello che l’ha scritto. Un avviso che cita un id o un nome inesistente suggerisce anche quello esistente più vicino.

Una chiave scritta male di un modello, di una cornice, di un gruppo, di una griglia, di fit, di overflow, di una variante o di uno stile di etichetta è un unknownConfigKey; una parola fuori dalle scelte di un’impostazione (area, verticalAlign, exclude, takes, kind, align, writingMode, direction, fontStyle, textTransform) è un unknownConfigValue, e l’impostazione tiene il suo valore predefinito. Un modello senza id, o una cornice o un gruppo senza name, viene ignorato con un unknownConfigValue su quel campo.

La versione della configurazione è la 15 dai modelli di pagina in poi (i bundle scritti prima continuano a caricarsi senza modifiche: niente di ciò che dice una configurazione più vecchia cambia significato).