Configurazione: pagina e impaginazione

#Pagina

La proprietà page controlla le dimensioni fisiche e l’aspetto della pagina.

#Margini speculari

I libri si leggono per doppie pagine, e il margine interno di solito è diverso da quello esterno. margins.mirror trasforma i quattro margini in margini a pagine affiancate:

{
  "page": {
    "margins": {
      "top": { "value": 2, "unit": "cm" },
      "bottom": { "value": 2.5, "unit": "cm" },
      "left": { "value": 2.2, "unit": "cm" },
      "right": { "value": 1.4, "unit": "cm" },
      "mirror": true
    }
  }
}

Con questa configurazione ogni pagina dispari ha un margine di 2,2 cm a sinistra (il dorso) e di 1,4 cm a destra (il taglio esterno); ogni pagina pari ha 1,4 cm a sinistra (il taglio esterno) e 2,2 cm a destra (il dorso). Ogni pagina impaginata porta il proprio contentArea sulla VDTPage, quindi tutto ciò che ne deriva (colonne, bande degli elementi flottanti a tutta larghezza, contenitori di intestazione e piè di pagina, e bande delle aperture span: 'page') segue automaticamente la geometria speculare. Le cornici della pagina e dell’abbondanza usate dagli elementi di progetto grafico ancorati a 'page' / 'bleed' non ne sono toccate: descrivono il foglio fisico, non i margini.

#Rilegatura

«Vertically set Chinese documents are bound on the right-hand side, and horizontally set documents are bound on the left-hand side» (clreq §7.1.1.1): i documenti cinesi composti in verticale si rilegano a destra, quelli in orizzontale a sinistra. page.binding: 'right' impagina un libro per il bordo destro:

• La pagina 1 resta dispari e resta il recto, quindi breakBefore.parity, :::pagebreak{parity}, gli elementi di progetto grafico con una parity e ogni conteggio di pagine mantengono il loro significato. Cambia il lato su cui sta il recto: la pagina sinistra della doppia pagina. Un capitolo che si apre su un nuovo recto si apre su una pagina sinistra (clreq §7.1.3.3).
• Con margins.mirror, left resta il margine interno, ma sono le pagine dispari a scambiarli: la pagina 1 ha il margine interno a destra, la pagina 2 a sinistra. Una colonna laterale oneAndHalf su 'outer' / 'inner', un elemento flottante ruotato addossato al dorso, i margini delle pagine di parte e le icone d’angolo dei riquadri su 'outer' / 'inner' seguono la stessa regola.
• Il documento lo dichiara (VDTDocument.binding: 'right'), così un host non deve mai leggere la configurazione: la Sandbox mostra le sue doppie pagine come [3 | 2] con la pagina 1 da sola a sinistra del dorso, e il suo visualizzatore HTML fa scorrere le pagine da destra a sinistra, aprendosi all’estremità destra, con la freccia sinistra che porta alla pagina successiva. renderToHtml in modalità multipla dispone la fila da destra a sinistra.
• Il PDF porta /ViewerPreferences << /Direction /R2L >> e /PageLayout /TwoPageRight (la pagina 1 da sola, poi a coppie), con o senza tag. Acrobat e Foxit li rispettano; il visualizzatore integrato di Chrome li ignora entrambi.

Folio e testatine non si spostano da soli: un modello che stampa il numero di pagina nell’angolo esterno ha bisogno che i suoi elementi per le pagine dispari e pari siano impostati per il bordo destro (gli elementi accettano una parity).

Anche un libro scritto da destra a sinistra (arabo, persiano, ebraico…) si rilega a destra: 'auto' dà il bordo destro quando la direction del documento si risolve in 'rtl'. Un libro del genere specchia anche l’intero flusso, quindi la sua prima colonna è quella di destra e i suoi rientri, i marcatori degli elenchi, gli elementi flottanti e le note stanno a destra; gli slot di intestazione e piè di pagina restano fisici. Vedi Impaginazione araba.

Anche un fumetto letto da destra a sinistra si rilega a destra: 'auto' dà il bordo destro quando la configurazione ha una sezione comics la cui direzione di lettura si risolve in 'rtl'. È il caso di un manga (comics.artDirection: 'rtl') e di un’edizione giapponese o in cinese tradizionale di un fumetto occidentale. La sezione decide per l’intero libro, non per i blocchi :::page di un capitolo. Vedi Fumetti.

#Formati di pagina predefiniti

I quattro formati da quotidiano sono nuovi in postext 1.18 e sono esclusi dal disegno: una pagina broadsheet ha un’area quasi quattro volte quella di una 21 × 28. Di solito si compongono con l’impaginazione 'multiple'; sei colonne sono frequenti in un broadsheet e cinque in un tabloid.

#Griglia della linea di base

La griglia della linea di base è il ritmo del testo del corpo: righe distanti un’interlinea del corpo l’una dall’altra, contate dalla cima dell’area del contenuto. L’impaginazione la usa che sia disegnata o no: titoli, fine degli elenchi, riquadri, figure e formule in display riportano il testo sulla griglia (a meno che il loro snapToGrid sia disattivato), così le righe delle colonne adiacenti restano allineate. enabled disegna soltanto le linee, nel canvas, nel PDF e nelle viste della Sandbox, per controllare quel ritmo; attivarlo o disattivarlo non sposta nulla. Le linee coprono solo il testo effettivo della pagina (dalla prima riga di testo all’ultima), quindi le bande degli elementi flottanti, le pagine bianche di parità e lo spazio inutilizzato in fondo non mostrano la griglia.

page: {
  baselineGrid: { enabled: true, color: { hex: '#e0e0e0', model: 'hex' } }
}

#Segni di taglio

Quando sono attivi, il canvas si allarga per includere un’area di abbondanza e il motore disegna i crocini a ogni angolo per la produzione di stampa. Il PDF assegna a ogni pagina un TrimBox e un BleedBox; un file PDF/X li ha anche senza segni di taglio. Nella Sandbox si impostano in Esporta › Preparazione per la stampa.

Il foglio cresce di bleed + markOffset + markLength su ogni lato, e la pagina rifilata sta al centro. Ogni angolo del rifilo riceve due crocini, lunghi markLength, ciascuno in linea con uno dei bordi che vi si incontrano. Un crocino comincia markOffset fuori dal rifilo, oppure al bordo dell’abbondanza quando bleed è il più ampio dei due, così nessun crocino si sovrappone a immagini che entrano nell’abbondanza. Con i valori predefiniti (3 mm di abbondanza, una distanza di 3 mm) i crocini vanno da 3 a 8 mm fuori dal rifilo, e una fascia bianca larga 3 mm corre attorno al foglio all’esterno di essi. cropMarkSegments(page, doc.config.page, doc.trimOffset) restituisce gli otto crocini di una pagina in pixel della pagina, quelli che disegnano i backend canvas e PDF. Il terzo argomento è la posizione del rifilo dentro il foglio, il valore da cui viene scritto il TrimBox del PDF; se omesso, viene calcolato da cutLines allo stesso modo.

Fuori dall’abbondanza non si stampa nulla tranne i crocini. Tutto ciò che la pagina dipinge, compresi gli elementi di progetto grafico ancorati a 'page' o 'bleed', viene ritagliato al riquadro dell’abbondanza sul canvas, nel PDF e nell’output HTML, come fa un’esportazione da software di impaginazione: una banda o un’immagine messe di proposito oltre l’abbondanza vengono tagliate al bordo dell’abbondanza, dove la taglierina le perderebbe comunque. Fino a postext 1.4 un elemento del genere proseguiva sopra i crocini fino al bordo del foglio.

