Configurazione: tipografia dell’Asia orientale

#Tipografia dell’Asia orientale

La proprietà cjk stabilisce come si compone il testo cinese, giapponese e coreano: quali convenzioni regionali segue, dove possono andare a capo le sue righe, quanto è larga la sua punteggiatura e se sporge oltre il margine, lo spazio tra han e latino, la griglia di caratteri della gabbia del testo e come vengono stampati i segni di enfasi, le linee laterali, le letture ruby, le note warichu e i segni kanbun del testo. Ogni campo è facoltativo, e 'auto' segue la regione della lingua del documento (locale), così un libro con locale: 'zh-Hant' va a capo e compone la punteggiatura all’uso di Taiwan, e uno con locale: 'ja' all’uso giapponese, senza impostare nient’altro. Impaginazione cinese e Impaginazione giapponese spiegano le regole alla base di queste impostazioni, con due configurazioni complete ciascuna. I campi e i valori giapponesi ci sono da postext 1.16.

interface CjkConfig {
  region?: 'auto' | 'mainland' | 'taiwan' | 'hongkong' | 'japan'; // Regional conventions.
  lineBreak?: 'auto' | 'none' | 'basic' | 'gb' | 'strict'
    | 'ja-very-strict' | 'ja-strict' | 'ja-loose';      // Which marks may not open or close a line.
  punctuationWidth?: 'auto' | 'fullwidth' | 'kaiming' | 'lineEndHalf' | 'halfwidth';
  compressAdjacent?: 'auto' | boolean;      // Two marks that meet take 1.5 em.
  trimLineStart?: 'auto' | boolean;         // Brackets at a line edge lose their outer half.
  hangingPunctuation?: 'auto' | 'none' | 'allow' | 'force';
  spaceAfterQuestion?: 'auto' | boolean;    // One em after ？！ inside a paragraph (Japan).
  paragraphStartBracket?: 'auto' | 'indent' | 'half' | 'flush'; // A bracket opening an indented paragraph.
  wordBreak?: 'normal' | 'keep-all';        // keep-all: break only at spaces (分かち書き, Korean).
  titleMinChars?: number;                   // Characters of a book title on either side of a break; default 2.
  circledNumbers?: 'cjk' | 'western';       // ① ② as Chinese characters (default) or Latin letters.
  composeDesignText?: boolean;              // CJK rules in design text; default true.
  latinSpacing?: Dimension;                 // Between Han and Latin; default 0.25 em.
  latinSpacingEdge?: 'auto' | 'letters' | 'western'; // Which side of a Western word takes it.
  uprightDigits?: 0 | 2 | 3 | 4;            // Vertical text: numbers in one upright cell; default 2.
  grid?: { enabled?: boolean; charsPerLine?: number; linesPerPage?: number; show?: boolean; fullLines?: boolean };
  emphasis?: 'auto' | 'italic' | 'dots';    // What *…* does to CJK characters.
  emphasisMark?: {                          // The mark *…* and :dots[…] draw when they do not say.
    style?: 'auto' | 'dot' | 'circle' | 'sesame';
    fill?: 'auto' | 'filled' | 'open';
    position?: 'auto' | 'over' | 'under';
  };
  bookTitleMark?: 'auto' | 'brackets' | 'wavy' | 'none'; // What :book[…] prints.
  bookTitleBrackets?: 'auto' | { open: string; close: string }[]; // The brackets, outermost first.
  annotationColor?: ColorValue;             // Dots and name/title lines; default the text colour.
  ruby?: {
    fontFamily?: string; fontSize?: Dimension; color?: ColorValue;
    position?: 'auto' | 'over' | 'under' | 'right';
    overhang?: 'auto' | 'none' | 'kana' | 'any'; // How far a reading may run onto its neighbours.
    align?: 'auto' | 'center' | 'jis' | 'start'; // How a reading shorter than its base is spaced.
    smallKana?: 'keep' | 'full';                 // Small kana in readings as written, or full size.
  };
  warichu?: { fontSize?: Dimension; color?: ColorValue; open?: string; close?: string; minChars?: number };
  kunten?: { fontSize?: Dimension; color?: ColorValue; placement?: 'inline' | 'interlinear' }; // Kanbun marks.
}

I livelli giapponesi seguono le tre convenzioni dell’Appendice C.3 di JLReq. A ciascuno di essi nessuna riga finisce con una parentesi o una virgoletta di apertura, un simbolo di valuta resta con il suo numero (tranne a ja-loose), la barra non ha regole, e ——, ―― e …… possono aprire una riga ma non si dividono mai (né si divide 〳〵):

A ogni livello:

