Em poucas palavras
O começo de um conto de Lu Xun composto como uma brochura chinesa. Mostra como pôr exatamente 28 caracteres em cada linha e 28 linhas em cada página, seguindo as regras chinesas de pontuação.
O que você vai compor
O começo de “Minha terra natal” (故乡, 1921), de Lu Xun, como o comporia uma brochura da China continental com a primeira coletânea dele: uma página 大32开, de 140 × 203 mm, cuja mancha é contada em caracteres, 28 por linha e 28 linhas por página, em Noto Serif SC de corpo 五号 (10,5 pt). Todo parágrafo começa com recuo de dois caracteres; vírgulas e aspas ocupam meio caractere, como na maioria dos livros do continente; nenhuma linha começa com 。 ou , e nenhuma termina com “. O conto abre num recto, sob o título no peso preto da Song. Em frente, uma prancha pintada mostra o campo de melancias ao luar de que o narrador se lembra, com as palavras que o descrevem na letra de pincel Ma Shan Zheng. Espanhol justificado num romance de bolso faz o mesmo trabalho com uma escrita latina.
Esta receita responde a
- Como defino a mancha em caracteres, tantos por linha e tantas linhas por página?
- Como evito que 。 e , comecem uma linha?
- Como componho a pontuação chinesa no estilo Kaiming, como nos livros da China continental, ou em meia largura?
- Como ponho um espaço entre palavras chinesas e latinas sem digitá-lo?
A resposta curta
const cjk = {
// The type area in characters: 28 ems wide, 28 lines of LEAD tall. page.margins become
// minimums, and the grid centres the type area in the room they leave.
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
// What 'zh-Hans' gives by itself, written out so a reader can compare regions and styles.
region: 'mainland',
lineBreak: 'gb', // no 。,、”》 opens a line, no “《( ends one, and no / at either end
punctuationWidth: 'kaiming', // ,、:; quotes, brackets ½ em; 。?! one em, ½ at a line end
compressAdjacent: true, // idle under Kaiming (no pair tops 1.5 em); 'fullwidth' needs it
latinSpacing: em(0.25), // 1921年, 用Noto Serif SC五号: a quarter em, none of it typed
};
const bodyText = {
fontFamily: SONG, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', // spread between the characters, never between words
firstLineIndent: em(2), indentAfterHeading: true, // two characters, every paragraph
};
Ingredientes
- Funcionalidades
- Grade de caracteresQuebra de linha em chinêsLargura da pontuação chinesaJustificação entre caracteresEspaço entre chinês e latimFontes chinesas, japonesas e coreanasRecuos, alinhamento e espaço entre parágrafosTipografia do textoCabeços e fóliosAberturas desenhadasEstilos de títuloAtributos de títuloTextos, fios e caixas nos designs de páginaCabeços por tipo de páginaMargens espelhadasEstilos de parágrafoMarcadores do PDF
- Também usa
- Cor do papelExportação para PDFFontes incorporadas ao PDFFiguras e tabelas como recursosCabeços por seção
- Tipografia
- Noto Serif SC, Noto Sans SC, Ma Shan Zheng (SIL OFL 1.1)
- Materiais
plate-1120.jpg- The plate: the moonlit melon field of the story, a painting (Generated With Diffusion Models, original)
Preparo
#1 · Uma página contada em caracteres
O código é a resposta curta lá em cima. cjk.grid faz a medida ter 28 emes de bodyText.fontSize (294 pt, 103,7 mm) e a mancha, 28 linhas de lineHeight (462 pt, 163 mm), e depois desloca as margens para que caibam, por isso uma linha cheia de han tem exatamente 28 caracteres e toda página cheia termina na mesma linha (grade de caracteres). Os cinco ajustes abaixo da grade são o que locale: 'zh-Hans' já dá sozinho; estão escritos por extenso para você poder mudar um de cada vez, embora compressAdjacent não mude nada enquanto punctuationWidth não for 'fullwidth': com Kaiming, dois sinais seguidos nunca ocupam mais de 1,5 em. Na página 71, o 。 que fecha um parágrafo não cabe, e as regras de início de linha (todos os níveis de lineBreak menos 'none'; 'gb' acrescenta a barra) o proíbem de abrir uma linha. A linha o recolhe compondo com meio caractere de largura o 。 depois de 事 (push-in), e assim 事。宏 se aperta e o parágrafo não ganha mais uma linha (larguras da pontuação). O espaço das linhas curtas é distribuído entre os caracteres, nunca entre palavras, e nestas páginas não passa de 0,05 em (chinês, japonês e coreano).

