Saltar al contenido principal
Receta número 86

Recetario · Capítulo 4 · Cabeceras y folios

Una página de diccionario chino con palabras guía

Cuatro páginas de una selección del Diccionario de Kangxi en orden de pinyin: {firstMark.h2} y {lastMark.h2} imprimen en la cabecera el primer y el último lema.

En esta página
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Licencia
Actualizada el 10 oct 2026
Código MIT · Texto CC BY 4.0

pp. 634–635 · 1–2 de 4

  • Formato 140 × 203 mm
  • 2 columnas, medianil de 6,3 mm
  • Noto Serif TC 9/15
  • LXGW WenKai TC
  • Noto Sans TC
  • 4 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 108 ms
  • 158 líneas de código

En pocas palabras

Cuatro páginas de un diccionario chino clásico. La esquina superior de cada página muestra su primera y su última entrada, para encontrar una palabra hojeando.

Lo que vas a componer

Cuatro páginas del centro de una edición de lectura del Diccionario de Kangxi (康熙字典, 1716), reordenado por pinyin, de 天 tiān a 庭 tíng. Cada lema va en rojo, en la song supernegra, con su pinyin encima; las lecturas de los diccionarios de rimas (反切) y las acepciones lo siguen en un solo párrafo, con las acepciones numeradas ① ② en el mismo rojo. La página es un 大32开 de 140 × 203 mm, a dos columnas de 17 caracteres de 小五 (9 pt), sobre una retícula de 31 líneas, y cada columna llega a su última línea. En la esquina exterior de cada página, la cabecera muestra el primer y el último lema que hay en ella, así que quien busca 蜩 va a la página que lleva 腆—髫. Para compararlo con un diccionario en alfabeto latino, mira el vocabulario marinero de Smyth.

Esta receta responde a

  • ¿Cómo imprimo en la cabecera de un diccionario el primer y el último lema de cada página?
  • ¿Cómo pongo pinyin sobre los caracteres chinos?
  • ¿Cómo llevo los caracteres chinos al PDF sin cajas vacías?

La respuesta corta

script.js · líneas 37–58en el 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

Tipografía
Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Las palabras guía salen de los lemas

El código es la respuesta corta de arriba. Cada lema es un encabezado de segundo nivel, y {firstMark.h2} y {lastMark.h2} imprimen el texto del primer y del último título de ese nivel que empiezan en la página (elementos de texto). La marca son los caracteres del título: ## {天|tiān} marca 天, y la lectura se queda sobre el lema. Una entrada que pasa de una página a la siguiente solo cuenta donde está su lema: la página 635 empieza con el final de 殄 y lleva 腆—髫. El primer nivel queda para las letras; en estas cuatro páginas no empieza ninguna, pero la cabecera de una letra no contaría como palabra guía.

#2 · El pinyin sobre el lema

script.js · líneas 82–91en el 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} es la forma corta de :ruby[天]{rt="tiān"}, una lectura sobre un carácter (marcas chinas, ruby y warichu). Un título sin diseño propio compone su lectura; con un diseño, el título imprimiría 天 solo. La lectura toma la fuente del título, la supernegra, salvo que cjk.ruby.fontFamily indique otra, y por eso se indica la song regular. La mitad de 15 pt son 7,5 pt, y la línea de 30 pt del título deja sitio para la lectura sobre el lema: el título ocupa dos líneas de la retícula y el texto que va debajo sigue en las líneas de 15 pt de las dos columnas. El pinyin sube lo que bajan los rasgos descendentes de su fuente y 0,04 em más, así que la g de tīng acaba 0,6 pt por encima de la caja de 汀.

#3 · Un párrafo para cada entrada

script.js · líneas 95–101en el 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

El Diccionario de Kangxi compone cada entrada seguida: primero las lecturas de los diccionarios de rimas y después cada acepción, introducida por 又. Aquí el 又 se ha cambiado por números en círculo, escritos como **②**, y boldColor los imprime en el rojo de los lemas; no hay otra negrita en el texto. Una acepción que el Kangxi lee de otro modo conserva su lectura, como 跳 ② con 徒刀切. El compositor trata ① a ⑳ como caracteres chinos: ninguna línea acaba en un número cuya acepción empieza en la línea siguiente, y no entra espacio entre chino y latín entre el número y su texto, así que los números se escriben tal cual. El equilibrado de columnas está desactivado (headings.balancing.enabled: false): ninguna columna abre espacio sobre sus lemas y cada entrada sigue a la anterior a la misma distancia.

#4 · La pestaña de la T

script.js · líneas 62–78en el 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) },
  ];
};

Las sílabas del pinyin empiezan por 23 de las 26 letras (ninguna por I, U o V), así que la altura de la caja se divide en 23 pasos de 7,13 mm, y a la T le toca el decimonoveno. La pestaña mide 9 mm y empieza 3 mm fuera del corte, de modo que la página la corta en recto por el borde exterior y solo se ven redondeadas sus esquinas interiores; un archivo para imprenta con page.cutLines llevaría esos 3 mm al sangrado. La letra se centra en los 6 mm que quedan dentro. Las cuatro páginas son de la T, de modo que la pestaña no cambia de altura; en el vocabulario de Smyth baja por el corte de una letra a la siguiente.

#5 · Cada fuente carga sus propios caracteres