• —— e …… sono un’unica unità larga due em e non si dividono mai; due unità di questo tipo consecutive possono separarsi tra loro.
• Un numero mantiene i suoi segni e la sua unità (¥5,999, 50%, 50％, 120㎡), anche attraverso uno spazio (−3 ℃, 50 %), e una parola latina resta intera: il testo occidentale tra caratteri CJK si compone come una sequenza al cui interno una riga non va mai a capo, a meno che la sequenza da sola non sia più larga della riga (allora viene divisa in una sillaba con un trattino, o all’ultimo carattere che entra; un indirizzo web nei suoi punti di giunzione). I quadrati di unità ㎡ ㎏ ㎞ ㏄ (U+3371–337A, U+3380–33DF, U+33FF) appartengono alla sequenza del loro numero e non rendono CJK un paragrafo latino.
• Nemmeno un numero o una parola in cifre e lettere a larghezza piena (１２３４５６, ５０％, ￥５９９, ３．１４, １２：３０, ＡＢＣ) si divide mai; una riga giustificata ne allarga comunque i caratteri come allarga gli han.
• Uno spazio tra parole è un punto di a capo solo dove le regole lo permettono: la riga non va a capo lì quando il carattere successivo non può aprire una riga (参见图表 （ 第三章 ） non apre mai una riga con ）) o l’ultimo prima di esso non può chiuderne una.
• Un richiamo di nota, un :ref e un apice o un pedice restano con il carattere che li precede.
• Lo spazio ideografico U+3000 è un carattere largo un em: una riga può andare a capo dopo di esso, mai prima; non viene mai allargato né eliminato a inizio riga. Per il rientro di due caratteri dei paragrafi cinesi imposta bodyText.firstLineIndent: { value: 2, unit: 'em' } invece di digitare due U+3000 (il parser elimina quelli con cui si apre un paragrafo).

Quando un carattere non entra nella riga e può aprire la successiva, scende e una riga giustificata allarga ciò che resta. Quando non può aprire la riga successiva (una virgola, una parentesi di chiusura, il carattere dopo una di apertura), la riga prova prima ad accoglierlo comprimendosi (push-in, clreq §6.2.2.3): se il bianco a cui può rinunciare (vedi Larghezza della punteggiatura) copre l’eccedenza, il carattere (con i segni che devono restare con esso, una virgoletta di chiusura dopo un punto) va nella riga e la riga viene composta alla giustezza. Altrimenti la riga gli cede dei caratteri (push-out): l’a capo arretra all’ultimo punto che le regole permettono, e una riga giustificata allarga ciò che resta. In una riga più stretta di un numero con il suo punto, niente può chiudere la riga, e alla fine va a capo prima del punto.

A quali paragrafi si applica: a quelli che contengono più caratteri CJK (han, kana, bopomofo, hangul) che spazi tra parole, anche senza due di essi consecutivi (第1条、第2条, 价¥5,999。好). Uno spazio accanto a un carattere o a un segno CJK non è uno spazio tra parole: 2026 年 9 月 28 日 si compone come 2026年9月28日. Si compongono riga per riga, sul percorso semplice e su quello formattato allo stesso modo, così un paragrafo con una parola in grassetto va a capo esattamente come lo stesso testo senza. Un paragrafo latino che cita un titolo o un nome cinese ha più spazi che caratteri: mantiene la divisione ottimale in righe, e una riga può andare a capo accanto ai suoi caratteri CJK secondo le stesse regole. Anche didascalie, celle di tabella, note e riquadri vanno a capo secondo il livello del documento. La sillabazione con dizionario non raggiunge le parole latine di un paragrafo CJK.

Una riga CJK giustificata che non è l’ultima del suo paragrafo viene allargata alla giustezza, in quest’ordine (clreq §6.2.2.4): gli spazi tra parole occidentali, fino a mezzo em ciascuno; gli spazi tra han e latino, fino a mezzo em ciascuno; poi ogni intervallo tra caratteri, e quegli spazi, in parti uguali. Nessuno spazio entra dentro una parola latina, un numero o un segno di due em, né accanto a un connettore o a una barra. La spaziatura si imposta per segmento di riga (VDTLineSegment.tracking, px dopo ogni carattere, parte della width del segmento), che gli output canvas, HTML e PDF disegnano come spaziatura tra lettere; una parola latina seguita da un intervallo dà alla sua ultima lettera un segmento a sé. Un segmento contiene una sequenza occidentale, o caratteri di uno stesso stile, collegamento e spaziatura che avanzano allo stesso modo, così la Sandbox ne distribuisce la larghezza in modo uniforme quando posiziona il cursore, e un collegamento copre solo i propri caratteri. Quando una riga avrebbe bisogno di più di mezzo em tra i caratteri (o di più di bodyText.maxJustifyTracking, quando è impostato), viene composta con quel valore e finisce prima della giustezza: la riga viene marcata cjkLoose e ragged, e la build segnala un avviso di contenuto cjkLooseLine con il testo della riga. La causa abituale è una lunga parola latina o un indirizzo web che non può risalire. Una riga senza alcun carattere CJK (l’inizio di un lungo indirizzo web) si compone in bandiera senza avviso, come una riga latina di una sola parola. Vedi Sillabazione e giustificazione.

#Larghezza della punteggiatura