Nel PDF (postext-pdf), il MediaBox di ogni pagina è l’intero foglio. La pagina porta anche un TrimBox, la pagina rifilata, e un BleedBox, il rifilo più l’abbondanza, che gli strumenti di imposizione e di controllo preliminare leggono. I crocini vengono dipinti in colore di registro, la separazione /All, così vengono stampati su ogni lastra. Questo vale qualunque sia lo spazio colore in cui è scritto il PDF (RGB, scala di grigi o CMYK): un nero semplice arriverebbe allo stampatore come nero ricco o come sola lastra del nero. color si applica solo al canvas.

#Numerazione

Il blocco page.pageNumbering controlla come vengono formattate le etichette di pagina e da dove parte il contatore. Definisce solo il valore predefinito per tutto il documento: per far ripartire la numerazione a metà documento (per esempio pagine preliminari in numeri romani che passano a capitoli in numeri decimali da 1), usa la direttiva :::numbering (vedi Formato del documento → Direttive).

L’etichetta calcolata viene memorizzata su ogni VDTPage come pageLabel ed è il valore in cui si risolve il segnaposto {pageNumber} di intestazione e piè di pagina. I PDF emettono un albero numerico /PageLabels, così l’indicatore di pagina e la navigazione «Vai alla pagina» di Anteprima / Acrobat corrispondono esattamente alle etichette stampate. Uno stile per cui il PDF non ha un codice (numeri cinesi, cifre cerchiate e a larghezza piena) viene scritto pagina per pagina, così il lettore mostra anche 一, 二, 三.

Grafie dei formati di numerazione

Tre impostazioni scelgono un formato di numerazione, e ognuna ha sviluppato la propria grafia: le etichette di pagina (page.pageNumbering.format e :::numbering{format=…}) dicono lower-roman, gli elenchi numerati (orderedLists.numberFormat) dicono arabic per il decimale, e i tipi di risorsa (counterFormat) dicono roman-lower. Ognuna di esse accetta tutte le grafie qui sotto, quindi un formato copiato da un’impostazione funziona nelle altre. I nomi non distinguono maiuscole e minuscole; le forme di un solo carattere sì (i e I sono diverse).

Gli stili dell’Asia orientale mantengono i loro nomi di CSS Counter Styles in tutte e tre le impostazioni. I numeri cinesi informali scrivono 十 per i valori da 10 a 19 senza un 一 iniziale (十二, ma 一百一十), un solo 零 per una sequenza di zeri all’interno del numero (一百零一, 一千零五十), e 万 o 萬 per diecimila, 亿 o 億 per cento milioni (一万零一十). Solo cjk-decimal usa 〇, cifra per cifra, come si scrivono gli anni (二〇二六, GB/T 15835—2011). I tronchi si fermano a 10, i rami a 12 e le cifre cerchiate a 50; oltre, il numero viene stampato in cifre. 一 e 壹 seguono la scrittura del locale del documento: tradizionale per zh-Hant, zh-TW o zh-HK, semplificata negli altri casi. Alcune edizioni più vecchie scrivono 101 come 一百一 senza 零; Postext non stampa questa forma.

Anche gli stili giapponesi (da postext 1.16) seguono CSS Counter Styles. japanese-informal scrive 十 senza un 一 iniziale e senza 零 per una posizione vuota (百一, 千十), e japanese-formal i 大字 壱 弐 参 拾 百 阡 con 壱 mantenuto davanti a ogni unità (壱拾, 壱百). Il CSS li ferma entrambi a 9 999; Postext prosegue in gruppi di quattro cifre con 万 億 兆 (formali 萬 億 兆), e ogni gruppo mantiene il suo 一 davanti a un’unità: 一万一 è 10 001, 一億一万 100 010 000. In un documento giapponese (ja, ja-JP…) 一 significa japanese-informal, quindi 第{1:一}章 stampa lì 第百一章 e 第一百零一章 in uno cinese; 壹 resta il numero formale cinese. Le serie di kana sono gli elenchi CSS: 48 kana in ordine gojūon (ゐ e ゑ compresi) e 47 nell’ordine della poesia iroha; dopo l’ultimo proseguono con due kana (ああ, いい), e non hanno lo zero, quindi una voce numerata 0 stampa 0. Le cifre kanji posizionali (二〇二六), la forma degli anni e dei folio, sono cjk-decimal.

Gli stili arabi mantengono i nomi CSS dove il CSS ne ha uno (arabic-indic, persian; urdu e maghrebi-abjad delle Ready-made Counter Styles del W3C vengono letti come persian e arabic-abjad-maghrebi). arabic mantiene il suo vecchio significato, le cifre europee. arabic-abjad scrive i numeri abjad additivi dell’arabo classico e della cartulazione dei manoscritti, dal valore più alto: 11 è يا, 1446 غتمو, e il conteggio delle migliaia precede غ (2000 بغ, 1002 غب); oltre 999 999 il numero viene stampato in cifre. La nota del W3C usa questo nome per una serie di 28 lettere in cui 11 è ك; Postext chiama quella serie abjad, la numerazione con lettere delle voci di elenco in ordine abjad (أ، ب، ج، د، هـ), e hijai l’ordine alfabetico (أ، ب، ت، ث). Entrambe scrivono la prima lettera con la sua hamza (أ), e una heh che starebbe da sola come هـ, con un tatweel, così nessuna delle due viene letta come le cifre ١ e ٥; oltre 28 si raddoppiano, come fa lower-alpha (أأ, أب). I valori magrebini seguono la formula mnemonica صعفض قرست ثخذ ظغش (ص 60, ض 90); l’elenco del W3C scambia ص e ض. Una sola أ non permette di distinguere le due serie di lettere, quindi i loro token sono le prime quattro lettere: {1:أبجد}, {1:أبتث}. Le cifre proprie di un documento si impostano con numerals.

Le altre grafie servono per configurazioni che nessuno controlla nei tipi: preset JSON e JavaScript semplice. I tipi TypeScript nominano ancora solo la grafia propria di ogni impostazione (quella che scrive la Sandbox e che restituisce resolveAllConfig, nomi dell’Asia orientale compresi), quindi un PostextConfig tipizzato vi si attiene, e un’altra grafia richiede un cast.

// JavaScript or a JSON preset (in TypeScript, each setting's own spelling)
orderedLists: { numberFormat: 'decimal' },          // same as 'arabic'
page: { pageNumbering: { format: 'roman-lower' } }, // same as 'lower-roman'
resourceTypes: [{ id: 'plate', counterFormat: 'upper-roman', … }], // same as 'roman-upper'

resolveAllConfig converte i formati degli elenchi e delle pagine nella grafia della rispettiva impostazione ('decimal' si risolve in 'arabic' in orderedLists, 'roman-lower' in 'lower-roman' in page.pageNumbering) e stripConfigDefaults elimina una grafia del valore predefinito. I pannelli della Sandbox mostrano ognuna delle tre impostazioni nella propria grafia, qualunque sia quella usata dalla configurazione. Qualsiasi altro valore (roman, 01, un refuso) numera in decimale invece di stampare undefined, e viene segnalato come avviso di configurazione. I modelli di numerazione dei titoli accettano gli stessi nomi dopo i due punti ({1:roman-upper} equivale a {1:I}), accanto al loro {1:01} con zeri iniziali.

#Impaginazione

La proprietà layout controlla come sono disposte le colonne all’interno dell’area del contenuto.

#Scrittura verticale

Con writingMode: 'vertical-rl' una pagina viene impaginata come una pagina orizzontale ruotata di un quarto di giro in senso orario. Il flusso viene composto in una cornice larga quanto il foglio è alto; le sue righe sono le colonne del testo verticale, lette a partire da destra, e tutto ciò che il motore fa con le righe (divisione, giustificazione, elementi flottanti, note a piè di pagina, regole per tenere unito) funziona in quella cornice. Quindi, sul foglio:

