Configuração: tipografia do Leste Asiático

#Tipografia do Leste Asiático

A propriedade cjk define como se compõe o texto em chinês, japonês e coreano: que convenções regionais ele segue, onde suas linhas podem quebrar, que largura ocupa a pontuação e se ela fica pendente, o espaço entre han e latim, a grade de caracteres da mancha e como se imprimem as marcas de ênfase, as linhas laterais, as leituras em rubi, as notas warichu e as marcas de kanbun do texto. Todos os campos são opcionais, e 'auto' segue a região do idioma do documento (locale), de modo que um livro com locale: 'zh-Hant' quebra as linhas e compõe a pontuação à maneira de Taiwan, e um com locale: 'ja' à maneira japonesa, sem definir mais nada. Composição chinesa e Composição japonesa explicam as regras por trás desses ajustes, com duas configurações completas cada uma. Os campos e valores japoneses existem desde o postext 1.16.

interface CjkConfig {
  region?: 'auto' | 'mainland' | 'taiwan' | 'hongkong' | 'japan'; // Convenções regionais.
  lineBreak?: 'auto' | 'none' | 'basic' | 'gb' | 'strict'
    | 'ja-very-strict' | 'ja-strict' | 'ja-loose';      // Que sinais não podem abrir nem fechar uma linha.
  punctuationWidth?: 'auto' | 'fullwidth' | 'kaiming' | 'lineEndHalf' | 'halfwidth';
  compressAdjacent?: 'auto' | boolean;      // Dois sinais vizinhos ocupam 1.5 em.
  trimLineStart?: 'auto' | boolean;         // Parênteses na borda da linha perdem a metade externa.
  hangingPunctuation?: 'auto' | 'none' | 'allow' | 'force';
  spaceAfterQuestion?: 'auto' | boolean;    // Um eme depois de ？！ dentro do parágrafo (Japão).
  paragraphStartBracket?: 'auto' | 'indent' | 'half' | 'flush'; // Parêntese que abre um parágrafo com recuo.
  wordBreak?: 'normal' | 'keep-all';        // keep-all: quebrar só nos espaços (分かち書き, coreano).
  titleMinChars?: number;                   // Caracteres de um título de obra de cada lado de uma quebra; padrão 2.
  circledNumbers?: 'cjk' | 'western';       // ① ② como caracteres chineses (padrão) ou como letras latinas.
  composeDesignText?: boolean;              // Regras CJK no texto de design; padrão true.
  latinSpacing?: Dimension;                 // Entre han e latim; padrão 0.25 em.
  uprightDigits?: 0 | 2 | 3 | 4;            // Texto vertical: números numa célula em pé; padrão 2.
  grid?: { enabled?: boolean; charsPerLine?: number; linesPerPage?: number; show?: boolean };
  emphasis?: 'auto' | 'italic' | 'dots';    // O que *…* faz com os caracteres CJK.
  emphasisMark?: {                          // A marca que *…* e :dots[…] desenham quando não a indicam.
    style?: 'auto' | 'dot' | 'circle' | 'sesame';
    fill?: 'auto' | 'filled' | 'open';
    position?: 'auto' | 'over' | 'under';
  };
  bookTitleMark?: 'auto' | 'brackets' | 'wavy' | 'none'; // O que :book[…] imprime.
  bookTitleBrackets?: 'auto' | { open: string; close: string }[]; // Os parênteses, do mais externo para dentro.
  annotationColor?: ColorValue;             // Pontos e linhas de nome/título; padrão a cor do texto.
  ruby?: {
    fontFamily?: string; fontSize?: Dimension; color?: ColorValue;
    position?: 'auto' | 'over' | 'under' | 'right';
    overhang?: 'auto' | 'none' | 'kana' | 'any'; // Quanto uma leitura pode avançar sobre os vizinhos.
    align?: 'auto' | 'center' | 'jis' | 'start'; // Como se espaça uma leitura mais curta que a base.
    smallKana?: 'keep' | 'full';                 // Kana pequenos nas leituras como escritos, ou em tamanho cheio.
  };
  warichu?: { fontSize?: Dimension; color?: ColorValue; open?: string; close?: string };
  kunten?: { fontSize?: Dimension; color?: ColorValue; placement?: 'inline' | 'interlinear' }; // Marcas de kanbun.
}