Un segno cinese a larghezza piena è mezzo em di glifo e mezzo em di bianco, e ciò che le impostazioni regolano è il bianco, mai il glifo (clreq §6.3.2). Il bianco sta prima del glifo di una parentesi o di una virgoletta di apertura, dopo il glifo di una di chiusura e dopo il glifo dei segni di pausa e di fine frase della Cina continentale 、，。．；：？！, che stanno nell’angolo del loro riquadro; i segni che Taiwan e Hong Kong centrano (、，。．；：) e i punti mediani mantengono un quarto di em per lato. ？！ restano di un em nel testo orizzontale di Taiwan e Hong Kong, e ：；？！ nel testo verticale ovunque. Il punto mediano della Cina continentale è di mezzo em con ogni stile, centrato, in entrambe le direzioni di scrittura (GB/T 15834, clreq §5.1): un glifo a larghezza piena rinuncia al suo bianco su entrambi i lati, e nel testo verticale la sua cella è di mezzo em fin dall’inizio.

In Giappone (punctuationWidth: 'fullwidth', il valore auto) i segni seguono invece JLReq §3.1: 、，。． mantengono il bianco dopo il glifo, ：； e ・ un quarto di em per lato, e ？！ riempiono il loro em. Un segno di chiusura a fine riga mantiene il suo mezzo em, e vi rinuncia per intero, prima di tutto, quando la riga deve accogliere un carattere in più; il bianco dopo 。 non viene mai ridotto dentro la riga. Una riga restituisce spazio nell’ordine di JLReq §3.8.3: spazi tra parole, il bianco del segno che chiude la riga, punti mediani, parentesi e 、，, poi lo spazio tra giapponese e latino; e viene allargata senza aggiungere spazio dopo una parentesi di apertura, prima di una di chiusura o accanto a 、。・：；？！ e U+3000 (§3.1.11). 、 e ・ tra due numerali kanji si compongono senza spazio e non vanno mai a capo (二、三日, 三・一四). Un documento giapponese a cui si dà un altro punctuationWidth (kaiming, halfwidth…) segue invece le regole clreq di questa sezione.

Con compressAdjacent, due segni che si incontrano rinunciano al bianco tra loro (le otto regole delle prime bozze di clreq): una parentesi di chiusura dopo un’altra di chiusura o dopo un segno di pausa o di fine frase della Cina continentale (。」, non dopo i segni centrati di Taiwan e Hong Kong), un segno di pausa o di fine frase dopo una parentesi di chiusura (」，), una parentesi di apertura dopo uno qualsiasi di questi o dopo un’altra di apertura (，「, 》（, 「『), e un quarto di em tra un punto mediano e una parentesi di chiusura prima di esso o una di apertura dopo. Mai più di quanto porta la coppia a 1,5 em: con Kaiming 。” occupa già 1,5 em e li mantiene, 》（ occupa un em. Kaiming mette il bianco di un segno di fine frase dopo un segno di chiusura che lo segue, con o senza compressAdjacent: i due glifi stanno insieme e il mezzo em viene dopo la virgoletta (。”␣母, non 。␣”母), e a fine riga va come quello di un segno di fine frase. Con trimLineStart, una parentesi di apertura che comincia una riga rinuncia al suo bianco iniziale, così il suo inchiostro si allinea al margine del testo (sulla prima riga di un paragrafo si colloca mezzo em dentro il rientro), e una di chiusura che termina una riga al suo bianco finale. Un segno centrato rinuncia a un quarto di em per lato, mai a mezzo su un lato. Quando una riga va a capo tra due segni, nessuno dei due mantiene la compressione: ciascuno si compone come un segno al margine della riga (un ， a larghezza piena il cui 「 apre la riga successiva chiude la propria riga con un em intero).

Una riga accoglie un carattere che non può aprire la riga successiva (push-in) quando il bianco a cui può ancora rinunciare copre l’eccedenza, nell’ordine di clreq: spazi tra parole fino a un quarto di em, poi punti mediani, parentesi, segni di pausa, gli spazi tra han e latino fino a un ottavo di em e infine i segni di fine frase, ogni passo ripartito in parti uguali. kaiming lascia scendere a mezzo em solo i suoi segni di fine frase, e solo in questo caso: una riga a cui manca semplicemente un carattere viene allargata, così 。？！ mantengono il loro em dentro la riga. lineEndHalf lascia scendere ogni segno a mezzo em; i segni fullwidth non rinunciano a niente (un libro a larghezza piena mantiene la sua griglia), e i segni halfwidth non hanno più niente da cedere.

I segni che il testo latino condivide con il cinese (“ ” ‘ ’ … — ·) prendono nel testo cinese il riquadro di un segno cinese, qualunque sia l’avanzamento proprio del font: LXGW WenKai disegna “ ” larghe 0,35 em, Noto Serif SC la lineetta lunga a 0,89 em e · a un terzo di em. Contano come cinesi quando il carattere più vicino su uno dei due lati (oltre altri segni di questo tipo) è cinese, o quando accanto a loro non c’è niente di occidentale. Il glifo di una virgoletta di apertura sta alla fine del suo riquadro di un em, quello di una di chiusura all’inizio; un punto mediano, i puntini di sospensione e una lineetta singola stanno nel mezzo; una coppia di puntini di sospensione (……) si compone come il font compone le due insieme ed è centrata nei suoi due em. Un 破折号 (——) è un unico filetto continuo: ogni lineetta viene allungata sul suo em a partire dallo spazio laterale proprio del carattere, con i due tratti che si sovrappongono alla giunzione, e sollevata al centro dei caratteri (VDTLineSegment.inkScale, una scala che riguarda solo il disegno). Lo stile poi regola il riquadro come quello di qualsiasi altro segno. Con testo occidentale su entrambi i lati (他说：He said “yes” and left.) mantengono l’avanzamento del font, e un glifo già largo un em non cambia nulla.

