Em poucas palavras
Quatro páginas de um dicionário chinês clássico. O canto de cima de cada página mostra a primeira e a última palavra dela, para achar uma palavra folheando.
O que você vai compor
Quatro páginas do miolo de uma edição de leitura do Dicionário Kangxi (康熙字典, 1716), reordenado pelo pinyin, de 天 tiān a 庭 tíng. Cada entrada vai em vermelho, na Song extranegra, com o pinyin por cima; as leituras dos dicionários de rimas (反切) e as acepções vêm em seguida num só parágrafo, com as acepções numeradas ① ② no mesmo vermelho. A página é um 大32开 de 140 × 203 mm, em duas colunas de 17 caracteres de 小五 (9 pt) sobre uma grade de 31 linhas, e cada coluna vai até a última linha. No canto externo de cada página, o cabeço nomeia a primeira e a última entrada que há nela, por isso quem procura 蜩 vai à página encabeçada por 腆—髫. Para comparar com um dicionário em alfabeto latino, veja o vocabulário náutico de Smyth.
Esta receita responde a
- Como imprimo no cabeço de um dicionário o primeiro e o último verbete de cada página?
- Como coloco pinyin sobre os caracteres chineses?
- Como levo os caracteres chineses para o PDF sem caixas vazias?
A resposta curta
// Each headword is a level-2 heading, '## {天|tiān}'. {firstMark.h2} prints the text of the
// first one that starts on the page, without its reading, and {lastMark.h2} the last; a
// page on which none starts repeats the one in force. They stand at the outer corner, the
// folio outside them, over a hairline as wide as the type area.
const HEAD_Y = 11; // mm from the top edge to the top of the guide words
const [GUIDE, FOLIO] = [10.5, 8]; // pt
const head = (id, content, parity, x, size, extra) => ({ kind: 'text', id, content, parity,
fontFamily: HEI, fontWeight: 700, fontSize: pt(size), lineHeight: 1, color: col('ink'),
// A design line puts its baseline 0.8 of its height down: the folio drops to share it.
placement: { anchor: { to: 'page', edge: parity === 'even' ? 'top-left' : 'top-right' },
offset: { x: mm(parity === 'even' ? x : -x), y: mm(HEAD_Y + 0.8 * (GUIDE - size) * PT) } },
...extra });
const folio = { color: col('muted') };
const guideWords = [
head('verso-folio', '{pageNumber}', 'even', SIDE, FOLIO, folio),
head('verso-guide', '{firstMark.h2}—{lastMark.h2}', 'even', SIDE + 8, GUIDE),
head('recto-guide', '{firstMark.h2}—{lastMark.h2}', 'odd', SIDE + 8, GUIDE),
head('recto-folio', '{pageNumber}', 'odd', SIDE, FOLIO, folio),
{ kind: 'rule', id: 'hairline', direction: 'horizontal', thickness: pt(0.5), color: col('ink'),
placement: { anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(SIDE), y: mm(HEAD_Y + 5.5) }, size: { width: mm(AREA.width) } } },
];
Ingredientes
- Funcionalidades
- Palavras-guia no cabeçoRubi: leituras em pinyin e zhuyinGrade de caracteresUma ou duas colunasFio entre colunasEquilíbrio de colunasFontes chinesas, japonesas e coreanasQuebra de linha em chinêsLargura da pontuação chinesaJustificação entre caracteresCabeços e fóliosFaixas sangradas e guias lateraisAncoragem de elementos de designNegrito, itálico e suas coresEstilos de parágrafoMargens espelhadasPaleta de cores semânticaExportação para PDF
- Tipografia
- Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Palavras-guia a partir das entradas
O código é a resposta curta lá em cima. Cada entrada é um título de nível 2, e {firstMark.h2} e {lastMark.h2} imprimem o texto do primeiro e do último título de nível 2 que começam na página (elementos de texto). A marca são os caracteres do título: ## {天|tiān} marca 天, e a leitura fica sobre a entrada. Um verbete que passa de uma página para a seguinte só conta onde está a entrada: a página 635 começa com o fim de 殄 e é encabeçada por 腆—髫. O nível 1 fica para as letras: nenhuma começa nestas quatro páginas, mas o título de uma letra não contaria como palavra-guia.
#2 · O pinyin sobre as entradas
// A heading with no design of its own keeps its reading: '## {天|tiān}' sets tiān over 天.
// Two grid lines hold the headword and a 7.5 pt reading, so every entry stays on the grid.
// A Latin reading stands clear of its base by its descenders: the g of tīng stays off 汀.
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
// The regular Song, not the heading's Black: a reading takes the face of its base.
ruby: { fontFamily: SONG, fontSize: em(0.5), color: col('cinnabar') },
};
const headword = { level: 2, fontSize: pt(15), lineHeight: pt(2 * LEAD), marginTop: pt(0),
marginBottom: pt(0) };
{天|tiān} é a forma curta de :ruby[天]{rt="tiān"}, uma leitura sobre um caractere (marcas chinesas, rubi e warichu). Um título sem design próprio compõe a leitura; um design de título imprimiria 天 sozinho. A leitura usa a fonte do próprio título, a extranegra, a não ser que cjk.ruby.fontFamily indique outra, e por isso a Song regular é indicada. Metade de 15 pt são 7,5 pt, e a linha de 30 pt do título deixa espaço para a leitura sobre a entrada, de modo que o título ocupa duas linhas da grade e o texto embaixo continua nas linhas de 15 pt das duas colunas. Uma leitura em pinyin sobe o tanto das descendentes da fonte mais 0,04 em, por isso o g de tīng termina 0,6 pt acima da caixa do eme de 汀.
#3 · Um parágrafo para cada verbete
// As the Kangxi Dictionary sets an entry: the rhyme-book readings (反切), then the senses
// run in, each after its number. '**②**' marks a number, and the text prints its bold in
// cinnabar: the only bold on these pages. A circled number is a Chinese character to the
// composer: no line ends on one, away from the sense it opens, and no space follows it.
const bodyText = { fontFamily: SONG, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('cinnabar'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', firstLineIndent: pt(0) }; // no indent: the headword opens the entry
O Dicionário Kangxi compõe cada verbete corrido: as leituras dos dicionários de rimas e depois cada acepção, introduzida por 又. Aqui o 又 virou números circulados, digitados como **②**, e boldColor os imprime no vermelho-cinábrio das entradas; não há outro negrito no texto. Uma acepção que o Kangxi lê de outra forma mantém a leitura, como 跳 ② com 徒刀切. O compositor trata ① a ⑳ como caracteres chineses: nenhuma linha termina num número cuja acepção abre a linha seguinte, e nenhum espaço entre chinês e latim entra entre o número e o texto, por isso os números são digitados como estão. O equilíbrio de colunas está desativado (headings.balancing.enabled: false), de modo que nenhuma coluna abre espaço sobre as entradas e cada verbete segue o anterior à mesma distância.
#4 · O marcador da letra T
const INITIALS = 'ABCDEFGHJKLMNOPQRSTWXYZ'; // no pinyin syllable starts with I, U or V
const STEP = AREA.height / INITIALS.length; // mm: 7.13, the 23 tabs fill the type area's height
const tab = (parity) => {
const edge = parity === 'odd' ? 'top-right' : 'top-left'; // the fore-edge
const at = (x, width) => ({ anchor: { to: 'page', edge },
offset: { x: mm(parity === 'odd' ? x : -x), y: mm(TOP + INITIALS.indexOf('T') * STEP + 0.3) },
size: { width: mm(width), height: mm(STEP - 0.6) } });
// 6 mm inside the trim and 3 mm past it: the page cuts the tab square at the fore-edge
// (a print file with cutLines prints the 3 mm in its bleed); the letter on the 6 mm.
return [
{ kind: 'box', id: `tab-${parity}`, parity, placement: at(3, 9),
style: { backgroundColor: col('cinnabar'), borderRadius: mm(1.2) } },
{ kind: 'text', id: `tab-letter-${parity}`, parity, content: 'T', fontFamily: HEI,
fontWeight: 700, fontSize: pt(9), lineHeight: 1, color: col('paper'), align: 'center',
verticalAlign: 'middle', placement: at(0, 6) },
];
};
As sílabas do pinyin começam com 23 das 26 letras (nenhuma com I, U ou V), por isso a altura da mancha é dividida em 23 passos de 7,13 mm, e o T fica com o 19º. O marcador tem 9 mm de largura e começa 3 mm além do refile, de modo que a página o corta reto na borda externa e só os cantos internos mostram o arredondamento; um arquivo de impressão com page.cutLines levaria esses 3 mm para a sangria. A letra fica centrada nos 6 mm dentro da página. As quatro páginas são do T, por isso o marcador fica sempre na mesma altura; o vocabulário de Smyth o desce pela borda de uma letra para a seguinte.
#5 · Cada fonte carrega os seus próprios caracteres
// Fontsource cuts a Chinese face into about a hundred files (gotcha: cjk-fonts-slices).
// The regular Song sets the whole sample; each other voice gets only its own text.
const all = (re) => [...markdown.matchAll(re)].map((m) => m[1]).join('');
const heads = all(/^## \{(.+?)\|/gm);
await loadFonts(FONTS, markdown);
await loadCjkFonts({ [SONG]: ['400'] }, markdown);
await loadCjkFonts({ [SONG]: ['700'] }, all(/\*\*(.+?)\*\*/g));
await loadCjkFonts({ [SONG]: ['900'] }, heads);
await loadCjkFonts({ [HEI]: ['700'] }, `${heads}—0123456789T`);
await loadCjkFonts({ [KAI]: ['400'] }, all(/style="colophon-zh"\}\n(.+)\n/g));
A Fontsource corta cada fonte chinesa em cerca de cem arquivos por faixa de caracteres, e loadCjkFonts carrega os arquivos que contêm o texto que recebe. A Song regular recebe a amostra inteira, inclusive o texto em inglês do colofão. A extranegra recebe as trinta entradas, o negrito os números de acepção, a Hei as entradas e os algarismos dos cabeços, e a Kai a frase em chinês do colofão. cjkPdfProvider incorpora esses mesmos arquivos no PDF, cada um reduzido aos caracteres que as páginas usam.
A receita completa
// ═══ Postext Cookbook · Nº 086 · A Chinese dictionary page with guide words ═════════
// https://postext.dev/en/cookbook/chinese-dictionary-page
// Code: MIT · Text: 康熙字典 (1716), Wikisource transcription, CC BY-SA 4.0 · Pinyin: CC BY 4.0
// Fonts: Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import { buildDocument, withLoadedFonts, renderPageToCanvas } 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-dictionary-page';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black and one cinnabar, the second ink of a two-colour dictionary
const palette = {
ink: '#1f1b17', // text, guide words
cinnabar: '#a52f28', // headwords, their readings, sense numbers, the thumb tab
rule: '#bab2a4', // the column rule
muted: '#5c554d', // folios, colophon
paper: '#fbf8f2', // the page, and the letter reversed out of the tab
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at the cinnabar.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.cinnabar })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [SONG, HEI, KAI] = ['Noto Serif TC', 'Noto Sans TC', 'LXGW WenKai TC'];
const PT = 25.4 / 72; // mm in a point
const [BODY, LEAD] = [9, 15]; // pt: 小五 on a 15 pt line, the grid both columns share
const [CHARS, LINES] = [17, 31]; // characters to a column's line, lines to a column
const TRIM = { width: 140, height: 203 }; // mm: 大32开
const MIN = { top: 20, bottom: 16, side: 12 }; // mm: minimums the grid grows to centre the area
// The type area the grid sets (two columns and a 2-em gutter) and the margins it leaves.
const AREA = { width: (2 * CHARS + 2) * BODY * PT, height: LINES * LEAD * PT }; // 114.3 × 164
const SIDE = (TRIM.width - AREA.width) / 2; // 12.85 mm
const TOP = MIN.top + (TRIM.height - MIN.top - MIN.bottom - AREA.height) / 2; // 21.5 mm
// #region answer: the first and the last headword of each page in its running head
// Each headword is a level-2 heading, '## {天|tiān}'. {firstMark.h2} prints the text of the
// first one that starts on the page, without its reading, and {lastMark.h2} the last; a
// page on which none starts repeats the one in force. They stand at the outer corner, the
// folio outside them, over a hairline as wide as the type area.
const HEAD_Y = 11; // mm from the top edge to the top of the guide words
const [GUIDE, FOLIO] = [10.5, 8]; // pt
const head = (id, content, parity, x, size, extra) => ({ kind: 'text', id, content, parity,
fontFamily: HEI, fontWeight: 700, fontSize: pt(size), lineHeight: 1, color: col('ink'),
// A design line puts its baseline 0.8 of its height down: the folio drops to share it.
placement: { anchor: { to: 'page', edge: parity === 'even' ? 'top-left' : 'top-right' },
offset: { x: mm(parity === 'even' ? x : -x), y: mm(HEAD_Y + 0.8 * (GUIDE - size) * PT) } },
...extra });
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
#A primeira entrada no verso, a última no recto
Alguns dicionários imprimem uma palavra-guia por página, a primeira no alto do verso e a última no alto do recto, de modo que a página dupla diz 天 … 髫.
- head('verso-guide', '{firstMark.h2}—{lastMark.h2}', 'even', SIDE + 8, GUIDE),
- head('recto-guide', '{firstMark.h2}—{lastMark.h2}', 'odd', SIDE + 8, GUIDE),
+ head('verso-guide', '{firstMark.h2}', 'even', SIDE + 8, GUIDE),
+ head('recto-guide', '{lastMark.h2}', 'odd', SIDE + 8, GUIDE),#Pinyin com ɑ e ɡ de um só bojo
Os dicionários chineses compõem o pinyin numa fonte com o a e o g de um só bojo. Indique a Andika para as leituras e acrescente-a a FONTS ('Andika': ['400'], com o crédito OFL dela).
- ruby: { fontFamily: SONG, fontSize: em(0.5), color: col('cinnabar') },
+ ruby: { fontFamily: 'Andika', fontSize: em(0.5), color: col('cinnabar') },#Entradas no tamanho do texto
Um dicionário compacto põe a entrada em negrito no começo do parágrafo. Coloque os verbetes em :::paragraphs{style="entry"}, abra cada um com **{天|tiān}** e imprima {firstMark.entry}: um parágrafo que começa com um trecho em negrito marca a página com ele.
Erros comuns
Erro comum
As leituras são impressas no texto, não em designs, legendas nem células
As leituras rubi são desenhadas em parágrafos, títulos, itens de lista, citações e boxes. Um elemento de texto de design (uma abertura, um cabeço, um selo), uma legenda, uma nota de rodapé e uma célula de tabela imprimem os caracteres-base sem as leituras. Um título que precisa do seu pinyin é um título sem design próprio: desenhe o que está em volta dele (uma faixa, o número da lição) com o design do título anterior, cujos elementos com reserve: false são pintados sob o texto de uma abertura span: 'page'. Rubi: leituras em pinyin e zhuyin →
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 →
- Com o equilíbrio de colunas ativado, uma coluna que não comporta a próxima entrada com duas linhas do texto embaixo (
bodyText.widowMinLines) termina antes, e as linhas que sobram vão para cima das entradas, no máximo uma para cada: um verbete fica a uma linha do anterior, o seguinte não. Desativado, essa coluna fica curta.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Thirty entries of the Kangxi Dictionary (康熙字典, 1716), 天 to 庭, each cut to a few senses: what is kept stands in the source’s order and under its attribution, a sense with a reading of its own keeps it, and of the ancient forms (古文) only 銕 is set, the others being outside the fonts. Variant forms are written in today’s standard Traditional characters and the punctuation is revised in places. From the zh.wikisource transcription, which gives the Siku Quanshu Huiyao copy (四庫全書薈要本) as its source and notes some of Wang Yinzhi’s corrections of 1831 (字典考證); 29 pages by radical and stroke count, revisions read on 29 September 2026: 大部 2535754, 水部/八畫 2542298, 田部 2543683, 心部/六畫 2537571, 土部/十畫 2535684, 門部/十畫 2553837, 心部/四畫 2537569, 歹部/五畫 2541608, 肉部/八畫 2549900, 人部/六畫 416510, 手部/六畫 2538445, 辵部/五畫 2553283, 木部/七畫 2540094, 虫部/八畫 2551174, 言部/八畫 2551690, 髟部/五畫 2556393, 穴部/六畫 2546633, 目部/六畫 2544863, 足部/六畫 2552906, 米部/十九畫 2548884, 巾部/五畫 2536199, 貝部/五畫 2552278, 金部/十三畫 2553630, 食部/九畫 2556072, 水部/二畫 2541898, 耳部/十六畫 2549782, 广部/二十二畫 2536291, 亠部/七畫 409671, 广部/七畫 2536277 · Zhang Yushu, Chen Tingjing and others (1716); transcription by Wikisource editors · CC BY-SA 4.0
- The pinyin readings, the sense numbers, the order of the entries and the colophon · Postext Cookbook · CC BY 4.0
- Fontes
- Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · LXGW WenKai TC (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)