• Una colonna dell’impaginazione è un registro (栏): layoutType: 'double' dà due registri impilati dall’alto in basso, riempiti a partire dall’angolo in alto a destra; gutterWidth è lo spazio tra di essi e il filetto tra le colonne un filetto orizzontale tra di essi. I registri non vengono bilanciati alla fine di un capitolo (clreq §7.1.3.4): il bilanciamento delle colonne è disattivato in un documento verticale a meno che non sia impostato headings.balancing.enabled.
• Ciò che il flusso chiama «alto» è il bordo destro del foglio, dove comincia la lettura: un elemento flottante in alto sta a destra della pagina, uno in basso a sinistra, un’apertura a tutta larghezza è una banda lungo il bordo destro, le note a piè di pagina finiscono all’estremità sinistra di ogni registro. Un elemento di progetto grafico ancorato alla cima della pagina (il progetto grafico di un titolo, un riquadro fisso) è ancorato al bordo destro. sideColumnSide 'left' è il registro superiore, 'right' quello inferiore; 'outer' e 'inner' si leggono come 'right' e 'left'.
• I margini del flusso sono i margini del foglio ruotati: il margine destro è la cima del flusso, il margine superiore la sua sinistra. page.margins mantengono i loro nomi sul foglio.
• Testatine, folio, crocini e lo sfondo della pagina restano sul foglio, composti in orizzontale, come descrive clreq per i libri verticali.
• Figure e tabelle stanno diritte. Una figura occupa l’altezza del suo registro per quanto la didascalia lo consente, al massimo larga quanto la pagina; la larghezza che prende è lo spazio che usa nel flusso. La sua didascalia è composta in orizzontale sotto di essa, e così le celle di una tabella: entrambe vengono misurate come testo orizzontale. Una tabella è composta diritta attraverso la pagina, con le righe tagliate al registro quando è più alta. placement.align colloca una figura in cima ('left'), al centro o al piede del suo registro. Un placement.rotate non viene applicato dove la figura è richiamata per la prima volta in un testo verticale: la build segnala un avviso di contenuto rotateIgnoredVertical. Una sezione orizzontale del libro (uno stile di titolo il cui layout imposta 'horizontal-tb') ruota le sue figure come richiesto.
• Anche l’immagine di un progetto grafico (l’illustrazione di un’apertura, di una pagina di parte) sta diritta. Il suo riquadro nel flusso viene dimensionato con larghezza e altezza dell’immagine scambiate, quindi size.width è quanto l’immagine si estende lungo la colonna e la sua larghezza sul foglio deriva dalle sue proporzioni.
• Caratteri: Han, kana e forme a larghezza piena stanno diritti, un em ciascuno; le parole latine e i numeri sono ruotati di lato con le loro larghezze orizzontali; la punteggiatura prende la forma verticale del font. I segni di pausa e di punto non vengono mai ruotati: un font della Cina continentale compone 、。，． nell’angolo in alto a destra della cella e ！？：； nella sua metà destra, un font di Taiwan o di Hong Kong li centra (cjk.region). Le parentesi prendono le loro forme verticali, e “ ” ‘ ’ nel testo continentale si leggono come 『』「」. Trattini, puntini di sospensione e il trattino ondulato prendono la forma verticale del font dove esiste (Noto CJK associa quella di — a vert insieme a fwid: un filetto lungo il centro della cella), altrimenti vengono ruotati con l’inchiostro centrato sull’asse della colonna. Un 破折号 (——) nel testo cinese è un unico filetto lungo la colonna: le sue forme verticali lascerebbero bianco a entrambe le estremità di ogni cella, quindi ogni trattino viene ruotato con la riga e allungato come nel testo orizzontale (vedi Larghezze della punteggiatura). Un numero di al massimo due cifre sta in un’unica cella diritta, a meno che non si trovi in una frase latina, di cui segue le parole (vedi Numeri nel testo verticale). Il punto mediano (·) occupa mezza cella nel testo continentale e una cella intera nel testo di Taiwan e Hong Kong. I segni che Unicode compone diritti (× © ± § ℃ ① e simili) stanno in una cella propria, anche dentro un numero: 3×4 è 3 e 4 ruotati con × diritto tra di essi. Un apostrofo o un punto mediano tra due lettere di una parola latina (don’t, l·l) resta nella parola, ruotato. Un paragrafo latino in un flusso verticale segue le stesse regole. Formule in linea, chip e campioni di colore vengono ruotati di lato con la riga.
• Ogni carattere viene misurato come viene dipinto: una cella avanza di una cella lungo la riga, un tratto ruotato della sua larghezza orizzontale. Il testo che resta orizzontale sul foglio (testatine, folio, didascalie, celle di tabella) viene misurato in orizzontale.
• Le larghezze della punteggiatura, la punteggiatura sporgente e lo spazio tra Han e latino si applicano lungo la riga come si applicano attraverso di essa. Il bianco prima di un glifo sta sopra di esso e il bianco dopo sotto: un 、 Kaiming occupa mezza cella, 」「 si comprimono in una cella e mezza, una parentesi di apertura ridotta in testa a una riga comincia mezza cella più in alto, un 。 sporgente si colloca sotto il piede della sua riga, e lo spazio tra Han e latino è un quarto di em della colonna sopra e sotto una parola ruotata. ：；？！ mantengono una cella intera nel testo verticale in ogni regione.
• La griglia dei caratteri conta i caratteri lungo la riga e le righe attraverso la pagina: charsPerLine stabilisce quanto è lungo un registro, linesPerPage quante righe contiene una pagina, e layoutType: 'double' dà due registri di caratteri interi con un intercolonna di em interi tra di essi.

Per gli host che leggono l’impaginazione: una pagina verticale porta VDTPage.flow. Il suo contentArea, le colonne, i blocchi, le righe, gli elementi flottanti, le aree delle note, la banda dell’apertura e le sovrapposizioni di progetto grafico dei blocchi sono in coordinate di flusso; width, height, header e footer sono sul foglio. flowToPage, pageToFlow, flowRectToPage e pageRectToFlow convertono tra le due, e verticalOrientation(char, region) dice come sta un carattere. flow.centralBaselines dà, per ogni famiglia di font, l’asse su cui l’impaginazione ha centrato i caratteri diritti: il centro dell’inchiostro di 中, il cui tratto lungo copre l’altezza del riquadro dell’em (0,38 em sopra la linea di base in Noto Serif e Noto Sans, sia SC sia TC), e che ogni carattere cinese, giapponese e coreano possiede. Ogni riga è centrata su quell’asse: la linea di base di una riga verticale sta metà della sua interlinea più la linea di base centrale della famiglia sotto la cima del riquadro della riga (quella di una riga orizzontale sta a 0,8 della sua interlinea), così una colonna di caratteri sta al centro del suo passo e un filetto tracciato tra due colonne a un passo intero cade a metà tra di esse. Un testo di progetto grafico verticale viene composto allo stesso modo nelle proprie righe. Il canvas dipinge da sé una pagina verticale; per dipingere la punteggiatura con le forme verticali proprie del font, un host browser carica, una volta per famiglia, un carattere gemello con quelle forme attivate: loadVerticalAlternates(family, faces), dove faces sono le sorgenti della famiglia (URL o byte) e i descrittori. Il gemello viene mantenuto solo dove il browser applica la funzionalità al testo del canvas (Chrome 140 e successivi): disegna 「（《 con il gemello e con una copia degli stessi caratteri caricata senza la funzionalità, al peso e allo stile dei caratteri forniti, e mantiene il gemello quando il loro inchiostro differisce. Una chiamata successiva per altri caratteri di una famiglia il cui gemello è in uso (il grassetto dopo il normale) li aggiunge a esso. La Sandbox lo fa per ogni famiglia di un documento verticale. Senza un gemello, le parentesi vengono ruotate attorno al loro riquadro dell’em e i segni di pausa e di punto continentali spostati nella loro cella dove le forme verticali del font li metterebbero: 、。，． nell’angolo in alto a destra (entro 0,07 em dalle forme verticali di Noto Serif SC), ！？：； mezzo em a destra e un po’ più in alto (entro 0,02 em). Il PDF e l’HTML compongono la stessa pagina: vedi Testo verticale nel PDF e la tabella in Come l’output HTML differisce da canvas e PDF. Confrontato cella per cella con HarfBuzz (impaginazione verticale con vert) in Noto Serif TC e SC, ogni carattere di 「賈雨村」云云，宜乎？故曰！；：、。“引”‘單’…… sta entro 0,02 em da esso sul canvas e nel PDF, ed entro 0,05 em nell’HTML (Chrome centra un glifo ruotato sul punto medio tra ascendente e discendente del font, che in Noto sta 0,05 em sopra il centro del suo riquadro dell’em). flow.dashAdvances dà, per famiglia, l’avanzamento orizzontale in em di ogni trattino che la pagina allunga per riempire la sua cella (— – ― ⸺ ⸻ －), per un renderer senza metriche di font proprie: l’HTML allunga il trattino di quel valore, come fanno il canvas e il PDF a partire dalle loro. Anche testatine e folio possono essere composti in verticale: vedi Elementi di testo verticali.

