Capitolo 3.3 · Parte II · Il mestiere
Configurazione: testo corrente
La tipografia del testo corrente: font, corpo e interlinea, colori, rientri, citazioni in blocco, versi, tabulatori e capilettera
In breve
Questa pagina spiega le impostazioni del testo principale di un libro. Puoi scegliere il carattere, la grandezza delle lettere e lo spazio tra le righe, oltre ai colori delle parole in grassetto e in corsivo. Stabilisci anche il rientro della prima riga e lo spazio tra i paragrafi. La pagina tratta anche le citazioni staccate dal testo, le poesie, i tabulatori per il testo in colonne e la grande lettera iniziale con cui si aprono alcuni capitoli. Sillabazione, titoli ed elenchi hanno pagine a parte.
#Testo corrente
La proprietà bodyText controlla la tipografia di tutto il testo dei paragrafi.
| Proprietà | Tipo | Predefinito | Descrizione |
|---|---|---|---|
fontFamily | string | 'EB Garamond' | Famiglia di caratteri del testo corrente. Qualsiasi Google Font, font di sistema o famiglia personalizzata dichiarata in customFonts. Una sola famiglia, non un elenco di font CSS (font stack; vedi più sotto). |
figureStyle | FigureStyle | quelle del font | Le cifre del testo corrente: 'oldstyle' per la prosa di un libro. Gli stili di paragrafo, le tabelle, le didascalie, gli elenchi e il contenuto dei riquadri che prendono la famiglia del corpo del testo le prendono anche loro. Vedi Stili delle cifre. |
fontSize | Dimension | 8 pt | Corpo di base del testo corrente. |
lineHeight | Dimension | 1.5 em | Distanza verticale tra le righe. Le unità relative (em, rem) variano con il corpo. |
paragraphSpacing | boolean | Dimension | false | Lo spazio tra due paragrafi. true inserisce una riga vuota (pari a lineHeight), per una separazione di tipo editoriale; una misura come { value: 2, unit: 'mm' } o 0.33em del corpo del testo lascia esattamente quello spazio, nel testo corrente, nei riquadri e nelle cornici delle pagine composte. Una misura che non sia un numero intero di righe porta i paragrafi fuori dalla griglia di base; il blocco successivo che vi si allinea (un titolo, l’ultima voce di un elenco, una formula in display) riporta il testo sulla griglia. È lo stesso spazio di paragraphStyles[]., che lo sostituisce dentro un contenitore :::paragraphs. Un riquadro fissa il proprio in calloutStyles[].. |
snapTopToGrid | boolean | false | Fa iniziare ogni paragrafo del corpo e ogni citazione su una riga della griglia: lo spazio sopra viene arrotondato fino alla successiva, comunque sia finito il blocco precedente (un titolo fuori griglia, un riquadro o una figura con margini esatti). false lascia il paragrafo dove l’ha lasciato il blocco precedente. Un paragrafo in un contenitore :::paragraphs segue invece lo snapTopToGrid del suo stile, e i versi quello del loro stile di paragrafo, o questo quando non ne hanno. Per ritrovare la griglia solo sotto un titolo fuori griglia, usa il regainGrid del titolo. Nel Sandbox: Inizia i paragrafi su una riga della griglia. |
color | ColorValue | #000000 | Colore del testo. |
boldColor | ColorValue | Colore principale (#295AA3) | Colore del testo in grassetto (strong). Il valore predefinito rimanda alla voce main-color della tavolozza predefinita: se cambi quel colore nella tavolozza, cambiano tutti i grassetti del documento. |
italicColor | ColorValue | Colore principale (#295AA3) | Colore del testo in corsivo (enfasi). Come per boldColor, il valore predefinito è legato alla tavolozza. |
referenceColor | ColorValue | Colore principale (#295AA3) | Colore delle etichette :ref nel testo (rimandi alle risorse). Come per boldColor, il valore predefinito è legato alla tavolozza. Segue la tavolozza da postext 1.5; fino alla 1.4 restava #295AA3 qualunque fosse il colore principale. |
referenceBold | boolean | true | Compone in grassetto le etichette :ref nel testo. Un rimando conserva l’enfasi del testo che lo circonda (dentro ***…*** resta in grassetto corsivo con entrambi i valori); questa opzione si limita ad aggiungere il grassetto. |
referenceItalic | boolean | false | Compone in corsivo le etichette :ref nel testo. Un rimando dentro un testo in corsivo resta in corsivo con entrambi i valori. |
emphasis | 'auto' | 'italic' | 'bold' | 'color' | 'overline' | 'auto' | Come viene composto *…*: in corsivo, nel carattere grassetto con boldColor, in tondo con italicColor, o in tondo con un filetto sopra le parole. 'auto' vale 'bold' in un documento scritto in caratteri arabi e 'italic' in qualsiasi altro. Vedi Testo arabo. |
tashkil | 'keep' | 'strip' | 'strip-vowels' | 'keep' | Segni vocalici arabi: composti come sono scritti, tolti tutti, o tolti tranne la shadda. Vedi Testo arabo. |
textAlign | 'left' | 'justify' | 'center' | 'right' | 'start' | 'end' | 'justify' | Allineamento del testo. 'left' (o 'start') è il lato da cui comincia una riga: la destra di un paragrafo da destra a sinistra (vedi Direzione del testo). 'right' (o 'end') è il lato in cui finisce, e 'center' centra ogni riga. Il testo giustificato distribuisce lo spazio su ogni riga, così i margini risultano regolari. Le ultime righe dei paragrafi giustificati vengono composte in bandiera alla loro larghezza naturale, tranne quando Knuth-Plass ha accettato un’ultima riga troppo piena contando sulla compressione degli spazi: in quel caso gli spazi tra le parole si stringono in modo che la riga occupi esattamente la giustezza (la semantica di composizione della glue di TeX, applicata allo stesso modo nei backend canvas, HTML e PDF). |
fontWeight | number | 400 | Peso del testo normale (100–900). |
boldFontWeight | number | 700 | Peso del testo in grassetto/strong (100–900). |
hyphenation | HyphenationConfig | attiva, 'en-us' | Impostazioni della sillabazione automatica. Vedi più sotto. |
firstLineIndent | Dimension | 1.5em | Rientro applicato alla prima riga di ogni paragrafo (o a tutte le righe tranne la prima quando è attivo il rientro sporgente). |
hangingIndent | boolean | false | Se attivo, il rientro si applica a tutte le righe tranne la prima (rientro sporgente, alla francese). |
indentAfterHeading | boolean | true | Se impostato a false, il primo paragrafo subito dopo un titolo viene composto senza rientro della prima riga: una convenzione tipografica comune nelle pubblicazioni scientifiche e in molti stili librari. Lo stesso vale per un paragrafo subito dopo una riga :::space. Se tra i due c’è un riquadro collocato fuori dal testo (nella colonna laterale con span: 'side', flottante in testa o al piede di una pagina, oppure fisso) o una figura flottante, non se ne tiene conto: nella sua colonna il paragrafo segue comunque il titolo e si compone senza rientro. Un riquadro collocato nel testo (placement: 'here') conta, e il paragrafo che lo segue riceve il rientro. Non ha effetto quando hangingIndent è attivo. |
maxWordSpacing | number | 2 | Limite superiore della spaziatura tra le parole nel testo giustificato, espresso come moltiplicatore della larghezza normale dello spazio. Knuth-Plass tiene entro questo limite tutte le righe che il paragrafo permette, anzitutto sillabando una parola o distribuendo il gioco sulle righe vicine; una riga che nessuna combinazione di a capo riesce a tenere entro il limite lo supera, e se va oltre 3× lo spazio normale si compone in bandiera. Le righe che superano questo rapporto sono considerate «lasche»: vedi Righe che il motore non riesce a riempire, e maxJustifyTracking per concedere loro, invece, un po’ di tracking. |
minWordSpacing | number | 0.6 | Limite inferiore della spaziatura tra le parole nel testo giustificato, come moltiplicatore della larghezza normale dello spazio. Entrambi i limiti vincolano la variazione di ogni spazio rispetto alla sua larghezza, contata in spazi del carattere regular: una riga che contiene uno spazio in corsivo o in grassetto, più stretto o più largo di quello regular, viene disegnata qualche centesimo di spazio sotto o sopra il limite entro cui è stata divisa. lineWordSpacing(line) restituisce il valore a cui si applicano i limiti; vedi Giustificazione. |
maxJustifyTracking | number | 0 | Tracking massimo che una riga giustificata può ricevere, in millesimi di em in più o in meno (l’unità di InDesign: 10 = 0,01 em per carattere), quando i soli spazi tra le parole si allargherebbero oltre maxWordSpacing o si stringerebbero oltre minWordSpacing. La parte della correzione che eccede il limite passa nelle lettere, così gli spazi di una riga lasca tornano a maxWordSpacing e una riga stretta entra nella giustezza con minWordSpacing. Knuth-Plass ne tiene conto quando sceglie gli a capo, e solo per le righe che la sola spaziatura tra le parole porterebbe oltre i limiti: le altre righe non ne ricevono, e nemmeno l’ultima riga di un paragrafo (a meno che non sporga oltre la giustezza), una riga di una sola parola o una riga che contiene un chip. La riga lo registra come letterSpacing, e il canvas, l’HTML e il PDF lo disegnano. Richiede optimalLineBreaking. 0 lo disattiva. Vedi Il tracking come ultima risorsa. |
kashida | 'auto' | 'none' | 'auto' in un documento in scrittura araba, altrimenti 'none' | Giustificazione con kashida: una riga giustificata di testo in scrittura araba assorbe il gioco prima negli spazi tra le parole (fino a un quarto della loro larghezza) e poi nelle kashida, cioè tatweel interi (U+0640) inseriti tra due lettere legate, mai nella spaziatura tra le lettere. Knuth-Plass conta l’allungamento di ogni parola come elasticità. Mai nelle parole latine, nelle cifre, nei titoli, nelle righe in bandiera o nell’ultima riga di un paragrafo. I tatweel vengono disegnati ma restano fuori dal testo semplice e da quello copiato. Vedi La kashida nel testo arabo. |
kashidaPatterns | 'auto' | 'naskh' | 'simple' | 'nastaliq' | 'auto' | Quali raccordi ricevono una kashida, e in che ordine: le regole classiche del naskh, le priorità di Microsoft, o le regole del naskh adattate al nastaʿlīq (secondo raqim-kashida). 'auto' guarda il font del testo corrente: nessuna kashida in un carattere ruqʿa o dīwānī (Aref Ruqaa), regole nastaʿlīq in un carattere nastaʿlīq, naskh negli altri casi. |
kashidaPerWord | number | 1 | Numero massimo di allungamenti in una parola. |
kashidaMaxLength | number | 0.6 | Allungamento massimo in un raccordo, in em; si ottiene con tutti i tatweel interi che vi entrano. |
optimalLineBreaking | boolean | true | Usa la divisione in righe ottimale di Knuth-Plass invece di quella greedy, che riempie una riga alla volta. Produce una spaziatura tra le parole più uniforme in tutto il paragrafo. Un paragrafo cinese, giapponese o coreano (vedi Tipografia dell’Asia orientale), o uno con una parola più larga della colonna, viene comunque composto riga per riga; un paragrafo latino che cita qualche parola CJK la mantiene. Anche il testo in bandiera la usa con optimalRagged. Vedi Sillabazione e giustificazione. |
optimalRagged | boolean | true | Divide in righe con Knuth-Plass anche il testo in bandiera: testo corrente, citazioni e voci di elenco allineati a sinistra, a destra o al centro, gli stili di paragrafo in bandiera, il testo dei riquadri e quello delle parti e degli stili di sezione. Gli spazi tra le parole mantengono la loro larghezza. L’algoritmo valuta quanto ogni riga resta corta rispetto alla giustezza (una riga corta di 3 em costa quanto una riga giustificata a maxWordSpacing), così rende più regolare il margine in bandiera invece di riempire ogni riga prima di passare alla successiva, e le regole sulle righe finali troppo corte (avoidRunts, tightenRunts) e hyphenateAcrossColumns funzionano sul testo in bandiera come su quello giustificato. Con hyphenation.ragged è ancora la zona a decidere quali sillabe possono chiudere una riga (vedi Testo in bandiera). I titoli, le didascalie, le note, le celle di tabella e l’indice in bandiera vengono ancora composti riga per riga. Richiede optimalLineBreaking. false compone il testo in bandiera riga per riga, come fino a postext 1.4; le configurazioni salvate in precedenza che compongono in bandiera parte del testo corrente vengono lette con questo valore (vedi Pacchetti scritti da postext 1.4 o precedenti). |
breakAfterDashes | boolean | true | Consente a una riga di terminare dopo una lineetta lunga o media scritta senza spazi tra due parole: say—that’s, riddles.—I, Hamburg–Berlin, anche dove la parola dopo la lineetta è composta in un altro stile (see—*and*). Knuth-Plass la tratta come uno spazio tra parole, e la riga termina sulla lineetta senza aggiungere nulla. Mai dopo una lineetta che apre un inciso o una battuta di dialogo (—dijo, said "—Hola, sagte »—Ich: uno spazio, o uno spazio e una virgoletta, prima della lineetta; dopo una virgoletta che chiude una parola, come in "no"—and, nel tedesco „nein“—und o nel francese « non »—et, la riga può terminare), prima della punteggiatura (él—,), prima di una virgoletta o di una parentesi (thinking—" and, says—“no”, says—(no): una virgoletta dopo una lineetta chiude spesso la battuta che la lineetta ha interrotto), dentro una serie di lineette, o dentro un intervallo di numeri composto con una lineetta media (1914–1918). false mantiene gli a capo della 1.4: Knuth-Plass non va mai a capo dopo una lineetta, e l’algoritmo riga per riga del testo in bandiera formattato o sillabato va a capo solo tra due lettere; le configurazioni salvate in precedenza il cui testo contiene una lineetta del genere vengono lette con questo valore (vedi Pacchetti scritti da postext 1.4 o precedenti). Si applica al testo corrente, ai titoli, agli elenchi, alle citazioni e ai riquadri. Le didascalie, le note, le celle di tabella e l’indice mantengono gli a capo della 1.4, e un semplice paragrafo in bandiera composto riga per riga segue in ogni caso le regole proprie di pretext. |
breakAfterHyphens | boolean | true | Consente a una riga di terminare dopo il trattino di una parola composta, un trattino tra due lettere (well- · known, vencer- · se), in ogni paragrafo che Knuth-Plass divide in righe. La riga termina sul trattino e non si aggiunge nulla; l’a capo ha lo stesso costo di una sillabazione. Mai dopo un trattino accanto a una cifra o a un simbolo (COVID-19, -5 °C). Un paragrafo giustificato senza formattazione in linea va a capo lì solo con due lettere per lato del trattino, quindi nessuna riga termina sull’e- di e-mail. false mantiene gli a capo della 1.4: un paragrafo giustificato senza formattazione in linea non va mai a capo lì, mentre lo fanno lo stesso paragrafo con una parola in corsivo in qualsiasi punto, un paragrafo in bandiera e un paragrafo composto riga per riga; le configurazioni salvate in precedenza il cui testo contiene una parola composta vengono lette con questo valore (vedi Pacchetti scritti da postext 1.4 o precedenti). Si applica al testo corrente, ai titoli, agli elenchi, alle citazioni e ai riquadri. Vedi Parole composte. |
breakAfterSlashes | boolean | true | Consente che una riga di testo formattato termini dopo una barra tra due parole (entrata/ · uscita, ACC/ · AHA): ogni lato con almeno tre lettere o cifre di seguito, e non due cifre, così km/h, kg/m³, e/o, 1/2 e 10/03/2026 restano interi. La riga termina sulla barra e non si aggiunge nulla. Una parola più larga della sua riga viene divisa prima dopo una barra. Vale ovunque si componga testo formattato: il testo corrente, le didascalie, le celle, le note e le bibliografie; un paragrafo senza formattazione in linea va a capo dopo qualsiasi barra in entrambi i casi. false mantiene le divisioni di postext 1.51, dopo una barra solo dentro un indirizzo web; le configurazioni salvate prima di configVersion 19 vengono lette così (vedi Pacchetti scritti da postext 1.4 o precedenti). Vedi Come la sillabazione si integra con Knuth-Plass. |
repeatHyphen | boolean | false | Fa cominciare anche con un trattino la riga che segue un a capo sul trattino di una parola composta: vencer- · -se, come chiede l’ortografia portoghese, e léxico- · -semántico, come chiedono le regole della Real Academia Española dal 2010. Il trattino ripetuto viene misurato e disegnato con la sua riga, che lo registra come repeatedHyphen; i suoi plainStart e sourceStart puntano oltre il trattino, così i link, le testatine e la Sandbox leggono la parola così com’è scritta. Il PDF lo disegna sotto un /ActualText che lo esclude, quindi il testo copiato o estratto dal PDF riporta la parola con un solo trattino. Un indirizzo web non lo riceve mai. Si applica al testo corrente, ai titoli, agli elenchi, alle citazioni e ai riquadri; un paragrafo senza formattazione che contiene una parola composta viene allora diviso in righe dall’algoritmo che compone il testo formattato. |
stacks | 'allow' | 'warn' | 'avoid' | 'allow' | Ripetizioni: due righe di seguito di un paragrafo, nella stessa colonna, che finiscono con la stessa parola, o con gli stessi stackMinCharacters ultimi caratteri, spazi compresi (-mente / -mente, della / nella), o che cominciano con la stessa parola o gli stessi primi caratteri (di un / di una). 'allow' compone le righe come le trova l'algoritmo e non segnala nulla. 'warn' le compone allo stesso modo e segnala ogni ripetizione con un avviso di contenuto stack, che il Sandbox elenca in Revisione e segna sulla pagina. 'avoid' somma stackPenalty ai demeriti di ogni ripetizione, così l'algoritmo compone il paragrafo in altro modo dove la spaziatura tra le parole lo permette, e segnala le ripetizioni che tiene. Accenti e maiuscole non contano («sól» è «sol»). Le parole si confrontano solo nelle scritture che le separano con spazi: un testo cinese, giapponese, thai, lao, khmer, birmano o tibetano non ha ripetizioni. Una formula, un chip o un campione di colore al bordo di una riga non si confronta mai. Con 'avoid', didascalie, note e celle di tabella, giustificate o a bandiera, si dividono intere con Knuth–Plass per seguire la regola; la cornice di una pagina composta compone il suo testo senza. Richiede optimalLineBreaking. Nel port di un libro lasciala su 'allow' o usa 'warn' per le bozze: il port riproduce le divisioni dell'originale. |
stackMinCharacters | number | 3 | Caratteri, spazi compresi, che lo stesso bordo di due righe di seguito deve condividere perché ci sia ripetizione (stacks). La punteggiatura all'estremità non conta, e la stessa parola è sempre ripetizione. |
stackPenalty | number | 3000 | Quanto costa una ripetizione all'algoritmo con stacks: 'avoid', in demeriti sommati a quelli del paragrafo, sulla scala di consecutiveHyphenDemerit (due righe di seguito con il trattino costano 3000). Un monosillabo ripetuto («a», «e», «di», con le vocali delle scritture latina, greca e cirillica) costa il doppio. Un valore più alto evita più ripetizioni a prezzo di righe più larghe; 0 le tiene tutte. |
hardLineBreaks | boolean | true | Legge una barra rovesciata che chiude una riga della sorgente, e \\ prima di uno spazio, come un a capo forzato dentro un paragrafo, una citazione o una voce di elenco (l’a capo forzato di CommonMark): le parole successive cominciano una nuova riga dello stesso paragrafo, e la riga precedente si compone alla sua larghezza naturale, come un’ultima riga di paragrafo. Una barra rovesciata che chiude il paragrafo viene stampata, e due spazi alla fine di una riga non sono un a capo (vedi Formato del documento › A capo). false mantiene la lettura della 1.22: le barre rovesciate vengono stampate e le righe si uniscono con uno spazio; le configurazioni salvate in precedenza il cui testo contiene una barra rovesciata del genere vengono lette con questo valore (vedi Pacchetti scritti da postext 1.4 o precedenti). Titoli, didascalie, note e celle di tabella vanno a capo a \\ in ogni caso. |
justifyHardBreaks | boolean | false | Nel testo giustificato, giustifica la riga che precede un a capo forzato, come fanno i programmi di impaginazione: si compone a giustezza come le righe che spezza il motore, e solo l’ultima riga del paragrafo alla sua larghezza naturale. Un libro le cui righe sono state decise altrove (un’importazione che conserva gli a capo dell’originale, un adattamento che segue un’edizione a stampa riga per riga) si compone bene con questa impostazione. Una riga troppo corta per i suoi spazi resta a bandiera ed è segnalata, come ogni riga giustificata che il motore non ha potuto riempire; una riga con tabulazione mantiene le sue larghezze. Il testo a bandiera e il testo giustificato tra i caratteri (cinese, giapponese) si compongono come senza. Da postext 1.76. |
plusUnderline | boolean | false | Leggi ++testo++ come testo sottolineato, oltre a :underline[testo], che si legge sempre. Ogni coppia di due segni più per lato sottolinea, anche use ++i rather than i++; \+\+ scrive una coppia letterale, una lettera o una cifra attaccata ai segni li lascia come testo (C++, g++), e il codice in linea e i blocchi di codice non si sottolineano mai. Vale ovunque si leggano i segni in linea: il testo corrente, i titoli, gli elenchi, le didascalie, le celle di tabella, le note e i chip. false: i segni più si stampano. Vedi Formato del documento › Sottolineato. |
scriptContext | boolean | true | Esegue lo shaping di una parola senza lettere (46., 1367), ».: solo cifre, punteggiatura o simboli) nella scrittura del testo che la circonda. Un carattere può disegnare questi segni in base alla scrittura (Amiri usa punto e parentesi latini nel testo latino e arabi negli altri casi, con larghezze diverse), e un motore di shaping che riceve la parola da sola sceglie una scrittura con una regola propria, che cambia tra le versioni dei browser e nel PDF. Con questa opzione attiva, la parola prende la scrittura della lettera più vicina che la precede nel suo isolato (altrimenti di quella che la segue), della lettera da destra a sinistra più vicina quando viene disegnata da destra a sinistra, e della lingua del documento quando non ci sono lettere vicine; l’impaginazione la misura in quella scrittura, e il canvas, l’HTML, l’EPUB a layout fisso e il PDF disegnano quelle forme a quella larghezza. Agisce nei contesti latini, greci, cirillici, arabi ed ebraici, e solo con un carattere la cui punteggiatura o le cui cifre cambiano con la scrittura; una parola modellata in scrittura araba non riceve spaziatura tra lettere. Un pezzo senza lettere di una parola che ne ha (10.1006/ e .2001 di un DOI che va a capo nelle sue giunture) prende la scrittura che ha dentro la parola. In un documento cinese o giapponese un’ellissi o una lineetta doppia (……, ——) citata in una frase di un’altra scrittura mantiene le forme del testo han. I marcatori di elenco, le etichette dei rimandi, il testo grafico, il lettering dei fumetti e i paragrafi composti dal compositore CJK non vengono toccati. false esegue lo shaping di una parola del genere da sola, come fino a postext 1.27; una configurazione salvata prima di configVersion 12 viene letta con questo valore (pinLegacyScriptContext). Vedi Parole senza lettere. |
shapingLanguage | 'document' | 'host' | 'document' | La lingua con cui si esegue lo shaping del testo, cioè con cui il testo si misura, si disegna e si incorpora. Un font risponde con altri glifi a seconda della lingua (OpenType locl): Noto Serif SC compone le cifre in un altro modo in cinese, un carattere con una forma catalana disegna l·l in un altro modo, uno con la regola turca non lega le lettere di fi. 'document' (il valore predefinito da postext 1.30): quella del documento (locale, altrimenti la lingua della sillabazione; un documento che non ne indica nessuna è inglese, en-US, e uno il cui locale non è un tag di lingua viene modellato senza lingua) e, dove un tratto di testo indica una lingua propria, quella del tratto (:ltr[…]{lang=en}). L’impaginazione la imposta su ogni contesto con cui misura, quindi un documento va a capo nello stesso modo in una pagina di qualsiasi lingua e in un worker di impaginazione; il canvas disegna in quella lingua, il visualizzatore HTML e l’EPUB la dichiarano sul documento e su ogni pagina, e il PDF esegue lo shaping con il sistema di lingua OpenType di quella lingua. Da postext 1.30 il testo viene misurato in quella lingua così come viene disegnato. Una stringa ha un’unica larghezza qualunque cosa sia stata misurata prima: Chrome conserva le parole che ha già modellato, e Noto Serif SC compone 2026 largo 2,20 em in una stringa senza caratteri oltre U+00FF e 2,23 em in una che ne ha, quindi i due tipi di stringa vengono misurati su contesti separati. Una parola da destra a sinistra viene misurata da destra a sinistra in qualsiasi carattere. Una parola che l’algoritmo di divisione in righe può spezzare (in una sillaba o a un trattino) viene misurata intera e composta intera dove resta su una riga, sul canvas, nel visualizzatore HTML e nel PDF, in qualsiasi paragrafo (da postext 1.31: fino alla 1.30.1 un paragrafo senza formattazione misurava da solo ogni pezzo di una parola del genere, quindi ciò che un carattere disegna a cavallo di un punto di sillabazione, la ff di of·fice in EB Garamond o il punto largo catalano di Crimson Pro in l·l, compariva in una parola di un paragrafo con un corsivo e non nella stessa parola di un paragrafo semplice). Con 'host' un paragrafo senza formattazione misura ancora da solo ogni pezzo di una parola del genere. Quando una parola si divide a fine riga, ogni parte si misura così come viene disegnata: la parte che apre la riga successiva come un testo a sé, e la prima parte di un col·lecció catalano come col-. Un testo grafico (una testatina, un’apertura, la grafica di un titolo) viene misurato tratto per tratto, ogni tratto nella direzione in cui viene disegnato. Il PDF esegue lo shaping parola per parola come fa il canvas del browser (una parola termina a uno spazio, a una tabulazione, a U+3000 o a U+200B, e prima di un carattere han), compone uno alla volta i caratteri cinesi e giapponesi che l’impaginazione ha misurato così, e prende ogni carattere dal file del font da cui l’ha preso il browser quando il fornitore di font lo indica (vedi Font cinesi, giapponesi e coreani). 'host': come fino a postext 1.28, l’impaginazione misura nella lingua della pagina che la ospita (nessuna in un worker) e il canvas disegna in quella stessa lingua; il visualizzatore HTML dichiara la lingua di un documento cinese, giapponese, coreano o da destra a sinistra. Un documento con 'host' conserva le larghezze e il PDF che aveva; in un paragrafo con formattazione anche il suo canvas e il suo visualizzatore HTML compongono intera una parola che resta su una riga (fino a postext 1.29.2 la disegnavano a pezzi). Con questo valore la parte di una parola divisa che apre la riga successiva viene misurata come la parola intera meno la sua prima parte, quindi un carattere la cui forma per la lingua ha bisogno delle lettere ai due lati dell’a capo (la l·l catalana di Crimson Pro, un punto largo composto solo tra due l) lascia un vuoto dopo il resto della parola, un terzo di em in quel carattere, in una pagina in quella lingua. Il valore predefinito era 'document' solo in postext 1.29.0, il cui canvas e il cui PDF non seguivano la misura, 'host' nella 1.29.1 e nella 1.29.2, e di nuovo 'document' dalla 1.30.0. Una configurazione salvata prima di configVersion 14 che non indica l’impostazione riceve 'host' scritto esplicitamente (pinLegacyShapingLanguage), così un documento salvato conserva le sue righe; una che indica un valore lo conserva. Un browser il cui canvas non ha lang (Chrome prima della 136, e Firefox e Safari dove manca) non riceve nessuna lingua e conserva le forme che ha sempre misurato, e la riga di comando impagina sempre con 'host' (vedi Differenze rispetto alla Sandbox). |
tabStops | TabStop[] | non impostato | Tabulatori di ogni paragrafo, voce di elenco e citazione: indicano dove una tabulazione (:tab, o un carattere di tabulazione nel testo) manda le parole che la seguono. Se uno stile di paragrafo o il testo di un riquadro ne impostano di propri, questi li sostituiscono. Se non sono impostati, un carattere di tabulazione è uno spazio tra parole, come prima, e lo è anche un :tab senza un tabulatore a cui andare. Vedi Tabulatori. Da postext 1.23. |
tabInterval | Dimension | non impostato | Tabulatori predefiniti, a intervalli regolari di questa misura dall’inizio della giustezza, dopo l’ultimo di tabStops. Se non è impostato, una tabulazione oltre l’ultimo tabulatore è uno spazio tra parole. Da postext 1.23. |
blockquote | BlockquoteConfig | vedi più sotto | Come vengono composte le citazioni Markdown (> …): colore, corsivo e rientri. Vedi Citazioni in blocco. |
verse | VerseConfig | vedi più sotto | Come vengono composte le poesie :::verse disposte verso per verso: rientri, versi troppo lunghi che vanno a capo, spazio tra le strofe e strofe tenute intere. Vedi Versi. |
#Citazioni in blocco
Una citazione (righe che cominciano con >) prende la famiglia, il corpo, l’interlinea, i pesi, l’allineamento e la sillabazione del testo corrente. bodyText.blockquote imposta il resto; se non è impostato, una citazione ha l’aspetto che aveva fino a postext 1.4: grigia, in corsivo, con il rientro della prima riga del testo corrente e senza rientro laterale.
| Proprietà | Tipo | Predefinito | Descrizione |
|---|---|---|---|
color | ColorValue | #666666 | Colore del testo. Un colore legato a una voce della tavolozza (paletteId) segue quella voce, come ovunque; i colori del grassetto, del corsivo e dei rimandi del testo corrente non si applicano dentro una citazione. |
italic | boolean | true | Compone il testo in corsivo. Un tratto *…* al suo interno torna in tondo; con false è in corsivo come in un paragrafo. |
indent | Dimension | 0 | Rientro di ogni riga dal bordo sinistro della colonna o del riquadro. La giustezza si restringe di altrettanto, quindi le righe giustificate terminano al bordo destro. em è il corpo del testo corrente. |
firstLineIndent | Dimension | quello del testo corrente | Rientro della prima riga di ogni paragrafo citato, contato da indent (con l’hangingIndent del testo corrente, il rientro di tutte le righe tranne la prima). Se non è impostato: bodyText.firstLineIndent. |
bodyText: {
firstLineIndent: { value: 1.5, unit: 'em' },
// Upright verse in the body colour, set in by 2 em, no first-line indent.
blockquote: { color: { hex: '#241f26', model: 'hex' }, italic: false, indent: { value: 2, unit: 'em' }, firstLineIndent: { value: 0, unit: 'em' } },
}Nella Sandbox queste impostazioni formano il gruppo Citazioni della sezione Testo corrente.
#Versi
Una poesia :::verse le cui righe non contengono un separatore di emistichi viene composta riga per riga (vedi Formato del documento › :::verse). bodyText.verse dà i valori predefiniti di queste poesie; un attributo con lo stesso nome nella riga di apertura di una poesia vale solo per quella poesia.
| Proprietà | Tipo | Predefinito | Descrizione |
|---|---|---|---|
layout | 'auto' | 'bayt' | 'auto' | Come si compone una poesia che nella riga di apertura non indica un layout. 'auto': in bayt (versi di due emistichi) quando una riga contiene un separatore (||), riga per riga negli altri casi. 'bayt': sempre in bayt, e una poesia senza separatore in emistichi singoli centrati, come fino a postext 1.22. |
indentStep | Dimension | 0.5em | Larghezza di uno spazio iniziale di un verso (una tabulazione ne vale quattro, uno spazio ideografico due); em è il corpo della poesia. |
turnover | 'hang' | 'right' | 'hang' | Come va a capo un verso più largo della giustezza: con rientro sporgente sulla riga successiva, o allineato alla fine della giustezza dopo turnoverMark. |
hang | Dimension | 2em | Rientro del seguito sporgente di un verso, misurato dall’inizio della sua riga, quando lo stile di paragrafo della poesia non imposta un hangingIndent. |
turnoverMark | string | '[' | Il segno che precede un seguito allineato a destra. |
stanzaSpace | number | 1 | Spazio tra le strofe, espresso in righe dell’interlinea della poesia. Sulla griglia della linea di base si arrotonda a righe intere della griglia; uno stile di paragrafo con snapToGrid: false lo mantiene esatto. |
keepStanzas | number | 0 | Tiene intera in una colonna ogni strofa che non supera questo numero di versi. 0 disattiva l’opzione. |
tighten | boolean | true | Stringe gli spazi tra le parole di un verso poco più largo della giustezza, fino a bodyText.minWordSpacing della loro larghezza naturale, e lo tiene su una riga; va a capo solo un verso ancora troppo largo. Per questo non si aggiunge mai tracking alle lettere. false manda a capo ogni verso più largo della giustezza, come faceva postext 1.23. Nell’EPUB a layout fluido, dove è il sistema di lettura a dividere le righe, gli spazi non si stringono. |
bodyText: {
// Turnovers flush right behind a bracket; tankas kept whole.
verse: { turnover: 'right', keepStanzas: 5 },
}Una configurazione salvata prima di queste impostazioni (configVersion 8 o precedente) che impagina una poesia senza separatore viene letta con layout: 'bayt', così la poesia conserva le righe centrate che le dava postext 1.22. Una salvata da postext 1.23 (configVersion 9) che impagina una poesia riga per riga viene letta con tighten: false, così i suoi versi vanno a capo dove andavano nella 1.23.
Nella Sandbox queste impostazioni formano il gruppo Versi della sezione Testo corrente.
#Tabulatori
bodyText.tabStops elenca i tabulatori (i punti di tabulazione) a cui va una tabulazione: :tab, o un carattere di tabulazione in un paragrafo che ha tabulatori (vedi Formato del documento › Tabulazioni e tabulatori per il markup e per come viene composta una riga). I tabStops di uno stile di paragrafo li sostituiscono per i suoi paragrafi, e il body.tabStops di uno stile di riquadro dentro i suoi riquadri; un elenco vuoto non ne imposta nessuno. Ogni tabulatore è un TabStop:
bodyText: {
tabStops: [
{ position: { value: 30, unit: 'mm' } },
{ position: 'end', align: 'end', leader: '.', leaderGap: { value: 2, unit: 'pt' } },
],
tabInterval: { value: 10, unit: 'mm' },
}| Proprietà | Tipo | Predefinito | Descrizione |
|---|---|---|---|
position | Dimension | 'end' | `${number}%` | obbligatorio | Dove si trova il tabulatore, dal bordo d’inizio della giustezza del paragrafo (dopo l’indent di uno stile di paragrafo; em è il corpo proprio del paragrafo): una lunghezza, 'end' per il bordo finale della giustezza, o una percentuale della giustezza ('50%'). Nel testo da destra a sinistra il bordo d’inizio è quello destro. |
align | 'start' | 'end' | 'center' | 'decimal' | 'start' | Come si colloca sul tabulatore il testo dopo la tabulazione: comincia lì, finisce lì (il testo fino alla tabulazione successiva o alla fine del paragrafo), è centrato sul tabulatore, o vi allinea il separatore decimale (un tratto di testo che non ne ha finisce lì). |
leader | string | nessuno | Testo (linea guida) ripetuto nello spazio che precede il tabulatore: '.', '. ', '·', '_', '-' o qualsiasi testo breve, nel carattere e nel colore del paragrafo; 'rule' traccia una linea poco sotto la linea di base. La linea guida termina allineata alla fine del suo spazio, così le linee guida di più righe si allineano. Viene misurata come un unico tratto, come quella di una riga dell’indice. |
leaderGap | Dimension | 0.5em | Spazio lasciato tra la linea guida e il testo da entrambi i lati, come il leader.gap dell’indice. Nessuno prima della linea guida quando la tabulazione apre la riga, nessuno dopo quando non segue nulla. |
decimalChar | string | quello della lingua del documento | Il separatore su cui si allinea un tabulatore 'decimal': . in inglese, cinese, giapponese e arabo, , in spagnolo, catalano, portoghese, francese, tedesco e altre lingue. |
tabInterval aggiunge tabulatori a intervalli regolari dall’inizio della giustezza, dopo l’ultimo tabulatore dell’elenco; se manca, una tabulazione oltre l’ultimo tabulatore è uno spazio tra parole. Un carattere di tabulazione digitato nel testo è una tabulazione solo in un paragrafo il cui stile ha tabulatori o un intervallo, propri o del testo corrente; altrove resta lo spazio tra parole che è sempre stato, quindi un documento salvato si impagina come prima e non ha bisogno di alcun vincolo di compatibilità.
I tabulatori si controllano insieme al resto della configurazione (vedi Avvisi di configurazione): una chiave sconosciuta in un tabulatore (leaders) viene segnalata come unknownConfigKey con la chiave a cui somiglia di più; un align che non è nessuno dei quattro come unknownConfigValue, e il tabulatore si comporta come 'start'; una position che non è una lunghezza, 'end' o una percentuale come unknownConfigValue con used: 'none', e il tabulatore viene scartato.
Il colore e il carattere della linea guida sono quelli del paragrafo; per ora non hanno un’impostazione propria.
#Capilettera
Un paragrafo del testo corrente può aprirsi con un capolettera: la sua prima lettera composta grande accanto alle prime righe, che vengono accorciate della larghezza della lettera più uno spazio e composte come qualsiasi altra riga (divise da Knuth–Plass, giustificate, sillabate). Uno stile di paragrafo ne dà uno al primo paragrafo di ogni gruppo :::paragraphs con quello stile (a ogni paragrafo con each: true, per un catalogo di voci); un livello di titolo o uno stile di titolo ne dà uno al primo paragrafo del testo corrente dopo il titolo (vedi il campo dropCap di Personalizzazioni per livello, Stili di paragrafo e Stili dei titoli). Per trovare il paragrafo che segue il titolo, Postext salta le righe di apertura e di chiusura dei contenitori, le direttive, i riquadri usciti dal flusso e le figure flottanti, come fa indentAfterHeading; un paragrafo dentro un riquadro, una voce di elenco, una citazione, una poesia o una nota non ne riceve mai uno. Nel testo, {dropcap}, {dropcap=false} e {dropcap=N} su una riga di titolo o sulla riga di apertura di un :::paragraphs lo attivano, lo disattivano o ne impostano le righe per quel capitolo o gruppo (vedi Formato del documento › Capilettera). Da postext 1.23.
Una cornice di una pagina composta non è un riquadro: è testo corrente, e i suoi paragrafi prendono il capolettera come quelli del flusso, da un gruppo :::paragraphs, da uno stile di paragrafo o dal livello di un titolo che sta nella stessa cornice (un titolo che il modello manda in una cornice propria, takes: 'h1', dà il capolettera del suo livello al paragrafo che lo segue nel Markdown quando quel paragrafo apre il testo della cornice di flusso, da postext 1.39). Un gruppo che chiede il capolettera dentro un riquadro :::callout viene composto senza capolettera e genera un avviso dropCap (inBox). Da postext 1.38. Un paragrafo aperto da un capolettera non viene mai tagliato prima dell’ultima riga dell’iniziale, né in una catena di cornici (next) né in una cornice che prosegue in un’altra pagina, esattamente come nel flusso: passa avanti intero, e si taglia lì solo quando apre una cornice troppo bassa per quelle righe, con un avviso dropCap (split). Da postext 1.39.
headings: {
levels: [
{ level: 1, dropCap: { lines: 3, fontFamily: 'Libre Bodoni', fontWeight: 700, color: { hex: '#8b2e2a', model: 'hex', paletteId: 'accent' }, leadIn: { words: 3 } } },
],
},| Proprietà | Tipo | Predefinito | Descrizione |
|---|---|---|---|
lines | number | 3 | Righe occupate dall’iniziale, dalla sommità delle sue maiuscole alla sua linea di base. 1 con un fontSize maggiore è un’iniziale rialzata che poggia sulla prima linea di base. |
sink | number | lines | Righe di cui l’iniziale scende nel testo: poggia sulla linea di base della riga sink, e quelle righe vengono accorciate. Un valore minore di lines la alza sopra la prima riga. |
characters | number | 1 | Numero di cluster di grafemi composti in grande: É, una lettera con un segno combinante o un carattere fuori dal Basic Multilingual Plane contano come uno. Non oltre la prima parola. |
fontFamily, fontWeight, italic | string, number, boolean | quelli del paragrafo; false | Carattere dell’iniziale. Viene caricato e incorporato con gli altri caratteri del documento. |
fontSize | Dimension | vedi più sotto | Corpo dell’iniziale. Se non è impostato: il corpo che porta la sommità delle sue maiuscole al livello delle maiuscole della prima riga mentre poggia lines righe più in basso. |
color | ColorValue | quello del paragrafo | Un colore legato alla tavolozza segue le tavolozze delle parti e delle sezioni. |
gap | Dimension | 0.15em | Spazio tra l’iniziale e le righe accorciate, dove em è il corpo del testo. |
punctuation | 'with-cap' | 'hang' | 'text' | 'with-cap' | Una virgoletta di apertura, ¿, ¡ o una parentesi prima della lettera: composta grande come parte dell’iniziale, sporgente al corpo del testo fuori dalla giustezza prima dell’iniziale, o composta al corpo del testo all’inizio della prima riga, dopo l’iniziale. |
leadIn | { words, smallCaps, uppercase } | nessuno | Le prime words parole dopo l’iniziale in maiuscoletto (il valore predefinito) o in maiuscolo (uppercase: true); words: 'line' prende le parole della prima riga. Quando l’attacco copre la prima riga, le parole si contano in una prima passata e si compongono in una seconda: in maiuscoletto la riga può allora contenere una parola in più, composta come è scritta. |
shortParagraph | 'reserve' | 'shrink' | 'skip' | 'reserve' | Un paragrafo di meno righe di sink: mantiene il blocco alto sink righe, perché il blocco successivo non tocchi l’iniziale; compone l’iniziale sulle sole righe del paragrafo; oppure compone il paragrafo senza capolettera. Ogni caso genera un avviso di contenuto dropCap. |
each | boolean | false | Solo stili di paragrafo: ogni paragrafo del gruppo si apre con il capolettera, non solo il primo. |
Come viene composta la lettera:
- Corpo. Entrambe le altezze delle maiuscole, quella del testo e quella dell’iniziale, vengono misurate dai rispettivi caratteri (l’inchiostro di una
H; dell’iniziale stessa nel testo cinese o giapponese), e un carattere che non fornisce metriche dell’inchiostro conta le sue maiuscole come 0,72 del suo corpo. Il corpo predefinito si adatta a qualsiasi coppia di caratteri, quindi non serve una correzione per carattere. IldropCapdi un testo grafico mantiene il suo valore fisso di 0,72 (vedi Elementi di testo). - La lettera e la sua parola. L’iniziale prende cluster di grafemi interi. Il resto della prima parola continua dopo di essa senza spazio; una parola di una sola lettera (A, Y) mantiene il suo spazio all’inizio della prima riga. Il rientro della prima riga del paragrafo viene eliminato. La copia, la ricerca, la mappa della sorgente e il cursore della Sandbox leggono il paragrafo come è scritto: il testo semplice del blocco include la lettera, il
plainStartdella prima riga conta oltre la lettera, eVDTBlock.dropCapcontiene il suo intervallo e la sua geometria sul frammento con la prima riga. - Un’iniziale rialzata (
lines: 1con unfontSizemaggiore, osinkminore dilines) si alza sopra la prima riga, e il paragrafo tiene libero quello spazio sopra di sé, in righe intere della griglia, così non si sovrappone al testo soprastante. - Divisione. Il paragrafo non si divide mai prima della riga
sink: passa invece intero alla colonna o alla pagina successiva, a meno che non sia solo in una colonna vuota che non può contenere quelle righe, nel qual caso si divide comunque e genera un avvisodropCap. Un titolo tenuto unito al suo testo tiene sotto di sé quelle righe. La parte che continua nella colonna successiva non ha iniziale e ha righe a piena larghezza; se il paragrafo si divide di nuovo per una colonna di larghezza diversa, le prime righe mantengono il rientro. Il bilanciamento delle colonne può rendere il paragrafo più lasco o più stretto come qualsiasi altro, e non aggiunge mai spazio tra le righe accorciate. - Scritture. Le righe vengono accorciate sul lato d’inizio: la sinistra nel testo latino, la destra in arabo ed ebraico. Una lettera che si unisce alla successiva (arabo, siriaco, N’Ko) non viene staccata, e il paragrafo genera un avviso
dropCap; il cinese e il giapponese orizzontali ricevono un’iniziale di un carattere (首字下沉). Il testo verticale non ne riceve (avviso). Nemmeno un paragrafo che si apre senza una lettera o una cifra (un rimando, una formula, un richiamo di nota) ne riceve (avviso). - Output. Il canvas, il visualizzatore HTML e l’EPUB a layout fisso disegnano l’iniziale accanto alle righe; l’HTML la scrive subito prima del testo della prima riga senza nulla in mezzo, così uno screen reader legge la parola intera. In un PDF con tag l’iniziale fa parte del
Pdel paragrafo e, con il resto della sua parola, di unoSpanil cui/ActualTextè la parola: l’estrazione del testo legge Long before, mai L ong before. Un EPUB a layout fluido la compone comeinitial-letterCSS (righe, discesa), flottante dove il sistema di lettura non lo supporta.
Le impostazioni si controllano insieme al resto della configurazione (vedi Avvisi di configurazione): una chiave sconosciuta in un capolettera o nel suo attacco viene segnalata come unknownConfigKey, un punctuation o uno shortParagraph che non è uno dei valori ammessi, o un lines, un sink o un characters che non è un numero intero a partire da 1, come unknownConfigValue, e si usa il valore predefinito. I capilettera sono disattivati per impostazione predefinita, quindi nessun documento salvato cambia.
#Una sola famiglia per fontFamily
fontFamily, qui e in ogni altro campo di famiglia di caratteri (headings.fontFamily, tableStyle.bodyFontFamily, separatorFontFamily, il fontFamily di uno stile di chip o di un elemento grafico…), indica una sola famiglia. Il canvas, l’output HTML e il PDF devono comporre con lo stesso carattere, e il PDF incorpora un font per famiglia senza catena di ripiego, quindi un elenco di font CSS non avrebbe nulla su cui ripiegare. Un elenco di questo tipo si compone con la prima famiglia e segnalato come avviso di configurazione:
bodyText: { fontFamily: "'EB Garamond', Georgia, serif" } // set in EB GaramondCarica quella famiglia prima di impaginare (vedi Font personalizzati e il fornitore di font in Generare PDF); se manca, il browser misura con il suo font predefinito, qualunque cosa indichi il resto dell’elenco. Una virgola tra virgolette fa parte di un nome ('"Foo, Bar"' è una sola famiglia).