Os níveis japoneses seguem as três convenções do Apêndice C.3 do JLReq. Em todos eles nenhuma linha termina com um parêntese ou uma aspa de abertura, um símbolo de moeda fica com seu número (exceto em ja-loose), a barra não tem regra, e ——, ―― e …… podem abrir uma linha mas nunca se separam (nem 〳〵):

Em todos os níveis:

• —— e …… formam uma unidade de dois emes que nunca se separa; duas unidades assim seguidas podem se separar entre si.
• Um número conserva seus sinais e sua unidade (¥5,999, 50%, 50％, 120㎡), também com um espaço no meio (−3 ℃, 50 %), e uma palavra latina fica inteira: o texto ocidental entre caracteres CJK é composto como um trecho que nenhuma linha quebra por dentro, a não ser que o trecho sozinho seja mais largo que a linha (nesse caso ele é dividido numa sílaba, com hífen, ou no último caractere que cabe; um endereço web, nas suas junções). Os quadrados de unidade ㎡ ㎏ ㎞ ㏄ (U+3371–337A, U+3380–33DF, U+33FF) pertencem ao trecho do seu número e não tornam CJK um parágrafo latino.
• Um número ou uma palavra em algarismos e letras de largura cheia (１２３４５６, ５０％, ￥５９９, ３．１４, １２：３０, ＡＢＣ) também nunca se divide; uma linha justificada espaça seus caracteres como espaça os han.
• Um espaço entre palavras só é ponto de quebra onde as regras o permitem: a linha não quebra ali quando o caractere seguinte não pode abrir uma linha (参见图表 （ 第三章 ） nunca abre uma linha com ）) ou quando o último antes dele não pode fechá-la.
• Uma chamada de nota, um :ref e um sobrescrito ou subscrito ficam com o caractere anterior.
• O espaço ideográfico U+3000 é um caractere de um eme de largura: uma linha pode quebrar depois dele, nunca antes; ele nunca é esticado nem suprimido no início de uma linha. Para o recuo de dois caracteres dos parágrafos chineses, defina bodyText.firstLineIndent: { value: 2, unit: 'em' } em vez de digitar dois U+3000 (o analisador descarta os que abrem um parágrafo).

Quando um caractere não cabe na linha e pode abrir a seguinte, ele desce, e uma linha justificada distribui o que sobra. Quando não pode abrir a linha seguinte (uma vírgula, um parêntese de fechamento, o caractere depois de um de abertura), a linha tenta primeiro acomodá-lo comprimindo-se (push-in, clreq §6.2.2.3): se o branco que ela pode ceder (veja Largura da pontuação) cobre o excesso, o caractere (com os sinais que precisam ficar com ele, uma aspa de fechamento depois de um ponto final) entra na linha e a linha é ajustada à medida. Caso contrário, a linha cede caracteres a ele (push-out): a quebra recua até o último ponto que as regras permitem, e uma linha justificada distribui o que sobra. Numa linha mais estreita que um número com seu ponto final, nada pode terminar a linha, e ela acaba quebrando antes do ponto final.

A que parágrafos isso se aplica: aos que têm mais caracteres CJK (han, kana, bopomofo, hangul) do que espaços entre palavras, mesmo sem dois deles seguidos (第1条、第2条, 价¥5,999。好). Um espaço junto a um caractere ou sinal CJK não é um espaço entre palavras: 2026 年 9 月 28 日 é composto como 2026年9月28日. Esses parágrafos são compostos linha a linha, tanto no caminho simples quanto no formatado, de modo que um parágrafo com uma palavra em negrito quebra exatamente como o mesmo texto sem ela. Um parágrafo latino que cita um título ou um nome chinês tem mais espaços que caracteres: ele mantém a quebra de linhas ótima, e uma linha pode quebrar junto aos seus caracteres CJK pelas mesmas regras. Legendas, células de tabela, notas e boxes também quebram no nível do documento. A hifenização por dicionário não alcança as palavras latinas de um parágrafo CJK.