script.js · líneas 284–293en el 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));

Fontsource corta cada fuente china en un centenar de archivos por intervalos de caracteres, y loadCjkFonts carga los que contienen el texto que recibe. La song regular recibe toda la muestra, también el texto en español del colofón. La supernegra, los treinta lemas; la negrita, los números de acepción; la hei, los lemas y las cifras de las cabeceras, y la kai, la frase en chino del colofón. cjkPdfProvider incrusta esos mismos archivos en el PDF, cada uno reducido a los caracteres que usan sus páginas.

La receta 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 = 'es'; // @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 });

El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)

Variantes

#El primer lema en la par y el último en la impar

Hay diccionarios que imprimen una sola palabra guía por página: la primera arriba en la par y la última arriba en la impar, de modo que la doble página dice 天 … 髫.

-  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 con ɑ y ɡ de un solo ojo

Los diccionarios chinos componen el pinyin en una fuente con la a y la g de un solo ojo. Elige Andika para las lecturas y añádela a FONTS ('Andika': ['400'], con su crédito OFL).

-  ruby: { fontFamily: SONG, fontSize: em(0.5), color: col('cinnabar') },
+  ruby: { fontFamily: 'Andika', fontSize: em(0.5), color: col('cinnabar') },

#Lemas del tamaño del texto

Un diccionario compacto pone el lema en negrita al principio de su párrafo. Mete las entradas en :::paragraphs{style="entry"}, empieza cada una con **{天|tiān}** e imprime {firstMark.entry}: un párrafo que empieza con un tramo en negrita marca la página con él.

Errores frecuentes

Error frecuente

Las lecturas se imprimen en el texto, no en diseños, pies ni celdas

Las lecturas ruby se dibujan en párrafos, títulos, elementos de lista, citas y recuadros. Un elemento de texto de un diseño (una apertura, una cabecera, una etiqueta), un pie, una nota al pie y una celda de tabla imprimen los caracteres base sin sus lecturas. Un título que necesita su pinyin es un título sin diseño propio: dibuja lo que lo rodea (una banda, el número de la lección) con el diseño del título anterior, cuyos elementos con reserve: false se pintan bajo el texto de una apertura span: 'page'. Ruby: lecturas en pinyin y zhuyin →

Error frecuente

Las fuentes chinas se cargan por fragmentos, con el bloque cjk

Fontsource sirve una familia china, japonesa o coreana en un centenar de archivos por peso, cada uno con un intervalo de caracteres. loadFonts solo descarga el archivo latin, así que en pantalla los caracteres chinos salen de una fuente del sistema y se miden mal, y fontsourceProvider entrega al PDF ese archivo latin, que los imprime como cajas vacías. Añade el bloque cjk del kit, llama a loadCjkFonts(FONTS, markdown) después de loadFonts (una vez por voz, con el texto que compone, si el libro usa varias fuentes chinas) y pasa a renderToPdf fontProvider: cjkPdfProvider: ambos toman los archivos que contienen los caracteres del texto. Fuentes chinas, japonesas y coreanas →

Error frecuente

Etiqueta el documento zh-Hans o zh-Hant, no con LANG

Las ediciones de una receta son en y es, pero una muestra china es china en las dos: `locale: LANG` la etiquetaría como inglés o español, separaría sus palabras latinas, llamaría Figure o Figura a sus figuras y daría al PDF un idioma equivocado. Desde postext 1.30 la etiqueta es además el idioma en el que se compone el texto (en el que se mide, se pinta y se incrusta), así que bajo una etiqueta inglesa o española una fuente china compone con otras formas sus cifras y la puntuación que comparte con el texto latino, y las líneas se parten por otro sitio. Escribe tú la etiqueta: 'zh-Hans' (convenciones de la China continental: corte GB, puntuación Kaiming) o 'zh-Hant' (Taiwán: puntuación de ancho completo centrada); 'zh-HK' para Hong Kong. Un 'zh' a secas se lee como chino simplificado continental. Una muestra japonesa lleva 'ja' (gotcha ja-locale-tag). Corte de líneas en chino →

  • Con el equilibrado de columnas activado, una columna en la que ya no cabe el siguiente lema con dos líneas de su texto debajo (bodyText.widowMinLines) termina antes, y las líneas que sobran van encima de los lemas, una como mucho para cada uno: una entrada queda a una línea de la anterior y la siguiente no. Desactivado, esa columna se queda corta.

Créditos

Texto
  • Treinta entradas del Diccionario de Kangxi (康熙字典, 1716), de 天 a 庭, reducidas a unas pocas acepciones: lo que se conserva sigue el orden y las atribuciones del original, una acepción con lectura propia la mantiene y, de las formas antiguas (古文), solo se compone 銕, porque las demás no están en las fuentes. Las variantes van en los caracteres tradicionales normalizados de hoy y la puntuación se ha revisado en algunos puntos. Según la transcripción de zh.wikisource, que da como fuente la copia del Siku Quanshu Huiyao (四庫全書薈要本) y anota algunas correcciones de Wang Yinzhi de 1831 (字典考證); 29 páginas por radical y número de trazos, revisiones consultadas el 29 de septiembre de 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
  • Las lecturas en pinyin, los números de acepción, el orden de las entradas y el colofón · Postext Cookbook · CC BY 4.0
Fuentes
Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1)
SandboxPDF