En pocas palabras
Seis páginas de una novela clásica china, escrita en columnas que se leen de arriba abajo. Las notas antiguas de un lector aparecen en rojo dentro de las líneas y en una franja sobre el texto.
Lo que vas a componer
El comienzo del capítulo 1 de la Historia de la piedra en el manuscrito Jiaxu, la copia que conserva los comentarios de Zhiyan Zhai, compuesto en seis páginas de una edición comentada en formato 16开, de 184 × 260 mm, en vertical y encuadernada por la derecha. El texto de Cao Xueqin va en Noto Serif TC, con 36 caracteres por columna y 18 columnas por página. El manuscrito escribe en rojo, junto a las columnas, los 61 comentarios laterales (側批) de este fragmento. Postext no compone nada entre dos columnas, así que esta edición los mete en la línea, cada uno plegado en dos filas bermellón a la mitad del cuerpo justo después de las palabras que glosa, como las ediciones comentadas impresas componen sus 雙行夾批. Los diez comentarios del margen superior (眉批) van en letra Kai roja, en un piso de 42 mm sobre el texto y encima del pasaje que discuten, así que el lector sigue el texto y el comentario de una sola pasada.
Esta receta responde a
- ¿Cómo compongo una edición comentada, con notas pequeñas a dos líneas dentro de la línea y comentarios en el margen superior?
- ¿Cómo compongo un libro chino en vertical, encuadernado por la derecha?
La respuesta corta
const layout = {
writingMode: 'vertical-rl', // columns down the page, read from the right; bound on the right
layoutType: 'oneAndHalf', // a text tier and a narrow tier for the comments
sideColumnRole: 'floats', // no text runs into it: only boxes fenced with span="side"
sideColumnSide: 'left', // in vertical text 'left' is the top tier: the head margin (天頭)
sideColumnPercent: 19, // the grid rounds it to 10 characters of the body, 42 mm
gutterWidth: mm(8), // rounded to 2 characters
columnRule: { enabled: true, lineWidth: pt(0.5), color: col('rule') },
};
const cjk = {
grid: { enabled: true, charsPerLine: 36, linesPerPage: 18 }, // 版心: 36 字 × 18 行
// :warichu[…] folds a side comment into two rows at half the body size, in red
// and with no brackets, as the manuscripts write their 雙行夾批.
warichu: { color: col('vermilion') },
};
// A 眉批 is :::callout{type="meipi" span="side"}: span="side" sends it to the head
// margin, level with the column the text has reached at its fence, so the fence goes
// just before the passage it discusses (gotcha: side-box-starts-at-fence).
const meipi = {
id: 'meipi', backgroundEnabled: false,
border: { enabled: false }, stripe: { enabled: false },
padding: { top: pt(0), right: pt(0), bottom: pt(0), left: pt(0) },
// 17 characters of 7 pt down the 120 pt tier, a column every 10 pt. The next comment
// starts on a text column at least one body column (21 pt) further on, whatever the margin.
snapToGrid: false, marginBottom: pt(0),
body: { fontFamily: KAI, fontSize: pt(7), lineHeight: pt(10), color: col('vermilion'),
textAlign: 'left', firstLineIndent: pt(0) },
};
Ingredientes
- Funciones
- Warichu: notas a dos líneas dentro de la líneaNotas al margenTexto verticalLibros encuadernados por la derechaColumna al margen para flotantesColumna y mediaRetícula de caracteresFuentes chinas, japonesas y coreanasAnchura de la puntuación chinaCorte de líneas en chinoNumeración chinaAperturas diseñadasAtributos de títuloCabeceras y foliosRecuadrosEstilos de párrafoPaleta de color semánticaMárgenes simétricos
- También usa
- Filete de columnaSalir de la rejilla a propósitoColor del papelCabeceras según el tipo de páginaExportación a PDFFuentes incrustadas en el PDFPreliminares en romanos
- Tipografía
- Noto Serif TC, LXGW WenKai TC, Noto Sans TC (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Convierte la columna lateral en el margen superior
El código es la respuesta corta de arriba. Una página vertical es una página horizontal girada un cuarto de vuelta, así que la columna lateral de una disposición en columna y media se convierte en un piso que cruza la página, y sideColumnSide: 'left' lo coloca arriba (Escritura vertical). La retícula de caracteres redondea sideColumnPercent: 19 a 10 caracteres del cuerpo, 120 pt, y el medianil a dos; el filete de columna pasa a ser la línea fina que separa los comentarios del texto. El estilo de los comentarios no tiene borde: Kai de 7 pt, 17 caracteres por columna, un cuerpo con el que ninguno de los diez comentarios acaba en una columna de un solo carácter, y snapToGrid: false, para que los comentarios se apilen con su propio paso de 10 pt y no con los 21 pt del cuerpo.
Los dos tipos de comentario se marcan donde los pone el manuscrito. Un comentario lateral es un :warichu[…], al que cjk.warichu da el color; un comentario del margen superior es un recuadro con span="side" cuya línea de apertura va justo antes del pasaje que comenta:
:::callout{type="meipi" span="side"}
妙!自謂落墮情根,故無補天之用。
:::
原來女媧氏煉石補天之時,:warichu[補天濟世,勿認真,用常言。]于大荒山:warichu[荒唐也。]…#2 · Baja el número del capítulo y su pareado por las primeras columnas
const opener = { enabled: true, minHeight: mm(46), slot: { elements: [
{ kind: 'text', id: 'book', content: '{title}', fontFamily: HEI, fontWeight: 500,
fontSize: pt(10), letterSpacing: pt(3), color: col('vermilion'), align: 'left',
placement: { anchor: { to: 'container', edge: 'top-left' } } },
{ kind: 'text', id: 'number', content: '{titleText}', fontFamily: SONG, fontWeight: 700,
fontSize: pt(30), letterSpacing: pt(6), color: col('ink'), align: 'left',
placement: { anchor: { to: '#book', edge: 'below' }, offset: { x: em(2), y: mm(4) } } },
...['a', 'b'].map((half, i) => ({ kind: 'text', id: `couplet-${half}`,
content: `{attr.${half}}`, fontFamily: SONG, fontSize: pt(15), letterSpacing: pt(3),
color: col('ink'), align: 'left',
placement: { anchor: { to: i ? '#couplet-a' : '#number', edge: 'below' },
offset: { x: i ? pt(0) : em(4), y: mm(i ? 1.5 : 4) } } })),
] } };
En una página vertical la apertura se compone en el marco del flujo: su texto baja, below significa a la izquierda y un desplazamiento x baja el elemento por la columna. Primero va el título del libro en Hei rojo; después, 第一回 a 30 pt, dos de sus propios caracteres más abajo, y luego las dos mitades del pareado, sacadas de los atributos del título {a="…" b="…"} y más bajas todavía, de modo que el número y el pareado descienden en escalera como en un 回目 impreso. minHeight: mm(46) deja una columna libre entre el pareado y el texto.
#3 · Lleva las cabeceras por el corte exterior
// 'outer' is the margin away from the spine: a recto's left, a verso's right.
const edge = (id, content, edgeOf, y, extra = {}) => ({ kind: 'text', id, content,
writingMode: 'vertical-rl', fontFamily: HEI, fontWeight: 500, fontSize: pt(9.5),
letterSpacing: pt(2), color: col('muted'), overflow: 'clip', align: 'left',
placement: { anchor: { to: 'outer', edge: edgeOf }, offset: { y: em(y) } }, ...extra });
const header = { elements: [
// Four characters below the head: the book on a verso, the chapter on a recto,
// never on the opener.
edge('head-verso', '{title}', 'top', 4, { pages: 'body', parity: 'even' }),
edge('head-recto', '{chapterTitle}', 'top', 4, { pages: 'body', parity: 'odd' }),
edge('folio', '{pageNumber}', 'bottom', -5), // 一, 二, 三…: page.pageNumbering below
] };
Son las cabeceras del corte exterior que describen los Elementos de texto verticales: anchor.to: 'outer' es el margen del lado contrario al lomo, el izquierdo en una página impar y el derecho en una par cuando el libro se encuaderna por la derecha, y writingMode: 'vertical-rl' compone el texto de arriba abajo. Aquí la caja de texto incluye el piso de los comentarios, así que los «cuatro caracteres por debajo de la cabeza» se cuentan desde el borde superior de los comentarios rojos. trad-chinese-informal imprime los folios del 一 al 六.
#4 · Carga cada voz con el texto que compone
// Song sets the whole sample and its bold only 第一回, Kai the head-margin comments and
// the edition's note, Hei the running heads, the folios and the colophon
// (gotcha: cjk-fonts-slices).
const blocks = (style) => [...markdown.matchAll(
new RegExp(`:::(?:callout|paragraphs)\\{[^}]*"${style}"[^}]*\\}\\n([^]*?)\\n:::`, 'g'))]
.map((m) => m[1]).join('');
const numerals = '一二三四五六七八九十';
await loadFonts(FONTS, markdown);
await loadCjkFonts({ [SONG]: ['400'] }, markdown, { vertical: true });
await loadCjkFonts({ [SONG]: ['700'] }, '第一回'); // the bold weight sets three characters
await loadCjkFonts({ [KAI]: FONTS[KAI] }, blocks('meipi') + blocks('note'), { vertical: true });
await loadCjkFonts({ [HEI]: FONTS[HEI] }, `脂硯齋重評石頭記第一回${numerals}${blocks('colophon')}`,
{ vertical: true });
Fontsource sirve cada fuente china en unos cien archivos por peso. La Song compone toda la muestra en su peso normal y en negrita solo 第一回; la Kai, solo los comentarios del margen superior y la nota de la edición, y la Hei, las cabeceras, los folios y el colofón, así que cada llamada descarga solo los archivos de sus propios caracteres. vertical: true carga además la puntuación vertical de cada fuente para el canvas.
#5 · Dos tintas
const palette = {
ink: '#231d18', // the text: a warm black
vermilion: '#b0362a', // 朱: every comment, the chapter's kicker; 5.5 : 1 on the paper
rule: '#b9a78f', // the line under the head margin
muted: '#6f6356', // folios, the colophon
paper: '#f7f1e3',
};
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: aimed at the vermilion, nothing prints blue.
{ id: 'main-color', name: 'vermilion (defaults)',
value: { hex: palette.vermilion, model: 'hex' } },
];
La página se imprime a dos colores, como se escribió el manuscrito: un negro cálido para el texto y un bermellón para cada comentario, el antetítulo del capítulo y nada más. El bermellón tiene un contraste de 5,5 : 1 con el papel, suficiente para las filas de 6 pt de los comentarios laterales. main-color apunta a él, así que cualquier valor por defecto que la configuración no redefina sale en rojo, nunca en azul.
La receta completa
// ═══ Postext Cookbook · Nº 078 · Red-ink commentary in the line and the head margin ═══
// https://postext.dev/en/cookbook/red-ink-commentary
// Code: MIT · Text: 脂硯齋重評石頭記, Jiaxu manuscript, Wikisource (CC BY-SA 4.0) · Pictures: none
// Fonts: Noto Serif TC, LXGW WenKai TC, Noto Sans TC (SIL OFL 1.1) · Needs postext ≥ 1.28.0
// The first chapter of the Stone as a commentary edition: the text set vertically, the
// comments the manuscript writes beside the columns folded into two small red rows inside
// the line, the head-margin comments in red Kai above the columns they gloss.
import {
buildDocument, withLoadedFonts, renderPageToCanvas, loadVerticalAlternates,
} 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 = 'red-ink-commentary';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black ink and vermilion on a warm paper
const palette = {
ink: '#231d18', // the text: a warm black
vermilion: '#b0362a', // 朱: every comment, the chapter's kicker; 5.5 : 1 on the paper
rule: '#b9a78f', // the line under the head margin
muted: '#6f6356', // folios, the colophon
paper: '#f7f1e3',
};
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: aimed at the vermilion, nothing prints blue.
{ id: 'main-color', name: 'vermilion (defaults)',
value: { hex: palette.vermilion, model: 'hex' } },
];
// #endregion
const [SONG, KAI, HEI] = ['Noto Serif TC', 'LXGW WenKai TC', 'Noto Sans TC']; // 宋, 楷, 黑
const BODY = 12; // pt, 小四: the notes fold to two rows of 6 pt in the same em
const LEAD = 21; // pt between columns, 1.75 × the body
// #region answer: side comments inside the line, head-margin comments above it
const layout = {
writingMode: 'vertical-rl', // columns down the page, read from the right; bound on the right
layoutType: 'oneAndHalf', // a text tier and a narrow tier for the comments
sideColumnRole: 'floats', // no text runs into it: only boxes fenced with span="side"
sideColumnSide: 'left', // in vertical text 'left' is the top tier: the head margin (天頭)
sideColumnPercent: 19, // the grid rounds it to 10 characters of the body, 42 mm
gutterWidth: mm(8), // rounded to 2 characters
columnRule: { enabled: true, lineWidth: pt(0.5), color: col('rule') },
};
const cjk = {
grid: { enabled: true, charsPerLine: 36, linesPerPage: 18 }, // 版心: 36 字 × 18 行
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
#Imprime los comentarios a una tinta
Para imprimir a un solo color, compón las notas en negro entre corchetes y los comentarios del margen superior en la tinta apagada; los corchetes van al cuerpo del texto, antes de la primera fila de la nota y después de la última.
- warichu: { color: col('vermilion') },
+ warichu: { color: col('ink'), open: '〔', close: '〕' },
- body: { fontFamily: KAI, fontSize: pt(7), lineHeight: pt(10), color: col('vermilion'),
+ body: { fontFamily: KAI, fontSize: pt(7), lineHeight: pt(10), color: col('muted'),#Compárala con una edición en alfabeto latino
La misma técnica en una página horizontal es el clásico anotado con glosas al margen: allí la columna lateral va junto al corte exterior (sideColumnSide: 'outer') y cada glosa se coloca al lado del párrafo que explica, no encima.
Errores frecuentes
Error frecuente
Un recuadro lateral empieza a la altura del bloque que sigue a su valla
En postext 1.4.1, un recuadro con span: 'side' se coloca en la columna lateral a la altura a la que ha llegado el texto en su valla, en la siguiente línea de la rejilla y debajo de los recuadros que ya haya. Pon la valla de una glosa justo antes del párrafo que explica: si va después, la glosa empieza junto al párrafo siguiente. Un recuadro que pasaría del pie de la columna sube hasta que su pie coincide con el de la columna, si el recuadro de encima le deja sitio; si aun así no cabe, espera a la columna lateral de la página siguiente. Notas al margen →
Error frecuente
En texto vertical la columna lateral es un piso, y 'left' es el de arriba
Con layout.writingMode 'vertical-rl' la página es una página horizontal girada un cuarto de vuelta, así que la columna lateral de una disposición oneAndHalf pasa a ser un piso que cruza la página: sideColumnSide 'left' la pone arriba, donde van los comentarios del margen superior (眉批), y 'right' al pie. 'outer' e 'inner' se leen como 'right' y 'left' (un piso no tiene borde exterior), así que el 'outer' de la columna de notas de un libro de texto manda las notas al pie. sideColumnPercent es una fracción de la altura de la página. Columna al margen para flotantes →
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
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 →
- Un comentario del margen superior queda a la altura de la columna a la que ha llegado el texto en su línea de apertura, así que el bloque va justo antes del pasaje que discute; si va después, el comentario empieza junto al párrafo siguiente. Un recuadro va entre dos bloques, nunca dentro de un párrafo, así que cuando el manuscrito comenta una frase del interior de un párrafo largo, esta edición corta el párrafo en ese punto: antes de 石頭聽了, antes de 廟傍住着 y una vez dentro del discurso de la piedra, antes de 竟不如我, donde el párrafo nuevo vuelve a abrir con 「, como hace una cita que ocupa dos párrafos.
- En el piso cabe lo que cabe en su página. Un comentario que no cabe en lo que queda de él se desplaza hacia la derecha hasta que su última columna toca el borde izquierdo de la caja de texto, y si ni así cabe, espera a la página siguiente junto con todos los comentarios que van detrás. Cada comentario empieza además en una columna del texto y deja libre una columna del cuerpo tras el anterior. Los tres comentarios del manuscrito sobre el discurso de la piedra ocupan once columnas del piso: con el bloque antes de 今之人, donde los pone la transcripción, el último, 斯亦太過, pasaba a la página 5 y desplazaba un paso los comentarios de esa página. Esta edición corta el discurso una frase antes, delante de 竟不如我, y los tres quedan en la página 4.
- La retícula llena cada página con sus 18 columnas sin ningún ajuste: en una retícula de caracteres
avoidWidowsviene desactivado, así que un párrafo puede empezar en la última columna de una página. Activado, pasaría ese párrafo entero a la siguiente, la página se quedaría con una columna de menos y el comentario cuyo bloque va antes del párrafo se quedaría atrás.avoidOrphanssigue activo, como lo tiene por defecto una retícula china: la última columna de un párrafo sola en la cabeza de una página (孤行) es justo lo que un editor chino evita. - Dos comentarios laterales escritos uno detrás de otro se pliegan en filas que se leen como una sola nota. El Markdown deja entre ellos un espacio ideográfico (U+3000).
- Noto Serif TC no tiene glifo para algunas formas del manuscrito, como 縂, 竒 o 数. El canvas las toma de una fuente del sistema, y el PDF las deja en blanco y las anota en C25. Esta edición usa sus formas normalizadas y conserva las variantes que sí tienen las fuentes.
Créditos
- Receta
- Ignacio Ferro
- Texto
- 脂硯齋重評石頭記 (Historia de la piedra, con los comentarios de Zhiyan Zhai), manuscrito Jiaxu (1754), capítulo 1 desde el comienzo hasta la casa de los Zhen, con los comentarios; transcripción de Wikisource, revisión 2644544 · Cao Xueqin and Zhiyan Zhai; transcription by Wikisource editors · CC BY-SA 4.0
- La nota sobre esta edición (本編說明) y los cortes de párrafo añadidos para los comentarios del margen superior · Ignacio Ferro · CC BY 4.0
- Fuentes
- Noto Serif TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1) · Noto Sans 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)


