En poques paraules
Quatre pàgines d'un diccionari xinès clàssic. La cantonada superior de cada pàgina mostra la primera i l'última entrada, per trobar una paraula fullejant.
Què compondràs
Quatre pàgines del centre d'una edició de lectura del Diccionari de Kangxi (康熙字典, 1716), reordenat per pinyin, de 天 tiān a 庭 tíng. Cada lema va en vermell, en la song supernegra, amb el pinyin a sobre; les lectures dels diccionaris de rimes (反切) i les accepcions el segueixen en un sol paràgraf, amb les accepcions numerades ① ② en el mateix vermell. La pàgina és un 大32开 de 140 × 203 mm, a dues columnes de 17 caràcters de 小五 (9 pt), sobre una retícula de 31 línies, i cada columna arriba a la seva última línia. A la cantonada exterior de cada pàgina, la capçalera anomena el primer i l'últim lema que hi ha, de manera que qui cerca 蜩 va a la pàgina que porta 腆—髫. Per comparar-ho amb un diccionari en alfabet llatí, mira el vocabulari mariner de Smyth.
Aquesta recepta respon a
- Com imprimeixo a la capçalera d'un diccionari el primer i l'últim lema de cada pàgina?
- Com poso pinyin damunt dels caràcters xinesos?
- Com porto els caràcters xinesos al PDF sense caixes buides?
La 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) } } },
];
Ingredients
- Funcions
- Paraules guia a la capçaleraRuby: lectures en pinyin i zhuyinRetícula de caràctersUna o dues columnesFilet de columnaEquilibri de columnesFonts xineses, japoneses i coreanesTall de línies en xinèsAmplada de la puntuació xinesaJustificació entre caràctersCapçaleres i folisBandes a sang i pestanyesAncoratge d'elements de dissenyNegreta, cursiva i els seus colorsEstils de paràgrafMarges simètricsPaleta de color semànticaExportació a PDF
- Tipografia
- Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Les paraules guia surten dels lemes
El codi és la resposta curta de més amunt. Cada lema és un títol de segon nivell, i {firstMark.h2} i {lastMark.h2} imprimeixen el text del primer i de l'últim títol d'aquest nivell que comencen a la pàgina (elements de text). La marca són els caràcters del títol: ## {天|tiān} marca 天, i la lectura es queda sobre el lema. Una entrada que passa d'una pàgina a la següent només compta on hi ha el lema: la pàgina 635 comença amb el final de 殄 i porta 腆—髫. El primer nivell queda per a les lletres; en aquestes quatre pàgines no en comença cap, però la capçalera d'una lletra no comptaria com a paraula guia.
#2 · El pinyin sobre el lema
// 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} és la forma curta de :ruby[天]{rt="tiān"}, una lectura sobre un caràcter (marques xineses, ruby i warichu). Un títol sense disseny propi compon la seva lectura; amb un disseny, el títol imprimiria 天 sol. La lectura pren la font del títol, la supernegra, llevat que cjk.ruby.fontFamily n'indiqui una altra, i per això s'hi indica la song regular. La meitat de 15 pt són 7,5 pt, i la línia de 30 pt del títol deixa lloc per a la lectura sobre el lema: el títol ocupa dues línies de la retícula i el text que va a sota continua en les línies de 15 pt de les dues columnes. El pinyin puja el que baixen els traços descendents de la seva font i 0,04 em més, de manera que la g de tīng acaba 0,6 pt per sobre de la caixa de 汀.
#3 · Un paràgraf per a cada entrada
// 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 Diccionari de Kangxi compon cada entrada seguida: primer les lectures dels diccionaris de rimes i després cada accepció, introduïda per 又. Aquí el 又 s'ha canviat per números en cercle, escrits com **②**, i boldColor els imprimeix en el vermell dels lemes; no hi ha cap altra negreta al text. Una accepció que el Kangxi llegeix d'una altra manera conserva la seva lectura, com 跳 ② amb 徒刀切. El compositor tracta de ① a ⑳ com a caràcters xinesos: cap línia no acaba en un número si la seva accepció comença a la línia següent, i no hi entra espai entre xinès i llatí entre el número i el seu text, així que els números s'escriuen tal com són. L'equilibratge de columnes està desactivat (headings.balancing.enabled: false): cap columna obre espai sobre els seus lemes i cada entrada segueix l'anterior a la mateixa distància.
#4 · La pestanya de la 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) },
];
};
Les síl·labes del pinyin comencen per 23 de les 26 lletres (cap per I, U o V), així que l'alçada de la caixa es divideix en 23 passos de 7,13 mm, i a la T li toca el dinovè. La pestanya fa 9 mm i comença 3 mm fora del tall, de manera que la pàgina la talla recta per la vora exterior i només se'n veuen arrodonides les cantonades interiors; un fitxer per a impremta amb page.cutLines portaria aquests 3 mm a la sang. La lletra es centra en els 6 mm que queden a dins. Les quatre pàgines són de la T, de manera que la pestanya no canvia d'alçada; en el vocabulari de Smyth baixa pel tall d'una lletra a la següent.
#5 · Cada font carrega els seus propis caràcters
// 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 talla cada font xinesa en un centenar de fitxers per intervals de caràcters, i loadCjkFonts carrega els que contenen el text que rep. La song regular rep tota la mostra, també el text en castellà del colofó. La supernegra, els trenta lemes; la negreta, els números d'accepció; la hei, els lemes i les xifres de les capçaleres, i la kai, la frase en xinès del colofó. cjkPdfProvider incrusta aquests mateixos fitxers al PDF, cadascun reduït als caràcters que fan servir les seves pàgines.
La recepta 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 = '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 });
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#El primer lema a la parella i l'últim a la senar
Hi ha diccionaris que imprimeixen una sola paraula guia per pàgina: la primera a dalt a la parella i l'última a dalt a la senar, de manera que la doble pàgina diu 天 … 髫.
- 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 amb ɑ i ɡ d'un sol ull
Els diccionaris xinesos componen el pinyin en una font amb la a i la g d'un sol ull. Indica Andika per a les lectures i afegeix-la a FONTS ('Andika': ['400'], amb el seu crèdit OFL).
- ruby: { fontFamily: SONG, fontSize: em(0.5), color: col('cinnabar') },
+ ruby: { fontFamily: 'Andika', fontSize: em(0.5), color: col('cinnabar') },#Lemes de la mida del text
Un diccionari compacte posa el lema en negreta al principi del paràgraf. Posa les entrades dins de :::paragraphs{style="entry"}, comença cadascuna amb **{天|tiān}** i imprimeix {firstMark.entry}: un paràgraf que comença amb un tram en negreta marca la pàgina amb aquest tram.
Errors freqüents
Error freqüent
Les lectures s'imprimeixen al text, no en dissenys, peus ni cel·les
Les lectures ruby es dibuixen en paràgrafs, títols, elements de llista, cites i requadres. Un element de text d'un disseny (una obertura, una capçalera, una etiqueta), un peu, una nota a peu de pàgina i una cel·la de taula imprimeixen els caràcters base sense les seves lectures. Un títol que necessita el seu pinyin és un títol sense disseny propi: dibuixa el que l'envolta (una banda, el número de la lliçó) amb el disseny del títol anterior, els elements del qual amb reserve: false es pinten sota el text d'una obertura span: 'page'. Ruby: lectures en pinyin i zhuyin →
Error freqüent
Les fonts xineses es carreguen per fragments, amb el bloc cjk
Fontsource serveix una família xinesa, japonesa o coreana en un centenar de fitxers per pes, cadascun amb un interval de caràcters. loadFonts només baixa el fitxer latin, així que a la pantalla els caràcters xinesos surten d'una font del sistema i es mesuren malament, i fontsourceProvider lliura al PDF aquest fitxer latin, que els imprimeix com a caixes buides. Afegeix el bloc cjk del kit, crida loadCjkFonts(FONTS, markdown) després de loadFonts (una vegada per veu, amb el text que compon, si el llibre fa servir diverses fonts xineses) i passa a renderToPdf fontProvider: cjkPdfProvider: tots dos agafen els fitxers que contenen els caràcters del text. Fonts xineses, japoneses i coreanes →
Error freqüent
Etiqueta el document zh-Hans o zh-Hant, no amb LANG
Les edicions d'una recepta són en i es, però una mostra xinesa és xinesa en totes dues: `locale: LANG` l'etiquetaria com a anglès o castellà, separaria les seves paraules llatines, anomenaria Figure o Figura les seves figures i donaria al PDF una llengua equivocada. Des de postext 1.30 l'etiqueta és a més la llengua en què es compon el text (en què es mesura, es pinta i s'incrusta), de manera que sota una etiqueta anglesa o castellana una font xinesa compon amb altres formes les xifres i la puntuació que comparteix amb el text llatí, i les línies es parteixen per un altre lloc. Escriu tu l'etiqueta: 'zh-Hans' (convencions de la Xina continental: tall GB, puntuació Kaiming) o 'zh-Hant' (Taiwan: puntuació d'amplada completa centrada); 'zh-HK' per a Hong Kong. Un 'zh' tot sol es llegeix com a xinès simplificat continental. Una mostra japonesa porta 'ja' (gotcha ja-locale-tag). Tall de línies en xinès →
- Amb l'equilibratge de columnes activat, una columna en què ja no hi cap el lema següent amb dues línies del seu text a sota (
bodyText.widowMinLines) acaba abans, i les línies que sobren van a sobre dels lemes, com a molt una per a cadascun: una entrada queda a una línia de l'anterior i la següent no. Desactivat, aquesta columna queda curta.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- 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
- Fonts
- Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