#Filetto tra le colonne

Disegna una sottile linea verticale nell’intercolonna per separare visivamente le colonne.

Sotto un titolo a tutta larghezza (span: 'page') il filetto comincia dove comincia il testo delle colonne, sotto la banda del titolo, sia che la banda sia dipinta dall’apertura predefinita sia da un progetto grafico proprio. Fino a postext 1.4 partiva dalla cima del blocco di testo, attraversando la banda.

Uno stile di titolo può impostare un filetto proprio nel suo layout (vedi Stili dei titoli), e le pagine della sua sezione disegnano quello. Un campo che lo stile lascia non impostato prende il valore del documento, quindi una sezione che cambia solo le colonne mantiene il filetto del documento. Fino a postext 1.4 il filetto di uno stile non veniva mai disegnato: ogni pagina disegnava quello del documento.

#Tipi di impaginazione

• 'single': una colonna che occupa l’intera larghezza del contenuto. Ideale per pagine strette o per contenuti con molto testo e paragrafi lunghi.

• 'double': due colonne di uguale larghezza. La classica impaginazione editoriale: mantiene la giustezza nell’intervallo ottimale di 40–50 caratteri per una lettura comoda.

• 'oneAndHalf': un’impaginazione asimmetrica con una colonna principale e una colonna laterale più stretta. La colonna laterale (controllata da sideColumnPercent) è ideale per note a margine, piccole figure o contenuti di supporto. Valori tra il 25 e il 40% funzionano bene, e un canale stretto per i numeri di riga o i segni a margine occupa circa il 10–15%. La colonna laterale è il sideColumnPercent % della larghezza del contenuto e la colonna principale è ciò che resta dopo l’intercolonna, quindi al 50% la colonna laterale è più larga di quella principale di un intercolonna. Qualsiasi valore viene impaginato così com’è scritto finché entrambe le colonne mantengono almeno l’1% della larghezza del contenuto; uno che lascerebbe una delle due più stretta (0 o meno, o uno così ampio che la colonna principale sparisce dietro l’intercolonna) viene ricondotto al valore più vicino che le mantiene entrambe, e un valore che non è un numero prende quello predefinito, 33. I configWarnings del documento riportano allora { kind: 'sideColumnPercentClamped', path: 'layout.sideColumnPercent', value, used } (il percorso del layout proprio di uno stile di titolo nomina lo stile, come in headingStyles[2].layout.sideColumnPercent, e viene misurato sui margini di quello stile), che la Sandbox elenca nel suo pannello Verifiche; collectConfigWarnings(config) restituisce lo stesso elenco senza impaginare nulla. Un’impaginazione che non è 'oneAndHalf' non legge mai il valore, e non lo segnala mai. Con sideColumnRole: 'floats' il testo del corpo non entra mai nella colonna laterale: questa diventa un canale per le figure, le tabelle e i riquadri collocati con span: 'side'. Una figura o una tabella laterale si impila dalla testa del canale nella pagina che la cita per prima (la figura a margine di un manuale sta in cima alla sua pagina anche quando il testo la cita più in basso); una che non entra nel resto del canale aspetta quello della pagina successiva. Un riquadro laterale si impila accanto al testo che interrompe, e quando il resto del canale non può contenerlo lì sale fino alla posizione più bassa in cui entra ancora (con il piede sul piede del canale), oppure aspetta la pagina successiva. Quando il testo dopo il delimitatore di un riquadro prosegue nella pagina successiva (la colonna è piena, o le regole di interruzione spostano oltre quel testo), il riquadro resta al suo delimitatore, accanto al testo che lo precede; uno stile con sideAtColumnEnd: 'after' lo colloca invece all’altezza della prima riga del testo dopo il delimitatore, nel canale della pagina successiva, come richiedono i numeri di riga e i titoletti a margine scritti prima della loro riga. Anche un elemento del progetto grafico di un titolo che sta nel canale (un numero di capitolo ancorato nel margine esterno) viene tenuto libero dalla pila (vedi Altezza riservata). Gli elementi flottanti e i riquadri span: 'page' attraversano comunque entrambe le colonne, e un elemento flottante di colonna con placement.captionSide mette la sua didascalia nel canale, all’altezza della figura. In combinazione con margini speculari e sideColumnSide: 'outer', il canale sta sul bordo esterno di ogni pagina: la colonna a margine di un manuale. Da postext 1.28 anche una figura o una tabella composta nel testo (position: 'here') con captionSide mette la sua didascalia nel canale (inlineCaptionSide).

• 'multiple': da tre a otto colonne uguali, tante quante indica columnCount (predefinito 3): la griglia dei quotidiani e di molte riviste (da postext 1.18). Ogni colonna è larga (content width − (n − 1) × gutterWidth) / n. Il testo passa da una colonna all’altra come in un’impaginazione a due colonne; il filetto tra le colonne viene disegnato in ogni intercolonna, il bilanciamento delle colonne livella tutte le colonne nella pagina di chiusura di un capitolo e prima di un riquadro a tutta larghezza, le note a piè di pagina funzionano in ogni colonna, e figure, riquadri e titoli a tutta larghezza attraversano l’intera pagina. Una figura o un riquadro flottante può occupare solo alcune delle colonne: placement.columns (vedi Tipi di risorsa) e il columns di uno stile di riquadro. Un columnCount fuori da 3–8, o non intero, viene arrotondato e ricondotto al numero valido più vicino (un valore che non è un numero prende 3), e i configWarnings del documento riportano { kind: 'columnCountClamped', path: 'layout.columnCount', value, used } (il percorso del layout proprio di uno stile di titolo nomina lo stile, come in headingStyles[1].layout.columnCount). Un’impaginazione di un altro tipo non legge mai il valore. Uno stile di titolo il cui layout è 'multiple' prende il columnCount del documento a meno che non imposti il proprio, così un quotidiano composto in cinque colonne può impaginare le pagine dei commenti in quattro.

#Intestazioni e piè di pagina

Le proprietà header e footer controllano gli spazi di intestazione e piè di pagina di ogni pagina. Intestazioni e piè di pagina si disegnano dentro i margini esistenti della pagina: non riservano spazio aggiuntivo e non riducono l’area del contenuto.