Uma linha CJK justificada que não é a última do parágrafo é espaçada até a medida nesta ordem (clreq §6.2.2.4): os espaços entre palavras ocidentais, até meio eme cada um; os espaços entre han e latim, até meio eme cada um; depois todos os intervalos entre caracteres, e esses espaços, por igual. Nenhum espaço entra numa palavra latina, num número ou num sinal de dois emes, nem junto a um conector ou a uma barra. O espaçamento é definido por segmento da linha (VDTLineSegment.tracking, px depois de cada caractere, incluídos no width do segmento), que o canvas, o HTML e o PDF pintam como espaçamento entre letras; uma palavra latina seguida de um intervalo dá à sua última letra um segmento próprio. Um segmento contém um trecho ocidental, ou caracteres de um mesmo estilo, link e espaçamento que avançam igual, por isso o Sandbox distribui sua largura por igual entre eles ao posicionar o cursor, e um link cobre só os seus próprios caracteres. Quando uma linha precisaria de mais de meio eme entre os caracteres (ou mais que bodyText.maxJustifyTracking, quando definido), ela é composta com esse máximo e termina antes da medida: a linha recebe as marcas cjkLoose e ragged, e a composição emite um aviso de conteúdo cjkLooseLine com o texto da linha. A causa costuma ser uma palavra latina longa ou um endereço web que não consegue subir. Uma linha sem nenhum caractere CJK (o começo de um endereço web longo) fica em bandeira sem o aviso, como uma linha latina de uma única palavra. Veja Hifenização e justificação.

#Largura da pontuação

Um sinal chinês de largura cheia é meio eme de glifo e meio eme de branco, e os ajustes mexem no branco, nunca no glifo (clreq §6.3.2). O branco fica antes do glifo num parêntese ou aspa de abertura, depois do glifo num de fechamento, e depois do glifo nos sinais de pausa e de fim de frase da China continental 、，。．；：？！, que ficam no canto da sua caixa; os sinais que Taiwan e Hong Kong centralizam (、，。．；：) e os pontos médios guardam um quarto de eme de cada lado. ？！ continuam com um eme no texto horizontal de Taiwan e Hong Kong, e ：；？！ no texto vertical em todas as regiões. O ponto médio da China continental ocupa meio eme em qualquer estilo, centralizado, nos dois sentidos de escrita (GB/T 15834, clreq §5.1): um glifo de largura cheia cede o branco dos dois lados, e no texto vertical sua célula já mede meio eme.

No Japão (punctuationWidth: 'fullwidth', o valor automático), os sinais seguem o JLReq §3.1: 、，。． mantêm o branco depois do glifo, ：； e ・ um quarto de eme de cada lado, e ？！ preenchem o seu eme. Um sinal de fechamento no fim da linha conserva seu meio eme e o cede inteiro, antes de qualquer outro branco, quando a linha precisa acomodar mais um caractere; o branco depois de 。 nunca é reduzido dentro da linha. Uma linha devolve espaço na ordem do JLReq §3.8.3: espaços entre palavras, o branco do sinal que termina a linha, pontos médios, parênteses e 、，, e depois o espaço entre japonês e latim; e é espaçada sem acrescentar espaço depois de um parêntese de abertura, antes de um de fechamento ou junto a 、。・：；？！ e U+3000 (§3.1.11). 、 e ・ entre dois numerais kanji são compostos sem branco e nunca quebram (二、三日, 三・一四). Um documento japonês com outro punctuationWidth (kaiming, halfwidth…) segue, em vez disso, as regras do clreq desta seção.

Com compressAdjacent, dois sinais que se encontram cedem o branco entre eles (as oito regras dos rascunhos anteriores do clreq): um parêntese de fechamento depois de outro de fechamento ou depois de um sinal de pausa ou de fim de frase da China continental (。」, não depois dos sinais centralizados de Taiwan e Hong Kong), um sinal de pausa ou de fim de frase depois de um parêntese de fechamento (」，), um parêntese de abertura depois de qualquer um deles ou depois de outro de abertura (，「, 》（, 「『), e um quarto de eme entre um ponto médio e um parêntese de fechamento antes dele ou um de abertura depois dele. Nunca mais do que o necessário para deixar o par em 1,5 eme: no Kaiming, 。” já ocupa 1,5 eme e assim fica, 》（ ocupa um eme. O Kaiming põe o branco de um sinal de fim de frase depois do sinal de fechamento que o segue, com ou sem compressAdjacent: os dois glifos ficam juntos e o meio eme vem depois da aspa (。”␣母, não 。␣”母), e no fim da linha ele cai como o de um ponto final. Com trimLineStart, um parêntese de abertura que inicia uma linha cede o branco anterior, de modo que sua tinta se alinha com a borda do texto (na primeira linha de um parágrafo ele fica meio eme para dentro do recuo), e um de fechamento que termina uma linha cede o branco posterior. Um sinal centralizado cede um quarto de eme de cada lado, nunca meio eme de um só. Quando uma linha quebra entre dois sinais, nenhum deles mantém a compressão: cada um é composto como sinal na borda da linha (uma ， de largura cheia cujo 「 abre a linha seguinte termina sua própria linha com um eme inteiro).