#2 · Um 大32开 com margem superior maior
const page = {
width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, backgroundColor: col('paper'),
// 22 + 18 mm leave 163 mm, exactly 28 lines of 16.5 pt; 18 mm a side leave the 103.7 mm
// measure 0.3 mm to share. A grid that no longer fits is cut down (cjkGridClamped).
margins: { top: mm(22), bottom: mm(18), left: mm(18), right: mm(18), mirror: true },
};
Com a grade ativada, as margens são mínimas: a grade põe a mancha no espaço que elas deixam e distribui o que sobra. 22 e 18 mm deixam exatamente 163 mm, por isso a margem superior continua 4 mm maior que a inferior, como nos livros chineses; os 18 mm de cada lado deixam 0,3 mm para distribuir. Se você pedir mais caracteres ou linhas do que cabem, a grade é reduzida ao que cabe, com um aviso cjkGridClamped; o corpo e a entrelinha ficam como foram escritos.
#3 · Um título rebaixado um número inteiro de linhas
const SINK = 8; // lines of LEAD: a whole number, so the text under it keeps to the grid
const centred = (y) => ({ anchor: { to: 'container', edge: 'top' }, offset: { y: mm(y) } });
const opener = {
enabled: true,
minHeight: pt(SINK * LEAD),
slot: { elements: [
// The spacing after the last character is advance, not ink: the title stays centred.
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: SONG, fontWeight: 900,
fontSize: pt(46), letterSpacing: pt(23), lineHeight: 1.1, color: col('ink'),
align: 'center', placement: centred(6) },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1.2),
color: col('night'), placement: { ...centred(30), size: { width: mm(8) } } },
{ kind: 'text', id: 'author', content: '{author}', fontFamily: HEI, fontSize: pt(10.5),
letterSpacing: pt(5), color: col('ink'), align: 'center', placement: centred(34) },
] },
};
// parity 'any': a story opens on the next page, left or right.
const chapter = { level: 1, breakBefore: { enabled: true, parity: 'any' },
marginTop: pt(0), marginBottom: pt(0), advancedDesign: opener };
minHeight tem oito linhas de 16,5 pt, de modo que o texto sob o título começa na nona linha da grade, nas mesmas linhas de base de qualquer outra página. Os 23 pt de espaçamento entre letras põem meio caractere entre 故 e 乡, o espaçamento habitual num título de dois caracteres; o Postext não conta o espaçamento depois do último caractere ao centrar a linha, por isso o título fica no eixo da página (estilos de título).
#4 · O livro no verso, o conto no recto
const HEAD_Y = 11; // mm from the top edge to the heads; the hairline 5 mm lower
const label = { fontFamily: HEI, fontSize: pt(8), color: col('muted'), pages: 'body' };
const at = (edge, x, y = HEAD_Y) => ({ anchor: { to: 'page', edge },
offset: { x: mm(x), y: mm(y) } });
const header = { elements: [
{ kind: 'text', id: 'verso-folio', content: '{pageNumber}', parity: 'even', ...label,
placement: at('top-left', SIDE) },
{ kind: 'text', id: 'verso-book', content: '{title}', parity: 'even', ...label,
letterSpacing: pt(4), placement: at('top', 0) },
{ kind: 'text', id: 'recto-story', content: '{chapterTitle}', parity: 'odd', ...label,
letterSpacing: pt(4), placement: at('top', 0) },
{ kind: 'text', id: 'recto-folio', content: '{pageNumber}', parity: 'odd', ...label,
placement: at('top-right', -SIDE) },
{ kind: 'rule', id: 'hairline', direction: 'horizontal', thickness: pt(0.5), color: col('rule'),
pages: 'body', placement: { ...at('top-left', SIDE, HEAD_Y + 5), size: { width: mm(MEASURE) } },
},
] };
// The opener has no head: its folio drops to the foot, centred under the text.
const footer = { elements: [{ kind: 'text', id: 'drop-folio', content: '{pageNumber}',
...label, pages: 'opener', align: 'center', placement: at('bottom', 0, -10) }] };
Os romances do continente trazem o título do livro sobre os versos e o do conto sobre os rectos, centrados, com o fólio na borda externa e um fio fino embaixo dos dois. pages: 'body' os mantém fora da abertura e da prancha, e a abertura recebe o fólio no pé. Os cabeços são compostos em Noto Sans SC, a Hei, a 8 pt: pequenos, mas numa voz diferente da Song do texto.
#5 · Uma prancha sobre a folha inteira
// The plate, a painting: a JPEG in assets/ cut to the 140 × 203 mm trim, declared at its pixels.
const resources = [{
id: 'moon', typeId: 'figure', kind: 'bitmap', createdAt: 0, updatedAt: 0,
bitmap: { fileId: 'plate-1120.jpg', format: 'jpeg', width: 1120, height: 1624 },
altText: t({
en: 'A golden full moon in a deep blue sky over a strip of sea. On the sand below, among '
+ 'rows of striped watermelons, a boy with a silver collar stabs a steel fork at the '
+ 'sand ahead of him, and the small animal he aimed at runs off between his legs.',
es: 'Una luna llena dorada en un cielo azul oscuro sobre una franja de mar. En la arena, '
+ 'entre hileras de sandías rayadas, un muchacho con un aro de plata al cuello clava una '
+ 'horquilla de acero en la arena, delante de él, y el animalillo al que apuntaba huye '
+ 'entre sus piernas.',
}),
}];
const quote = { fontFamily: KAI, fontSize: pt(14), lineHeight: 1.5, color: col('paper') };
// # 月下的瓜地 {style="plate" line1="…" line2="…" line3="…"}: a page with no head or folio.
// 'page' spans the design over the sheet: a heading's design in the column is cut at its foot.
const plate = {
id: 'plate', span: 'page', runningChapter: false, toc: false, // out of the PDF outline
breakBefore: { enabled: true, parity: 'any' }, // (gotcha: style-inherits-break)
header: { elements: [] }, footer: { elements: [] },
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'image', id: 'picture', resourceId: 'moon', placement: { // the whole trim
anchor: { to: 'bleed', edge: 'top-left' },
size: { width: mm(TRIM.width), height: mm(TRIM.height) } } },
{ kind: 'text', id: 'line1', content: '{attr.line1}', ...quote, align: 'left',
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(2) } } },
{ kind: 'text', id: 'line2', content: '{attr.line2}', ...quote, align: 'left',
placement: { anchor: { to: '#line1', edge: 'below' } } },
{ kind: 'text', id: 'line3', content: '{attr.line3}', ...quote, align: 'left',
placement: { anchor: { to: '#line2', edge: 'below' } } },
] } },
};
A imagem pertence a um título próprio, # 月下的瓜地 {style="plate" …}, cujo estilo desenha a página e tira dela o cabeço e o fólio. A prancha precisa de span: 'page', porque o design de um título que fica na coluna é cortado no pé da coluna, 18 mm antes do refile. runningChapter: false com toc: false a deixa fora dos marcadores do PDF, que começam em 故乡. As três linhas da citação são três atributos e três elementos de texto, porque o texto de design tem a própria quebra de linhas e não aplica as larguras da pontuação chinesa; quebradas à mão, as linhas também perdem as vírgulas, como costuma acontecer nas linhas de destaque em chinês.
#6 · Letras latinas e algarismos no texto chinês
const paragraphStyles = [
// 小五 (9 pt) nudged to 9.1875 pt: 32 of its characters fill the 28-em measure exactly.
{ id: 'note', fontSize: pt((CHARS * BODY) / 32), lineHeight: pt(LEAD), color: col('ink'),
firstLineIndent: em(2), marginTop: pt(LEAD) }, // on the grid, a line below the text
{ id: 'colophon', fontFamily: HEI, fontSize: pt(7), lineHeight: pt(11), color: col('muted'),
textAlign: 'left', firstLineIndent: pt(0), marginTop: pt(LEAD / 2) },
];
A nota e o colofão da página 76 são onde algarismos e nomes latinos encostam no han. latinSpacing põe um quarto de eme onde quer que se toquem, como no 1921年 da nota e no 用Noto Serif SC五号 do colofão, digitados sem espaço algum (espaço entre han e latim); numa linha justificada, esse espaço é o primeiro a crescer, até meio eme. A nota é composta a 9,1875 pt, e não nos 9 pt do 小五, para que 32 dos caracteres preencham a medida: a 9 pt sobravam dois terços de eme em cada linha, e os espaços entre han e latim ficavam com eles. No Markdown, os nomes das fontes estão unidos por espaços não separáveis (U+00A0), que o espaço entre han e latim não toca: com espaços comuns, as linhas em bandeira do colofão quebravam Noto Sans / SC.
A receita completa
// ═══ Postext Cookbook · Nº 074 · A Chinese novel page on a 28 × 28 grid ════════════
// https://postext.dev/en/cookbook/chinese-novel-horizontal
// Code: MIT · Text: Lu Xun, 故乡 (1921), public domain, zh.wikisource · Plate: diffusion models
// Fonts: Noto Serif SC, Noto Sans SC, Ma Shan Zheng (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'chinese-novel-horizontal';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// The night of the story's memory, and ink on a cream paper.
const palette = {
ink: '#1f1c19', // text: a warm near-black
night: '#1d3150', // the accent: the deep blue of the plate's sky, the opener's rule
rule: '#c9c1b2', // the hairline under the running heads
muted: '#6a645b', // running heads, folios, the colophon
paper: '#fbf8f1', // a cream book paper
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
{ id: 'main-color', name: 'night (defaults)', value: { hex: palette.night, model: 'hex' } },
];
const SONG = 'Noto Serif SC'; // 宋: the text, and the title in its black weight
const HEI = 'Noto Sans SC'; // 黑: running heads, folios, the author, the colophon
const KAI = 'Ma Shan Zheng'; // 楷: a brush regular script for the plate's quotation
const [BODY, LEAD] = [10.5, 16.5]; // pt: 五号 on a 6 pt line gap, the grid's pitch
const [CHARS, LINES] = [28, 28];
const TRIM = { width: 140, height: 203 }; // mm: 大32开
const MEASURE = (CHARS * BODY * 25.4) / 72; // 103.7 mm: 28 ems of 五号
const SIDE = (TRIM.width - MEASURE) / 2; // 18.1 mm: the grid centres the measure
// #region answer: 28 characters × 28 lines of 五号, mainland line breaks and Kaiming marks
const cjk = {
// The type area in characters: 28 ems wide, 28 lines of LEAD tall. page.margins become
// minimums, and the grid centres the type area in the room they leave.
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
// What 'zh-Hans' gives by itself, written out so a reader can compare regions and styles.
region: 'mainland',
lineBreak: 'gb', // no 。,、”》 opens a line, no “《( ends one, and no / at either end
punctuationWidth: 'kaiming', // ,、:; quotes, brackets ½ em; 。?! one em, ½ at a line end
compressAdjacent: true, // idle under Kaiming (no pair tops 1.5 em); 'fullwidth' needs it
latinSpacing: em(0.25), // 1921年, 用Noto Serif SC五号: a quarter em, none of it typed
};
const bodyText = {
O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)
Variações
#Compor toda a pontuação em largura cheia (全角式)
Vírgulas, vírgulas de enumeração e aspas ocupam um caractere inteiro, 。” ocupa dois e cada linha comporta menos caracteres de texto.
- punctuationWidth: 'kaiming', // ,、:; quotes, brackets ½ em; 。?! one em, ½ at a line end
- compressAdjacent: true, // idle under Kaiming (no pair tops 1.5 em); 'fullwidth' needs it
+ punctuationWidth: 'fullwidth',
+ compressAdjacent: false,#Mostrar a grade enquanto você compõe a página
O canvas desenha um quadrado cinza-claro para cada posição de caractere de cada linha (稿纸); o PDF não o inclui a não ser que renderToPdf receba characterGrid: true.
- grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
+ grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES, show: true },Erros comuns
Erro comum
Fontes chinesas são carregadas em fatias, pelo bloco cjk
O Fontsource serve uma família chinesa, japonesa ou coreana em cerca de cem arquivos por peso, cada um com um intervalo de caracteres. loadFonts baixa só o arquivo latin, então na tela os caracteres chineses vêm de uma fonte do sistema e são medidos errado, e o fontsourceProvider entrega ao PDF esse arquivo latin, que os imprime como caixas vazias. Inclua o bloco cjk do kit, chame loadCjkFonts(FONTS, markdown) depois de loadFonts (uma vez por voz, com o texto que ela compõe, quando o livro usa várias fontes CJK) e passe a renderToPdf fontProvider: cjkPdfProvider: os dois pegam os arquivos que contêm os caracteres do texto. Fontes chinesas, japonesas e coreanas →
Erro comum
Marque o documento como zh-Hans ou zh-Hant, não com LANG
As edições de uma receita são en e es, mas uma amostra chinesa é chinesa nas duas: `locale: LANG` a marcaria como inglês ou espanhol, hifenizaria as suas palavras latinas, chamaria as suas figuras de Figure ou Figura e daria ao PDF o idioma errado. Desde o postext 1.30 a marcação é também o idioma em que o texto é composto (em que é medido, pintado e incorporado), então, sob uma marcação inglesa ou espanhola, uma fonte chinesa compõe com outras formas os algarismos e a pontuação que divide com o texto latino, e as linhas quebram em outro ponto. Escreva você mesmo a marcação: 'zh-Hans' (convenções da China continental: quebra de linha GB, pontuação Kaiming) ou 'zh-Hant' (Taiwan: pontuação de largura inteira centralizada); 'zh-HK' para Hong Kong. Um 'zh' sozinho é lido como chinês simplificado continental. Uma amostra japonesa leva 'ja' (armadilha ja-locale-tag). Quebra de linha em chinês →
Erro comum
Componha a pontuação de cada região com uma fonte dessa região
As larguras da pontuação levam o branco de cada sinal para o lado em que a região do documento o coloca, não para o lado em que a fonte o desenha: com zh-Hans, uma vírgula Kaiming mantém a metade esquerda da sua caixa, onde uma fonte simplificada desenha o glifo, e cede a metade direita. Uma fonte tradicional centraliza ,。 na caixa, então a metade que sai leva parte do glifo e a vírgula fica colada no caractere seguinte. LXGW WenKai TC, a única Kai de texto do Fontsource, faz isso em texto simplificado. Componha o texto, as notas e as citações continentais em Noto Serif SC ou Noto Sans SC, deixe as fontes TC para zh-Hant e use uma fonte de pincel simplificada (Ma Shan Zheng) só em linhas de destaque, onde o texto de design não aplica larguras de pontuação. Ela também desenha formas herdadas que nem o padrão continental nem o de Taiwan imprimem, 為 com o topo 爫 de 爲 e 令 (em 冷, 領) com o pé de 卩: confira os caracteres que uma página compõe com ela. Largura da pontuação chinesa →
Erro comum
O chinês não tem itálico
As famílias CJK não trazem itálico, e a tipografia chinesa marca a ênfase com pontos ao lado dos caracteres, não com inclinação. Em um documento marcado como chinês, *…* coloca pontos de ênfase nos caracteres chineses que abrange e deixa o itálico para as palavras latinas (cjk.emphasis: 'dots', o padrão para o chinês); :dots[…] os coloca em qualquer lugar. Com cjk.emphasis: 'italic', ou em um documento marcado como en ou es, *…* faz o canvas inclinar os glifos redondos, um oblíquo sintético que a tipografia chinesa nunca usa (o PDF recorre à fonte redonda): mantenha a marcação chinesa ou faça a ênfase em negrito ou em uma fonte Kai (LXGW WenKai) com um estilo de parágrafo ou de chip. Fontes chinesas, japonesas e coreanas →
Erro comum
Um estilo de título herda a quebra de página do seu nível
Uma entrada de headingStyles recebe do seu nível de título todos os campos que não define, inclusive breakBefore. Um sumário ou um colofão com estilo sobre um H1 depois de um :::pagebreak herda a paridade 'odd' e cai depois de uma página em branco. Dê a esse estilo breakBefore: { enabled: false }. Estilos de título →
Aviso de diagramação · cjkGridClamped
Grade de caracteres grande demais
Por quê. `cjk.grid` pede mais caracteres por linha ou mais linhas por página do que cabem entre as margens com esse corpo e essa entrelinha; por isso, a grade é composta com o máximo que cabe.
Correção. Reduza `charsPerLine` ou `linesPerPage`, estreite as margens (elas são mínimas) ou use um `bodyText.fontSize` ou um `lineHeight` menor. Docs →
- A prancha é um título, e um título ganha marcador no PDF: sem
runningChapter: falseetoc: falseno estilo da prancha, os marcadores começariam em 月下的瓜地, um marcador de primeiro nível antes de 故乡. Com só um dos dois ajustes, o marcador continua lá. O PDF marcado ainda mantém o título da prancha como H1. - A fonte dos próprios títulos tem de ser uma das que
FONTScarrega, mesmo quando um design pinta todos os títulos: com o peso padrão 700, o kit encontrou Noto Serif SC 700 na diagramação e carregou o arquivo latino com um aviso.headings.fontWeight: 400mantém os blocos de título na fonte do texto.
Créditos
- Receita
- Ignacio Ferro
- Texto
- “My Old Home” (故乡, 1921), the first half, from the 1948 Complete Works, in simplified characters · Lu Xun (鲁迅) · domínio público
- The editor’s note and the colophon · Postext Cookbook · original
- Imagens
- The plate: the moonlit melon field of the story, a painting · Generated With Diffusion Models · original
- Fontes
- Noto Serif SC (SIL OFL 1.1) · Noto Sans SC (SIL OFL 1.1) · Ma Shan Zheng (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


