Capitolo 3.15 · Parte II · Il mestiere
Configurazione: pagine composte
I modelli delle pagine composte: cornici, gruppi, griglie che ripetono un insieme di cornici, moduli, decorazione e connettori, ereditarietà e varianti per pagina dispari e pari (recto/verso); gli stili delle etichette poste sulle ancore delle immagini, e gli avvisi che un modello può dare
In breve
Questa pagina presenta i modelli di pagina. Un modello è una pagina disegnata nelle impostazioni: riquadri con un nome, chiamati cornici, dove sta ciascuno, quanto può crescere e che aspetto ha. Il Markdown di una pagina composta riempie poi le cornici per nome, così il testo non contiene mai posizioni e le impostazioni non contengono mai testo. Un modello può partire da un altro e cambiare solo alcune cornici, e può essere diverso sulle pagine di sinistra e di destra. La pagina elenca anche gli stili delle etichette per le parole messe sulle immagini, e ogni avviso che un modello può dare insieme al modo di correggerlo.
#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 di pagina, il blocco ::::page{template="…"} che si apre con quattro segni di due punti. 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:
| Proprietà | Tipo | Predefinito | Descrizione |
|---|---|---|---|
id | string | obbligatorio | Il nome con cui un blocco di pagina richiama il modello (template="tema-cajas"). Unico tra i modelli: un secondo modello con lo stesso id viene ignorato. |
name | string | l’id | Il nome mostrato nella Sandbox. L’impaginazione non lo legge mai. |
extends | string | nessuno | L’id del modello da cui parte questo. Vedi Ereditarietà e varianti. |
area | 'content' | 'trim' | 'bleed' | 'content' | Il rettangolo a cui si riferiscono le posizioni delle cornici. 'content' è l’area del contenuto della pagina, speculare sulle pagine di sinistra e di destra come il testo corrente; 'trim' è la pagina rifilata; 'bleed' la pagina con la sua abbondanza. |
grid | { columns, rows, columnGap?, rowGap? } | nessuna | Divide l’area in celle, così una cornice o un gruppo si può collocare per cella (grid: { col: 2, row: 1, cols: 2 }, contando da 1) invece che con placement. Gli spazi valgono 0 per impostazione predefinita. |
frames | FrameConfig[] | [] | Le cornici, nell’ordine del modello: è l’ordine in cui vengono misurate e quello che decide in caso di parità. Vedi Cornici. |
groups | FrameGroupConfig[] | [] | Pile e file di cornici che si dividono lo spazio. Vedi Gruppi. |
decoration | DesignSlot | nessuna | Immagini, filetti e riquadri disegnati con la pagina, nel linguaggio di elementi di intestazioni e piè di pagina. Gli elementi di testo contengono solo segnaposto ({pageNumber}, {chapterTitle}, {attr.x} per un attributo del blocco di pagina). Un elemento si può ancorare a una cornice o a un gruppo ('#dinero') e allora si sposta con esso. La decorazione si colloca dopo le cornici e non spinge mai il testo. Da postext 1.42, {headingNumber} scrive il contatore del primo titolo numerato contenuto nelle cornici della pagina (una cornice con takes) e {headingNumber.titulo} quello della cornice titulo, con le cifre del documento: così un bollino con il numero di un tema lo prende dal titolo, e il blocco di pagina non deve ripeterlo. La decorazione è disegnata sotto le cornici; un clic su un elemento di testo che sta sopra una cornice, in un punto in cui la cornice non ha testo proprio, raggiunge l’elemento e non la cornice. Una cornice con layer negativo è disegnata sotto la decorazione. Da postext 1.48 la decorazione accetta anche gli elementi tracciato (barre, nastri, frecce a chevron disegnati come forme vettoriali) e i connettori, le linee che uniscono le cornici. |
header, footer | DesignSlot | false | ereditati | La testatina e il numero di pagina. Se non sono impostati, la pagina tiene quelli del suo capitolo; false li nasconde. |
spread | boolean | false | Il modello descrive due pagine affiancate composte come un solo foglio (vedi Pagine composte › Doppie pagine). Una doppia pagina comincia su una pagina pari, la sinistra in un libro che si legge da sinistra a destra e la destra in uno che si legge da destra a sinistra, con una pagina bianca prima se serve. Anche il suo blocco di pagina riporta l’indicatore spread; se non concordano, decide il modello (spreadMismatch). |
gutter | Dimension | 0 | Su una doppia pagina, una fascia di questa larghezza centrata sul dorso da cui le cornici stanno lontane, a meno che non abbiano crossGutter: true: una cornice che la attraversa viene tagliata al suo bordo, dalla parte del suo centro, e una che comincia dentro ne esce. Con 0 la fascia è il dorso stesso. |
variants | { recto?, verso? } | nessuna | Modifiche per una pagina di destra (recto) o di sinistra (verso), scritte come il modello stesso. Il lato è quello fisico, quindi funzionano sia i libri da sinistra a destra sia quelli da destra a sinistra. |
overflowTemplate | string | questo modello | Il modello delle pagine aggiunte quando una cornice continua nella pagina successiva (overflow.). Se non è impostato, la pagina aggiunta è questo stesso modello, impaginato di nuovo riempiendo solo le cornici che proseguono; le altre non occupano spazio. Se qui c’è una doppia pagina, anche il proseguimento è una doppia pagina. Vedi Pagine composte › Quando il testo prosegue. |
bodyStyle | string | nessuno | Uno stile di paragrafo per il testo della pagina, come quello degli stili dei titoli. L’impaginazione non lo applica ancora. |
palette | string | nessuna | Una tavolozza sostitutiva per la pagina, come quella degli stili dei titoli e delle parti: coppie voce=#hex separate da virgole (tinta=#f6c3d0). Il valore si applica a tutti i colori delle cornici e della decorazione della pagina legati a quella voce della tavolozza (o uguali al suo valore), e l’attributo palette del blocco di pagina ha la precedenza. Da postext 1.42 il valore viene applicato; prima era letto e ignorato. |
role | string | 'composed' | Il ruolo di pagina che vedono gli elementi grafici con un filtro pages. 'module' fa del modello un modulo: un blocco di cornici che le pagine impilano in un gruppo invece di una pagina a sé (vedi Moduli). Da postext 1.48. |
width | Dimension | { percent } | 'fill' | 'fill' | Un modulo: la sua larghezza in una fila o in una pila di moduli, come lunghezza, come percentuale della larghezza del gruppo o come 'fill', una parte uguale di ciò che lasciano gli altri moduli della fila. In una griglia il modulo prende la sua colonna. Da postext 1.50. |
grow | number | 0 · 'fill': 1 | Un modulo: la sua quota dello spazio che una riga di moduli lascia oltre le larghezze dei suoi moduli; un modulo 'fill' ne prende almeno 1. Da postext 1.51. |
shrink | number | 0 | Un modulo con width: quanta larghezza cede, secondo la sua larghezza, quando una riga di moduli supera la fine del gruppo. Da postext 1.51. |
#Cornici
Una cornice è un rettangolo con un nome che riceve contenuto composto. Il suo name è lo slot che il Markdown indica, 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 nella cella indicata da grid, se il modello ha una griglia, altrimenti secondo placement, che funziona come quello di un elemento 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 parte dall’angolo in alto a sinistra dell’area, larga quanto l’area e alta quanto dice la sua regola di altezza. Come il contenuto viene distribuito tra le cornici, concatenato e tagliato è descritto in Pagine composte › Come si compone la pagina.
| Proprietà | Tipo | Predefinito | Descrizione |
|---|---|---|---|
name | string | obbligatorio | Il nome dello slot. |
placement | ElementPlacement | tutta l’area | Ancoraggio, bordo, scostamento e dimensione, come nella collocazione degli elementi. Ignorato quando una cella della griglia colloca la cornice. |
grid | { col, row, cols?, rows? } | nessuna | Una cella della griglia del modello, contando da 1, estesa su cols × rows celle (1 per impostazione predefinita). Una cella oltre la griglia viene riportata al suo interno. Ignorato quando il modello non ha una griglia. |
width, height | Dimension | { percent } | 'auto' | 'fill' | 'fill', 'auto' | Una lunghezza fissa, una percentuale dell’area (da 0 a 100), 'auto' (la dimensione propria del contenuto) o 'fill' (quanto resta fino al bordo a cui la cornice è ancorata). Se non è impostata, la cornice legge placement.size e poi il valore predefinito: tutta la larghezza, alta quanto il suo contenuto. Da postext 1.42, una larghezza 'auto' rende la cornice larga quanto la sua riga più lunga più il margine interno, non oltre lo spazio che lascia l’ancoraggio né oltre maxWidth (il testo che non ci sta va a capo lì) e non meno di minWidth. Il testo è misurato composto a sinistra, quindi un titolo centrato occupa quanto le sue parole. La cornice parte dal bordo indicato dal suo ancoraggio, e le cornici ancorate a essa la seguono. Serve per una linguetta o un riquadro che deve adattarsi al titolo in ogni lingua. Un valore che il motore non può usare (una lunghezza negativa, un’unità sconosciuta) vale come il predefinito. |
minWidth, maxWidth, minHeight, maxHeight | Dimension | nessuno | Limiti per una dimensione 'auto' o 'fill' e per lo spazio che un gruppo cede o prende. Il minimo prevale sul massimo, e una dimensione fissa fuori dai limiti viene riportata tra di essi (frameMinMax avvisa di entrambi i casi). |
style | string | senza riquadro | L’id di uno stile dei riquadri: le cornici si disegnano con gli stili dei riquadri (sfondo, bordo, spaziatura interna, banda, icona, linguetta, titolo). Le parole di una linguetta vengono dal Markdown (:::frame{slot="dinero" label="El dinero"}). Le impostazioni dei riquadri che decidono dove va un riquadro nel testo corrente (placement, span, columns, width, fixed…) non valgono per una cornice. |
padding | { top?, right?, bottom?, left? } | quella dello stile | Sostituisce la spaziatura interna dello stile lato per lato: lo spazio per le foto che stanno sopra un riquadro, per esempio. |
layer | number | 1 | L’ordine di disegno. La decorazione è il livello 0; un livello negativo si disegna sotto di essa. |
rotate | number | 0 | Gradi, in senso orario. Il riquadro e il suo contenuto ruotano insieme. |
verticalAlign | 'top' | 'middle' | 'bottom' | 'justify' | 'top' | Dove sta il contenuto in una cornice più alta del contenuto stesso. |
columns, columnGap | number, Dimension | 1, quello dello stile | Colonne dentro la cornice. Un titolo non ne chiude mai una: passa alla colonna successiva con il testo che introduce (con headings.keepWithNext, da postext 1.46). |
exclude | 'none' | 'push' | 'none' | 'push': il testo delle altre cornici scorre attorno al rettangolo di questa. |
wrap | 'box' | 'contour' | 'box' | Con exclude: 'push': attorno a che cosa scorre il testo delle altre cornici. 'contour' è la forma delle immagini che la cornice contiene (il loro poligono o canale alfa, vedi Testo lungo il contorno); una cornice ruotata, o una le cui immagini non hanno una forma nota, sposta il testo con il suo rettangolo. |
flow | boolean | false | La cornice riceve il contenuto che non indica nessuno slot. |
takes | 'h1' … 'h6', 'toc' | nessuno | La cornice riceve il primo titolo di quel livello che non indica nessuno slot, quindi il titolo di una pagina è solo # Title in cima al blocco. Con 'toc' riceve il :::toc della pagina che non indica nessuno slot e lo compone con le regole dell’indice (da postext 1.42; vedi Pagine composte). |
next | string | nessuno | Una catena: il contenuto che non entra continua nella cornice con quel nome, nella stessa pagina. |
overflow.continueIn | string | nessuno | Dove prosegue il contenuto che non entra: '#frame' (un’altra cornice della pagina, come next), 'next-page' (la stessa cornice in una pagina aggiunta dopo questa, con overflowTemplate), 'template:<id>' (una pagina di quel modello: la sua cornice con lo stesso nome, altrimenti la sua cornice di flusso) o 'page:<id>' (una cornice del blocco di pagina ::::page{id=…} che viene più avanti: quella indicata da 'page:<id>#<frame>', altrimenti una che il suo contenuto lascia vuota; <id> può essere {attr.name}, letto dal blocco della pagina; vedi Pagine composte › Saltare a una pagina più avanti). Una cornice di una pagina aggiunta senza una regola propria prosegue con la regola che vi ha mandato il contenuto (dopo un salto, 'next-page'), fino a 16 pagine aggiunte. La pagina può trovarsi in un file di capitolo successivo del libro (da postext 1.41). |
overflow.mark | string | false | quello della lingua | Il segno alla fine di un pezzo che prosegue in un’altra pagina. Se non è impostato, il continuesMarker dello stile della cornice, che segue la lingua del documento («Continued», «Continúa», «À suivre»…, le parole delle tabelle divise); una stringa imposta quelle parole, dove {page} è il numero della pagina in cui prosegue il resto; false non ne mette nessuno. Una cornice concatenata con next nella stessa pagina non porta segno. |
overflow.fromMark | string | nessuno | Parole in testa al pezzo nella pagina in cui prosegue il contenuto, dove {page} è il numero della pagina da cui viene ("Segue da pagina {page}"). Quello della cornice che riceve prevale su quello della cornice che invia. |
fit.shrinkText | boolean | true | Quando nient’altro fa entrare il contenuto, il suo testo si può comporre più piccolo, a passi del 2,5 % (vedi Quando il contenuto non entra). |
fit.minScale | number | 0.9 | La scala minima del testo, sopra 0 e al massimo 1 (un valore maggiore vale 1). Corpo, interlinea e spaziature seguono la stessa scala. |
fit.scaleImages, fit.imageMinScale | boolean, number | true, 0.8 | Se le immagini della cornice e quelle delle altre cornici del suo gruppo si possono rimpicciolire quando il contenuto di questa cornice non entra, e fino a quale scala. |
fit.preferContinue | boolean | true | Una cornice il cui overflow.continueIn manda il contenuto in un’altra pagina prosegue lì prima che le sue immagini e il suo testo si riducano, così un articolo mantiene la stessa dimensione da una pagina all’altra. false: si riducono prima, e la cornice prosegue solo quando questo non basta. |
pin | boolean | false | La cornice non si sposta né cambia dimensione, per un riquadro che deve restare allineato con l’illustrazione. Un gruppo si dispone attorno a essa. |
grow, shrink, priority | number | 0 | Come la cornice divide lo spazio del suo gruppo: grow prende una parte dello spazio libero, shrink permette alla cornice di cedere spazio, e le cornici con priority più bassa lo cedono per prime. |
growWith | 'children' | string[] | — | Cresce con le cornici interne (vedi Libri di pagine composte, passo 6). |
optional | boolean | false | Nessun avviso quando il Markdown non manda nulla alla cornice. |
crossGutter | boolean | false | Su una doppia pagina, la cornice può attraversare la fascia del dorso. Il suo testo si legge sulla pagina che ne contiene il centro; la pagina di fronte ne disegna la metà. |
rules | { every?, color?, width?, inset? } | — | Righe tracciate nell’area del contenuto della cornice: una al piede di ogni riga di testo, quante ne entrano nella sua altezza. every è il passo, 'line' (predefinito: l’interlinea del testo della cornice) o una lunghezza; color è un grigio medio per impostazione predefinita, width lo spessore (0,5 pt), inset lo spazio lasciato a ciascuna estremità di ogni riga tracciata, oppure { left, right }. Vedi Cornici rigate, più sotto. Da postext 1.38. |
look | { background?, border?, stripe?, icon?, marker?, titleStyle?, body?, label? } | — | Ciò che questa cornice cambia dell’aspetto del suo stile di riquadro, con i nomi e l’annidamento dello stile stesso: colori (background, border.color, stripe.color, icon.color, marker.color e marker.rule.color, titleStyle.color, body.color, body.boldColor, body.italicColor, label.color, label.background, label.rule.color) e spaziatura tra le lettere del testo (body.letterSpacing). Un background attiva anche il riempimento dello stile; il colore di una linguetta conta solo se lo stile ha una linguetta. In un modello figlio si fonde chiave per chiave con la cornice che sostituisce. Un libro che usa la stessa forma di riquadro in più tinte mantiene un solo stile e indica qui la tinta, oppure lascia che palette ricolori un riempimento legato alla tavolozza. Un pezzo della pagina può posarci sopra un aspetto con nome (vedi Aspetti delle cornici). Da postext 1.42. |
writingMode, direction | 'horizontal-tb' | 'vertical-rl', 'ltr' | 'rtl' | quelli della pagina | Una cornice composta nel proprio modo di scrittura o nella propria direzione: un riquadro verticale su una pagina orizzontale, una scheda orizzontale su una pagina verticale, una citazione da destra a sinistra in un libro da sinistra a destra. Una cornice dell’altro modo di scrittura viene composta nel suo riquadro ruotato di un quarto di giro: le righe ne percorrono l’altezza e si susseguono nella larghezza, e un’altezza 'auto' è la minima che le contiene in quella larghezza. Il testo viene disegnato come lo disegna una pagina con quel modo di scrittura. direction compone il testo della cornice in quella direzione, come un riquadro con {dir=…}; un blocco o un riquadro che scrive il proprio dir lo mantiene. Da postext 1.39. Da postext 1.40 una cornice verticale funziona anche su una pagina da destra a sinistra: è composta come su una pagina da sinistra a destra e collocata dove la mette il flusso specchiato, con il testo disegnato senza specchiatura; un’immagine in una cornice verticale di una pagina orizzontale sta dritta, con la sua didascalia, e occupa lo spazio che il riquadro le lascia nel senso della larghezza della pagina; l’EPUB a layout fluido scrive una cornice di un altro modo di scrittura come un riquadro con quel modo e la lunghezza lungo cui corrono le sue righe (in em del testo base). Da postext 1.42 anche un’immagine in una cornice di una pagina verticale che segue il modo della pagina sta dritta, con la sua didascalia. |
overlap | 'check' | 'allow' | 'check' | 'allow' esclude la cornice dai controlli di sovrapposizione: frameCovered non viene segnalato per una coppia di cui fa parte, che sia disegnata sopra l’altra cornice o sotto, e frameOutsideArea non viene segnalato per lei. Per un disegno che deve stare sopra il testo, o un bollino appeso di proposito per metà fuori dalla sua scheda. Vedi Avvisi di sovrapposizione, ripetizione e moduli. Da postext 1.48. |
remove | boolean | false | In un modello che ne estende un altro, o in una variante: elimina la cornice ereditata con quel nome. |
Cornici rigate. Uno spazio per la risposta in un quaderno di attività è una cornice con rules: le sue righe seguono la sua altezza, quindi è il Markdown a decidere quante sono. Una cornice vuota di altezza fissa riceve le righe che vi entrano; una cornice 'auto' che riceve :::space{lines=4} ne riceve quattro, e una cornice che cresce con il suo testo ne riceve di più. Le righe si disegnano sopra lo sfondo della cornice e sotto il suo testo, nel canvas, nell’HTML, nel PDF e nell’EPUB a layout fisso; l’ispettore delle cornici della Sandbox le attiva in Aspetto.
frames: [
{ name: 'pregunta', style: 'actividad' },
{ name: 'respuesta', rules: { color: { hex: '#93bcd8', model: 'hex' }, width: { value: 0.75, unit: 'pt' } } },
],
groups: [{ name: 'actividad', kind: 'stack', gap: { value: 3, unit: 'mm' }, frames: ['pregunta', 'respuesta'] }],:::frame{slot="respuesta"}
:::space{lines=4}
:::#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').
| Proprietà | Tipo | Predefinito | Descrizione |
|---|---|---|---|
name | string | obbligatorio | Unico tra le cornici e i gruppi del modello. |
kind | 'stack' | 'row' | 'grid' | 'stack' | Dall’alto in basso, dall’inizio alla fine, o celle disposte in righe ('grid', da postext 1.48; vedi Griglie che ripetono un insieme di cornici). |
frames | string[] | [] | Le cornici del gruppo, nel loro ordine sulla pagina. Una cornice appartiene al massimo a un gruppo; un nome che non è una cornice del modello, o una cornice già elencata, viene saltato. Una griglia che si ripete prende invece le cornici di repeat.frames. |
columns | number | 1 | Una griglia: il numero di colonne, tutte della stessa larghezza. |
columnGap, rowGap | Dimension | il gap del gruppo | Una griglia: lo spazio fra due colonne, e fra due righe. |
rowAlign | 'start' | 'center' | 'end' | 'stretch' | 'stretch' | Una griglia: dove sta una cella più bassa della sua riga. 'stretch' rende la sua cornice principale alta quanto la riga (fino al suo maxHeight), quando l’altezza di quella cornice è 'auto' o 'fill'. Una fila o una griglia di moduli: dove sta un modulo più basso della sua fila; 'stretch' lo mette in un riquadro alto quanto la fila, così il suo fondo e le sue cornici 'fill' arrivano al piede della fila. Da postext 1.51 anche le sue cornici 'auto' che finiscono al suo piede arrivano al piede della riga, ma non una larga quanto il suo contenuto. |
repeat | { frames, max? } | nessuno | Una griglia: l’insieme di cornici disposto una volta per ogni elemento del contenuto della pagina. La prima cornice di frames è la cornice principale della cella; max limita il numero di elementi, e il resto va alla cornice di flusso (repeatOverflow). |
modules | boolean | false | Il gruppo prende i blocchi :::module della pagina nell’ordine del Markdown, con gap tra loro: uno sotto l’altro ('stack'), uno accanto all’altro ('row') o in columns ('grid', da postext 1.50). I suoi frames non vengono letti. Vedi Moduli. Da postext 1.48. |
overflow.continueIn | 'next-page' | 'template:<id>' | nessuno | Un gruppo di moduli: dove prosegue, intero, un modulo che non entra. Se non è impostato, il modulo viene tagliato al piede del gruppo e le sue cornici percorrono la scala di reimpaginazione. |
within | string | nessuno | Un gruppo di moduli dentro il gruppo di moduli con questo nome: ogni serie consecutiva dei moduli della pagina che riceve viene messa dove viene il suo primo modulo, come righe di una pila o come una cella di una riga o di una griglia. Da postext 1.50; qualsiasi gruppo di moduli, a qualsiasi profondità, da postext 1.51. |
templates | string[] | nessuno | Un gruppo di moduli within un altro: i modelli di modulo che riceve. Se non indicato, tutti i moduli, o solo quelli dei suoi gruppi interni se ne ha. Un modulo va al primo gruppo che lo riceve, altrimenti al gruppo di moduli della pagina. |
gap | Dimension | 0 | Lo spazio tra due cornici del gruppo. |
placement, grid | come le cornici | il riquadro delle sue cornici | Il riquadro proprio del gruppo. Se non è impostato, il gruppo comincia dove è collocata la sua prima cornice e arriva fin dove servono le sue cornici. |
align | 'start' | 'center' | 'end' | 'space-between' | 'start' | Dove va lo spazio libero quando nessuna cornice del gruppo cresce. |
remove | boolean | false | In un modello che ne estende un altro, o in una variante: elimina il gruppo ereditato. |
#Come i gruppi si dividono lo spazio
Una cornice dichiara la sua dimensione: un height fisso, oppure 'auto', cioè l’altezza di ciò che contiene, tenuta fra minHeight e maxHeight. In un modello ricalcato su una pagina stampata, dai a ogni riquadro come minHeight l’altezza che ha su quella pagina: con un testo breve il riquadro resta come è disegnato, con uno più lungo diventa più alto. Nella stessa passata la pagina viene disposta due volte, una come la dichiara il modello e una come la richiede il contenuto, e le differenze fra le due finiscono nel registro di reimpaginazione.
Pila. Le cornici di una pila si dispongono l’una sotto l’altra, ciascuna alla sua altezza, con gap fra l’una e l’altra. Ognuna mantiene la propria posizione orizzontale e la propria larghezza; la sua posizione verticale viene ignorata.
- Un gruppo senza
placementnégridpropri comincia dove è collocata la sua prima cornice (il suoplacement, o la sua cellagridin un modello con griglia) e scende quanto serve alle sue cornici, fino al piede dell’area del modello. Quando una cornice cresce, quelle che la seguono scendono della stessa misura. - Un gruppo con un riquadro proprio dispone le sue cornici dentro quel riquadro. Se le cornici richiedono più spazio di quanto il riquadro ne offra, cedono spazio quelle con
shrinkmaggiore di 0, a cominciare da quelle con laprioritypiù bassa; le cornici con la stessa priorità cedono in proporzione al loroshrink, e nessuna scende sotto il suominHeight. Lo spazio libero va alle cornici congrowmaggiore di 0, in proporzione a quel valore e fino al loromaxHeight; se nessuna hagrow, le cornici vengono collocate secondoalign('end'al piede,'center','space-between'). Una cornice del gruppo senza una collocazione propria prende come area il riquadro del gruppo. - Quando più niente può cedere, cedono per prime le cornici più vicine al piede del gruppo, ciascuna fino al suo
minHeight; una cornice con altezza fissa la tiene, così uno spazio di risposta vuoto o il posto di un’immagine sotto un riquadro che cresce resta sulla pagina, ed è il testo del riquadro a cedere. Nessuna cornice oltrepassa il piede del gruppo: la cornice il cui contenuto non entra percorre la sequenza di reimpaginazione (vedi Quando il contenuto non entra), e quello che ancora non entra viene tagliato lì e segnalato comeframeOverflow. Anche una cornice ridotta sotto il suominHeighto la sua altezza fissa viene segnalata, che abbia contenuto o no. - Una cornice con
height: 'fill'chiede il suominHeighte prende lo spazio libero come se avessegrow: 1.
Fila. Le cornici di una fila si affiancano alle larghezze dichiarate e sono tutte alte quanto la fila, cioè quanto il riquadro del gruppo o, se il gruppo non ne ha uno proprio, quanto la maggiore fra le altezze che scrivono le sue cornici: una height fissa, altrimenti un minHeight (una cornice 'auto' non dichiara altro), oppure, se non ne scrivono nessuna, quanto il contenuto più alto (una cornice con altezza fissa tiene la sua). Quando il testo di una cornice supera l’altezza della fila, la cornice si allarga: prima prende la larghezza libera della fila, poi quella delle cornici vicine con shrink maggiore di 0, a cominciare da quelle con la priority più bassa, e nessuna di queste diventa più stretta della larghezza in cui il suo testo entra ancora. La cornice prende il minor numero di millimetri interi che basta a far entrare il testo; se non basterebbe nemmeno tutto lo spazio disponibile, non prende nulla, e una fila senza riquadro proprio diventa invece più alta. Così delle schede con height: 'auto' e un minHeight si dividono la larghezza a quell’altezza, e la fila cresce solo quando nessuna ha larghezza da cedere. La larghezza libera va alle cornici con grow maggiore di 0, e quella che resta si distribuisce secondo align. Le file vanno da sinistra a destra.
Cornici fissate. Una cornice con pin: true mantiene il riquadro che il modello le dichiara anche quando la cornice a cui è ancorata cresce o si sposta: un riquadro disegnato su misura dell’illustrazione le resta sopra. In un gruppo, una cornice fissata tiene il suo posto e le altre cornici la scavalcano, con gap su entrambi i lati. Una cornice fissata fuori dal gruppo fa lo stesso con le cornici del gruppo che altrimenti la coprirebbero.
Decorazione. Un elemento della decorazione ancorato a una cornice (anchor: { to: '#dinero' }) la segue quando la cornice cresce o si sposta. Un elemento con pin: true resta dove il modello disegna quella cornice.
| Proprietà | Tipo | Predefinito | Descrizione |
|---|---|---|---|
pin (elemento della decorazione) | boolean | false | Nella decorazione di una pagina composta: un elemento ancorato a una cornice resta dove il modello colloca quella cornice, qualunque cosa facciano il contenuto della cornice o il suo gruppo. Ignorato nelle intestazioni, nei piè di pagina e nella grafica dei titoli. |
I tre riquadri della pagina di un libro di scuola, ciascuno all’altezza con cui è disegnato e pronto a crescere con il suo testo:
frames: [
{ name: 'dinero', style: 'caja-azul', width: { value: 186, unit: 'mm' }, minHeight: { value: 36, unit: 'mm' },
placement: { anchor: { to: '#texto', edge: 'below' }, offset: { y: { value: 9, unit: 'mm' } } } },
{ name: 'dinero-fotos', layer: 2, width: { value: 58, unit: 'mm' },
placement: { anchor: { to: '#dinero', edge: 'top-right' } } },
{ name: 'gasto', style: 'caja-verde', width: { value: 186, unit: 'mm' }, minHeight: { value: 62, unit: 'mm' } },
{ name: 'ahorro', style: 'caja-amarilla', width: { value: 186, unit: 'mm' }, minHeight: { value: 30, unit: 'mm' } },
],
groups: [{ name: 'cajas', kind: 'stack', frames: ['dinero', 'gasto', 'ahorro'], gap: { value: 12, unit: 'mm' } }],Il risultato dipende solo dal contenuto della pagina, dal modello e dalla tipografia: a parità di dati si ottiene la stessa pagina, misurata nello stesso ordine e con gli stessi passi. Mentre divide lo spazio, l’impaginazione non legge mai un’altra pagina, quindi una modifica su una pagina composta lascia invariate tutte le altre, purché il contenuto resti sulla sua pagina.
Tenere le cornici al piede di una scheda (da postext 1.42). Una cornice ancorata sotto il testo che ha sopra segue quel testo: in un’edizione in cui il testo è una riga più corto o più lungo, le cornici sotto salgono o scendono, mentre ciò che il modello disegna (una scheda, una fascia, il piede) resta dov’è. Per tenere le cornici al piede di una scheda, dove il modello le mette, riunisci le cornici della scheda in una pila con un riquadro proprio alto quanto la scheda. Le cornici sopra quelle trattenute prendono lo spazio che avanza (grow: 1) e lo restituiscono (shrink: 1); quelle trattenute scrivono un minHeight. Un testo più corto lascia le cornici trattenute dove erano. Uno più lungo viene stretto sopra di esse: mantengono il loro minHeight, il testo sopra si riduce e, se ancora non entra, l’impaginazione segnala frameOverflow e il registro di reimpaginazione annota textScaled e overflow per la cornice sopra. Anche una cornice ancorata al piede del contenitore (bottom-left) mantiene il suo posto, ma nulla la lega alle cornici sopra: un testo più lungo la ricopre, nulla viene stretto per lei e la sovrapposizione non viene segnalata.
{
"frames": [
{ "name": "texto", "grow": 1, "shrink": 1 },
{ "name": "mapa", "minHeight": { "value": 60, "unit": "mm" } }
],
"groups": [{
"name": "tarjeta", "frames": ["texto", "mapa"], "gap": { "value": 4, "unit": "mm" },
"placement": {
"anchor": { "to": "container", "edge": "top-left" },
"size": { "width": "fill", "height": { "value": 140, "unit": "mm" } }
}
}]
}La cornice che cresce è alta quanto lo spazio libero, qualunque cosa contenga, quindi uno stile con sfondo visibile la colorerebbe tutta: disegna la scheda nella decorazione del modello e lascia la cornice di testo senza stile.
#Griglie che ripetono un insieme di cornici
Una pagina di schede con foto, una pagina di schede di attività o una pagina di ritratti con un nome sotto ciascuno sono la stessa scheda disegnata molte volte. Un gruppo a griglia con repeat la disegna una sola volta nel modello: le cornici di una scheda, dette insieme di cornici, che la griglia dispone una volta per ogni elemento che il Markdown della pagina le dà. Quante schede ha una pagina lo decide allora il Markdown, e una traduzione che aggiunge una scheda non ha bisogno di un nuovo modello. Da postext 1.48.
frames: [
{ name: 'titulo', takes: 'h1' },
{ name: 'foto', style: 'marco', placement: { anchor: { to: '#titulo', edge: 'below' }, offset: { y: { value: 6, unit: 'mm' } } } },
{ name: 'pie', style: 'pastilla', width: 'auto', layer: 2, overlap: 'allow',
placement: { anchor: { to: '#foto', edge: 'bottom' }, offset: { y: { value: 4, unit: 'mm' } } } },
],
groups: [{
name: 'fotos', kind: 'grid', columns: 3,
columnGap: { value: 6, unit: 'mm' }, rowGap: { value: 10, unit: 'mm' },
repeat: { frames: ['foto', 'pie'] },
}],- L’insieme. La prima cornice di
repeat.framesè la cornice principale della cella: prende la larghezza della cella e mantiene la propria regola di altezza ('auto'è l’altezza del suo contenuto, framinHeightemaxHeight). Le altre cornici dell’insieme si dispongono come le disegna il modello, ancorate alla cornice principale o l’una all’altra: qui la pastiglia della didascalia pende dal piede della foto. Una cornice dell’insieme ancorata a una cornice esterna resta dove la mette quell’ancoraggio. - Elementi. Ogni pezzo
:::frame{slot="foto"}della pagina è un elemento: i pezzi di uno slot ripetuto non vengono uniti. Dentro il pezzo, un blocco che indica un membro dell’insieme (:::frame{slot="pie"},::resource{… slot="pie"}) va a quel membro della stessa scheda; il resto va alla cornice principale. Vedi Pagine composte › Slot ripetuti. - Istanze. Le cornici di ogni scheda si chiamano
<frame>[n], contando da 1:foto[2]epie[2]sono la seconda scheda. Gli avvisi, il registro di reimpaginazione, la mappa delle origini e la Sandbox usano questi nomi, gli id delle cornici sonocp<n>:foto[2], e un elemento della decorazione o un connettore può ancorarsi a'#foto[2]'. Ilto: '#foto[*]'di un connettore raggiunge tutte le schede della pagina. Un elemento ancorato a'#foto'legge il riquadro della griglia. - Celle. Le celle riempiono le righe dal lato d’inizio, quindi in una pagina da destra a sinistra la prima scheda sta a destra. Una riga è alta quanto la sua cella più alta, contando ciò che pende sopra la cornice principale (una linguetta) e sotto (una pastiglia);
rowAligncolloca quelle più basse. Il riquadro della griglia è il suoplacemento la sua cellagrid; se non ne ha, comincia dove il modello disegna la cornice principale e arriva al bordo destro e al piede dell’area. - Quando le schede non entrano. Una riga che supera il piede della griglia viene tagliata lì, ogni scheda percorre da sola la scala di reimpaginazione, e l’ultima scheda tagliata segnala
frameOverflow. Conoverflow.continueInsulla cornice principale ('next-page','template:<id>'), la griglia prosegue per righe intere: la prima riga che non entra, e tutte quelle che la seguono, si dispongono nella pagina aggiunta, nella griglia di un modello che ripete lo stesso insieme di cornici. Una cella più alta dell’intera griglia dà un avviso invece di proseguire all’infinito. max. Gli elementi oltrerepeat.maxvanno alla cornice di flusso, o dopo la pagina quando il modello non ne ha una, e ciascuno producerepeatOverflow.
Una griglia senza repeat dispone le cornici che elenca, una per cella, nell’ordine in cui sono scritte. Una cornice di un insieme ripetuto elencata in un altro gruppo viene saltata lì (groupFrameTwice), e un nome che il modello non ha è groupFrameUnknown. grow e shrink non si applicano alle righe di una griglia, né redistribute alle sue schede.
#Moduli
Una pagina di libro di scuola impila spesso blocchi che tornano lungo il libro in un altro ordine: un riquadro con una foto accanto, un albero di tre idee, una griglia di quattro foto sotto un titolo. Disegnare un modello per ogni ordine moltiplica i modelli. Un modulo è uno di questi blocchi disegnato una volta sola: un modello con role: 'module', che contiene cornici, gruppi e decorazione (connettori compresi), e nessuna pagina propria. Un modello di pagina prende i moduli in un gruppo con modules: true; il Markdown della pagina dice quali moduli contiene e in che ordine (vedi Pagine composte › Moduli in una pagina). Da postext 1.48.
pageTemplates: [
{ id: 'tema', frames: [{ name: 'titulo', takes: 'h1' }],
groups: [{ name: 'cuerpo', modules: true, gap: { value: 8, unit: 'mm' },
placement: { anchor: { to: '#titulo', edge: 'below' }, offset: { y: { value: 6, unit: 'mm' } },
size: { width: 'fill', height: 'fill' } } }] },
{ id: 'arbol', role: 'module',
frames: [
{ name: 'raiz', style: 'nodo', width: { value: 56, unit: 'mm' }, placement: { anchor: { to: 'container', edge: 'top' } } },
{ name: 'izq', style: 'nodo', width: { value: 56, unit: 'mm' },
placement: { anchor: { to: '#raiz', edge: 'below' }, offset: { x: { value: -44, unit: 'mm' }, y: { value: 10, unit: 'mm' } } } },
{ name: 'der', style: 'nodo', width: { value: 56, unit: 'mm' },
placement: { anchor: { to: '#raiz', edge: 'below' }, offset: { x: { value: 44, unit: 'mm' }, y: { value: 10, unit: 'mm' } } } },
],
decoration: { elements: [
{ kind: 'connector', id: 'ramas', routing: 'tree', from: { to: '#raiz' }, to: [{ to: '#izq' }, { to: '#der' }] },
] } },
],- Che cosa ha un modulo. Cornici, gruppi (compresa una griglia che si ripete), decorazione e connettori. Non ha
area,header,footer,variants,spread,gutternéoverflowTemplate: ciascuno di questi viene segnalato comeunknownConfigValuee ignorato.extendsfunziona fra moduli (un modello che estende un modulo è un modulo). - Il suo riquadro. Un modulo è largo quanto il suo gruppo e alto fin dove arrivano le sue cornici; il gruppo impila i moduli dalla sua cima, con
gapfra l’uno e l’altro. Dentro un modulo,'container'è il riquadro del modulo, per le sue cornici (anche'fill'e le percentuali) e per la sua decorazione: un fondo dimensionato a{ to: 'container', edge: 'bottom' }copre il modulo qualunque altezza gli diano le sue parole. - Nomi. Le cornici, i gruppi e gli elementi di un modulo prendono come prefisso il nome dell’istanza del modulo:
<name>.<frame>, con il nome che dà il Markdown (name="ramas") oppure<template>[n], il numero d’ordine del modulo tra i moduli della pagina con quel modello (arbol[2].raiz). Gli ancoraggi,next,continueIn: '#x'e i connettori dentro un modulo vengono riscritti verso le sue cornici, così due alberi sulla stessa pagina non si uniscono mai fra loro. L’id di una cornice ècp0:arbol[2].raiz. - Quando i moduli non entrano. Un modulo che supera il piede del gruppo viene tagliato lì e le sue cornici percorrono la scala di reimpaginazione;
frameOverflowviene segnalato una volta per il gruppo. Conoverflow.continueInsul gruppo di moduli ('next-page'o'template:<id>'), il primo modulo che non entra e tutti quelli che lo seguono proseguono interi nella pagina aggiunta, con gli stessi nomi, in cima al gruppo di moduli di quella pagina. In una fila o in una griglia di moduli una fila prosegue intera: i suoi moduli non vengono mai divisi tra due pagine. - Affiancati. Un gruppo di moduli con
kind: 'row'mette i suoi moduli dall’inizio alla fine, ciascuno largo quanto lawidthdel suo modello (una lunghezza,{ percent: 48 }o'fill', una parte uguale di ciò che resta), con la fila alta quanto il suo modulo più alto;kind: 'grid'li mette incolumnscolonne uguali, fila dopo fila.rowAligncolloca un modulo più basso della sua fila. Le file partono dal lato in cui inizia la riga, quindi una pagina da destra a sinistra mette il primo modulo a destra. Da postext 1.50. - Gruppi dentro la pila. Un gruppo di moduli con
within: '<pila>'sta dentro la pila di moduli della pagina, etemplatesdice quali moduli riceve: ogni serie consecutiva di questi nel Markdown forma una fila o una griglia della pila, dove viene il suo primo modulo. Con i gruppi qui sotto, due blocchiavisoseguiti da quattro blocchitarjetadanno una fila di due riquadri sopra una griglia di 2 × 2 schede, e il Markdown contiene solo blocchi:::module. - Gruppi dentro gruppi. Da postext 1.51
withinpuò nominare qualsiasi gruppo di moduli, anche una riga o una griglia, a qualsiasi profondità. Conbandauna riga dentrocuerpoecolumnauna pila dentrobanda, un riquadro seguito da due schede sta accanto a una colonna con le due schede. Una cornice della pagina ancorata a#bandaviene messa dopo i moduli. - Dividere una riga. Da postext 1.51 lo spazio che una riga di moduli lascia va secondo il
growdi ogni modulo, e una riga più larga del suo gruppo cede larghezza secondoshrink. - Non ancora. Un modulo dentro un modulo (
moduleNested) e cellegriddel modello dentro un modulo.
groups: [
{ name: 'cuerpo', modules: true, gap: { value: 8, unit: 'mm' } },
{ name: 'par', modules: true, within: 'cuerpo', kind: 'row', templates: ['aviso'], gap: { value: 6, unit: 'mm' } },
{ name: 'tarjetas', modules: true, within: 'cuerpo', kind: 'grid', columns: 2, templates: ['tarjeta'], gap: { value: 6, unit: 'mm' } },
],#Quando il contenuto non entra
Quando il contenuto di una cornice è più alto dello spazio che le dà il suo gruppo, l’impaginazione prova in ordine i passi della sequenza di reimpaginazione e si ferma al primo che lo fa entrare: lo spazio libero fino a maxHeight, il gruppo che spinge e cede, immagini più piccole, le altre cornici del gruppo portate al loro minimo, testo più piccolo, la prosecuzione in un’altra pagina. Queste impostazioni della cornice stabiliscono fin dove può spingersi ciascun passo:
maxHeightsu una cornice conheightfisso: la cornice può crescere fin lì prima di qualsiasi riduzione.minHeightsulle altre cornici del gruppo: fin dove restituiscono spazio; una cornice non scende mai sotto quanto richiede il suo contenuto.fit.scaleImagesefit.imageMinScale: se le immagini della cornice e del suo gruppo si possono rimpicciolire, e fino a quale scala (80 % per impostazione predefinita).fit.shrinkTextefit.minScale: se il testo della cornice si può rimpicciolire, e fino a quale scala (90 % per impostazione predefinita). La scala è la stessa per il corpo, l’interlinea e le spaziature; la cornice mantiene la sua dimensione.overflow.continueIn: dove prosegue il contenuto quando tutto questo non basta, in un’altra cornice o in un’altra pagina ('next-page','template:<id>','page:<id>'), dove il testo riprende a dimensione piena dopo l’overflow.markdel pezzo. Una cornice che può proseguire in un’altra pagina lo fa prima che le sue immagini e il suo testo si riducano, a meno che il suofit.preferContinuesiafalse.
Le scale vanno a passi del 2,5 % e l’impaginazione sceglie la più grande che funziona, così un testo che eccede di una riga viene composto al 97,5 %, non al minimo. Un riquadro che deve mantenere il suo corpo imposta fit: { shrinkText: false }; una pagina le cui immagini devono mantenere la loro dimensione imposta fit: { scaleImages: false } sulle cornici del suo gruppo:
{ name: 'recuadro', style: 'recuadro', height: { value: 63, unit: 'mm' }, maxHeight: { value: 75, unit: 'mm' },
fit: { minScale: 0.85, imageMinScale: 0.9 } }Quello che ancora non entra viene segnalato come frameOverflow, con i passi tentati e proposte che portano i loro valori: vedi L’avviso e le sue proposte.
#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,headerooverflowTemplatesostituisce quello del genitore.gridsi unisce chiave per chiave. Anchespread,guttererolesi ereditano;id,nameedextendssono propri del modello. framesegroupssi uniscono per nome: una voce con il nome di una ereditata cambia i campi che scrive e tiene gli altri (fit,overflowepaddingsi uniscono chiave per chiave;placementsi sostituisce per intero);remove: truela elimina; un nome nuovo si aggiunge dopo quelli ereditati.- Gli elementi della decorazione si uniscono per
idallo stesso modo; un elemento con un id nuovo, o senza id, si aggiunge. Da postext 1.42,{ id: 'testata-pari', remove: true }indecoration.elementsdi un modello figlio o di una variante toglie l’elemento ereditato con quell’id, comeremove: truefa per una cornice; unidche il modello non eredita non cambia nulla. Un nuovo elemento con lo stessoidpuò seguire la rimozione nella stessa lista.
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.
Un elemento di variants.recto con parity: 'even', o di variants.verso con 'odd', non viene mai disegnato: unknownConfigValue.
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.
#Disegnato quando la pagina lo dice
Un elemento della decorazione, e uno dell’header o del footer del modello, può avere when o unless, ciascuno con il nome di un attributo del blocco della pagina. when: 'folio' disegna l’elemento solo nelle pagine il cui blocco imposta folio; unless: 'frontmatter' lo toglie dalle pagine il cui blocco imposta frontmatter. Un blocco imposta un attributo quando lo scrive da solo (::::page{template="pagina" frontmatter}) o con un valore diverso da false. Così un solo modello serve alle pagine preliminari, senza folio né banda, e alle pagine del testo, che hanno entrambi: il Markdown dice che cosa è la pagina e il modello tiene il disegno. Da postext 1.50.
decoration: { elements: [
{ kind: 'box', id: 'band', unless: 'frontmatter',
placement: { anchor: { to: 'page', edge: 'top-left' }, size: { width: 'fill', height: { value: 12, unit: 'mm' } } },
style: { backgroundColor: { hex: '#2a6f97' } } },
{ kind: 'text', id: 'folio', when: 'folio', content: '{pageNumber}',
placement: { anchor: { to: 'page', edge: 'bottom-center' }, offset: { y: { value: -8, unit: 'mm' } } } },
] }- Un elemento ancorato a un elemento tolto, o con la misura che arriva fino a esso, viene tolto anche lui.
- Con entrambe le chiavi, l’elemento si disegna dove il blocco imposta l’attributo di
whene non quello diunless. - Le testatine del documento e quelle di una sezione le leggono anch’esse. Una pagina che non è composta non ha blocco e non imposta nulla. I disegni di titolo, di parte e di riquadro le ignorano.
- Un valore che non è un testo non vuoto, o uno scritto in un disegno di titolo, di parte o di riquadro, viene segnalato come
unknownConfigValue, e l’elemento si disegna come se non lo avesse.postext checkaggiunge una nota,conditionNeverMet, per unwheno ununlesssu un attributo che nessuna pagina del libro imposta: quell’elemento non si disegna mai, oppure sempre. Lo stesso per un{attr.x}che nulla imposta: resta vuoto. - A libro impaginato, una pagina che non disegna nulla di un folio o di una testatina (un testo di
headerofooter, un testo della decorazione che legge{pageNumber}, un nome corrente o{attr.x}) che la maggior parte delle pagine del suo modello e del suo lato disegna viene segnalata comefolioMissing, con la pagina, il modello e l’elemento. Non conta una pagina il cui blocco spegne l’elemento, né una il cui modello non ha quell’elemento. Da postext 1.53. - Nel Sandbox, ogni scheda di elemento di una testatina e della decorazione di un modello ha i campi Disegnato quando la pagina lo dice e Non disegnato quando la pagina lo dice, che offrono gli attributi usati dai blocchi di pagina del libro.
#Che cosa applica l’impaginazione
L’impaginazione applica la collocazione e le dimensioni di ogni cornice (griglia, ancoraggi, min/max, verticalAlign), il suo stile e il suo padding, columns, rules, layer, rotate, exclude (e il suo wrap), flow, takes, next, overflow.continueIn ("#frame", "next-page", "template:<id>", "page:<id>") con overflow.mark e overflow.fromMark, e il suo fit (la riduzione del testo e delle immagini nella scala di riadattamento, vedi Quando il contenuto non entra); la ripartizione dello spazio in un gruppo (grow, shrink, priority, pin, e il gap e l’align del gruppo, vedi Come i gruppi si dividono lo spazio); e area, grid, decoration, header, footer, variants, spread e overflowTemplate del modello. Da postext 1.42 applica anche la palette del modello, il look di una cornice e la larghezza 'auto' (quella della riga più lunga della cornice). Il writingMode e la direction di una cornice sono applicati da postext 1.39. Da postext 1.48 applica i gruppi a griglia e il loro repeat, i gruppi di moduli e i modelli di modulo, i connettori e gli elementi tracciato nella decorazione, e l’overlap di una cornice. Viene letto e controllato, ma non ancora applicato: il bodyStyle del modello.
#Doppie pagine
In un modello a doppia pagina tutte le coordinate valgono sul foglio delle sue due pagine, con il dorso al centro: area, grid, gli ancoraggi a container, page e bleed e le misure fill leggono la larghezza doppia. bleed arriva alla testa, al piede e ai due bordi esterni, mai al dorso. La linea del tempo a doppia pagina di un libro di testo è un solo modello:
pageTemplates: [{
id: 'linea-tiempo',
spread: true,
gutter: { value: 10, unit: 'mm' },
grid: { columns: 6, rows: 12, columnGap: { value: 12, unit: 'mm' }, rowGap: { value: 3, unit: 'mm' } },
frames: [
{ name: 'titulo', takes: 'h1', style: 'tab-titulo' },
{ name: 'texto', flow: true, width: { value: 196, unit: 'mm' },
placement: { anchor: { to: '#titulo', edge: 'below' } } },
{ name: 'recuadro', style: 'recuadro', grid: { col: 4, row: 1, cols: 3, rows: 4 }, height: 'auto' },
{ name: 'banda-1', style: 'banda', grid: { col: 1, row: 5, cols: 3 }, height: { value: 8, unit: 'mm' } },
{ name: 'banda-2', style: 'banda', crossGutter: true, width: 'fill', height: { value: 8, unit: 'mm' },
placement: { anchor: { to: '#banda-1', edge: 'right-of' }, offset: { x: { value: 2, unit: 'mm' } } } },
{ name: 'era-1', style: 'era', grid: { col: 1, row: 6, rows: 2 }, height: 'auto' },
// … da era-2 a era-6, una colonna della griglia ciascuna, e le note sotto la striscia
{ name: 'tira', crossGutter: true, grid: { col: 1, row: 8, cols: 6, rows: 3 } },
],
}]Un’intercolonna più larga del gutter tiene le schede di una griglia simmetrica lontane dal dorso, quindi nessuna si sposta. La seconda fascia e la striscia di immagini hanno crossGutter per attraversarlo: ciascuna si legge sulla pagina che ne contiene il centro e si disegna su entrambe. Tutte le parole della pagina, anche i nomi delle epoche sulle linguette, restano nel Markdown.
In un libro verticale (vertical-rl) la doppia pagina si compone nel sistema di riferimento del flusso delle pagine, come le sue pagine composte singole: l’alto della pagina è il bordo destro del foglio e le righe scendono, quindi la x del modello scende lungo il foglio e la sua y va dal bordo destro del foglio a quello sinistro. Il foglio è la pagina destra seguita dalla sinistra lungo y, il dorso è una linea che attraversa il modello, e gutter, crossGutter e il taglio fra le pagine leggono quell’asse; la decorazione si compone sempre sul foglio fisico e si taglia al dorso. Una linea del tempo orizzontale disegnata per un libro orizzontale esce ruotata in uno verticale: scrivi il modello di un libro verticale nel sistema di riferimento del suo flusso. Da postext 1.38. Una scheda da leggere in orizzontale sul foglio prende writingMode: 'horizontal-tb': viene composta in orizzontale e sta dritta sulla pagina verticale (da postext 1.39).
#Connettori
Un connettore è una linea della decorazione che unisce delle cornici: i rami di uno schema ad albero, un organigramma, le stanghette di una linea del tempo, le frecce di un diagramma di flusso, il puntatore di una nota verso un luogo di una carta. Si colloca quando le cornici hanno già il loro riquadro definitivo, quindi segue un testo che cresce, un’edizione con parole più lunghe o un gruppo che sposta le sue cornici, e si disegna come linea vettoriale in ogni uscita, così il modello non ha bisogno di un’immagine delle linee. I connettori sono elementi della decoration di un modello di pagina o di un modulo; le testatine e la grafica dei titoli non hanno cornici da unire, e un connettore lì viene segnalato (unknownConfigValue) e non disegnato. Da postext 1.48.
decoration: {
elements: [
{ kind: 'connector', id: 'ramas', routing: 'tree', radius: { value: 2, unit: 'mm' },
width: { value: 1.25, unit: 'pt' }, from: { to: '#raiz' }, to: [{ to: '#a' }, { to: '#b' }], endCap: 'arrow' },
],
},| Proprietà | Tipo | Predefinito | Descrizione |
|---|---|---|---|
kind, id | 'connector', string | obbligatorio | L’elemento e il suo id, come per gli altri elementi della decorazione. |
from | ConnectorEnd | obbligatorio | Un’estremità della linea; il genitore di un albero. |
to | ConnectorEnd | ConnectorEnd[] | obbligatorio | L’altra estremità, o più d’una: una linea verso ciascuna, o i figli di un albero. '#card[*]' vale per tutte le schede di una griglia che si ripete presenti nella pagina. |
routing | 'straight' | 'elbow' | 'tree' | 'elbow' | 'straight': un segmento. 'elbow': di traverso, lungo e di nuovo di traverso fra lati affrontati, una L fra lati ad angolo retto. 'tree': un tronco da from fino a una barra, la barra attraverso i punti dei figli, una stanghetta verso ciascun figlio. |
trunk | number | 0.5 | Dove sta, fra le estremità, il tratto centrale di un gomito o la barra di un albero: 0 su from, 1 sul to più vicino. Un albero con trunk: 0 non disegna la barra: una stanghetta dal bordo del genitore verso ciascun figlio, come le tacche di una linea del tempo. |
radius | Dimension | 0 | Arrotonda le curve di un gomito o di un albero. |
color | ColorValue | il colore principale | Un colore legato alla tavolozza segue la palette del modello, quella del blocco di pagina e quella di una parte, come i filetti. Un colore con canale alfa (#rrggbbaa) dipinge la linea e i suoi segni in trasparenza e lascia vedere l’immagine che sta sotto (da postext 1.49). |
opacity | number | 1 | Quanto sono opachi la linea e i suoi segni, da 0 a 1, moltiplicato per l’alfa del colore stesso. Resta separata dal colore, così un colore legato alla tavolozza resta legato. Una linea bordata sono due connettori: uno largo e chiaro con opacity: 0.6 sotto uno tratteggiato. Da postext 1.49. |
width, dash | Dimension, Dimension[] | 0.75pt, continua | Lo spessore della linea, e uno schema di tratteggio (pieno, vuoto, …). |
startCap, endCap | 'none' | 'dot' | 'arrow' | 'ring' | 'bar' | 'none' | Un segno su from e su ogni to: un punto pieno centrato sull’estremità, o una punta di freccia il cui vertice è l’estremità. 'ring': un punto vuoto centrato sull’estremità, tracciato nello spessore della linea, che arriva fino al suo bordo; 'bar': un tratto di traverso all’estremità, dello spessore della linea (entrambi da postext 1.49). |
capSize | Dimension | 3 × width | La larghezza di un punto o di un anello, la lunghezza di una punta di freccia o di una barra. |
over | boolean | un connettore con un’estremità anchor si disegna sopra le cornici, gli altri sotto | Disegna la linea dopo tutte le cornici della pagina (true) o con la decorazione, sotto le cornici (false). Senza valore, un connettore con un’estremità anchor si disegna sopra, così una linea che punta dentro un’immagine si vede sopra la cornice dell’immagine; una linea fra cornici resta sotto. |
pin | boolean | false | Unisce i riquadri che dichiara il modello, non quelli che il contenuto ha dato alle cornici. |
parity, pages, when, unless | come gli altri elementi | 'all' | Quali pagine lo disegnano. |
Ogni estremità (ConnectorEnd) indica un riquadro e un punto su uno dei suoi lati:
| Campo | Tipo | Predefinito | Descrizione |
|---|---|---|---|
to | '#name' | obbligatorio | Una cornice, un gruppo, una scheda di una griglia che si ripete ('#foto[2]') o un altro elemento della decorazione. |
side | 'top' | 'bottom' | 'left' | 'right' | 'start' | 'end' | il lato rivolto verso l’altra estremità | Il lato da cui la linea lascia il riquadro o lo raggiunge. start ed end seguono la direzione delle righe della pagina. Se non è impostato, è il lato rivolto verso l’altro riquadro lungo lo spazio più ampio fra i due; i figli di un albero sono rivolti verso il genitore. |
at | 'start' | 'center' | 'end' | number | 'center' | Il punto lungo quel lato, o una frazione del lato a partire dal suo inizio (da 0 a 1). Un lato orizzontale comincia dove cominciano le righe della pagina, uno verticale in alto. |
gap | Dimension | 0 | Lo spazio fra il bordo del riquadro (o il punto dell’ancora) e la fine della linea. |
anchor | string | nessuna | Un’ancora dell’immagine contenuta nella cornice: l’estremità è quel punto dell’immagine, attraverso il suo ritaglio, la sua zona sicura e la sua scala, come per un’etichetta, invece di un punto del lato della cornice. at non viene letto; side dice da che parte arriva la linea (per impostazione predefinita, dall’altra estremità). |
Estremità che non ci sono. Un’estremità su una cornice che la pagina non mostra (ridotta a zero, facoltativa e vuota, una scheda oltre gli elementi della pagina, un punto dell’immagine che la sua cornice taglia fuori) viene tralasciata: un albero tiene gli altri figli, e il registro di reimpaginazione della pagina lo annota (connectorDropped). Se non resta un from o un to, non si disegna nulla.
Disegno. I connettori si disegnano come tracciati vettoriali: nel canvas, nel PDF, nel visualizzatore HTML e nell’EPUB a layout fisso, e come artefatto di impaginazione in un PDF taggato; l’EPUB a layout fluido li lascia fuori insieme al resto della decorazione. Un connettore con un’estremità anchor si disegna sopra tutte le cornici della pagina, così una linea che punta dentro un’immagine si vede sopra la cornice dell’immagine senza un layer; gli altri connettori restano con la decorazione, sotto le cornici. over: true porta sopra una linea fra cornici, over: false tiene sotto una linea che punta. In una doppia pagina un connettore fra cornici delle due pagine attraversa il dorso e viene tagliato lì come il resto della decorazione; in una pagina da destra a sinistra start ed end seguono il flusso specchiato.
frames: [
{ name: 'mapa', width: { value: 118, unit: 'mm' } },
{ name: 'nota', style: 'nota', width: { value: 44, unit: 'mm' } },
],
decoration: { elements: [
{ kind: 'connector', id: 'a-lago', from: { to: '#nota', side: 'end' },
to: { to: '#mapa', anchor: 'lago', gap: { value: 1.2, unit: 'mm' } }, endCap: 'dot' },
] },Controlli. Un’estremità il cui to non indica nulla è frameAnchorUnknown (in …/from/to o …/to/<k>/to) e viene tralasciata; [*] vale solo in to e su una cornice ripetuta. Un’anchor che nessuna immagine della cornice ha è labelAnchorUnknown, con l’id del connettore. Una parola fuori dalle scelte di routing, startCap, endCap o side, e un at fuori dall’intervallo da 0 a 1, sono unknownConfigValue. Un’opacity che non è un numero da 0 a 1 è anch’essa unknownConfigValue (un numero fuori dall’intervallo viene riportato al suo interno).
#Aspetti delle cornici
Una griglia di schede con foto le cui pastiglie differiscono solo per il colore, o una pagina di riquadri in una dozzina di tinte, tiene un solo stile di riquadro e un solo modello: i colori vanno in frameLooks, un elenco di aspetti con nome, e il Markdown ne indica uno su ogni pezzo che lo porta. Da postext 1.50.
frameLooks: [
{ id: 'rojo', name: 'Red pill', background: { hex: '#e63946', model: 'hex' }, body: { color: { hex: '#ffffff', model: 'hex' } } },
{ id: 'verde', background: { hex: '#6a994e', model: 'hex' } },
{ id: 'marino', border: { color: { hex: '#264653', model: 'hex' } } },
]| Campo | Descrizione |
|---|---|
id | Obbligatorio. La parola che un pezzo scrive in look="…". Quando due aspetti hanno lo stesso id, si usa il primo. |
name | Mostrato solo nella Sandbox. |
I campi del look di una cornice | background, border.color, stripe.color, icon.color, marker.color, marker.rule.color, titleStyle.color, body.color, body.boldColor, body.italicColor, body.letterSpacing, label.color, label.background, label.rule.color, con i nomi e l’annidamento del look della cornice (vedi Cornici). Un background attiva anche il riempimento dello stile; il colore di una linguetta vale solo per uno stile che ha una linguetta. |
- Dove si applica. Un pezzo
:::frame{slot="…" look="<id>"}porta l’aspetto. In una griglia, il pezzo principale dell’elemento e il:::frameannidato di un membro indicano ciascuno il proprio (vedi Pagine composte › Aspetti delle cornici). - Ordine. L’aspetto si posa sullo stile di riquadro della cornice e sul
lookproprio della cornice del modello, chiave per chiave: un aspetto che imposta solo il riempimento tiene il colore del testo del modello. Vale solo per quel pezzo. Lo portano anche le cornici in cui prosegue il suo testo (una catena, una pagina aggiunta per continuazione). - Tavolozze. Un colore legato a una voce della tavolozza segue la tavolozza come ogni colore della configurazione, quindi una tavolozza di parte o la
palettedi una pagina lo ricolora. - Verifiche. Una voce senza
idviene ignorata (unknownConfigValue), e una chiave che un aspetto non ha è ununknownConfigKeya qualsiasi profondità, con il nome più vicino. Un pezzo che indica un id che nessuna voce ha tiene i colori della sua cornice e producelookUnknown.
Nella Sandbox gli aspetti si modificano in Grafica › Riquadri › Aspetti delle cornici, che conta anche i pezzi che indicano ciascuno di essi, e il pulsante Aspetto della cornice dell’editor scrive look="…" sul pezzo in cui si trova il cursore.
#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 su un’ancora dell’immagine (un punto salvato con la risorsa, come i personaggi dei fumetti) e prende lo stile indicato dall’ancora o dall’etichetta. Nella Sandbox si modificano in Grafica › Figure e tabelle › Stili di etichetta (da postext 1.42). Rinominare lì uno stile riscrive le ancore e le righe ::label che lo nominano (da postext 1.43).
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' } } },
]| Proprietà | Tipo | Predefinito | Descrizione |
|---|---|---|---|
id | string | obbligatorio | Il nome che usano ancore ed etichette. |
name | string | l’id | Il nome mostrato nella Sandbox. |
paragraphStyle | string | nessuno | Uno stile di paragrafo da cui l’etichetta prende il carattere; i campi qui sotto lo sostituiscono. |
fontFamily, fontSize, fontWeight | string, Dimension, number | quelli del testo corrente | Il carattere dell’etichetta. |
fontStyle | 'normal' | 'italic' | 'normal' | Tondo o corsivo. |
color | ColorValue | colore del testo corrente | Il colore delle lettere. |
textTransform | 'none' | 'uppercase' | 'none' | Maiuscole, come le carte scrivono mari e paesi. |
letterSpacing | number | 0 | Spazio in più tra le lettere, in em. |
halo | { color, width } | nessuno | Un contorno dietro le lettere, perché si leggano su un’immagine carica di dettagli. |
background, padding | ColorValue, Dimension | nessuno | Una campitura dietro l’etichetta, e lo spazio attorno al suo testo. |
minScale | number | 0.85 | Quanto si può rimpicciolire un’etichetta che non entra nella sua larghezza. |
writingMode | 'horizontal-tb' | 'vertical-rl' | 'horizontal-tb' | Scrittura verticale per le etichette di questo stile: caratteri dritti in celle una sotto l’altra, colonne da destra a sinistra, come si scrive una mappa cinese o giapponese. Il writingMode proprio di un’ancora prevale. |
overlap | 'check' | 'allow' | 'check' | 'allow' esclude le etichette di questo stile dal controllo labelOverlap, per una carta i cui nomi si toccano nell’originale. L’overlap proprio di un’ancora ha la precedenza. Da postext 1.42. |
align | 'start' | 'center' | 'end' | come l’ancora colloca il riquadro | Come si allineano dentro il loro riquadro le righe di un’etichetta su più righe, start ed end nella direzione dell’etichetta. Se non è impostato, seguono l’align dell’ancora (centrate per impostazione predefinita); in una legenda, start. Da postext 1.48. |
border, radius | { color, width }, Dimension | nessuno | Una linea attorno alla piastra dell’etichetta (il suo riquadro allargato da padding), con o senza background, e gli angoli arrotondati della piastra: la legenda incorniciata di una carta. Da postext 1.48. |
kind | 'legend' | nessuno | La legenda di una carta: ogni riga dell’etichetta è una voce, e il simbolo (:icon) che apre una voce sta in una colonna larga quanto il più largo di essi, così le parole di tutte le voci partono dallo stesso bordo. Una voce senza simbolo resta com’è. Non nelle etichette verticali. Da postext 1.48. |
leader | { color?, opacity?, width?, dash?, startCap?, endCap?, capSize?, routing? } | nessuno | L’aspetto delle linee di richiamo delle etichette di questo stile: la linea dal riquadro di un’etichetta al punto della sua ancora. Per impostazione predefinita il colore è quello dell’etichetta, lo spessore 0.75pt, endCap: 'dot' sul punto, nessun startCap, capSize tre volte lo spessore, routing 'straight' (oppure 'elbow': esce dal riquadro ad angolo retto, poi una sola svolta verso il punto). Un’etichetta lontana dal suo punto (labelAt) in uno stile con leader ne riceve una. Da postext 1.48. startCap ed endCap accettano i segni del connettore, 'ring' e 'bar' compresi, e opacity (da 0 a 1) o un colore con canale alfa rendono la linea trasparente (da postext 1.49). |
Un’etichetta senza stile, o con uno stile che non fissa il carattere, prende famiglia, corpo, peso e colore del testo corrente. Le righe di un’etichetta su più righe distano 1,15 volte il suo corpo, o l’interlinea dello stile di paragrafo preso in prestito. Con paragraphStyle l’etichetta prende anche il corsivo e il maiuscolo di quello stile; fontStyle: 'italic' e textTransform: 'uppercase' li aggiungono a uno stile che non ne prende in prestito nessuno. Uno stile di etichetta che scrive fontStyle: 'normal' o textTransform: 'none' spegne il corsivo o il maiuscolo dello stile di paragrafo preso in prestito (da postext 1.40); se non lo scrive, valgono quelli dello stile di paragrafo. Un’etichetta ridotta per entrare mantiene l’alone in proporzione.
#Campi di etichetta di un’ancora
Le ancore di un’immagine (Resource.anchors, i punti che i fumetti usano per i personaggi) accettano alcuni campi facoltativi per le etichette. I valori sono frazioni dell’immagine, quindi valgono in ogni lingua e con qualunque ritaglio dell’immagine. I fumetti li ignorano.
| Campo | Tipo | Predefinito | Descrizione |
|---|---|---|---|
width | number | quella dell’etichetta | La giustezza dell’etichetta, come frazione della larghezza dell’immagine: un nome lungo va a capo su due righe al suo interno. |
align | 'start' | 'center' | 'end' | 'center' | Quale lato dell’etichetta sta sul punto dell’ancora. |
verticalAlign | 'top' | 'middle' | 'bottom' | 'middle' | Quale bordo dell’etichetta sta all’altezza dell’ancora. |
rotate | number | 0 | Gradi, in senso orario, attorno al punto dell’ancora: il nome di un fiume lungo il suo corso. |
style | string | nessuno | Un id di labelStyles. Un’etichetta che indica il proprio stile lo sostituisce. |
writingMode | 'horizontal-tb' | 'vertical-rl' | 'horizontal-tb' | 'vertical-rl' compone l’etichetta in verticale, come si scrive una mappa cinese o giapponese o un dorso. La sua width è allora una frazione dell’altezza dell’immagine, align corre lungo la colonna (start è l’alto) e verticalAlign attraverso le colonne (top è la prima, quella di destra). |
overlap | 'check' | 'allow' | 'check' | 'allow' dice che l’etichetta posta su questa ancora può toccare le vicine, come la stampa l’originale: labelOverlap non viene segnalato per una coppia di cui fa parte. Ha la precedenza sull’overlap dello stile. Da postext 1.42. |
gutter | 'keep' | 'cross' | 'keep' | Su una figura che attraversa il dorso di una doppia pagina, 'keep' sposta l’etichetta fuori dalla fascia del margine del dorso, dalla parte in cui cade il suo punto; 'cross' la lascia dove la mette il punto, come richiede un titolo disteso sulle due pagine. Da postext 1.43. |
labelAt | { x: number; y: number } | sul punto | Dove sta l’etichetta posta su questa ancora, lontano dal suo punto, in frazioni dell’immagine intera: un nome in mezzo al mare con una linea verso l’isola che nomina. align, verticalAlign e rotate collocano l’etichetta rispetto a questo punto; il punto proprio dell’ancora resta quello in cui finiscono le linee di richiamo e i connettori. Da postext 1.48. |
leader | boolean | LeaderStyle | vedi sotto | Una linea dal riquadro dell’etichetta al punto dell’ancora. true la disegna con l’aspetto leader dello stile di etichetta, un oggetto cambia quell’aspetto campo per campo, false non ne disegna nessuna. Se non è impostato, un’etichetta lontana dal suo punto ne riceve una quando il suo stile ha un leader. L’attributo leader di una ::label prevale. Da postext 1.48. |
start ed end seguono la direzione dell’etichetta: in un’etichetta araba start è il suo bordo destro. Un’ancora condivisa dalle edizioni da sinistra a destra e da destra a sinistra della stessa mappa si legge meglio con l’etichetta centrata sopra o sotto il punto. Un’etichetta con width va a capo tra le parole; una parola più larga della giustezza riduce tutta l’etichetta, fino al minScale del suo stile. Come vengono disegnate le etichette è spiegato in Pagine composte.
Una linea di richiamo lascia l’etichetta dal lato del suo riquadro (la piastra, altrimenti le righe) rivolto verso il punto lungo lo spazio più ampio, dal centro di quel lato, così la linea non attraversa mai le parole dell’etichetta, anche quando è ruotata. Un punto che cade sotto il riquadro dell’etichetta, o una linea più corta del suo segno finale, non disegna nulla. Le linee di richiamo si disegnano sotto le etichette, con l’immagine, in ogni uscita che disegna le etichette, e seguono l’immagine quando viene ritagliata, ridotta, specchiata o distesa su una doppia pagina.
anchors: [
{ id: 'peaks', x: 0.42, y: 0.8, labelAt: { x: 0.62, y: 0.6 }, style: 'name', leader: true },
{ id: 'lake', x: 0.531, y: 0.865, labelAt: { x: 0.76, y: 0.93 }, style: 'name', leader: { routing: 'elbow' } },
],#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, wrap, takes, kind, align, writingMode, direction, fontStyle, textTransform, overlap, rowAlign, il routing, le estremità e il side di un connettore, le estremità e il routing di una linea di richiamo) è 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. Gli aspetti delle cornici (frameLooks) si verificano allo stesso modo: un aspetto senza id viene ignorato, e una chiave che il look di una cornice non ha è un unknownConfigKey.
| Avviso | Causa | Rimedio |
|---|---|---|
templateDuplicate | Due modelli hanno lo stesso id. Si usa il primo e quello successivo viene ignorato. | Rinomina uno dei due, o elimina la copia. |
templateExtendsCycle | Seguendo extends si torna allo stesso modello (a → b → a). Tutti i modelli del ciclo, e tutti quelli che ne estendono uno, vengono scartati: nessuna pagina li può usare. | Togli l’extends di un modello del ciclo. |
templateExtendsUnknown | extends indica un id che nessun modello ha. Il modello si usa da solo, senza ereditare nulla. | Correggi l’id (l’avviso suggerisce quello più vicino), o aggiungi il modello genitore. |
frameDuplicate | Due cornici, o due gruppi, di uno stesso elenco hanno lo stesso name, oppure un gruppo ha il nome di una cornice. La voce successiva viene ignorata; un ancoraggio a quel nome legge la cornice. | Dai a ogni cornice e a ogni gruppo un nome proprio. Per cambiare una cornice ereditata, scrivi una sola voce con il suo nome. |
frameStyleUnknown | Lo style di una cornice non indica nessuno stile dei riquadri. La cornice si disegna senza riquadro. | Correggi l’id, o aggiungi lo stile a calloutStyles. |
frameAnchorUnknown | Una cornice, un gruppo o un elemento della decorazione è ancorato a '#name' e il modello non ha cornici, gruppi o elementi con quel nome; oppure cornici e gruppi sono ancorati l’uno all’altro in un ciclo (anche attraverso un gruppo senza un proprio ancoraggio, il cui riquadro è quello delle sue cornici). L’ancoraggio vale come 'container', l’area. Un’estremità di un connettore che non indica nulla viene segnalata allo stesso modo, e quell’estremità viene tralasciata. | Ancora a una cornice o a un gruppo che esiste, o rompi il ciclo ancorandone uno all’area. |
frameMinMax | Un minimo è maggiore del suo massimo (minHeight 40mm > maxHeight 30mm), oppure una width o una height fissa sta fuori dai limiti. Il minimo prevale, una dimensione fissa viene riportata tra i limiti, e used dice cosa prende la cornice. Le lunghezze in unità diverse si confrontano alla risoluzione della pagina, gli em al corpo del testo corrente. | Rendi il minimo non maggiore del massimo, o togli il limite che la dimensione fissa contraddice. |
groupFrameUnknown | Le frames di un gruppo elencano un nome che non è una cornice del modello (forse eliminata da un modello figlio o da una variante). Il gruppo lo salta. | Correggi il nome, o toglilo dall’elenco. |
groupFrameTwice | Una cornice è elencata in due gruppi, o due volte nello stesso. Una cornice appartiene a un solo gruppo: la voce successiva viene saltata. | Tieni la cornice nell’unico gruppo con cui si sposta. |
frameChainLoop | Le cornici continuano l’una nell’altra in un ciclo tramite next o overflow. (a → b → a). Il collegamento che chiude il ciclo viene scartato, quindi la catena finisce nella cornice che lo precede. | Chiudi la catena nella sua ultima cornice: togli il suo next, o falla continuare nella pagina successiva. |
overflowTargetUnknown | Un next non indica nessuna cornice del modello; un overflow.continueIn non indica nessuna cornice ('#x') o nessun modello ('template:x'), oppure non ha nessuna delle forme '#frame', 'next-page', 'template:<id>' e 'page:<id>'; oppure overflowTemplate non indica nessun modello. Il contenuto che non entra non prosegue lì. | Correggi il nome o l’id, o scrivi una delle quattro forme. |
labelStyleUnknown | Un’ancora di un’immagine indica uno style che labelStyles non ha. L’avviso cita la risorsa. Le etichette su quell’ancora prendono l’aspetto predefinito. | Correggi l’id dello stile nell’ancora, o aggiungi lo stile a labelStyles. |
Dai connettori in poi (postext 1.48) la versione della configurazione è la 16; i modelli di pagina l’avevano portata alla 15. I pacchetti scritti prima continuano a caricarsi senza modifiche: niente di ciò che dice una configurazione più vecchia cambia significato, e un lettore precedente ai connettori lascia fuori gli elementi della decorazione che non conosce, con un unknownConfigValue.
#Avvisi di sovrapposizione, ripetizione e moduli
Questi avvisi vengono dall’impaginazione o dal Markdown della pagina, non dal solo modello, quindi indicano una pagina. Li elencano postext check (--json ne riporta i campi come data), il pannello Verifiche della Sandbox e i contentWarnings del documento. Da postext 1.48, lookUnknown da postext 1.50.
| Avviso | Causa | Rimedio |
|---|---|---|
frameCovered | L’inchiostro di una cornice (le sue righe, la sua linguetta o il suo titolo, le sue immagini) sta sotto un’altra cornice disegnata sopra di essa: un layer più alto, o lo stesso livello ma più avanti nell’ordine del modello. Una cornice copre dove è opaca: il suo riempimento, la sua linguetta, le sue immagini, le sue righe; un contorno da solo non copre nulla, e le parole sopra un’immagine non vengono segnalate. Un avviso per coppia, con la cornice che copre (coveredBy), l’area nascosta (overlapMm2) e le prime parole o l’immagine coperte. Vedi Pagine composte › frameCovered. | Applica una proposta: il layer della cornice che copre sotto quello della cornice coperta, exclude: 'push' su di essa perché il testo le scorra attorno, o un move calcolato sulla pagina. Quando la sovrapposizione è voluta (un disegno sopra il testo), imposta overlap: 'allow' su una delle due cornici. |
frameOutsideArea | Una cornice esce da ciò che la contiene: il suo testo oltre il rifilo, il suo riempimento o le sue immagini oltre l’abbondanza, o una sua parte qualsiasi oltre la cornice o il gruppo dentro cui è ancorata (un ancoraggio a nove punti su '#name' il cui punto cade dentro quel riquadro). past dice quale, excessMm di quanto. Vedi Pagine composte › frameOutsideArea. | Applica una proposta: un maxHeight per la cornice, un minHeight per la cornice dentro cui è ancorata, overflow. con un’altezza minore, o un move. Un bollino appeso di proposito fuori dalla sua scheda prende overlap: 'allow'. |
repeatOverflow | Una griglia che ripete un insieme di cornici contiene repeat.max elementi e la pagina gliene dà di più. Uno per ogni elemento in più, sul suo slot="…": l’elemento va alla cornice di flusso (flowFrame), o dopo la pagina. | Alza max, toglilo, o sposta gli elementi in più su un’altra pagina. |
lookUnknown | Un pezzo :::frame scrive look="…" con un id che nessuna voce di frameLooks ha (vedi Aspetti delle cornici). La cornice tiene il suo stile e i colori del modello. Punta al valore dell’attributo e indica l’id più vicino (suggestion). | Correggi l’id sul pezzo, oppure aggiungi a frameLooks un aspetto con quell’id. |
moduleUnknown | Un :::module{template="…"} che la pagina non dispone: l’id non indica alcun modello (reason: 'unknown'), indica un modello che non è un modulo ('notModule'), oppure il modello della pagina non ha un gruppo di moduli ('noGroup'). Il suo contenuto va alla cornice di flusso. | Correggi l’id, dai al modello role: 'module', o aggiungi al modello della pagina un gruppo con modules: true. |
moduleAsPage | Un blocco di pagina indica un modello di modulo. Un modulo si dispone nel gruppo di moduli di una pagina, mai come pagina: il contenuto del blocco viene composto nel flusso, come per un modello sconosciuto. | Indica nel blocco un modello di pagina, e metti il modulo al suo interno come :::module. |
moduleNested | Un :::module dentro un altro modulo. Non è supportato: i suoi blocchi appartengono al modulo esterno. | Chiudi prima il modulo esterno, o disegna il blocco interno come cornici del modulo esterno. |
moduleNameRejected | Il name="…" di un modulo è già usato da un altro modulo della pagina (reason: 'taken') o contiene uno spazio, ., #, [ o ] ('invalid'). Il modulo prende invece il nome used (<template>[n]), e le sue cornici si indicano con quel nome. | Dai a ogni modulo della pagina un nome suo, fatto di lettere, cifre e trattini. |
connectorDropped (registro di reimpaginazione). Un connettore la cui estremità sta su una cornice che la pagina non mostra (ridotta a zero, facoltativa e vuota, una scheda oltre gli elementi della pagina, un punto dell’immagine che la sua cornice taglia fuori) tralascia quell’estremità. Non è un avviso: lo annota il registro di reimpaginazione della pagina, «connector ramas left out izq (not on the page)», così una pagina in cui è sparito un ramo si distingue da una disegnata come previsto. Per tenere l’estremità, dai un contenuto a quella cornice, oppure fai andare il connettore verso le cornici che la pagina ha.