Cornice del contenitore. Un elemento ancorato a 'container' si colloca nella fascia di margine tra il testo e il bordo di rifilo, per tutta la larghezza dell’area del contenuto. Il contenitore dell’intestazione va dal bordo superiore di rifilo fino alla sommità del testo; quello del piè di pagina dalla base del testo fino al bordo inferiore di rifilo. Quindi le ancore top-* dell’intestazione e bottom-* del piè di pagina misurano dal bordo di rifilo, mentre le ancore bottom-* dell’intestazione e top-* del piè di pagina misurano dal bordo del testo. Il contenitore non comprende mai l’abbondanza né la fascia dei segni di taglio, quindi un’intestazione o un piè di pagina cade nella stessa posizione sulla pagina rifilata sia con page.cutLines attivo sia disattivato. Ancora a 'page' (il formato rifilato) o a 'bleed' per andare oltre la larghezza dell’area del contenuto o dentro l’abbondanza.

Gli spazi usano il modello unificato degli spazi di progetto: ogni elemento ha un placement con un anchor (al contenitore o a un altro elemento tramite #id), un offset facoltativo e una size facoltativa. I vecchi campi piatti align, marginFromBody, marginFromEdge e width: 'full' sono ancora accettati in ingresso e vengono convertiti automaticamente nella nuova forma; la descrizione equivalente nella nuova forma è documentata più sotto.

Ogni spazio contiene un elenco di elementi text, rule e box. L’ordine dell’array è l’ordine di disegno (il primo elemento si disegna per primo, l’ultimo sopra tutti). Vale qualunque cosa dicano le ancore: un elemento può ancorarsi a uno elencato dopo di lui (anchor.to: '#ttl'), così un riquadro di sfondo può venire per primo ed essere comunque posizionato rispetto al testo che sta dietro.

Valori predefiniti incorporati. Quando header o footer è undefined, postext applica un valore predefinito incorporato ragionevole invece di uno spazio vuoto:

• Intestazione predefinita: {title} allineato a destra sulle pagine dispari, {chapterTitle} allineato a sinistra sulle pagine pari e un filetto a tutta larghezza, tutto nel colore principale della palette, Open Sans 8pt/600, marginFromBody 16pt (testo) / 13pt (filetto).
• Piè di pagina predefinito: {pageNumber} centrato su ogni pagina nel colore principale della palette, Open Sans 8pt/600, marginFromBody 16pt.

Per rinunciare ai valori predefiniti incorporati, imposta header: { elements: [] } (o footer: { elements: [] }). Un array elements vuoto ed esplicito viene conservato come «nessun elemento»: solo undefined attiva i valori predefiniti.

#Elementi di testo

Gli elementi di testo disegnano una stringa modello sostituendo i segnaposto. I segnaposto usano la sintassi {name}; {{ e }} producono parentesi graffe letterali.

I valori predefiniti della tabella qui sotto sono quelli di un elemento di testo che aggiungi tu. L’intestazione e il piè di pagina incorporati descritti più sopra in Valori predefiniti incorporati sono elementi già pronti con valori propri (Open Sans 8pt/600 nel colore principale della palette), non i valori predefiniti dell’elemento.

Segnaposto disponibili:

• {pageNumber}: numero della pagina corrente, a partire da 1.
• {totalPages}: numero totale di pagine del documento. In un libro impaginato capitolo per capitolo (la Sandbox, buildBundle) ogni capitolo è un documento, quindi questo è il conteggio del capitolo stesso.
• {bookTotalPages}: numero totale di pagine dell’intero libro: tutti i capitoli, pagine bianche comprese. Per un documento impaginato da solo è uguale a {totalPages}. Vedi Numero di pagine del libro più sotto.
• {title}, {subtitle}, {author}, {publishDate}: valori letti da content.metadata. I metadati sconosciuti o vuoti producono una stringa vuota (e generano un avviso nella Sandbox).
• {chapterTitle}: testo dell’H1 più recente sulla pagina corrente o prima di essa. Un H1 il cui stile di titolo imposta runningChapter: false (una tavola, una mappa) viene saltato.
• {chapterTitleAtTop}, {chapterNumberAtTop}: titolo e numero del capitolo in vigore in cima alla pagina, che differiscono da {chapterTitle} e {chapterNumber} su una pagina dove un nuovo capitolo inizia sotto altro testo. Vedi Il capitolo in cima alla pagina più sotto.
• {partTitle}, {partNumber}: titolo e numero della parte corrente (la pagina :::part più recente sulla pagina corrente o prima di essa; le pagine bianche di parità appena prima di una pagina di parte le appartengono già). Vuoti prima della prima parte.
• {firstMark.<key>}, {lastMark.<key>}: la prima e l’ultima parola guida della pagina: un titolo di un livello (h1–h6) o una voce di uno stile di paragrafo. Vedi Parole guida più sotto.

Numero di pagine del libro

{bookTotalPages} stampa il numero di pagine dell’intero libro, il conteggio che un lettore vede in «pagina 12 di 348». Conta le pagine fisiche, bianche comprese, come {totalPages}, ma su tutti i capitoli:

• Un documento impaginato da solo (buildDocument senza continuation) è l’intero libro: {bookTotalPages} è uguale a {totalPages}.
• buildBundle impagina il libro, somma le pagine di tutti i capitoli e lo impagina ancora una volta con quel totale, così ogni capitolo stampa lo stesso numero. Il conteggio non sposta mai un’interruzione di pagina, quindi basta un giro in più; una configurazione che non stampa {bookTotalPages} non costa nulla.
• La Sandbox passa il totale a ogni capitolo quando le pagine di tutti i capitoli sono note. Fino ad allora, un capitolo stampa le pagine fino alla propria fine. L’esportazione dell’intero libro della scheda PDF conta le pagine che impagina: quando un capitolo ha stampato un altro conteggio, perché le sue pagine non erano ancora note, impagina il libro ancora una volta con il conteggio a cui sono arrivati i capitoli.
• Un host che impagina i capitoli da sé passa il totale come continuation.bookPageCount (anche al primo capitolo). Senza di esso, {bookTotalPages} conta le pagine fino alla fine del documento (continuation.pageIndexOffset più le sue pagine), il che è corretto solo per l’ultimo capitolo.

footer: {
  elements: [{
    kind: 'text', id: 'folio', content: '{pageNumber} / {bookTotalPages}',
    fontSize: { value: 8, unit: 'pt' },
    placement: { anchor: { to: 'container', edge: 'top' }, size: { width: 'auto', height: 'auto' } },
  }],
}

configUsesPlaceholder(config, 'bookTotalPages') dice a un host se vale la pena calcolare il conteggio.

Parole guida: primo e ultimo segno

Un dizionario stampa nella testatina la prima e l’ultima voce di ogni pagina («Aback – Anchor»); un’opera di consultazione stampa la prima e l’ultima sezione. {firstMark.<key>} e {lastMark.<key>} le stampano. La chiave indica che cosa marca una pagina:

• Da h1 a h6: un titolo di quel livello. Il segno è il suo testo, senza il numero.
• L’id di uno stile di paragrafo (entry): un paragrafo di un contenitore :::paragraphs{style="entry"}. Il segno è la sequenza in grassetto con cui si apre il paragrafo, il lemma, senza la punteggiatura finale: **Aback.** Said of… marca Aback. Un paragrafo che non si apre con testo in grassetto non imposta alcun segno.

{firstMark.<key>} è il primo segno che inizia sulla pagina e {lastMark.<key>} l’ultimo. Una pagina su cui non inizia alcun segno (una voce lunga che continua) stampa per entrambi il segno in vigore, l’ultimo prima di essa. Le pagine prima del primo segno non stampano nulla; in un libro impaginato capitolo per capitolo si tratta del primo segno del capitolo, perché i segni non passano da un capitolo al successivo. Un titolo o un paragrafo diviso tra più pagine marca solo la pagina in cui inizia. La chiave si scrive dopo il punto con lettere, cifre, _ e -, cominciando con una lettera o con _; una chiave sconosciuta non stampa nulla.

:::paragraphs{style="entry"}
**Aback.** Said of the sails when pressed back against the mast.
 
**Abaft.** Towards the stern, or behind a given point.
:::

header: {
  elements: [{
    kind: 'text', id: 'guide', content: '{firstMark.entry} – {lastMark.entry}',
    fontSize: { value: 8, unit: 'pt' },
    placement: { anchor: { to: 'container', edge: 'bottom' }, size: { width: 'auto', height: 'auto' } },
  }],
}

Le parole guida sono testatine: si risolvono negli spazi di intestazione e piè di pagina (compresi header e footer di uno stile di titolo) e non stampano nulla nei progetti dei titoli, delle parti e del sommario; nei progetti dei titoli e delle parti il pannello Verifiche le segnala come segnaposto sconosciuti. Per mostrare il primo lemma sui verso e l’ultimo sui recto, crea due elementi con parity: 'even' e parity: 'odd'. Un H1 il cui stile di titolo imposta runningChapter: false non imposta alcun segno h1.

Il capitolo in cima alla pagina

{chapterTitle} e {chapterNumber} indicano l’ultimo capitolo iniziato sulla pagina o prima di essa. In un libro i cui capitoli si susseguono senza interruzione di pagina, una pagina che chiude un capitolo e inizia il successivo vicino al piede porta allora il titolo del nuovo capitolo sopra un testo che appartiene ancora al vecchio. {chapterTitleAtTop} e {chapterNumberAtTop} indicano invece il capitolo in vigore in cima alla pagina, come fanno i romanzi con capitoli consecutivi e molte opere di consultazione:

• una pagina il cui primo blocco è l’H1 di un capitolo indica quel capitolo;
• qualsiasi altra pagina indica il capitolo da cui prosegue, anche quando un nuovo capitolo inizia più in basso;
• una pagina bianca aggiunta per la parità va con la pagina che la segue, e il separatore delle modalità always-* con la pagina che lo precede (vedi Appartenenza delle pagine bianche); quando la pagina dopo una bianca di parità si apre con la fine di un capitolo e non con il suo H1, anche la bianca resta a quel capitolo;
• un H1 con runningChapter: false viene saltato.

header: {
  elements: [{
    kind: 'text', id: 'chapter', content: '{chapterTitleAtTop}', parity: 'odd', pages: 'body',
    fontSize: { value: 8, unit: 'pt' },
    placement: { anchor: { to: 'container', edge: 'bottom-right' }, size: { width: 'auto', height: 'auto' } },
  }],
}

Come le parole guida, entrambi sono testatine: si risolvono negli spazi di intestazione e piè di pagina e non stampano nulla nei progetti dei titoli, delle parti e del sommario. {attr.<key>} legge sempre l’ultimo capitolo iniziato.

Allineamento implicito dal bordo

Quando il placement.anchor.to di un elemento di testo fa riferimento a un altro elemento tramite #id, il bordo di ancoraggio implica un allineamento predefinito del testo per le righe spezzate:

• right-of e align-left implicano un testo align: 'left': le righe spezzate scorrono verso destra a partire dall’ancora.
• left-of e align-right implicano align: 'right': le righe spezzate aderiscono al lato più vicino all’elemento di riferimento.

L’editor dei titoli della Sandbox applica automaticamente questi allineamenti impliciti quando cambi il bordo o l’elemento di ancoraggio. Mantengono il testo su più righe visivamente ancorato all’elemento a cui si riferisce (così, per esempio, la «P» di un «Postext» spezzato si allinea verticalmente sotto la «I» di «Introduction»).

Segni in linea e contorni

Un elemento di testo compone il suo testo in un solo carattere per impostazione predefinita: **, ^ e gli altri marcatori Markdown si stampano come sono scritti. Con inlineMarks: true il testo risolto viene letto come Markdown in linea, con gli stessi segni che accetta il testo (vedi Formato del documento → Formattazione in linea):

• **bold** imposta il peso 700 (o il fontWeight dell’elemento stesso quando è più pesante); *italic* inverte l’inclinazione dell’elemento, così l’enfasi dentro un elemento in corsivo risulta in tondo; ***both*** fa entrambe le cose. Funzionano anche le forme con il trattino basso (__bold__, _italic_).
• ^superscript^ e ~subscript~ si compongono al 58% del corpo, l’apice alzato di un terzo del corpo e il pedice abbassato di 0,15; un pedice e un apice che si toccano (T~0~^2^) vengono impilati, come nel testo.
• Una barra rovesciata compone il carattere marcatore stesso (\*, \_, \^, \~). Un link conserva il suo testo; gli apici inversi del codice vengono eliminati.

I segni si leggono dopo che i segnaposto sono stati riempiti, quindi un valore può contenerli: una riga di autori in un attributo del titolo riceve i numeri di affiliazione come apici. L’a capo, la giustificazione, le modalità con puntini, dropCap e paragraphIndent funzionano tutti sul testo marcato; ogni sequenza conserva il colore dell’elemento.

{ "kind": "text", "id": "authors", "content": "{attr.authors}", "inlineMarks": true, "overflow": "wrap",
  "fontSize": { "value": 11, "unit": "pt" },
  "placement": { "anchor": { "to": "#title", "edge": "below" }, "offset": { "y": { "value": 6, "unit": "pt" } } } }

# Snow cover and river flow {authors="Ana Ruiz^1^, Luis Gil^2^ and Marta Sanz^1,3^"}

stroke traccia un contorno intorno alle lettere: width è lo spessore della linea, centrata sui bordi dei glifi (metà cade dentro le lettere, metà fuori; la larghezza misurata del testo non cambia), color vale per impostazione predefinita il colore del testo, e hollow: true lascia le lettere senza riempimento così che si veda solo il contorno: un numero da display a contorno, un titolo che si stacca da una fotografia. Il contorno si dipinge sopra il riempimento, allo stesso modo nel canvas, nell’HTML (-webkit-text-stroke) e nel PDF (modalità di rendering del testo 2, o 1 quando è vuoto).

{ "kind": "text", "id": "year", "content": "1863", "fontFamily": "Bitter", "fontSize": { "value": 120, "unit": "pt" }, "fontWeight": 700,
  "color": { "hex": "#1d3557", "model": "hex" },
  "stroke": { "width": { "value": 1.5, "unit": "pt" }, "hollow": true },
  "placement": { "anchor": { "to": "page", "edge": "bottom-right" }, "offset": { "x": { "value": -15, "unit": "mm" }, "y": { "value": -20, "unit": "mm" } } } }

Nel PDF le sequenze in grassetto e in corsivo incorporano i caratteri corrispondenti della famiglia dell’elemento, quindi il provider di font deve fornirli.

Valori predefiniti del testo e trappole dell’ancoraggio

Un elemento di testo che scrivi tu parte da questi valori, alcuni dei quali sorprendono:

• overflow segue lo spazio. Nel progetto di un titolo o in una pagina di parte un titolo lungo va a capo su più righe; in una testatina, in un folio o in una riga di parte del sommario un testo troppo largo per il suo spazio viene tagliato a una riga con …. Imposta overflow: 'wrap' su una testatina che può allungarsi (un indirizzo, una firma) e controlla gli avvisi designTextTruncated per i testi tagliati. Un a capo nel contenuto (un fine riga, o \n nel modello o nel valore di un attributo) inizia una nuova riga in ogni modalità; le modalità con puntini tagliano ogni riga per conto suo.
• align è 'center' e verticalAlign è 'middle'. Un elemento a larghezza automatica si adatta alla sua riga più lunga, quindi le sue righe sono centrate l’una rispetto all’altra; imposta align: 'left' per un blocco allineato a sinistra (un elemento a larghezza automatica ancorato a un altro elemento allinea da sé le righe sul lato della sua ancora, vedi sopra).
• Il carattere è EB Garamond 8 pt, nero, lineHeight 1.2, qualunque cosa usi il testo. A differenza delle altre interlinee della configurazione, il lineHeight di un testo di progetto è di solito un semplice multiplo (1.2); funziona anche una Dimension (vedi sopra).

Un elemento senza placement.size.width (o con 'auto') si dimensiona sul suo testo, ma solo entro lo spazio tra il suo punto di ancoraggio e il bordo del contenitore verso cui cresce: per un’ancora top o bottom, il doppio della distanza dal bordo più vicino. Il suo offset conta. Uno scostamento in direzione opposta a quel bordo non costa nulla: una testatina ancorata top-left con una x negativa (che sporge nel margine sinistro) non perde spazio, perché cresce verso destra. Uno scostamento verso quel bordo riduce lo spazio della stessa misura (il doppio per un’ancora top o bottom), e uno che spinge l’ancora oltre il bordo non ne lascia: un’ancora top-right la cui x è inferiore a meno la larghezza del contenitore, o un’ancora top spostata di lato di più di metà di quella larghezza. Senza spazio, una modalità con puntini non stampa nulla e 'wrap' impila un carattere per riga. Tre vie d’uscita:

• dai all’elemento una size.width fissa: le larghezze fisse non vengono mai limitate;
• ancoralo a 'page' o a 'bleed', così lo spazio è delimitato dalla pagina (o dall’abbondanza);
• ancoralo al bordo opposto del contenitore.

Il contenitore di un’intestazione va dal bordo superiore di rifilo fino al testo, e quello di un piè di pagina dal testo fino al bordo inferiore di rifilo: in un’intestazione le ancore top-* misurano dal bordo di rifilo e le ancore bottom-* dal testo, e viceversa in un piè di pagina (vedi Cornice del contenitore più sopra). Un’intestazione o un piè di pagina non sposta mai il testo e si dipinge sopra di esso, quindi un elemento spinto nell’area del testo copre il testo. Una fascia di apertura, invece, si dipinge sotto il testo; quanto spazio occupa nel flusso è descritto in Altezza riservata.

#Elementi di testo verticale

Un elemento di testo con writingMode: 'vertical-rl' si compone in verticale in uno spazio il cui testo è orizzontale: le testatine e i folio di qualsiasi libro, che restano sul foglio, e ogni progetto di una pagina orizzontale. Si impagina come un testo orizzontale nella propria cornice ruotata di un quarto di giro in senso orario, e poi riportata sulla pagina:

• Il suo riquadro resta dove lo mette la collocazione. La sua altezza è la lunghezza di una riga: la imposta size.height (o 'auto', la lunghezza del testo; 'fill', fino al bordo del contenitore), size.width imposta quante righe entrano in larghezza, e size.maxWidth limita la lunghezza di una riga.
• align colloca le righe lungo il riquadro ('left' in alto), verticalAlign attraverso di esso ('top' a destra, dove sta la prima riga), e il padding di un riquadro resta sul lato per cui è scritto.
• I caratteri si misurano e si dipingono come in una pagina verticale: gli Han diritti, un em ciascuno, la punteggiatura nella sua forma verticale, le parole latine di lato, i numeri brevi in una cella (cjk.uprightDigits). Il canvas, il PDF e l’HTML lo collocano nello stesso rettangolo.
• Con inlineMarks: true i segni di orientamento distinguono una sequenza come nel testo: 第:tcy[3.0]回 compone 3.0 in una cella, :upright[GDP] mette le lettere diritte una sotto l’altra, :sideways[…] ruota una sequenza; una riga non va mai a capo al loro interno. Un elemento orizzontale li ignora.
• Un capolettera non si compone su un elemento verticale.
• Nel flusso di una pagina verticale (un’apertura, una pagina di parte, il titolo di un riquadro) il testo scorre già verso il basso, e lì writingMode non cambia nulla.

I libri cinesi verticali mettono testatine e folio in uno di tre posti (clreq §7.2; JLREQ §2.6 per il giapponese):

Le testatine sul margine esterno, come le aggiunge la Sandbox (Intestazione › Testatine sul taglio (verticali)), qui per un testo a 10 pt (la Sandbox le imposta all’80% del corpo del testo):

{
  "page": { "pageNumbering": { "format": "trad-chinese-informal" } },
  "header": { "elements": [
    { "kind": "text", "id": "head", "content": "{chapterTitle}", "writingMode": "vertical-rl",
      "fontSize": { "value": 8, "unit": "pt" }, "overflow": "clip", "align": "left",
      "placement": { "anchor": { "to": "outer", "edge": "top" }, "offset": { "y": { "value": 4, "unit": "em" } } } },
    { "kind": "text", "id": "folio", "content": "{pageNumber}", "writingMode": "vertical-rl",
      "fontSize": { "value": 8, "unit": "pt" }, "overflow": "clip", "align": "left",
      "placement": { "anchor": { "to": "outer", "edge": "bottom" }, "offset": { "y": { "value": -5, "unit": "em" } } } }
  ] }
}

anchor.to: 'outer' (vedi Collocazione degli elementi) è il margine esterno di ogni pagina, quindi in un libro rilegato a destra (page.binding) i due elementi scendono lungo il bordo sinistro di un recto e il bordo destro di un verso. {pageNumber} si stampa nel formato di numerazione delle pagine: trad-chinese-informal dà 一百零三 a pagina 103, cjk-decimal 一〇三. Le regole di ciascuno spazio valgono ancora: pages: 'body' tiene una testatina lontana dalle aperture di capitolo. Un piccolo ornamento tra testatina e folio (una coda di pesce ︻, un filetto) è un elemento ordinario ancorato alla stessa cornice.

Nel VDT un blocco verticale porta vertical (VDTDesignTextBlock.vertical: la regione, le cifre diritte e l’asse centrale di ogni famiglia); le sue righe sono nella cornice ruotata del blocco stesso, xOffset verso il basso a partire dalla sommità del riquadro, baselineY verso sinistra a partire dal suo bordo destro. Una sequenza di una riga marcata porta tcy o orientation, come un segmento del testo.

#Elementi filetto

Gli elementi filetto disegnano una linea: orizzontale attraverso lo spazio, o verticale lungo di esso.

#Elementi riquadro

Gli elementi riquadro dipingono un rettangolo arrotondato dentro lo spazio: utile come fondale dietro il testo nelle aperture di capitolo, nelle colonne laterali o nei piè di pagina. Gli elementi riquadro si posizionano esclusivamente tramite il campo placement; non hanno la vecchia forma abbreviata piatta. Riempimento, tratto e raggio degli angoli stanno nell’oggetto annidato style (ElementBoxStyle), come nell’esempio JSON in «Collocazione degli elementi».

#Elementi immagine

Un elemento image disegna una risorsa bitmap o SVG del documento: il logo di un editore su un frontespizio, un marchio in una testatina. Si dimensiona con il suo placement.size: con uno tra width / height lasciato su 'auto' (il valore predefinito) l’altro lato segue le proporzioni dell’immagine; con entrambi impostati l’immagine viene adattata dentro il riquadro e centrata. Una risorsa mancante o che non è un’immagine non disegna nulla.

{
  kind: 'image', id: 'logo', resourceId: 'logo-publisher',
  placement: { anchor: { to: 'page', edge: 'top-left' }, offset: { x: { value: 64, unit: 'mm' }, y: { value: 233, unit: 'mm' } }, size: { width: { value: 83, unit: 'mm' }, height: 'auto' } },
}

resourceId accetta i segnaposto che accetta il content di un elemento di testo, così un unico progetto può disegnare un’immagine diversa per ogni titolo. Con resourceId: '{attr.vignette}' in uno stile di titolo, # Chapter I {style="opener" vignette="log"} disegna la risorsa log e # Chapter II {style="opener" vignette="wig"} disegna wig: i capitoli condividono lo stile invece di avere un clone per ogni immagine. Un’intestazione o un piè di pagina legge gli attributi del capitolo della pagina, come fa {attr.<key>} in una testatina, e funzionano anche gli altri segnaposto ('map-{chapterNumber}'). Un id che risulta vuoto, come un titolo senza l’attributo, non disegna nulla. Da postext 1.8.

Il backend PDF incorpora la risorsa come una figura (un SVG con un master di stampa usa quello); il visualizzatore HTML la risolve tramite resourceImageUrl.

Un’immagine disegnata da un progetto è contenuto quando la sua risorsa la descrive: l’altText della risorsa, altrimenti la sua didascalia come testo semplice (un chip letto attraverso la sua etichetta, un :ref attraverso il suo text quando ne ha uno), entra nel VDT (VDTDesignImageBlock.altText), diventa l’alt del suo <img> nell’HTML e una Figure con /Alt in un PDF con tag, letta subito dopo il testo del suo progetto (la tavola di un capitolo dopo il titolo del capitolo). Un’immagine la cui risorsa non ha né l’uno né l’altra, e una marcata decorative, è decorazione: alt="" con role="presentation", e un artefatto nel PDF. L’immagine di una testatina o di un piè di pagina si ripete su ogni pagina, quindi è un elemento d’arredo qualunque cosa dica la sua risorsa: nessun altText nel VDT, alt="" con role="presentation" nell’HTML, un artefatto della pagina nel PDF.

#Collocazione degli elementi

ElementPlacement è il modello di posizionamento unificato usato da ogni tipo di elemento (testo, filetto, riquadro) dentro qualsiasi spazio di progetto: intestazione della pagina, piè di pagina, o spazio del progetto avanzato di un livello di titolo. Tre informazioni descrivono una collocazione:

interface ElementPlacement {
  /** What this element anchors to and which edge of that target. */
  anchor: {
    to: 'container' | 'page' | 'bleed' | 'outer' | `#${string}`; // container = the slot; page = trim box; bleed = trim box + bleed; outer = the outer margin (header, footer); #id = another element
    edge: AnchorEdge;
  };
  /** Distance from the anchor point. */
  offset?: { x?: Dimension; y?: Dimension };
  /** Optional fixed width / height. Width also accepts 'fill' (span the slot).
   *  `maxWidth` caps an 'auto' width (text): the element still shrink-wraps its
   *  content, so elements anchored to it stay attached, but a long text wraps or
   *  ellipsizes there — a running head can reserve room for the label hanging
   *  off it instead of squeezing that label out. */
  size?: { width?: Dimension | 'fill' | 'auto'; height?: Dimension | 'fill' | 'auto'; maxWidth?: Dimension };
}

AnchorEdge accetta:

• Bordi del contenitore (quando anchor.to è 'container', 'page' o 'bleed'): top, top-left, top-right, bottom, bottom-left, bottom-right, left, right.
• Bordi relativi a un elemento (quando anchor.to === '#someId'): right-of, left-of, below, above, align-top, align-bottom, align-left, align-right.

Ogni bordo relativo a un elemento mette un angolo dell’elemento su un angolo dell’elemento a cui si ancora, e offset lo sposta da lì:

• right-of: il suo angolo in alto a sinistra sull’angolo in alto a destra dell’elemento di riferimento (accanto, con le sommità allineate); left-of: il suo angolo in alto a destra sull’angolo in alto a sinistra dell’elemento di riferimento;
• below: il suo angolo in alto a sinistra sull’angolo in basso a sinistra dell’elemento di riferimento (sotto, con i bordi sinistri allineati); above: il suo angolo in basso a sinistra sull’angolo in alto a sinistra dell’elemento di riferimento;
• align-top e align-left: il suo angolo in alto a sinistra sull’angolo in alto a sinistra dell’elemento di riferimento. I due nomi danno la stessa collocazione: si allineano sia i bordi superiori sia quelli sinistri;
• align-bottom: il suo angolo in basso a sinistra sull’angolo in basso a sinistra dell’elemento di riferimento;
• align-right: il suo angolo in alto a destra sull’angolo in alto a destra dell’elemento di riferimento.

Un bordo relativo a un elemento usato con 'container', 'page' o 'bleed', e un bordo del contenitore usato con '#id', vengono letti come l’angolo in alto a sinistra.

anchor.to: 'page' ancora l’elemento al formato rifilato (la pagina fisica dopo il taglio) e 'bleed' al formato rifilato allargato di cutLines.bleed su ogni lato (identico al formato rifilato finché i segni di taglio sono disattivati). Entrambe le cornici diventano anche il riferimento per size: 'fill' e per il limite automatico della larghezza, così una fascia colorata può andare da bordo a bordo indipendentemente dai margini della pagina:

{ "kind": "box", "id": "band", "placement": { "anchor": { "to": "bleed", "edge": "top-left" }, "size": { "width": "fill", "height": { "value": 6, "unit": "cm" } } }, "style": { "backgroundColor": { "hex": "#1d3557", "model": "hex" } } }

Con i segni di taglio attivi, tutto ciò che un elemento dipinge oltre il riquadro dell’abbondanza viene tagliato (vedi Segni di taglio).

anchor.to: 'outer' (spazi di intestazione e piè di pagina) ancora l’elemento al margine esterno della pagina: dal bordo della gabbia del testo al bordo di rifilo sul lato opposto al dorso, e dalla testa della gabbia del testo al suo piede. Sta a destra di un recto e a sinistra di un verso in un libro rilegato a sinistra, e al contrario in uno rilegato a destra (page.binding), così un solo elemento serve entrambe le pagine di una doppia pagina: una testatina lungo il margine esterno (vedi Elementi di testo verticale). In qualsiasi altro spazio vale come 'container'. L’offset di un elemento di testo si può scrivere in em, em del suo stesso fontSize: quattro caratteri sotto la testa della gabbia del testo è { "y": { "value": 4, "unit": "em" } }.

Dentro lo spazio del progetto avanzato di un titolo, gli elementi ancorati alla pagina e all’abbondanza non aumentano l’altezza riservata al titolo a meno che non si estendano sotto il bordo superiore del titolo (una fascia in cima alla pagina sta dietro l’apertura; una fascia che arriva sotto il titolo spinge in basso il testo). Usa advancedDesign.minHeight per riservare comunque un’altezza fissa all’apertura, e reserve: false su un elemento che non deve spingere affatto il testo. Le regole complete sono in Altezza riservata.

Ogni elemento ha un id stabile (assegnato automaticamente dalla Sandbox; puoi anche impostarlo a mano). Gli elementi ancorati ad altri elementi formano un piccolo grafo di dipendenze che il motore risolve prima di misurare, così un elemento può concatenarsi a un altro senza coordinate manuali.

La vecchia forma align + marginFromBody + marginFromEdge viene analizzata in ingresso e riscritta in una collocazione al momento della risoluzione della configurazione, così le configurazioni esistenti continuano a funzionare senza modifiche.