Uma linha acomoda um caractere que não pode abrir a linha seguinte (push-in) quando o branco que ela ainda pode ceder cobre o excesso, na ordem do clreq: espaços entre palavras até um quarto de eme, depois pontos médios, parênteses, sinais de pausa, os espaços entre han e latim até um oitavo de eme e, por último, os sinais de fim de frase, cada etapa distribuída por igual. kaiming só deixa seus sinais de fim de frase descerem a meio eme, e só nesse caso: uma linha à qual simplesmente falta espaço para mais um caractere é espaçada, de modo que 。？！ mantêm o seu eme dentro da linha. lineEndHalf deixa todos os sinais descerem a meio eme; os sinais de fullwidth não cedem nada (um livro de largura cheia mantém sua grade), e os de halfwidth não têm mais nada a ceder.

Os sinais que o texto latino compartilha com o chinês (“ ” ‘ ’ … — ·) ocupam no texto chinês a caixa de um sinal chinês, seja qual for o avanço da própria fonte: a LXGW WenKai desenha “ ” com 0,35 eme, a Noto Serif SC o travessão com 0,89 eme e o · com um terço de eme. Eles contam como chineses quando o caractere mais próximo de um dos lados (passando por outros sinais desses) é chinês, ou quando não há nada ocidental ao lado deles. O glifo de uma aspa de abertura fica no fim da sua caixa de um eme, o de uma de fechamento no começo; um ponto médio, umas reticências e um travessão isolado ficam no meio; um par de reticências (……) é composto como a fonte compõe os dois juntos e centralizado nos seus dois emes. Um 破折号 (——) é um fio contínuo: cada travessão é esticado sobre o seu eme a partir do espaço lateral da própria fonte, os dois traços se sobrepõem na junção e sobem até o centro dos caracteres (VDTLineSegment.inkScale, uma escala que só afeta a pintura). Depois o estilo ajusta a caixa como a de qualquer outro sinal. Com texto ocidental dos dois lados (他说：He said “yes” and left.), eles mantêm o avanço da fonte, e um glifo que já mede um eme não muda nada.

Os renderizadores mantêm fora do texto o espaçamento de pontuação do próprio navegador. O Chrome compõe com meia largura o primeiro de dois sinais vizinhos quando os mede ou pinta num único trecho (本）》录 em Noto Serif SC mede 3,5 eme desse jeito), por isso dois sinais vizinhos são medidos e pintados separadamente, e as linhas HTML de texto CJK levam text-spacing-trim: space-all e text-autospace: no-autospace, com os recursos chws, halt e vchw desativados.

No VDT, um sinal que cedeu branco é um segmento próprio, cujo width é o avanço que ele conserva, com inkOffset (px) definido: os renderizadores pintam seu glifo em x + inkOffset, de modo que um sinal que cedeu o branco anterior ao glifo (um parêntese de abertura no início de uma linha) é desenhado essa distância antes da sua caixa (um deslocamento negativo). Um sinal compartilhado composto numa caixa chinesa carrega a posição do seu glifo na caixa, menos o branco que tenha cedido antes dele, o que pode dar um valor positivo. O PDF mostra esse glifo com um espaçamento entre caracteres que termina o avanço onde termina a caixa, para que um leitor nunca o veja invadir o caractere seguinte, e põe a linha num trecho /ActualText (veja Espaço entre han e latim). Quem decide de que lado fica o branco de um sinal é a região, não a fonte: componha um livro numa fonte da sua região (Noto Serif SC para a China continental, TC para Taiwan, HK para Hong Kong); uma fonte tradicional sob uma etiqueta da China continental comprime o lado errado dos seus sinais centralizados.

#Pontuação pendente