I renderer tengono fuori dal testo la spaziatura della punteggiatura propria del browser. Chrome compone a mezza larghezza il primo di due segni che si incontrano quando li misura o li disegna in un’unica sequenza (本）》录 in Noto Serif SC misura così 3,5 em), quindi due segni che si incontrano vengono misurati e disegnati separatamente, e le righe HTML di testo CJK portano text-spacing-trim: space-all e text-autospace: no-autospace con le funzionalità chws, halt e vchw disattivate.

Nel VDT un segno che ha rinunciato al bianco è un segmento a sé, con la width pari all’avanzamento che mantiene e con inkOffset (px) impostato: i renderer disegnano il suo glifo a x + inkOffset, così un segno che ha rinunciato al bianco prima del glifo (una parentesi di apertura a inizio riga) viene disegnato di tanto prima del suo riquadro (uno scostamento negativo). Un segno condiviso composto in un riquadro cinese porta la posizione del suo glifo nel riquadro, meno il bianco a cui ha rinunciato prima, che può essere positiva. Il PDF mostra questo glifo con una spaziatura dei caratteri che termina il suo avanzamento dove finisce il riquadro, così un lettore non lo vede mai sovrapporsi al carattere successivo, e mette la sua riga in uno span /ActualText (vedi Spazio tra han e latino). È la regione a decidere su quale lato sta il bianco di un segno, non il font: componi un libro con un carattere della sua regione (Noto Serif SC per la Cina continentale, TC per Taiwan, HK per Hong Kong); un font tradizionale con un tag della Cina continentale comprime il lato sbagliato dei suoi segni centrati.

#Punteggiatura sporgente

hangingPunctuation: 'allow', il valore auto in Giappone, lascia che uno tra 、，。． (nella Cina continentale, i cui segni stanno all’inizio del loro riquadro, anche ；：？！) sporga oltre la fine della riga quando altrimenti aprirebbe la successiva e comprimere la riga non basta ad accoglierlo; mai nel testo orizzontale di Taiwan e Hong Kong, i cui segni centrati sembrerebbero tagliati (nel testo verticale possono). Nel testo verticale il segno sporgente sta sotto il piede della riga. 'force' fa sporgere un segno di questo tipo ogni volta che chiude una riga (tranne l’ultima riga di un paragrafo), e subito quando non entra. Un segno non sporge mai quando un altro segno lo tocca (。」, ，「). Il segmento sporgente viene marcato hangs; la bbox.width della riga, la sua giustificazione e il suo allineamento lo escludono, e il canvas e il PDF allargano il ritaglio della colonna del segno sporgente più largo (hangingPunctuationOverhang), così non viene mai tagliato. La maggior parte dei libri cinesi non fa sporgere la punteggiatura; clreq lo raccomanda solo con una griglia di caratteri. I libri giapponesi fanno sporgere 、。，． (burasagari), mai ；：？！ né le parentesi, in entrambe le direzioni di scrittura, e solo quando comprimere la riga non basta ad accogliere il segno.

#Spazio tra han e latino

latinSpacing (predefinito un quarto di em) mette uno spazio tra un carattere han (o un kana) e una lettera latina o una cifra europea adiacente: 用iPhone拍照 e 1999年 si compongono 用 iPhone 拍照 e 1999 年. Non ce n’è a inizio o a fine riga, né tra un carattere latino e un segno cinese (用iPhone， non mette niente prima della virgola), né dentro parentesi cinesi (（iPhone）), né accanto a un simbolo che non è una lettera o una cifra (为¥5,999). Uno spazio che l’autore ha digitato su questo confine (用 iPhone 拍照, come molti testi web lo riportano) viene sostituito dallo spazio tra han e latino, non sommato, così le due grafie si compongono allo stesso modo; uno spazio indivisibile o uno spazio ideografico resta com’è. In una riga giustificata cresce fino a mezzo em prima che i caratteri vengano allargati; in una riga che accoglie un carattere che non può aprire la riga successiva si restringe fino a un ottavo di em. Una lunghezza in un’unità diversa da em viene convertita ai dpi della pagina. 0 lo disattiva, e uno spazio digitato lì resta uno spazio tra parole.

Quale lato di una parola occidentale prende lo spazio dipende da latinSpacingEdge. Con 'letters', la regola di clreq §6.3.3 e di text-autospace del CSS e il predefinito delle regioni cinesi, è un lato che finisce con una lettera o una cifra. Con 'western', il predefinito della regione del Giappone (JLReq §3.2.6), una parola occidentale che contiene una lettera o una cifra lo prende anche su un lato che finisce con una parentesi o un simbolo: normalize()関数, (abc)関数, A+関数 e 100%関数 si compongono con il quarto di em su entrambi i lati della parola, come abc関数, e anche lì uno spazio digitato viene sostituito. Due lati restano senza spazio, dove il segno lega attraverso il confine: dopo una parentesi di apertura o un simbolo prefisso che chiude la parola (abc(関数), e prima di una parentesi di chiusura, una virgola, un punto o un simbolo suffisso che la apre (関数)abc). Una parentesi o un simbolo senza lettere o cifre nella sua parola, come in 関数(かんすう)は, sta in un contesto giapponese e non ne prende. Una configurazione giapponese salvata prima di postext 1.28 mantiene 'letters'.

