En pocas palabras
Un clásico chino compuesto como los antiguos libros impresos con planchas de madera. Cada página lleva un doble marco y finas líneas entre columnas, y las notas van en letra pequeña dentro de las líneas.
Lo que vas a componer
Tres hojas del comentario de Zhu Xi a las Analectas (論語集註), el comienzo del libro 學而, compuestas como las imprimía un bloque de madera, tras una portada. Cada página es media hoja de 121 × 213 mm y cada doble página es una hoja entera, que se lee desde la derecha: en cada mitad, nueve columnas de 17 caracteres en Noto Serif TC de 20 pt, un marco doble, un filete fino entre cada dos columnas y, en el pliegue, la franja central (版心) con el título, una cola de pez negra, el juan y el número de la hoja. Las notas de Zhu Xi se pliegan en dos filas de caracteres de 10 pt dentro de la columna, a continuación de las palabras que explican. El margen superior dobla al inferior.
Esta receta responde a
- ¿Cómo compongo una hoja xilográfica, con marco doble, un filete entre columnas y la franja central?
- ¿Cómo defino la mancha en caracteres, tantos por línea y tantas líneas por página?
- ¿Cómo compongo un libro chino en vertical, encuadernado por la derecha?
La respuesta corta
// 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
};
Ingredientes
- Funciones
- Textos, filetes y cajas en los diseños de páginaRetícula de caracteresTexto verticalWarichu: notas a dos líneas dentro de la líneaLibros encuadernados por la derechaEstilos de títuloCabeceras por secciónCapítulos sin númeroAnclaje de elementos de diseñoImágenes en los diseños de páginaTítulos numeradosAtributos de títuloNumeración chinaFuentes chinas, japonesas y coreanasEstilos de párrafoMárgenes simétricosFormato de páginaColor del papelPaleta de color semánticaExportación a PDF
- Tipografía
- Noto Serif TC, LXGW WenKai TC (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Cada página, media hoja; cada doble página, una hoja
El código es la respuesta corta de arriba. Un bloque imprimía la hoja (葉) entera de una vez, con sus dos mitades a los lados de la franja central; el impresor doblaba el papel por la franja, con la cara impresa hacia fuera, y cosía los bordes abiertos, así que la franja acababa en el corte delantero del libro. Estas páginas quedan como la hoja salía del bloque. Cada página es media hoja. En un libro encuadernado por la derecha la página 1 va sola a la izquierda del lomo y cada doble página siguiente junta una página par a la derecha con la impar que la sigue, así que, con la portada en la página 1, cada doble página es una hoja. La retícula de caracteres fija el 行款 del bloque, nueve columnas de 17 caracteres, y los márgenes que deja son exactos: el interior mide media franja.
Postext numera páginas, no hojas. Cada hoja empieza con un encabezado de nivel 1 oculto: no imprime nada ni ocupa sitio, pero su breakBefore con parity: 'even' abre una página de la derecha, y su número, 一, 二, 三 con numberingTemplate: '{1:一}', es el {chapterNumber} de la franja.
#2 · Corta el texto donde acaba cada hoja
El copista que pasaba a limpio un texto para el grabador lo ajustaba al bloque hoja a hoja. El Markdown hace lo mismo: el título de una hoja va donde termina la novena columna de la mitad izquierda de la anterior, aunque caiga dentro de una frase o de una nota. Una nota cortada ahí se cierra y se vuelve a abrir, y como cada columna pliega en dos filas su propio trozo de nota, las filas salen igual que antes:
子曰巧言令色鮮矣仁:warichu[巧好令善也好其言善其色致飾於]
# 學而
:warichu[外務以悦人則人欲肆而本心之德亡矣…]El bloque no lleva puntuación, así que ninguna regla de corte de línea mueve un carácter y cada columna termina en el decimoséptimo: los cortes de hoja se cuentan una vez y no se mueven. Las notas de Zhu Xi son :warichu[…] a la mitad de cuerpo, que es el valor por defecto, 34 caracteres pequeños por fila, con un ○ entre la lectura y la glosa como en el bloque.
#3 · Dibuja el bloque con los 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 cabecera se compone sobre el papel, así que el marco, los filetes y la franja se colocan en puntos desde la esquina de la página con los mismos números que fijan la retícula: un elemento de línea cada 29 pt a lo ancho de la caja de texto, una caja a 4,5 pt del texto para la línea fina y otra 4,5 pt más afuera para la gruesa. Cada columna de caracteres queda en el centro de su paso, así que los filetes caen a medio camino entre columnas. El texto de la franja va de arriba abajo en elementos de texto verticales y la cola de pez es un SVG en un elemento de imagen, los dos centrados entre los dos filetes de la franja, sobre el pliegue: cada página enseña 17 pt de franja. Cada página dibuja enteros el texto de la franja y la cola de pez y enseña la parte de su lado, y al juntarlas las partes casan. Los marcos pasan del pliegue por lo mismo.
#4 · Dale a la portada un estilo propio
// 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 (內封) es un encabezado de nivel 1 con un estilo de encabezado oculto y sin número, así que las hojas siguen contando desde 一. Un estilo gobierna las páginas de su sección, y su header sustituye allí al del documento: la portada lleva un marco cerrado y dividido en tres columnas en lugar de los elementos de la media hoja. La autoría, la nota de esta edición en Kai rojo y el colofón salen de los atributos del título; el colofón es la única línea que cambia con el idioma de la edición. \n dentro de un atributo empieza otra columna.
#5 · Carga cada fuente con los caracteres que compone
// 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 sirve cada fuente china en un centenar de archivos por peso. Song compone las hojas, la franja y los números de hoja, así que su llamada recibe la muestra y esos caracteres; Kai compone solo el título y la nota. El bloque no lleva puntuación, así que ninguna de las dos necesita las formas verticales de loadCjkFonts(…, { vertical: true }).
#6 · Una tinta sobre un papel cálido
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 texto y las líneas del bloque se imprimen en el mismo negro cálido, a 14 : 1 sobre el papel. Aun así son dos entradas de la paleta, ink y rule, para que los filetes cambien de color sin tocar el texto. El rojo queda para lo que añade esta edición.
La receta 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
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
#Pauta las columnas en rojo
Las copias del 四庫全書 se escribieron sobre papel pautado en rojo (朱絲欄). Cambia el color de los filetes; la cola de pez lo sigue.
- rule: '#1f1b17', // the frame, the column rules and the fish tail: the same block, same ink
+ rule: '#b3412e', // 朱絲欄: red rules under black text#Talla otro bloque
Hubo muchos 行款 distintos, y 半葉十行,行二十字 es de los más corrientes. Los marcos, la franja, las tres casillas de la portada y la sangría de la autoría salen de estos números, así que se ajustan solos; los cortes de hoja del Markdown hay que contarlos otra vez.
-const [BODY, PITCH, CHARS, LINES] = [20, 29, 17, 9];
+const [BODY, PITCH, CHARS, LINES] = [17, 24.5, 20, 10];#Compárala con una página europea sobre retícula
Una página de libro sobre una rejilla base construye su caja de texto contando líneas, como esta hoja construye la suya con columnas y caracteres; el diploma dibuja su orla en la cabecera de un estilo de encabezado, como aquí la portada.
Errores frecuentes
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
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
Un libro encuadernado por la derecha muestra sus pliegos con showBook
En un libro encuadernado por la derecha (texto árabe, hebreo o persa, chino vertical, o page.binding 'right') la página 1 sigue siendo impar, pero queda a la izquierda del lomo, y los pliegos se leen [3 | 2]. showPages compone todos los libros como si se encuadernaran por la izquierda; showBook, del bloque book (el bloque cjk trae la misma función), lee doc.binding y refleja los pliegos. capture.hero sigue nombrando un pliego en orden de lectura, [par, impar]: [2, 3]. Libros encuadernados por la derecha →
Error frecuente
Las transcripciones en chino tradicional traen caracteres simplificados sueltos
Los textos copiados de Wikisource o de otra edición en la web de un libro en chino tradicional traen a veces una forma simplificada (颙 por 顒 en el capítulo 1 de 三國演義), y una fuente TC como Noto Serif TC puede no tenerla. loadCjkFonts detiene la receta y nombra el carácter; en la página saldría con una fuente de sustitución. Recupera la forma tradicional en la muestra y dilo en los créditos. Fuentes chinas, japonesas y coreanas →
- Los cortes de hoja están en el Markdown. Si cambias el texto, el cuerpo o el 行款, una hoja que se pasa empuja el título siguiente una página más allá y las dobles páginas dejan de coincidir con las hojas; una que se queda corta deja columnas en blanco antes del pliegue. Revisa la última columna de cada página de la izquierda.
- La transcripción del 四庫全書 escribe 巳 tanto por 已 como por 己; esta muestra decide cada caso por la frase. La página aún pide que alguien la coteje con los facsímiles, y se nota: el comentario de 張敬夫 dice 必開其政 donde las Analectas, que él repite, dicen 必聞其政, y dos caracteres vienen como imágenes del glifo. La muestra pone 聞, 傳 y 邦. Coteja el pasaje con una segunda edición antes de componerlo.
- La misma transcripción trae formas que Noto Serif TC no tiene (廹 徳 絶 逺 専 内). Cinco caen dentro del rango de un archivo de Fontsource, así que
loadCjkFontslas deja pasar, y luego el canvas las toma de una fuente del sistema y postext-pdf imprime una caja vacía y avisa. 廹 no cae en el rango de ningún archivo, yloadCjkFontsse detiene con un error. La muestra usa 迫 德 絕 遠 專 內.
Créditos
- Receta
- Ignacio Ferro
- Texto
- 論語集註 (Comentarios reunidos a las Analectas), juan 1, el libro 學而 desde el comienzo hasta el final de su décima sección, en la copia hecha para el 四庫全書 (Siku quanshu, 1773–1782); transcripción de Wikisource, revisión 523110. 巳 se lee como 已 o 己 según la frase; el 開 de 必開其政, en la cita de 張敬夫, se cambia por 聞, como en las palabras de las Analectas que repite y en la otra edición de Wikisource (論語集注卷一, revisión 2598582); los dos caracteres que la transcripción da como imágenes se componen como 傳 (以忠信為傳習之本) y 邦 (夫子至於是邦也), y seis variantes que Noto Serif TC no dibuja (廹 徳 絶 逺 専 内) se componen en su forma normal · Zhu Xi (1130–1200); transcription by Wikisource editors · CC BY-SA 4.0
- La portada, la división en hojas y la nota sobre esta edición (據四庫全書本錄文…) · Ignacio Ferro · CC BY 4.0
- Fuentes
- Noto Serif 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)