hangingPunctuation: 'allow', o valor automático no Japão, deixa um dos sinais 、，。． (na China continental, cujos sinais ficam no início da caixa, também ；：？！) ficar pendente além do fim da linha quando, do contrário, ele abriria a linha seguinte e a compressão da linha não consegue acomodá-lo; nunca no texto horizontal de Taiwan e Hong Kong, cujos sinais centralizados pareceriam cortados (no texto vertical, sim). No texto vertical o sinal pendente fica abaixo do pé da linha. 'force' deixa esse sinal pendente sempre que ele termina uma linha (menos a última de um parágrafo), e de imediato quando ele não cabe. Um sinal nunca fica pendente quando outro sinal o toca (。」, ，「). O segmento pendente recebe a marca hangs; o bbox.width da linha, sua justificação e seu alinhamento o deixam de fora, e o canvas e o PDF alargam o recorte da coluna pelo sinal pendente mais largo (hangingPunctuationOverhang), de modo que ele nunca é cortado. A maioria dos livros chineses não usa pontuação pendente; o clreq só a recomenda com uma grade de caracteres. Os livros japoneses deixam pendentes 、。，． (burasagari), nunca ；：？！ nem os parênteses, nos dois modos de escrita, e só quando a compressão da linha não consegue acomodar o sinal.

#Espaço entre han e latim

latinSpacing (por padrão um quarto de eme) põe um espaço entre um caractere han (ou kana) e uma letra latina ou algarismo europeu vizinho: 用iPhone拍照 e 1999年 são compostos 用 iPhone 拍照 e 1999 年. Não há esse espaço no início nem no fim da linha, nem entre um caractere latino e um sinal chinês (用iPhone， não põe nada antes da vírgula), nem dentro de parênteses chineses (（iPhone）), nem junto a um símbolo que não seja letra nem algarismo (为¥5,999). Um espaço que o autor digitou nesse limite (用 iPhone 拍照, como trazem muitos textos da web) é substituído pelo espaço entre han e latim, não somado a ele, e as duas grafias são compostas igual; um espaço inseparável ou um espaço ideográfico fica como está. Numa linha justificada ele cresce até meio eme antes de os caracteres serem espaçados; numa linha que acomoda um caractere que não pode abrir a seguinte, ele encolhe até um oitavo de eme. Uma medida em qualquer unidade que não seja em é convertida pelo dpi da página. 0 o desativa, e um espaço digitado ali continua sendo um espaço entre palavras.

O espaço é um segmento de kind: 'space' com a marca autospace, com text vazio (ou o espaço que o autor digitou); seu width é definitivo, e a justificação de espaços própria dos renderizadores o deixa como está. Ele nunca entra no texto simples, de modo que a busca, copiar e colar e os intervalos de origem leem o texto como foi escrito. O PDF põe cada linha composta em partes (caracteres espaçados, espaços entre han e latim, sinais que cederam branco ou estão pendentes) num /Span cujo /ActualText é o texto da linha, de modo que a extração de texto lê 用iPhone拍照, não 用 iPhone 拍 照, e lê uma linha com sinais de meia largura como uma única linha.

#Números em texto vertical

No texto vertical, uma palavra latina ou um número longo é composto deitado, e um número curto fica em pé, com os algarismos lado a lado numa única célula de um eme: tate-chu-yoko (縱中橫, clreq §2.1.3, CSS text-combine-upright). uprightDigits define quantos algarismos esse número pode ter: 2 (o padrão), 3, 4, ou 0 para nenhum. 2026年9月28日 com 2 fica com 2026 deitado, 9 em pé e 28 em pé numa única célula.