Lo spazio è un segmento di kind: 'space' marcato autospace, con text vuoto (o lo spazio che l’autore ha digitato); la sua width è definitiva, e la giustificazione degli spazi propria dei renderer la lascia com’è. Non compare mai nel testo semplice, così la ricerca, il copia e incolla e gli intervalli della sorgente leggono il testo come è scritto. Il PDF mette ogni riga composta a pezzi (caratteri allargati, spazi tra han e latino, segni che hanno rinunciato al bianco o che sporgono) in uno /Span il cui /ActualText è il testo della riga, così l’estrazione del testo legge 用iPhone拍照, non 用 iPhone 拍 照, e legge una riga con segni a mezza larghezza come una sola riga.

#Numeri nel testo verticale

Nel testo verticale una parola latina o un numero lungo viene coricato, e un numero breve sta in piedi, con le cifre affiancate in una sola cella di un em: tate-chu-yoko (縱中橫, clreq §2.1.3, CSS text-combine-upright). uprightDigits stabilisce quante cifre può avere un numero di questo tipo: 2 (il predefinito), 3, 4, o 0 per nessuna. 2026年9月28日 con 2 diventa 2026 coricato, 9 in piedi e 28 in piedi in una sola cella.

• Tutto il numero o niente: con 2 un numero di tre cifre resta coricato, mai diviso.
• Un numero che tocca una lettera latina (A4, mp3, 3D) resta nella sua parola, coricato; lo stesso vale per un numero scritto con un separatore decimale o delle migliaia (3.14, 10,000).
• Un numero dentro una frase latina segue la frase: quando c’è una parola latina su entrambi i lati, scorre coricato con le parole (printed in 49 and 32 copies, chapters 49, 32 and (7) of). Su ciascun lato la ricerca oltrepassa spazi, altri numeri, richiami di nota, la punteggiatura di una sequenza coricata (, . : ; ( ) ' " - /), le lineette medie e lunghe e le virgolette curve (pages 3–5 of, the “49” copies) fino alla prima lettera o al primo carattere cinese. Un numero i cui segni portano a testo cinese sta in piedi (上午12:30:45开会, 比分为3:2:1, 见图(3)所示, 他住在"12"号楼), e così uno accanto a un carattere o a un segno cinese, con o senza spazio (第 3 回, 用iPhone 15拍攝, 第3 copies), uno accanto a un simbolo che sta in piedi (a 30×40 print), e uno all’inizio o alla fine di un paragrafo, che ha una parola su un solo lato (49 copies were printed, on page 7.: scrivi :sideways[…] per coricarlo). Il paragrafo viene letto per intero, attraverso a capo, enfasi e collegamenti.
• Accanto a un simbolo che Unicode compone in piedi, ogni numero prende una cella propria: 30×40 diventa 30, ×, 40, tutti in piedi.
• Una cella con più caratteri di quanti ne entrino in un em viene compressa in larghezza fino all’em; tracking e giustificazione non entrano mai al suo interno, solo dopo.
• Per l’a capo e la giustificazione, la cella conta come un carattere cinese, e attorno a essa non si mette spazio tra han e latino.
• In Giappone anche le coppie !!, !?, ?! e ??, a mezza larghezza o a larghezza piena, stanno in piedi in una sola cella (すごい！？), a meno che non le tocchi una lettera latina, una cifra o un terzo segno; una coppia a larghezza piena viene disegnata con i segni a mezza larghezza. I kana piccoli, ：；, “ ” (disegnate 〝〟) e ・ prendono le forme verticali giapponesi (vedi Impaginazione giapponese › Forme verticali).
• Il misuratore e ogni renderer trovano le stesse celle: il canvas disegna le cifre raddrizzate e compresse, il PDF lo stesso con il font orizzontale, e l’HTML le racchiude in text-combine-upright: all.

A mano, tre segni in linea sostituiscono l’impostazione nel testo verticale e non cambiano nulla nel testo orizzontale (vedi Formato del documento › Orientamento nel testo verticale):

第:tcy[120]回、:upright[GDP]與:sideways[12]

:tcy[…] compone il suo testo in una sola cella in piedi, :upright[…] mette in piedi ogni carattere in una cella propria (con le lettere latine centrate), :sideways[…] corica l’intera sequenza, caratteri cinesi compresi. Nel VDT una sequenza :tcy è un segmento con tcy: true, largo un em; una sequenza :upright o :sideways porta orientation. I numeri composti in una sola cella da uprightDigits non portano alcun indicatore: li trova verticalRuns(graphemes, region, uprightDigits). In un paragrafo, un numero breve che scorre con parole latine porta orientation: 'sideways', come se fosse scritto :sideways[…]: il suo segmento non contiene sempre le parole con cui scorre.

#Griglia di caratteri

Una gabbia del testo cinese si specifica in caratteri (clreq §7.1.1): il corpo del testo × i caratteri per riga × le righe per pagina, più lo spazio tra le righe e, con due colonne, l’intercolonna. grid la imposta in questo modo:

cjk: { grid: { enabled: true, charsPerLine: 28, linesPerPage: 28, show: true } }

Quando è enabled, la configurazione viene riscritta prima che qualcosa la legga: ogni colonna è larga charsPerLine em di bodyText.fontSize, e la gabbia del testo è alta linesPerPage righe di bodyText.lineHeight; con layoutType: 'double' l’intercolonna è layout.gutterWidth arrotondato a un numero intero di em, almeno uno. I margini in page.margins fanno da minimi: la gabbia del testo si colloca al centro dell’area che lasciano, e ogni margine cresce di metà dello spazio avanzato lungo il suo asse (un libro a pagine speculari mantiene distinti i margini interno ed esterno, entrambi cresciuti della stessa quantità). Se non sono impostati, charsPerLine e linesPerPage prendono quanti ne entrano. Un numero più grande di quanto entra viene ridotto a ciò che entra e segnalato come avviso di configurazione cjkGridClamped. Il corpo e l’interlinea restano come sono scritti. In un’impaginazione oneAndHalf charsPerLine è quello della colonna principale; la colonna laterale prende il numero intero di em più vicino alla larghezza che le dà sideColumnPercent dentro i margini configurati (almeno uno), l’intercolonna viene arrotondata come in un’impaginazione a due colonne, e sideColumnPercent viene riscritto in modo che entrambe le colonne siano tagliate in em interi. Nel testo verticale (layout.writingMode: 'vertical-rl') i caratteri di una riga scorrono dall’alto in basso e le righe da un lato all’altro della pagina, quindi charsPerLine misura l’altezza della pagina, un’impaginazione double dà due registri impilati dall’alto in basso, e le celle della sovrimpressione stanno sull’asse su cui sono centrati i caratteri.

Una pagina sulla griglia contiene le righe che la sua griglia conta, quindi le due regole che lasciano una colonna più corta di una riga seguono la griglia. bodyText.avoidWidows, che sposta intero un paragrafo quando al piede di una colonna ne entra solo una riga, lì è disattivata per impostazione predefinita. bodyText.avoidOrphans, che prende una riga dalla colonna precedente perché un paragrafo non finisca con una sola riga in testa alla successiva, resta attiva per un documento cinese (孤行, clreq §7.1.2) ed è disattivata nella regione japan: JLReq §3.5.4 conta i caratteri dell’ultima riga di un paragrafo, non le sue righe a un’interruzione di pagina. Una configurazione che imposta una delle due chiavi mantiene il suo valore, e una salvata prima di postext 1.28 mantiene attive entrambe le regole (configVersion 12).

Due impaginazioni della pratica cinese, a 五号 (10,5 pt) con uno spazio tra le righe di 6 pt (lineHeight: 16.5pt):

• 大32开, 140 × 203 mm, 28 × 28: una giustezza di 294 pt (103,7 mm) e una gabbia del testo di 462 pt (163 mm); page.margins di 16/20 mm interno ed esterno e di 18/20 mm in testa e al piede le lasciano spazio.
• 16开, 184 × 260 mm, due colonne di 23 caratteri a 小五 (9 pt, righe di 13,5 pt) con un’intercolonna di due caratteri: 2 × 207 pt + 18 pt.

show disegna la griglia (稿纸) sopra la gabbia del testo, un quadratino grigio chiaro per ogni posizione di carattere su ogni riga (il riquadro em del carattere attorno alla sua linea di base), su ogni colonna della pagina (una colonna laterale oneAndHalf sul lato in cui la mette la parità della pagina), nel canvas e nell’HTML. Il PDF la disegna solo quando a renderToPdf si passa characterGrid: true: è un aiuto a schermo. cjkGridGeometry(config) restituisce la griglia che una configurazione imposta (numeri in uso, margini, gabbia del testo) e applyCjkGrid(config) la configurazione riscritta.

fullLines serve per la carta da manoscritto (原稿用紙), dove si scrive in ogni quadrato di una riga piena. Un paragrafo non finisce su un solo carattere (vedi bodyText.avoidRunts): la riga sopra gli cede il suo ultimo carattere, e quando quella riga non è giustificata resta corta di un quadrato. Con fullLines: true una riga non giustificata mantiene tutti i quadrati e il paragrafo può finire su un carattere; una riga giustificata cede comunque il suo carattere e viene allargata alla giustezza. Disattivato per impostazione predefinita. Da postext 1.28.

#Segni, ruby e warichu

La marcatura dei segni cinesi, ruby e warichu tiene il suo testo nel paragrafo: la ricerca, l’indice, gli ancoraggi dell’indice analitico e il testo copiato leggono i caratteri come sono scritti, e solo ciò che viene disegnato attorno a essi dipende da queste impostazioni.

• Punti di enfasi (着重号, 傍点; :dots[…], e *…* sui caratteri CJK con emphasis: 'dots'): un segno per carattere, centrato su di esso (esclusa la spaziatura di una riga giustificata), mai sulla punteggiatura o sugli spazi: sotto il carattere nel testo orizzontale, alla sua destra nel testo verticale (clreq §5.3.1). style sceglie un punto pieno, un cerchio vuoto o un punto a sesamo, fill="open" disegna il contorno, pos="over|under" il lato; emphasisMark imposta ciò che un segno lascia non impostato (in Giappone un sesamo sopra il testo, alla sua destra nel testo verticale). Un sesamo sta orientato allo stesso modo sul foglio in entrambe le direzioni di scrittura, e i segni sul lato di una lettura ruby vanno all’esterno di essa.
• Linee laterali (傍線, :sideline[…]{style pos}): scorrono accanto al testo, punteggiatura e spazi compresi: solid, double, wavy o dotted, per impostazione predefinita sotto il testo che corre lungo la pagina e alla sua destra quando scende lungo la pagina; due linee che si incontrano rinunciano ciascuna a un ottavo di em. Funzionano in qualsiasi scrittura.
• Linee dei nomi propri e dei titoli (专名号 :name[…], 书名号 :book[…] con bookTitleMark: 'wavy'): scorrono sotto il riquadro em dei caratteri (alla sua sinistra nel testo verticale), attraverso gli spazi dentro la sequenza. Dove due sequenze si incontrano, ogni estremità rinuncia a un ottavo di em, così :name[賈寶玉]:name[林黛玉] si legge come due nomi. Quando punti e una linea marcano lo stesso testo sullo stesso lato, la linea è più vicina al testo. Con 'brackets' le 《》 sono testo con cui si dividono le righe, disegnate e copiate come qualsiasi altro carattere; non occupano caratteri del testo semplice né della mappa della sorgente (i segmenti sono marcati inserted).
• Ruby: le letture stanno nello spazio tra le righe contro il riquadro em della base, centrate su di esso; una lettura che contiene una lettera latina (pinyin) e sta sopra la sua base viene sollevata della profondità dei discendenti del suo carattere (g, j, p, q, y) e di altri 0,04 em del testo, così da non toccare la base, e ogni lettura della riga mantiene una sola linea di base; una lettura più larga della sua base allarga il riquadro della base, meno il quarto dell’em ruby che può invadere un vicino senza lettura, e due letture restano distanti un quarto dell’em ruby (due letture zhuyin un quarto dell’em dei simboli, così tre simboli accanto a ciascuno di due caratteri restano nelle loro celle). Un ruby mono (una lettura per carattere) può andare a capo tra i suoi caratteri; un ruby di gruppo non va mai a capo. In Giappone una lettura segue invece ruby.align e ruby.overhang: spaziata 1:2:1 quando è più corta della sua base, che invade i kana ma non i kanji quando è più lunga, mentre il resto dello spazio viene dall’allargare la base; un ruby per carattere di due o più caratteri è un ruby jukugo, in cui ogni carattere mantiene la sua lettura, che può invadere il carattere successivo della parola ma non si sovrappone mai a un’altra lettura, e la riga può comunque andare a capo tra loro (JLReq §3.3). A inizio o a fine riga, base e lettura si allineano al margine (clreq §5.5.4). Lo zhuyin nel testo orizzontale sta in una colonna a destra di ogni carattere, e il riquadro del carattere cresce della colonna; nel testo verticale la stessa colonna scende lungo la destra dei caratteri. Il segno di tono va a destra della colonna con metà del suo inchiostro sopra la sommità dell’ultimo simbolo (clreq §5.5.3.3), posizionato in base al suo inchiostro perché i font mettono questi segni in alto nel loro riquadro em, e nel testo verticale sta in piedi, come il punto del tono neutro sopra il primo simbolo.
• Note warichu (双行夹注): si piegano in due righe al corpo della nota, centrate sulla riga senza spazio tra loro. La riga superiore prende caratteri finché non contiene almeno metà della parte, così la seconda riga non è la più lunga, e uno in più quando la riga inferiore si aprirebbe con un segno che non può cominciare una riga. Quando ogni piegatura di questo tipo aprirebbe la riga inferiore con un segno (本名。), si prende la piegatura precedente e la riga inferiore è la più lunga: 本 sopra 名。; una parte di un carattere con i suoi segni resta su una riga. Una nota più lunga dello spazio rimasto su una riga lo riempie e prosegue nella riga, colonna o pagina successiva, e una riga va a capo al suo interno solo dove su ciascun lato stanno warichu.minChars dei suoi caratteri (2 per impostazione predefinita; segni e spazi tra parole non contano), così nessuna riga, colonna o pagina si apre con un solo carattere piccolo e il suo punto; le sue parentesi vanno solo prima della prima riga e dopo l’ultima. Nel testo verticale la riga superiore è quella di destra, letta per prima.
• Segni kanbun (:kunten[字]{kaeri okuri tate}): compongono i segni di ritorno dell’ultimo carattere sul lato del piede della riga dopo di esso (in basso a sinistra nel testo verticale), i suoi okurigana sul lato della testa a partire dal suo centro, con quelli più lunghi che spingono avanti il carattere successivo, e il tatesen come un breve filetto fino al carattere successivo (JIS X 4051 §5). Il testo copiato e l’/ActualText del PDF leggono gli okurigana dopo i loro caratteri ed escludono i segni di ritorno; uno spazio tra le righe troppo stretto per loro viene segnalato come kuntenExceedsLeading.

Il passo delle righe non cambia mai: segni e letture vivono nell’interlinea. Un paragrafo il cui spazio tra le righe (l’interlinea meno il corpo del testo) è inferiore a mezzo em con segni su un lato, o a cinque ottavi con segni su entrambi i lati (clreq §5.6.1), viene segnalato con un avviso di contenuto cjkMarksExceedLeading; uno le cui letture sono più alte del suo spazio tra le righe (una lettura pinyin contata con il suo sollevamento), come rubyExceedsLeading. Dai a questi paragrafi uno stile di paragrafo con più interlinea. I libri giapponesi con furigana di solito compongono il testo corrente con un’interlinea di circa 1,75 em (JLReq §2.4.2).

Nel VDT un segmento marcato porta cjkMarks, e l’impaginazione colloca i punti e le linee sulle sue righe come VDTLine.marks (punti, cerchi, sesami, linee continue, doppie, punteggiate e ondulate, nel sistema di riferimento del flusso della riga), che canvas, HTML e PDF disegnano così come sono (PDF: Artifact /Layout; HTML: riquadri aria-hidden, testo con punti in <em>). Il segmento di una base ruby porta ruby (la lettura e le sue sequenze; per una lettura giapponese anche l’id che la sua annotazione condivide con gli altri caratteri di una parola jukugo, e jukugo) e disegna la sua base a inkOffset, con tracking, quando la lettura l’ha allargata; un carattere con segni kanbun porta kunten (le sue sequenze e il suo tatesen); la parte di una nota warichu su una riga è un segmento il cui text è la sua riga superiore seguita da quella inferiore e il cui warichu contiene le righe che i renderer disegnano al suo posto. Il PDF con tag mette una lettura nell’RT del Ruby della sua base e una nota in un Warichu, e l’/ActualText della riga legge una sola volta il testo della base e la nota. Segni, letture e note vengono disegnati nel testo corrente, nei titoli, negli elenchi e nei riquadri, e nelle didascalie, nelle celle di tabella e nelle note delle risorse, le cui righe portano marks e ruby come le righe del testo corrente; il testo del progetto grafico mantiene il testo senza di essi.

Resolver e stripper si comportano come nelle altre sezioni. spaceAfterQuestion, paragraphStartBracket e wordBreak, e overhang, align e smallKana del ruby, compaiono nella configurazione risolta solo quando cambiano qualcosa (in Giappone, o quando sono impostati). setCjkLineBreak e setCjkComposition impostano il livello e la composizione (larghezza della punteggiatura, punteggiatura sporgente, spazio tra han e latino; cjkCompositionOf(resolved.cjk, dpi)) per le misurazioni fatte fuori da buildDocument, che li imposta a partire dalla configurazione. Fuori da una build, i segni mantengono il loro avanzamento pieno e non si mette alcuno spazio tra han e latino:

import { DEFAULT_CJK_CONFIG, resolveCjkConfig, stripCjkDefaults, cjkRegionOf, setCjkLineBreak, setCjkComposition, cjkCompositionOf } from 'postext';
 
resolveCjkConfig(undefined, 'zh-HK');
// { region: 'hongkong', lineBreak: 'basic', punctuationWidth: 'fullwidth', compressAdjacent: true,
//   trimLineStart: true, hangingPunctuation: 'none', latinSpacing: { value: 0.25, unit: 'em' }, uprightDigits: 2,
//   grid: { enabled: false, charsPerLine: 0, linesPerPage: 0, show: false, fullLines: false },
//   emphasis: 'dots', emphasisMark: { style: 'dot', fill: 'auto', position: 'auto' },
//   bookTitleMark: 'wavy', bookTitleBrackets: [{ open: '《', close: '》' }, { open: '〈', close: '〉' }],
//   ruby: { fontSize: { value: 0.5, unit: 'em' }, position: 'auto' },
//   warichu: { fontSize: { value: 0.5, unit: 'em' }, open: '', close: '', minChars: 2 }, kunten: { … } }
 
resolveCjkConfig(undefined, 'ja');
// { region: 'japan', lineBreak: 'ja-very-strict', punctuationWidth: 'fullwidth', compressAdjacent: true,
//   trimLineStart: true, hangingPunctuation: 'allow', spaceAfterQuestion: true, paragraphStartBracket: 'half', …,
//   emphasisMark: { style: 'sesame', fill: 'auto', position: 'over' }, bookTitleMark: 'brackets',
//   bookTitleBrackets: [{ open: '『', close: '』' }, { open: '「', close: '」' }],
//   ruby: { fontSize: { value: 0.5, unit: 'em' }, position: 'auto', overhang: 'kana', align: 'jis' },
//   warichu: { fontSize: { value: 0.5, unit: 'em' }, open: '（', close: '）', minChars: 2 }, kunten: { … } }

Nella Sandbox queste impostazioni si trovano in Grafica › Sistema di scrittura › Tipografia dell’Asia orientale.