En poques paraules
Un clàssic xinès compost com els antics llibres impresos amb planxes de fusta. Cada pàgina porta un marc doble i línies fines entre columnes, i les notes van en lletra petita dins de les línies.
Què compondràs
Tres fulls del comentari de Zhu Xi a les Analectes (論語集註), el començament del llibre 學而, compostos com els imprimia un bloc de fusta, després d'una portada. Cada pàgina és mig full de 121 × 213 mm i cada doble pàgina és un full sencer, que es llegeix des de la dreta: a cada meitat, nou columnes de 17 caràcters en Noto Serif TC de 20 pt, un marc doble, un filet fi entre cada dues columnes i, al plec, la franja central (版心) amb el títol, una cua de peix negra, el juan i el número del full. Les notes de Zhu Xi es pleguen en dues files de caràcters de 10 pt dins de la columna, a continuació de les paraules que expliquen. El marge superior dobla l'inferior.
Aquesta recepta respon a
- Com componc un full xilogràfic, amb marc doble, un filet entre columnes i la franja central?
- Com defineixo la caixa en caràcters, tants per línia i tantes línies per pàgina?
- Com componc un llibre xinès en vertical, enquadernat per la dreta?
La resposta curta
// A block printed both halves of a leaf (葉) at once, the centre strip between them. Each
// page here is a half-leaf. Page 1, the title, is a recto: in a book bound on the right it
// stands alone left of the spine, and every spread after it is one leaf, read from the
// right. The grid sets the block's 9 columns of 17 characters; the text has no
// punctuation, so every column ends on its 17th character.
const page = {
sizePreset: 'custom', width: pt(W), height: pt(H), dpi: 150,
backgroundColor: col('paper'),
// left is the inner margin, the half of the centre strip on this side of the fold
margins: { top: pt(TOP), bottom: pt(BOTTOM), left: pt(HALF), right: pt(OUTER), mirror: true },
};
const layout = { layoutType: 'single', writingMode: 'vertical-rl' }; // bound on the right
const cjk = { grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES } };
// Postext numbers pages, not leaves. Each leaf opens with a hidden level-1 heading, which
// prints nothing and starts a right-hand page; the centre strip prints their count.
const leaf = {
level: 1, hidden: true, numberingTemplate: '{1:一}', // 一, 二, 三
breakBefore: { enabled: true, parity: 'even' }, // even pages lie on the right in this binding
};
Ingredients
- Funcions
- Textos, filets i caixes als dissenys de pàginaRetícula de caràctersText verticalWarichu: notes a dues línies dins de la líniaLlibres enquadernats per la dretaEstils de títolCapçaleres per seccióCapítols sense númeroAncoratge d'elements de dissenyImatges als dissenys de pàginaTítols numeratsAtributs de títolNumeració xinesaFonts xineses, japoneses i coreanesEstils de paràgrafMarges simètricsFormat de pàginaColor del paperPaleta de color semànticaExportació a PDF
- Tipografia
- Noto Serif TC, LXGW WenKai TC (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Cada pàgina, mig full; cada doble pàgina, un full
El codi és la resposta curta de més amunt. Un bloc imprimia el full (葉) sencer d'una vegada, amb les dues meitats als costats de la franja central; l'impressor doblegava el paper per la franja, amb la cara impresa cap enfora, i cosia les vores obertes, de manera que la franja acabava al tall davanter del llibre. Aquestes pàgines queden com el full sortia del bloc. Cada pàgina és mig full. En un llibre enquadernat per la dreta la pàgina 1 va sola a l'esquerra del llom i cada doble pàgina següent ajunta una pàgina parella a la dreta amb la senar que la segueix, així que, amb la portada a la pàgina 1, cada doble pàgina és un full. La retícula de caràcters fixa el 行款 del bloc, nou columnes de 17 caràcters, i els marges que deixa són exactes: l'interior fa mitja franja.
Postext numera pàgines, no fulls. Cada full comença amb un títol de nivell 1 ocult: no imprimeix res ni ocupa lloc, però el seu breakBefore amb parity: 'even' obre una pàgina de la dreta, i el seu número, 一, 二, 三 amb numberingTemplate: '{1:一}', és el {chapterNumber} de la franja.
#2 · Talla el text on acaba cada full
El copista que passava en net un text per al gravador l'ajustava al bloc full a full. El Markdown fa el mateix: el títol d'un full va on acaba la novena columna de la meitat esquerra de l'anterior, encara que caigui dins d'una frase o d'una nota. Una nota tallada allà es tanca i es torna a obrir, i com que cada columna plega en dues files el seu propi tros de nota, les files surten igual que abans:
子曰巧言令色鮮矣仁:warichu[巧好令善也好其言善其色致飾於]
# 學而
:warichu[外務以悦人則人欲肆而本心之德亡矣…]El bloc no porta puntuació, així que cap regla de tall de línia no mou cap caràcter i cada columna acaba al dissetè: els talls de full es compten una vegada i no es mouen. Les notes de Zhu Xi són :warichu[…] a la meitat del cos, que és el valor per defecte, 34 caràcters petits per fila, amb un ○ entre la lectura i la glossa com al bloc.
#3 · Dibuixa el bloc amb els números de la retícula
// Header elements are placed on the sheet, pt from the page's top left corner. Both halves
// read right to left: a right-hand page (even) from the outer frame to the fold, a
// left-hand page (odd) from the fold to the outer frame.
const at = (x, y) => ({ anchor: { to: 'page', edge: 'top-left' }, offset: { x: pt(x), y: pt(y) } });
// A column of characters stands in the middle of its pitch, so the rules between columns
// fall on whole pitches. The k-th, counted from the right edge of the type area:
const line = (parity, k) =>
(parity === 'even' ? HALF + LINES * PITCH : W - HALF) - k * PITCH;
const [Y0, Y1] = [TOP - GAP, TOP + CHARS * BODY + GAP]; // the inner frame's top and foot
// A rule is drawn from its x, a box's border inside the box: each is set so that the line
// is centred where it belongs.
const rule = (id, x, parity) => ({ kind: 'rule', id, parity, direction: 'vertical',
thickness: pt(0.6), color: col('rule'),
placement: { ...at(x - 0.3, Y0), size: { height: pt(Y1 - Y0) } } });
const frame = (id, [x0, x1], parity) => [[RULES, 1.8], [0, 0.6]].map(([out, t], i) => ({
kind: 'box', id: `${id}-${i}`, parity, style: { borderColor: col('rule'), borderWidth: pt(t) },
placement: { ...at(x0 - out - t / 2, Y0 - out - t / 2),
size: { width: pt(x1 - x0 + 2 * out + t), height: pt(Y1 - Y0 + 2 * out + t) } } }));
// The middle of the strip, where its text stands: the fold, halfway between its two rules.
// Both pages draw the text whole, and each shows its half.
const mid = (parity) => (parity === 'even' ? 0 : W);
const strip = (id, content, parity, y) => ({ kind: 'text', id: `${id}-${parity}`, parity,
content, writingMode: 'vertical-rl', fontFamily: SONG, fontSize: pt(11), color: col('ink'),
align: 'left', overflow: 'clip',
placement: { ...at(mid(parity) - HALF, TOP + y),
size: { width: pt(2 * HALF), height: pt(CHARS * BODY - y) } } });
// The fish tail (魚尾): a black band with a notch, from one side of the strip to the other.
const FISH = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 18">
<path d="M0 0H32V13L16 6L0 13Z" fill="${palette.rule}"/></svg>`;
const resources = [{ id: 'fish', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
svg: { fileId: 'fish.svg', width: 32, height: 18 } }];
const fish = (parity) => ({ kind: 'image', id: `fish-${parity}`, parity, resourceId: 'fish',
decorative: true, placement: { ...at(mid(parity) - HALF + 0.3, TOP + 3.4 * BODY),
size: { width: pt(2 * HALF - 0.6), height: 'auto' } } });
const furniture = (parity) => [
// The frame runs 40 pt past the fold, where the other half of the leaf takes it on.
...frame(`frame-${parity}`, parity === 'even' ? [-40, line(parity, 0)]
: [line(parity, LINES), W + 40], parity),
// Nine rules: eight between the columns (界行) and the side of the strip.
...Array.from({ length: LINES }, (_, i) =>
rule(`rule-${i}-${parity}`, line(parity, parity === 'even' ? i + 1 : i), parity)),
strip('book', '{title}', parity, 0.7 * BODY), // 書名, above the fish tail
fish(parity),
strip('juan', '卷一', parity, 5.2 * BODY), // 卷次, under it
strip('leaf', '{chapterNumber}', parity, 11.5 * BODY), // 葉碼, the leaf's number
];
La capçalera es compon sobre el paper, així que el marc, els filets i la franja es col·loquen en punts des de la cantonada de la pàgina amb els mateixos números que fixen la retícula: un element de línia cada 29 pt a l'amplada de la caixa de text, una caixa a 4,5 pt del text per a la línia fina i una altra 4,5 pt més enfora per a la gruixuda. Cada columna de caràcters queda al centre del seu pas, així que els filets cauen a mig camí entre columnes. El text de la franja va de dalt a baix en elements de text verticals i la cua de peix és un SVG en un element d'imatge, tots dos centrats entre els dos filets de la franja, sobre el plec: cada pàgina mostra 17 pt de franja. Cada pàgina dibuixa sencers el text de la franja i la cua de peix i en mostra la part del seu costat, i en ajuntar-les les parts encaixen. Els marcs passen del plec pel mateix motiu.
#4 · Dona a la portada un estil propi
// A heading style of its own: hidden and unnumbered, so the leaves still count from 一, and
// its header replaces the leaves' furniture on its page. Its attributes hold the byline,
// this edition's note in red and the colophon, the one line that changes with the language.
const CELLS = [0, 2, LINES - 2, LINES]; // the byline, title and note, in pitches from the right
const cell = (i) => [CELLS[i], CELLS[i + 1]];
const column = (id, content, [k0, k1], style) => ({ kind: 'text', id, content,
writingMode: 'vertical-rl', color: col('ink'), overflow: 'clip', verticalAlign: 'middle',
placement: { ...at(line('odd', k1), TOP),
size: { width: pt((k1 - k0) * PITCH), height: pt(CHARS * BODY) } }, ...style });
const titlePage = {
id: 'title', numbered: false, hidden: true, breakBefore: { enabled: true, parity: 'any' },
footer: { elements: [] },
header: { elements: [
...frame('title-frame', [line('odd', LINES), line('odd', 0)]),
rule('title-rule-1', line('odd', CELLS[1])), rule('title-rule-2', line('odd', CELLS[2])),
column('byline', '{attr.byline}', cell(0), { fontFamily: SONG, fontSize: pt(14),
align: 'left' }),
column('book', '{title}', cell(1), { fontFamily: KAI, fontSize: pt(60),
letterSpacing: pt(20), align: 'center' }),
column('note', '{attr.note}', cell(2), { fontFamily: KAI, fontSize: pt(11),
lineHeight: pt(0.6 * PITCH), color: col('vermilion'), align: 'right' }), // 3 in 2 pitches
{ kind: 'text', id: 'colophon', content: '{attr.colophon}', fontFamily: SONG,
fontSize: pt(6.5), lineHeight: 1.4, color: col('muted'), align: 'left', overflow: 'wrap',
placement: { ...at(line('odd', LINES) - RULES - 0.9, Y1 + RULES + 16),
size: { width: pt(LINES * PITCH) } } },
] },
};
La portada (內封) és un títol de nivell 1 amb un estil d'encapçalament ocult i sense número, així que els fulls continuen comptant des de 一. Un estil governa les pàgines de la seva secció, i el seu header hi substitueix el del document: la portada porta un marc tancat i dividit en tres columnes en lloc dels elements del mig full. L'autoria, la nota d'aquesta edició en Kai vermell i el colofó surten dels atributs del títol; el colofó és l'única línia que canvia amb la llengua de l'edició. \n dins d'un atribut comença una altra columna.
#5 · Carrega cada font amb els caràcters que compon
// Song sets the leaves, the strip and its leaf numbers; Kai only the title page's title
// and note (gotcha: cjk-fonts-slices). No punctuation: no vertical forms to load.
const note = markdown.match(/note="([^"]*)"/)?.[1].replaceAll('\\n', '') ?? '';
await loadFonts(FONTS, markdown); // their Latin files: the colophon
await loadCjkFonts({ [SONG]: FONTS[SONG] }, `${markdown}論語集註卷一二三四五六七八九十`);
await loadCjkFonts({ [KAI]: FONTS[KAI] }, `論語集註${note}`);
Fontsource serveix cada font xinesa en un centenar de fitxers per gruix. Song compon els fulls, la franja i els números de full, així que la seva crida rep la mostra i aquests caràcters; Kai compon només el títol i la nota. El bloc no porta puntuació, així que cap de les dues no necessita les formes verticals de loadCjkFonts(…, { vertical: true }).
#6 · Una tinta sobre un paper càlid
const palette = {
ink: '#1f1b17', // the text, as the block printed it
rule: '#1f1b17', // the frame, the column rules and the fish tail: the same block, same ink
vermilion: '#a3301f', // 朱: this edition's note, on the title page; 5.9 : 1 on the paper
muted: '#6d6358', // the colophon
paper: '#f2ead8',
};
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' } })),
{ id: 'main-color', name: 'defaults', value: { hex: palette.ink, model: 'hex' } },
];
El text i les línies del bloc s'imprimeixen en el mateix negre càlid, a 14 : 1 sobre el paper. Tot i així són dues entrades de la paleta, ink i rule, perquè els filets canviïn de color sense tocar el text. El vermell queda per al que afegeix aquesta edició.
La recepta completa
// ═══ Postext Cookbook · Nº 085 · A woodblock leaf: double frame, rules and centre strip ═══
// https://postext.dev/en/cookbook/woodblock-leaf
// Code: MIT · Text: 論語集註 卷一, 四庫全書 copy, zh.wikisource (CC BY-SA 4.0) · Pictures: none
// Fonts: Noto Serif TC, LXGW WenKai TC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// A title page and three leaves of Zhu Xi's commentary on the Analects, set as a woodblock
// printed them: each spread is one leaf, its two halves either side of the centre strip
// (版心), the text in a double frame with a rule between every two columns, the commentary
// folded into two small rows inside the column.
import {
buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'es'; // @lang: the language of the colophon; the leaves are Chinese in both
const RECIPE = 'woodblock-leaf';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: one ink on a warm paper, and a red for the editor's note
const palette = {
ink: '#1f1b17', // the text, as the block printed it
rule: '#1f1b17', // the frame, the column rules and the fish tail: the same block, same ink
vermilion: '#a3301f', // 朱: this edition's note, on the title page; 5.9 : 1 on the paper
muted: '#6d6358', // the colophon
paper: '#f2ead8',
};
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' } })),
{ id: 'main-color', name: 'defaults', value: { hex: palette.ink, model: 'hex' } },
];
// #endregion
const [SONG, KAI] = ['Noto Serif TC', 'LXGW WenKai TC']; // 宋: the block's face; 楷: the title
// The leaf in points: 半葉九行,行十七字, a 20 pt character on a column pitch of 29 pt.
const [BODY, PITCH, CHARS, LINES] = [20, 29, 17, 9];
const HALF = 17; // half the centre strip, from the fold to the column rule beside it
const GAP = 4.5; // the text to the inner frame line, as a character to a column rule
const RULES = 4.5; // the thin inner frame line to the heavy outer one (文武線)
const [HEAD, FOOT, SIDE] = [164, 82, 60]; // paper outside the frame: 天頭 twice 地腳
const TOP = HEAD + RULES + GAP; // the page's margins
const BOTTOM = FOOT + RULES + GAP;
const OUTER = SIDE + RULES;
const W = HALF + LINES * PITCH + OUTER; // a half-leaf, 121 × 213 mm
const H = TOP + CHARS * BODY + BOTTOM;
// #region answer: a half-leaf to a page, so that every spread is one whole leaf
// A block printed both halves of a leaf (葉) at once, the centre strip between them. Each
// page here is a half-leaf. Page 1, the title, is a recto: in a book bound on the right it
// stands alone left of the spine, and every spread after it is one leaf, read from the
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
#Pauta les columnes en vermell
Les còpies del 四庫全書 es van escriure sobre paper pautat en vermell (朱絲欄). Canvia el color dels filets; la cua de peix el segueix.
- rule: '#1f1b17', // the frame, the column rules and the fish tail: the same block, same ink
+ rule: '#b3412e', // 朱絲欄: red rules under black text#Talla un altre bloc
Hi va haver molts 行款 diferents, i 半葉十行,行二十字 és dels més corrents. Els marcs, la franja, les tres caselles de la portada i el sagnat de l'autoria surten d'aquests números, així que s'ajusten sols; els talls de full del Markdown s'han de tornar a comptar.
-const [BODY, PITCH, CHARS, LINES] = [20, 29, 17, 9];
+const [BODY, PITCH, CHARS, LINES] = [17, 24.5, 20, 10];#Compara-la amb una pàgina europea sobre retícula
Una pàgina de llibre sobre una retícula de base construeix la seva caixa de text comptant línies, com aquest full construeix la seva amb columnes i caràcters; el diploma dibuixa la seva orla a la capçalera d'un estil d'encapçalament, com aquí la portada.
Errors freqüents
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 →
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
Un llibre enquadernat per la dreta mostra els seus plecs amb showBook
En un llibre enquadernat per la dreta (text àrab, hebreu o persa, xinès vertical, o page.binding 'right') la pàgina 1 continua sent senar, però queda a l'esquerra del llom, i els plecs es llegeixen [3 | 2]. showPages compon tots els llibres com si s'enquadernessin per l'esquerra; showBook, del bloc book (el bloc cjk porta la mateixa funció), llegeix doc.binding i reflecteix els plecs. capture.hero continua anomenant un plec en ordre de lectura, [parella, senar]: [2, 3]. Llibres enquadernats per la dreta →
Error freqüent
Les transcripcions en xinès tradicional porten caràcters simplificats solts
Els textos copiats de Wikisource o d'una altra edició al web d'un llibre en xinès tradicional porten a vegades una forma simplificada (颙 per 顒 al capítol 1 de 三國演義), i una font TC com Noto Serif TC pot no tenir-la. loadCjkFonts atura la recepta i anomena el caràcter; a la pàgina sortiria amb una font de substitució. Recupera la forma tradicional a la mostra i digues-ho als crèdits. Fonts xineses, japoneses i coreanes →
- Els talls de full viuen al Markdown. Si canvies el text, el cos o el 行款, un full que se'n passa empeny el títol següent una pàgina més enllà i les dobles pàgines deixen de coincidir amb els fulls; un que es queda curt deixa columnes en blanc abans del plec. Revisa l'última columna de cada pàgina de l'esquerra.
- La transcripció del 四庫全書 escriu 巳 tant per 已 com per 己; aquesta mostra decideix cada cas per la frase. La pàgina encara demana que algú la confronti amb els facsímils, i es nota: el comentari de 張敬夫 diu 必開其政 on les Analectes, que ell repeteix, diuen 必聞其政, i dos caràcters vénen com a imatges del glif. La mostra posa 聞, 傳 i 邦. Confronta el passatge amb una segona edició abans de compondre'l.
- La mateixa transcripció porta formes que Noto Serif TC no té (廹 徳 絶 逺 専 内). Cinc cauen dins del rang d'un fitxer de Fontsource, així que
loadCjkFontsles deixa passar, i després el canvas les agafa d'una font del sistema i postext-pdf imprimeix una caixa buida i avisa. 廹 no cau dins del rang de cap fitxer, iloadCjkFontss'atura amb un error. La mostra fa servir 迫 德 絕 遠 專 內.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- 論語集註 (Collected Commentaries on the Analects), juan 1, the book 學而 from its opening to the end of its tenth section, in the copy made for the 四庫全書 (Siku quanshu, 1773–1782); Wikisource transcription, revision 523110. 巳 is read as 已 or 己 by its sentence; 開 in 張敬夫's 必開其政 is corrected to 聞, as in the words of the Analects he repeats and in Wikisource's other edition (論語集注卷一, revision 2598582); the two characters the transcription gives as glyph images are set as 傳 (以忠信為傳習之本) and 邦 (夫子至於是邦也); and six variant forms Noto Serif TC does not draw (廹 徳 絶 逺 専 内) are set in their standard forms · Zhu Xi (1130–1200); transcription by Wikisource editors · CC BY-SA 4.0
- The title page, the division into leaves and the note on this edition (據四庫全書本錄文…) · Ignacio Ferro · CC BY 4.0
- Fonts
- Noto Serif 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)


