Pular para o conteúdo principal
Receita número 86

Receitas · Capítulo 4 · Cabeços e fólios

Uma página de dicionário chinês com palavras-guia

Quatro páginas de uma seleção do Dicionário Kangxi em ordem de pinyin: {firstMark.h2} e {lastMark.h2} põem no cabeço a primeira e a última entrada da página.

Nesta página
Saída
Canvas · PDF
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Licença
Atualizada em 10 de out. de 2026
Código MIT · Texto CC BY 4.0

p. 634–635 · 1–2 de 4

  • Amostra em inglês: ainda sem edição em português
  • Refile 140 × 203 mm
  • 2 colunas, medianiz de 6,3 mm
  • Noto Serif TC 9/15
  • LXGW WenKai TC
  • Noto Sans TC
  • 4 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 88 ms
  • 158 linhas de código

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

script.js · linhas 37–58no código completo
// 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

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

script.js · linhas 82–91no código completo
// 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

script.js · linhas 95–101no código completo
// 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

script.js · linhas 62–78no código completo
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

script.js · linhas 284–293no código completo
// 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

Sandbox
// ═══ 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

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)
SandboxPDF