• O número inteiro ou nada dele: com 2, um número de três algarismos continua deitado, nunca dividido.
• Um número que toca uma letra latina (A4, mp3, 3D) fica na sua palavra, deitado; o mesmo vale para um número escrito com ponto decimal ou separador de milhares (3.14, 10,000).
• Um número dentro de uma frase latina acompanha a frase: quando há uma palavra latina dos dois lados, ele corre deitado com as palavras (printed in 49 and 32 copies, chapters 49, 32 and (7) of). De cada lado, a busca passa por espaços, outros números, chamadas de nota, a pontuação de um trecho deitado (, . : ; ( ) ' " - /), a meia-risca, o travessão e as aspas curvas (pages 3–5 of, the “49” copies) até a primeira letra ou caractere chinês. Um número cujos sinais levam a texto chinês fica em pé (上午12:30:45开会, 比分为3:2:1, 见图(3)所示, 他住在"12"号楼), e o mesmo vale para um número junto a um caractere ou sinal chinês, com ou sem espaço (第 3 回, 用iPhone 15拍攝, 第3 copies), para um ao lado de um símbolo que fica em pé (a 30×40 print) e para um no início ou no fim de um parágrafo, que tem palavra de um lado só (49 copies were printed, on page 7.: escreva :sideways[…] para deitá-lo). O parágrafo é lido inteiro, atravessando quebras de linha, ênfases e links.
• Junto a um símbolo que o Unicode põe em pé, cada número ocupa sua própria célula: 30×40 fica 30, ×, 40, tudo em pé.
• Uma célula com mais caracteres do que cabem num eme é comprimida na horizontal até o eme; o tracking e a justificação nunca entram nela, só depois dela.
• Para quebrar e justificar, a célula conta como um caractere chinês, e nenhum espaço entre han e latim é posto em volta dela.
• No Japão, os pares !!, !?, ?! e ??, de meia largura ou de largura cheia, também ficam em pé numa única célula (すごい！？), a menos que uma letra latina, um algarismo ou um terceiro sinal os toque; um par de largura cheia é pintado com os sinais de meia largura. Kana pequenos, ：；, “ ” (pintados 〝〟) e ・ usam as formas verticais japonesas (veja Composição japonesa › Formas verticais).
• O medidor e todos os renderizadores encontram as mesmas células: o canvas pinta os algarismos de volta em pé e comprimidos, o PDF faz o mesmo com a fonte horizontal, e o HTML os envolve em text-combine-upright: all.

À mão, três marcas inline substituem o ajuste no texto vertical e não mudam nada no texto horizontal (veja Formato do documento › Orientação no texto vertical):

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

:tcy[…] compõe seu texto numa única célula em pé, :upright[…] põe cada caractere em pé numa célula própria (as letras latinas centralizadas nela), :sideways[…] deita o trecho inteiro, incluindo os caracteres chineses. No VDT, um trecho :tcy é um segmento com tcy: true, de um eme de largura; um trecho :upright ou :sideways carrega orientation. Os números compostos numa única célula por uprightDigits não carregam marca: verticalRuns(graphemes, region, uprightDigits) os encontra. Num parágrafo, um número curto que corre com palavras latinas carrega orientation: 'sideways', como se estivesse escrito :sideways[…]: seu segmento nem sempre contém as palavras que ele acompanha.

#Grade de caracteres

Uma mancha chinesa é especificada em caracteres (clreq §7.1.1): o corpo do texto × caracteres por linha × linhas por página, mais o espaço entre linhas e, com duas colunas, a medianiz. grid a define dessa forma:

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

Com enabled, a configuração é reescrita antes que qualquer coisa a leia: cada coluna tem charsPerLine emes de bodyText.fontSize de largura, e a mancha linesPerPage linhas de bodyText.lineHeight de altura; com layoutType: 'double', a medianiz é layout.gutterWidth arredondada para um número inteiro de emes, no mínimo um. As margens em page.margins funcionam como mínimos: a mancha é centralizada na área que elas deixam, e cada margem cresce metade da sobra no seu eixo (um livro espelhado mantém as margens interna e externa diferentes, as duas crescidas na mesma medida). Sem valor, charsPerLine e linesPerPage assumem quantos couberem. Um número maior do que cabe é reduzido ao que cabe e informado como um aviso de configuração cjkGridClamped. O corpo e a entrelinha ficam como escritos. Numa diagramação oneAndHalf, charsPerLine é o da coluna principal; a coluna lateral recebe o número inteiro de emes mais próximo da largura que sideColumnPercent lhe dá dentro das margens configuradas (no mínimo um), a medianiz é arredondada como numa de duas colunas, e sideColumnPercent é reescrito para que as duas colunas sejam cortadas em emes inteiros. No texto vertical (layout.writingMode: 'vertical-rl'), os caracteres de uma linha correm de cima para baixo na página e as linhas a atravessam, de modo que charsPerLine mede a altura da página, uma diagramação double dá dois andares empilhados de cima para baixo, e as células da sobreposição ficam no eixo em que os caracteres estão centralizados.

Duas diagramações da prática chinesa, em 五号 (10,5 pt) com 6 pt de espaço entre linhas (lineHeight: 16.5pt):

• 大32开, 140 × 203 mm, 28 × 28: uma medida de 294 pt (103,7 mm) e uma mancha de 462 pt (163 mm); page.margins de 16/20 mm interna e externa e de 18/20 mm superior e inferior deixam espaço para ela.
• 16开, 184 × 260 mm, duas colunas de 23 caracteres em 小五 (9 pt, linhas de 13,5 pt) com medianiz de dois caracteres: 2 × 207 pt + 18 pt.

show desenha a grade (稿纸) sobre a mancha, um quadrado cinza-claro por posição de caractere em cada linha (a caixa de eme do caractere em torno da sua linha de base), em cada coluna da página (uma coluna lateral oneAndHalf do lado em que a paridade da página a põe), no canvas e no HTML. O PDF só a desenha quando renderToPdf recebe characterGrid: true: é uma ajuda para a tela. cjkGridGeometry(config) devolve a grade que uma configuração define (números em uso, margens, mancha) e applyCjkGrid(config) a configuração reescrita.

#Marcas, rubi e warichu

A marcação de marcas chinesas, rubi e warichu mantém o texto no parágrafo: a busca, o sumário, as âncoras do índice remissivo e o texto copiado leem os caracteres como foram escritos, e só o que se desenha em volta deles depende destes ajustes.

• Pontos de ênfase (着重号, 傍点; :dots[…], e *…* sobre caracteres CJK com emphasis: 'dots') põem uma marca por caractere, centralizada nele (sem contar o espaçamento de uma linha justificada), nunca na pontuação nem nos espaços: sob o caractere no texto horizontal, à direita dele no texto vertical (clreq §5.3.1). style escolhe um ponto cheio, um círculo vazado ou um gergelim, fill="open" desenha o contorno, pos="over|under" o lado; emphasisMark define o que uma marca deixa sem definir (no Japão, um gergelim sobre o texto, à direita dele no texto vertical). Um gergelim fica na mesma posição na folha nos dois modos de escrita, e as marcas do lado de uma leitura em rubi ficam por fora dela.
• Linhas laterais (傍線, :sideline[…]{style pos}) correm ao lado do texto, incluindo pontuação e espaços: solid, double, wavy ou dotted, sob o texto na horizontal e à direita dele na vertical, por padrão; duas linhas que se encontram cedem cada uma um oitavo de eme. Funcionam em qualquer escrita.
• Linhas de nome próprio e de título de obra (专名号 :name[…], 书名号 :book[…] com bookTitleMark: 'wavy') correm sob a caixa de eme dos caracteres (à esquerda dela no texto vertical), atravessando os espaços dentro do trecho. Onde dois trechos se encontram, cada ponta cede um oitavo de eme, de modo que :name[賈寶玉]:name[林黛玉] se lê como dois nomes. Quando pontos e uma linha marcam o mesmo texto do mesmo lado, a linha fica mais perto do texto. Com 'brackets', os 《》 são texto com o qual as linhas são quebradas, pintado e copiado como qualquer outro caractere; eles não ocupam nenhum caractere do texto simples nem do mapa de origem (os segmentos recebem a marca inserted).
• As leituras em rubi ficam no espaço entre as linhas, encostadas na caixa de eme da base, centralizadas nela; uma leitura que contém uma letra latina (pinyin) e fica sobre a base sobe a profundidade das descendentes da sua fonte (g, j, p, q, y) mais 0,04 eme do texto, para não tocar a base, e todas as leituras da linha mantêm uma única linha de base; uma leitura mais larga que a base alarga a caixa da base, descontado um quarto do eme do rubi que ela pode avançar sobre um vizinho sem leitura, e duas leituras ficam a um quarto do eme do rubi uma da outra (duas leituras em zhuyin, a um quarto do eme dos símbolos, de modo que três símbolos ao lado de cada um de dois caracteres ficam nas suas células). Um rubi mono (uma leitura por caractere) pode quebrar entre seus caracteres; um rubi de grupo nunca quebra. No Japão, uma leitura segue ruby.align e ruby.overhang: espaçada 1:2:1 quando é mais curta que a base, avançando sobre kana mas não sobre kanji quando é mais longa, e o resto do espaço vem de espaçar a base; um rubi por caractere de dois ou mais caracteres é rubi jukugo, cada caractere mantém sua leitura, que pode avançar sobre o caractere seguinte da palavra mas nunca se sobrepõe a outra leitura, e a linha continua podendo quebrar entre eles (JLReq §3.3). No início ou no fim de uma linha, base e leitura se alinham à borda (clreq §5.5.4). O zhuyin no texto horizontal fica numa coluna à direita de cada caractere, e a caixa do caractere cresce com a coluna; no texto vertical, a mesma coluna desce pela direita dos caracteres. O sinal de tom vai à direita da coluna, com metade da tinta acima do topo do último símbolo (clreq §5.5.3.3), posicionado pela tinta porque as fontes põem esses sinais no alto da sua caixa de eme, e no texto vertical ele fica em pé, como o ponto do tom neutro acima do primeiro símbolo.
• As notas warichu (双行夹注) se dobram em duas linhas no corpo da nota, centralizadas na linha, sem espaço entre elas. A linha de cima recebe caracteres até conter pelo menos metade da parte, de modo que a de baixo nunca é a mais longa, e mais um enquanto a linha de baixo começaria com um sinal que não pode abrir linha. Uma nota mais longa que o espaço que resta na linha o preenche e continua na linha, coluna ou página seguinte; seus parênteses só vão antes da primeira linha e depois da última. No texto vertical a linha de cima é a da direita, lida primeiro.
• As marcas de kanbun (:kunten[字]{kaeri okuri tate}) põem as marcas de retorno do último caractere do lado do pé da linha, depois dele (embaixo à esquerda no texto vertical), seu okurigana do lado da cabeça, a partir do meio, os mais longos empurrando o caractere seguinte, e o tatesen como um fio curto até o caractere seguinte (JIS X 4051 §5). O texto copiado e o /ActualText do PDF leem o okurigana depois dos seus caracteres e deixam de fora as marcas de retorno; um espaço entre linhas estreito demais para elas é informado como kuntenExceedsLeading.

O passo das linhas nunca muda: marcas e leituras vivem na entrelinha. Um parágrafo cujo espaço entre linhas (a entrelinha menos o corpo do texto) é menor que meio eme com marcas de um lado, ou cinco oitavos com marcas dos dois lados (clreq §5.6.1), é informado como um aviso de conteúdo cjkMarksExceedLeading; um cujas leituras são mais altas que o espaço (uma leitura em pinyin contada com a sua elevação), como rubyExceedsLeading. Dê a esses parágrafos um estilo de parágrafo com mais entrelinha. Os livros japoneses com furigana costumam usar uma entrelinha do texto de cerca de 1,75 eme (JLReq §2.4.2).

No VDT, um segmento marcado carrega cjkMarks, e a diagramação põe os pontos e as linhas nas suas linhas como VDTLine.marks (pontos, círculos, gergelins, linhas retas, duplas, pontilhadas e onduladas, no referencial de fluxo da linha), que o canvas, o HTML e o PDF desenham como estão (PDF: Artifact /Layout; HTML: caixas aria-hidden, texto pontilhado em <em>). O segmento de uma base de rubi carrega ruby (a leitura e seus trechos; numa leitura japonesa, também o id que sua anotação compartilha com os outros caracteres de uma palavra jukugo, e jukugo) e pinta sua base em inkOffset, com tracking, quando a leitura a espaçou; um caractere com marcas de kanbun carrega kunten (seus trechos e seu tatesen); a parte de uma nota warichu numa linha é um único segmento cujo text é a linha de cima seguida da de baixo e cujo warichu contém as linhas que os renderizadores pintam no lugar. O PDF etiquetado põe uma leitura no RT do Ruby da sua base e uma nota num Warichu, e o /ActualText da linha lê o texto da base e a nota uma única vez. Marcas, leituras e notas são desenhadas no texto corrido, nos títulos, nas listas e nos boxes, e nas legendas, células de tabela e notas dos recursos, cujas linhas carregam marks e ruby como as linhas do corpo; o texto de design mantém o texto sem elas.

O resolvedor e o removedor de padrões seguem as outras seções. spaceAfterQuestion, paragraphStartBracket e wordBreak, e os overhang, align e smallKana do rubi, só aparecem na configuração resolvida quando mudam alguma coisa (no Japão, ou quando definidos). setCjkLineBreak e setCjkComposition definem o nível e a composição (larguras da pontuação, pontuação pendente, espaço entre han e latim; cjkCompositionOf(resolved.cjk, dpi)) para medições feitas fora de buildDocument, que os define a partir da configuração. Fora de uma composição, os sinais mantêm o avanço completo e nenhum espaço entre han e latim é posto:

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 },
//   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: '' }, 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: '）' }, kunten: { … } }

No Sandbox, esses ajustes ficam em Design › Sistema de escrita › Tipografia do Leste Asiático.