En pocas palabras
Una antología breve de una gran novela china con un índice de los nombres de sus personajes. Las mismas marcas dan dos ediciones: una ordenada por sonido y otra por número de trazos.
Lo que vas a componer
Una antología breve de 紅樓夢 (Sueño en el pabellón rojo) que recoge, de los capítulos 1 a 3, los pasajes en que aparece cada personaje y termina con un índice de sus 47 nombres, más cuatro remisiones desde otros nombres. Sale en dos ediciones con las mismas marcas. La de China continental, en caracteres simplificados, ordena los nombres por su inicial en pinyin, F, H, J…; la de Taiwán, en caracteres tradicionales, por el número de trazos del primer carácter, 三畫, 四畫… Las dos son libros en rústica de 大32开, 140 × 203 mm, con 26 caracteres por línea en Noto Serif, los títulos de capítulo en una Kai y los antetítulos, los folios y las letras del índice en Noto Sans. La tarjeta amplía los primeros grupos del índice simplificado, de la F a la L. Un índice onomástico y un índice de materias hace el mismo tipo de índice para una monografía en inglés o en español.
Esta receta responde a
- ¿Cómo agrupo un índice de nombres chinos por pinyin o por número de trazos?
- ¿Cómo llevo los caracteres chinos al PDF sin cajas vacías?
La respuesta corta
// Marks in the Markdown, one per passage; main is the page where the character enters:
// 字:index[士隐]{term="甄士隐" main} :index{term="贾化" see="贾雨村"}
// Printed at the end of each edition: # 人名索引 {style="index"}, then :::index
const index = (e) => ({
// 'auto' reads the same from the locale: pinyin for zh-Hans, strokes for zh-Hant.
groupBy: e.locale === 'zh-Hans' ? 'pinyin' : 'stroke', // A B C… or 三畫 四畫…
fontFamily: e.serif, fontSize: pt(9), lineHeight: pt(14),
separator: '\u3000', locatorSeparator: ',', // 贾宝玉 4,6: an ideographic space, then ,
see: { italic: false }, // 见 / 見 upright: Chinese has no italic (gotcha: cjk-no-italic)
groups: { fontFamily: e.sans, fontSize: pt(9.5), fontWeight: 700, color: col('cinnabar'),
marginTop: pt(6.25) }, // the three names of 九畫 stay whole at the foot of their column
});
const indexHeading = { id: 'index', numbered: false, breakBefore: { enabled: true, parity: 'any' },
layout: { layoutType: 'double', gutterWidth: pt(21) } }; // two columns, 2 characters apart
Ingredientes
- Funciones
- Índice analíticoFuentes chinas, japonesas y coreanasEstilos de títuloCapítulos sin númeroAperturas diseñadasAtributos de títuloNumeración chinaRetícula de caracteresCorte de líneas en chinoCabeceras y foliosMárgenes simétricosEquilibrado de columnasEstilos de párrafoPaleta de color semánticaExportación a PDF
- También usa
- Color del papelCabeceras según el tipo de páginaFuentes incrustadas en el PDFGeometría por secciónSaltos de línea en los títulos
- Tipografía
- Noto Serif SC, Noto Sans SC, Ma Shan Zheng, 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 · Marca cada nombre donde el lector se lo encuentra
La configuración es la respuesta corta de arriba; lo demás está en el Markdown. La marca archiva el nombre completo, lo imprima o no el texto: 字:index[士隐]{term="甄士隐" main} imprime 士隐 y anota la página bajo 甄士隐. main pone la página en negrita, y la nota bajo el título del índice explica qué significa aquí: la página en que el personaje sale a escena. Jia Baoyu nace en el capítulo 2 sin que lo nombren (又生了一位公子), así que la marca va sin texto que imprimir, :index{term="贾宝玉"}, y su entrada dice 4, 6. Los apodos y los nombres de antes tienen su propia remisión, :index[凤辣子]{term="凤辣子" see="王熙凤"}, que Postext imprime a la manera china, tras un punto y sin espacio: 凤辣子。见王熙凤 (Marcas de índice).
#2 · Deja que el idioma decida el orden
// The mainland edition in Simplified characters and the Taiwan edition in Traditional ones.
// Each takes the Song (serif), Hei (sans) and Kai faces cut for its script. Fontsource has no
// Kai text face with mainland forms: LXGW WenKai TC draws 冷 the Taiwan way, so the mainland
// titles take Ma Shan Zheng, a brush Kai.
const EDITIONS = {
hans: { locale: 'zh-Hans', serif: 'Noto Serif SC', sans: 'Noto Sans SC', kai: 'Ma Shan Zheng' },
hant: { locale: 'zh-Hant', serif: 'Noto Serif TC', sans: 'Noto Sans TC', kai: 'LXGW WenKai TC' },
};
Las dos ediciones comparten la configuración, y al índice le basta con cambiar locale: groupBy: 'auto' agrupa un índice zh-Hans por pinyin y uno zh-Hant por trazos; la respuesta corta escribe los dos valores para que los veas. Las entradas se ordenan según el mismo criterio que las letras de grupo, así que los mismos nombres cambian de sitio: 甄费 va antes que 甄士隐 en la Z (fèi antes que shì) y detrás en 十四畫 (士 tiene tres trazos; 費, doce); 宁国公 y 荣国公 se separan en la N y la R, mientras que 寧國公 y 榮國公 siguen juntos entre los nombres de catorce trazos (Índice analítico). Las lecturas y los trazos salen de la ordenación china del navegador; un apellido que lee mal (曾, 单, 解) lleva una clave sort escrita con caracteres que tengan la lectura correcta.
#3 · Carga cada fuente con los caracteres que compone
const DIGITS = '0123456789';
const HEADS = '第回一二三四五六七八九十画畫ABCDEFGHIJKLMNOPQRSTUVWXYZ'; // 第一回, the index heads
const all = (md, re) => [...md.matchAll(re)].map((m) => m[1]).join('\n');
for (const [key, md] of [['hans', markdown], ['hant', traditional]]) {
e = EDITIONS[key];
await loadCjkFonts({ [e.serif]: ['400'] }, md); // the text, the index, the running heads
await loadCjkFonts({ [e.serif]: ['700'] }, DIGITS); // the bold page numbers
await loadCjkFonts({ [e.sans]: ['700'] }, all(md, /kicker="([^"]*)"/g) + HEADS + DIGITS);
await loadCjkFonts({ [e.kai]: ['400'] }, all(md, /^# ([^{\n]*)/gm)); // the titles alone
}
Fontsource parte cada peso de una fuente china en unos cien archivos, y loadCjkFonts descarga los que toca su texto. La Song recibe el libro entero, así que las cabeceras no le cuestan nada; su negrita, las cifras de las páginas principales; la Hei, el texto de los atributos kicker, las letras del índice y las cifras de los folios, y la Kai, los tres pareados y 人名索引. El PDF sigue el mismo camino: cjkPdfProvider incrusta esos archivos, cada uno reducido a los caracteres que usan sus páginas, y ningún carácter sale como una caja vacía. La Kai cambia con la edición. LXGW WenKai TC, la única Kai de texto de Fontsource, dibuja formas heredadas, 冷 con el antiguo pie 卩 de 令, y centra comas y puntos, así que los títulos de la edición simplificada van en Ma Shan Zheng, una Kai de pincel con las formas del continente (Fuentes chinas, japonesas y coreanas).
#4 · Pon la nota en la apertura del índice
const opener = (e, sink, kicker, note = []) => ({
enabled: true,
minHeight: pt(LEAD * sink), // the text starts on the same line after every opener
slot: { elements: [
{ kind: 'text', id: 'kicker', content: kicker, fontFamily: e.sans, fontSize: pt(9),
fontWeight: 700, letterSpacing: pt(2.7), color: col('cinnabar'), align: 'center',
placement: { ...at('container', 'top', 0, 8), size: { width: 'fill', height: 'auto' } } },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: e.kai, fontSize: pt(16),
lineHeight: 1.45, color: col('ink'), align: 'center',
overflow: 'wrap', // design text ends in an ellipsis by default
placement: { ...at('#kicker', 'below', 0, 3), size: { width: 'fill', height: 'auto' } } },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.5), color: col('rule'),
placement: { ...at('#title', 'below', (MEASURE - 12) / 2, 4), size: { width: mm(12) } } },
...note,
] },
});
// The note (note="…" on the heading) sits above the columns: no paragraph for balancing to loosen.
const indexNote = (e) => [{ kind: 'text', id: 'note', content: '{attr.note}',
fontFamily: e.serif, fontSize: pt(9), lineHeight: 1.6, color: col('muted'), align: 'center',
overflow: 'wrap', placement: { ...at('#rule', 'below', -(MEASURE - 12) / 2, 4),
size: { width: 'fill', height: 'auto' } } }];
La nota es un atributo del encabezado, # 人名索引 {style="index" kicker="按汉语拼音排列" note="…"}, y ocupa toda la caja encima de las dos columnas. Como párrafo dentro de las columnas servía de palanca al equilibrado: para igualar la última página de la edición tradicional, la maquetación lo aflojaba a doce caracteres por línea en una columna de catorce. La nota es una sola frase, 本索引收录前三回选文中的人物,粗体页码为人物出场之页;别名与原名另立参见条目。, que el diseño parte en líneas: el texto de diseño de un libro chino sigue las reglas de corte de línea y los anchos de los signos del cuerpo, así que ,; van a medio ancho en la edición simplificada y a ancho completo en la tradicional, como en el texto, y ninguna línea de la nota empieza por un signo. Las aperturas de capítulo usan el mismo diseño, con 第{numberHan}回 como antetítulo, que imprime 第一回 en la escritura del documento.
#5 · Muestra las dos páginas de índice juntas
const indexPage = (doc) => doc.pages[doc.blocks.find((b) => b.headingStyleId === 'index')
?.pageIndex ?? doc.pages.length - 1];
const labels = { hans: t({ en: 'Simplified · by pinyin', es: 'Simplificado · por pinyin' }),
hant: t({ en: 'Traditional · by strokes', es: 'Tradicional · por trazos' }) };
document.getElementById('pages').insertAdjacentHTML('beforebegin', `<section id="indexes" style="
display:flex;flex-wrap:wrap;justify-content:center;gap:24px;padding:28px 16px;background:#e9e4da">
${Object.keys(docs).map((key) => `<figure style="margin:0;width:min(340px,44vw)">
<canvas id="index-${key}" role="img" style="display:block;width:100%;background:#fff;
box-shadow:0 18px 36px -18px rgb(0 0 0 / .45)"></canvas><figcaption style="margin-top:10px;
font:600 11px/1 system-ui,sans-serif;letter-spacing:.14em;text-transform:uppercase;color:#5b534a">
${labels[key]}</figcaption></figure>`).join('')}</section>`);
for (const [key, doc] of Object.entries(docs)) {
const canvas = document.getElementById(`index-${key}`);
const page = indexPage(doc);
canvas.setAttribute('aria-label', `${labels[key]}, ${page.pageLabel}`);
renderPageToCanvas(page, doc, canvas, { scale: (2 * canvas.clientWidth) / page.width });
}
El código compone las dos ediciones y deja la simplificada en la mesa. Los botones 简体版 y 繁體版 cambian de edición, y con cada cambio se ofrece el PDF de la que está a la vista, chinese-name-index-hans.pdf o chinese-name-index-hant.pdf. La captura registra las dos (capture.doc: ['first', 'last']): las ocho primeras páginas de arriba son de la edición simplificada, y las cuatro siguientes, de la tradicional, su primera página y su índice por trazos. La franja que hay encima de la mesa muestra la primera página de índice de cada edición. El PDF que acompaña a la receta es el de la edición simplificada.
La receta completa
// ═══ Postext Cookbook · Nº 079 · An index of Chinese names, by pinyin and by strokes ═══
// https://postext.dev/en/cookbook/chinese-name-index
// Code: MIT · Text: 紅樓夢 (1792), zh.wikisource revision 9685985 (CC BY-SA 4.0) · Pictures: none
// Fonts: Noto Serif/Sans SC/TC, Ma Shan Zheng, LXGW WenKai TC (OFL 1.1) · Needs postext ≥ 1.28.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-name-index';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink on a warm paper, one cinnabar for the heads and the index letters
const palette = {
ink: '#1f1b18', // text
cinnabar: '#a3301f', // the one accent: 回 numbers, index heads
muted: '#6b635a', // running heads, folios, colophon
rule: '#d6cdbf', // the short rule under each title
paper: '#fbf8f1',
};
// Each colour carries its hex and the palette entry it follows.
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' } })),
// The engine's defaults link to main-color: point it at the accent, never the default blue.
{ id: 'main-color', name: 'accent (defaults)', value: { hex: palette.cinnabar, model: 'hex' } },
];
// #endregion
// #region editions: one book, two scripts; the locale decides the index order
// The mainland edition in Simplified characters and the Taiwan edition in Traditional ones.
// Each takes the Song (serif), Hei (sans) and Kai faces cut for its script. Fontsource has no
// Kai text face with mainland forms: LXGW WenKai TC draws 冷 the Taiwan way, so the mainland
// titles take Ma Shan Zheng, a brush Kai.
const EDITIONS = {
hans: { locale: 'zh-Hans', serif: 'Noto Serif SC', sans: 'Noto Sans SC', kai: 'Ma Shan Zheng' },
hant: { locale: 'zh-Hant', serif: 'Noto Serif TC', sans: 'Noto Sans TC', kai: 'LXGW WenKai TC' },
};
// #endregion
const LEAD = 18; // body leading in pt: 1.7 × the 10.5 pt text (五号)
const MEASURE = (26 * 10.5 * 25.4) / 72; // the grid's 26 characters of 10.5 pt, in mm
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
// #region answer: the same marks, grouped by pinyin in zh-Hans and by strokes in zh-Hant
// Marks in the Markdown, one per passage; main is the page where the character enters:
// 字:index[士隐]{term="甄士隐" main} :index{term="贾化" see="贾雨村"}
// Printed at the end of each edition: # 人名索引 {style="index"}, then :::index
const index = (e) => ({
// 'auto' reads the same from the locale: pinyin for zh-Hans, strokes for zh-Hant.
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
#Ordena por pinyin un índice en caracteres tradicionales
Una edición tradicional para lectores que buscan los nombres por su lectura puede ordenarlos por pinyin. Pon groupBy: 'pinyin' en las dos ediciones: las letras de grupo son A–Z y las entradas conservan los caracteres tradicionales. El antetítulo dice cómo se ordena el índice, así que cámbialo también en el Markdown tradicional, a kicker="依漢語拼音排列".
- groupBy: e.locale === 'zh-Hans' ? 'pinyin' : 'stroke', // A B C… or 三畫 四畫…
+ groupBy: 'pinyin', // A B C… in both scripts#Imprime los nombres sin letras de grupo
Una lista corta de nombres se lee bien con una línea en blanco entre grupos y ninguna letra encima. Conserva los grupos y quita las letras. groupBy: 'none' no sirve para esto: solo separa símbolos, números y palabras, y aquí todos los nombres empiezan por un carácter chino, así que los 47 irían en un solo bloque.
- groups: { fontFamily: e.sans, fontSize: pt(9.5), fontWeight: 700, color: col('cinnabar'),
- marginTop: pt(6.25) }, // the three names of 九畫 stay whole at the foot of their column
+ groups: { enabled: false, marginTop: pt(14) }, // no heads; a blank line between groupsErrores frecuentes
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
El chino no tiene cursiva
Las familias CJK no traen cursiva, y la tipografía china marca el énfasis con puntos junto a los caracteres, no inclinándolos. En un documento etiquetado como chino, *…* pone puntos de énfasis en los caracteres chinos que abarca y deja la cursiva para las palabras latinas (cjk.emphasis: 'dots', lo predeterminado en chino); :dots[…] los pone en cualquier sitio. Con cjk.emphasis: 'italic', o en un documento etiquetado en o es, *…* hace que el canvas incline los glifos redondos, una oblicua sintética que la tipografía china nunca usa (el PDF recurre a la redonda): conserva la etiqueta china, o marca el énfasis en negrita o en una fuente Kai (LXGW WenKai) con un estilo de párrafo o de chip. 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 →
Error frecuente
Compón la puntuación de cada región con una fuente de esa región
Los anchos de la puntuación mueven el blanco de cada signo al lado donde lo pone la región del documento, no al lado donde lo dibuja la fuente: con zh-Hans, una coma Kaiming conserva la mitad izquierda de su caja, donde una fuente simplificada dibuja el signo, y cede la derecha. Una fuente tradicional centra ,。 en la caja, así que la mitad que se va se lleva parte del signo y la coma se pega al carácter siguiente. LXGW WenKai TC, la única Kai de texto de Fontsource, lo hace en texto simplificado. Compón el texto, las notas y las citas continentales en Noto Serif SC o Noto Sans SC, deja las fuentes TC para zh-Hant y usa una letra de pincel simplificada (Ma Shan Zheng) solo en líneas de exhibición, donde el texto de diseño no aplica anchos de puntuación. Además dibuja formas heredadas que no imprime ni el estándar continental ni el de Taiwán, 為 con el 爫 de 爲 y 令 (en 冷, 領) con el pie de 卩: revisa los caracteres que compone en cada página. Anchura de la puntuación china →
- La configuración
indexes del documento, así que un documento imprime un solo orden. Un libro que quiera un índice por pinyin y otro por trazos se compone dos veces, como hace este código. - En una retícula de caracteres el equilibrado de columnas está desactivado por defecto, y la última página de cada índice llenaría la primera columna hasta el pie: el colofón de la edición simplificada empezaría bajo la Z y acabaría en la cabeza de la segunda columna.
headings.balancing: { enabled: true }corta antes la primera columna de esa página, de modo que los nombres siguen en la segunda y el colofón queda entero debajo (Equilibrado de columnas). El corte cae entre entradas y nunca deja un nombre de un grupo solo al pie o en la cabeza de una columna (index.groups.splitMinEntries, 2 por defecto), así que las dos columnas solo acaban a la par cuando las longitudes lo permiten. Aquí cada colofón lleva una frase sobre el orden de su índice, y las columnas de las dos páginas de cierre acaban a menos de un tercio de línea una de otra.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Sueño en el pabellón rojo (紅樓夢), capítulos 1 a 3, pasajes en que aparecen los personajes, en la edición de Cheng y Gao de 1792 (程乙本); transcripción de Wikisource, revisión 9685985. La edición tradicional lee 原係 donde el original dice 原系; las dos componen su -- como ——; la edición simplificada, convertida con OpenCC · Cao Xueqin, Cheng Weiyuan and Gao E; transcription by Wikisource editors · CC BY-SA 4.0
- Fuentes
- Noto Serif SC (SIL OFL 1.1) · Noto Sans SC (SIL OFL 1.1) · Ma Shan Zheng (SIL OFL 1.1) · 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 Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


