En pocas palabras
Un librito de poemas chinos de la dinastía Tang con una traducción inglesa antigua en la página de enfrente. Cada fila de versos chinos queda a la altura de los versos ingleses que la traducen.
Lo que vas a componer
Un pequeño libro bilingüe de poemas Tang, compuesto como las ediciones bilingües de los clásicos: el chino en la página impar, sobre una hoja teñida como papel viejo, y los versos rimados de Herbert A. Giles, de 1901, en la par de enfrente. Cuatro poemas de Li Bai, Du Fu y Wang Wei ocupan una doble página cada uno, con título en cada lengua y el nombre del poeta. El chino va en LXGW WenKai, una Kai dibujada a partir del pincel, a dos versos por renglón, de modo que cada renglón queda a la altura de los dos versos ingleses que lo traducen. Al pie de la página china van las notas, en la lengua del lector. Traducción enfrentada, estrofa a estrofa pone un poema español junto a su versión inglesa en una sola página; aquí cada lengua tiene su página.
Esta receta responde a
- ¿Cómo compongo un poema y su traducción en páginas enfrentadas, con el original siempre en la impar?
- ¿Cómo compongo poesía: un verso por línea, espacio entre estrofas, sangría francesa en los versos que no caben y sin separación silábica?
- ¿Cómo hago notas al pie?
- ¿Cómo fuerzo un salto de página o de columna, y hago que cada capítulo empiece en página impar?
La respuesta corta
const SINK = 6; // lines of LEAD under both titles, so the two poems start on the same line
const at = (y) => ({ anchor: { to: 'container', edge: 'top' }, offset: { y: mm(y) } });
// A title whose foot is 23 mm down at any size, and the poet's line under it at 24 mm.
const titled = (size, title, poet, under = []) => ({
enabled: true, minHeight: pt(SINK * LEAD),
slot: { elements: [...under,
{ kind: 'text', id: 'title', content: '{titleText}', fontSize: pt(size), lineHeight: 1.2,
align: 'center', overflow: 'wrap', color: col('ink'),
placement: at(23 - (size * 1.2 * 25.4) / 72), ...title },
{ kind: 'text', id: 'poet', align: 'center', overflow: 'wrap', color: col('seal'),
placement: at(24), ...poet },
] },
});
// Each style breaks to its own side of the spread (gotcha: style-inherits-break).
const english = { id: 'en', breakBefore: { enabled: true, parity: 'even' }, // a verso
advancedDesign: titled(19, { fontFamily: ROMAN, italic: true },
{ content: '{attr.kicker}', fontFamily: LABEL, fontSize: pt(7.5), fontWeight: 600,
letterSpacing: pt(1.5), textTransform: 'uppercase' }) };
// The original on a tinted leaf: span 'page' lets the tint reach past the text column.
const chinese = { id: 'zh', span: 'page', breakBefore: { enabled: true, parity: 'odd' },
advancedDesign: titled(28, { fontFamily: SERIF, fontWeight: 700, letterSpacing: pt(7) },
{ content: '{attr.poet}', fontFamily: HEI, fontSize: pt(9), letterSpacing: pt(1.5) },
[{ kind: 'box', id: 'leaf', reserve: false, style: { backgroundColor: col('leaf') },
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: 'fill', height: 'fill' } } }]) };
Ingredientes
- Funciones
- Capítulos que abren en página imparEstilos de títuloNotas al pieVerso línea a líneaEstilos de párrafoRetícula de caracteresFuentes chinas, japonesas y coreanasCorte de líneas en chinoAperturas diseñadasAtributos de títuloTextos, filetes y cajas en los diseños de páginaCubiertas, portadas y colofonesCabeceras y foliosCabeceras por secciónMárgenes simétricosColor del papelPaleta de color semánticaEspacio vertical explícitoExportación a PDFFuentes incrustadas en el PDF
- También usa
- Cabeceras según el tipo de página
- Tipografía
- Noto Serif TC, LXGW WenKai TC, Noto Sans TC, Source Serif 4, Source Sans 3 (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Un estilo de título para cada lado del pliego
El código está en la respuesta corta, más arriba. Cada poema son dos encabezados de nivel 1: # Night Thoughts {style="en" …} con los versos de Giles y después # 靜夜思 {style="zh" …} con el poema. El estilo en salta a la siguiente página par; el zh, a la siguiente impar, la que queda enfrente. Mientras cada poema quepa en su página no entra ninguna página en blanco; una versión inglesa que se pasara de página empujaría su original a la impar siguiente, detrás de una par en blanco (Salto de página antes del encabezado). Los dos diseños reservan seis líneas de la retícula, así que el inglés y el chino empiezan en la misma línea. El estilo chino lleva span: 'page' porque su primer elemento, una caja del tamaño de la página, es la hoja teñida, y un diseño que se queda en la columna se corta al pie de la columna (Apertura a toda página y diseño avanzado).

#2 · Un renglón chino por cada dos versos ingleses
// Each English poem is a :::verse block: a line of verse a line of Markdown, Giles's indents
// as two leading spaces (two ems: bodyText.verse.indentStep), a blank line between stanzas.
// The block is centred on its longest line in the 103.7 mm measure, so a short poem and a
// long one both sit in the middle.
const verse = { id: 'verse', fontFamily: ROMAN, fontSize: pt(BODY), lineHeight: pt(LEAD) };
const shi = { id: 'shi', fontFamily: KAI, fontSize: pt(SHI), lineHeight: pt(2 * LEAD),
textAlign: 'left', firstLineIndent: pt(0), // two lines of verse to a row: 2 × LEAD
// Five characters and a full-width mark, twice: 12 ems, centred in the 28 of the grid.
// A fixed left edge, and the note numbers after each row's 。: every character keeps its column.
indent: pt((CHARS * BODY - 12 * SHI) / 2) };
Los renglones chinos tienen el doble de interlineado que los versos ingleses, 32 pt frente a 16, y así un renglón de dos versos de cinco caracteres queda frente al pareado que Giles saca de él. En el poema de la luna de las páginas 4 y 5 una línea en blanco entre las estrofas inglesas y un :::space{lines=1} entre las chinas dejan una línea cada uno, y sus tres estrofas siguen a la misma altura en toda la doble página. El renglón chino entra 51 pt, lo que centra sus doce cuadratines en los 28 de la retícula, y cada llamada de nota va tras el 。 de su renglón, fuera de los doce: dentro del renglón empujaría seis décimas de cuadratín a la derecha todos los caracteres que la siguen, que dejarían de caer sobre los del renglón de abajo. Cada poema inglés es un bloque :::verse, centrado sobre su verso más largo, así que no hay que medir ninguna sangría. Giles sangra un verso de cada dos; el Markdown conserva sus dos espacios, que bodyText.verse.indentStep convierte en dos cuadratines de sangría.
#3 · Notas al pie de la página china
const footnotes = { placement: 'column', numbering: 'page', // the page foot; ① again on each page
numberFormat: 'circled-decimal', markerSize: em(0.6), fontSize: pt(8), lineHeight: pt(11),
color: col('ink'), textAlign: 'left', spaceAbove: pt(LEAD), spaceBelowRule: pt(5),
spaceBetween: pt(3), separator: { width: 0.12, lineWidth: pt(0.6), color: col('seal') },
wordBreak: 'keep-all' }; // a reading a note quotes (山月, 看月光) is never broken
Las notas son notas al pie, una por renglón: 疑是地上霜。[^bed] cierra el primer renglón del poema y [^bed]: … va tras él, con las palabras que glosa en negrita, porque la llamada ya no está a su lado. Se numeran como numera sus notas un libro chino (页下注): números en círculo sobre la línea de base, contados de nuevo desde ① en cada página (numberFormat: 'circled-decimal', numbering: 'page'). En el verso la llamada se compone a seis décimas del tamaño del poema, markerSize: em(0.6), cerca del tamaño de las notas; al pie de la página cada nota empieza con su ① al tamaño del texto de la nota (Notas al pie). Las notas se componen con la fuente del texto base, y la de este libro es Noto Serif TC porque una nota mezcla caracteres y pinyin; las letras latinas de Noto Serif TC son las de Source Serif, y por eso las páginas inglesas van en Source Serif 4. Las notas se escriben en la lengua de la edición: con la cabecera de la página par y la nota sobre el texto, son lo que cambia en la edición española.
#4 · Cabeceras en la lengua de cada página
const head = (id, content, parity, edge, x, style) => ({ kind: 'text', id, content, parity,
pages: 'opener', // every poem page opens with its title; a blank page stays bare
fontFamily: LABEL, fontSize: pt(7.5), fontWeight: 600, color: col('muted'),
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(12) } }, ...style });
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', EDGE, { color: col('ink') }),
head('verso-book', '{subtitle}', 'even', 'top-left', EDGE + 8,
{ letterSpacing: pt(1.2), textTransform: 'uppercase' }),
head('recto-poet', '{attr.name}', 'odd', 'top-right', -(EDGE + 8),
{ fontFamily: HEI, fontWeight: 400, fontSize: pt(8), letterSpacing: pt(3) }),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -EDGE, { color: col('ink') }),
] };
Todas las páginas de este libro empiezan con un título, así que todas son aperturas, y las cabeceras llevan pages: 'opener'. Una página en blanco que añadiera un salto quedaría limpia, y la portada las quita con una cabecera vacía propia. La página par toma el título del libro del subtitle del frontmatter, que cada edición escribe en su lengua; la impar toma el nombre del poeta del atributo name del título chino (Cabeceras y pies).
#5 · Una portada sobre una luna
const onPage = (y, size) => ({ anchor: { to: 'page', edge: 'top' }, offset: { y: mm(y) },
...(size ? { size: { width: mm(size), height: mm(size) } } : {}) });
const [MOON_Y, MOON, HAN] = [36, 78, 60]; // mm: the moon's top and width; pt: the title
const UNDER = MOON_Y + MOON; // mm: the English lines start under the moon
const line = (id, content, y, style) => ({ kind: 'text', id, content, align: 'center',
overflow: 'wrap', color: col('ink'), placement: onPage(y), ...style });
const titlePage = { id: 'title', span: 'page', runningChapter: false,
header: { elements: [] }, footer: { elements: [] },
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'box', id: 'moon', placement: onPage(MOON_Y, MOON),
style: { backgroundColor: col('moon'), borderRadius: mm(MOON / 2) } },
line('han', '{titleText}', MOON_Y + MOON / 2 - (HAN * 25.4) / 144, { fontFamily: SERIF,
fontWeight: 900, fontSize: pt(HAN), letterSpacing: pt(HAN / 4), lineHeight: 1 }),
line('en', '{attr.en}', UNDER + 10, { fontFamily: LABEL, fontSize: pt(10), fontWeight: 600,
letterSpacing: pt(3), textTransform: 'uppercase', color: col('seal') }),
line('poets', '{attr.poets}', UNDER + 19, { fontFamily: ROMAN, fontSize: pt(12) }),
line('giles', '{attr.english}', UNDER + 26, { fontFamily: ROMAN, fontSize: pt(11),
italic: true }),
// A seal reading 明月, the bright moon of three of the four poems, set down its square.
{ kind: 'box', id: 'seal', placement: onPage(170, 13),
style: { backgroundColor: col('seal'), borderRadius: mm(1) } },
line('seal-text', '明月', 170, { placement: onPage(170, 13), writingMode: 'vertical-rl',
fontFamily: KAI, fontSize: pt(14), lineHeight: 1, color: col('paper'),
verticalAlign: 'middle' }),
] } },
};
La portada también es un estilo de encabezado, con runningChapter: false para que no nombre ningún capítulo. La luna es una caja de diseño cuyo radio de esquina mide la mitad de su lado, y 唐詩 se centra sobre ella con una cuenta: el centro de la luna menos la mitad de la altura del título. El sello compone 明月 con writingMode: 'vertical-rl', un carácter sobre el otro, como se tallan los sellos.
#6 · Cada fuente china carga lo que compone
const grab = (re) => (markdown.match(re) ?? []).join('');
// Each poem to its closing `:::` (not the `:::space` between stanzas), then the note numbers.
const poems = grab(/:::paragraphs\{style="shi"\}[\s\S]*?\n:::(?=\n|$)/g) + '①②③④⑤⑥⑦⑧⑨⑩';
await loadFonts(FONTS, markdown);
await Promise.all([
loadCjkFonts({ [SERIF]: ['400'] }, markdown + poems), // the notes and their ①, the heading blocks
loadCjkFonts({ [SERIF]: ['700'] }, grab(/^# \S+(?= \{style="zh")|\*\*[^*]+\*\*/gm)),
loadCjkFonts({ [SERIF]: ['900'] }, grab(/^# \S+(?= \{style="title")/gm)),
loadCjkFonts({ [KAI]: ['400'] }, `${poems}明月`),
loadCjkFonts({ [HEI]: ['400'] }, grab(/(?<=(?:poet|name)=")[^"]*/g)),
]);
Fontsource parte cada fuente china en unos cien archivos por rangos de caracteres, y loadCjkFonts descarga solo los que necesita su texto (Fuentes chinas, japonesas y coreanas). La Kai recibe los poemas y el sello; la Hei, los nombres de los poetas; la Song en negrita, los cuatro títulos y las palabras glosadas de las notas, y su peso más negro, los dos caracteres de la portada.
La receta completa
// ═══ Postext Cookbook · Nº 083 · Tang poems facing their English verse ═══════════════
// https://postext.dev/en/cookbook/tang-poems-facing-english
// Code: MIT · Text: Tang poems, zh.wikisource; H. A. Giles, 1901, Project Gutenberg (PD)
// Fonts: Noto Serif TC, LXGW WenKai TC, Noto Sans TC, Source Serif 4 (OFL) · 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 = 'tang-poems-facing-english';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// Ink and seal red on a cream paper, and a pale moon for the title page.
const palette = {
ink: '#1f1b18', // text: a warm near-black
seal: '#ad3526', // the accent: vermilion seal paste, for the poets, the rules and the seal
moon: '#eadcb4', // the title page's moon
leaf: '#f2e8cf', // the recto's tint, under the Chinese
muted: '#6d655c', // running heads and the colophon
paper: '#faf6ed', // a cream paper
};
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: 'seal (defaults)', value: { hex: palette.seal, model: 'hex' } },
];
const SERIF = 'Noto Serif TC'; // 明: the Chinese titles and the notes
const KAI = 'LXGW WenKai TC'; // 楷: the poems
const HEI = 'Noto Sans TC'; // 黑: the poet lines and the recto's running head
const ROMAN = 'Source Serif 4'; // the English: the Latin that Noto Serif TC is built on
const LABEL = 'Source Sans 3'; // English labels and folios
const [BODY, LEAD, SHI] = [10.5, 16, 16]; // pt: 五号 on a 16 pt pitch; the poems' size
const [CHARS, LINES] = [28, 30]; // the character grid: 28 ems by 30 lines
const TRIM = { width: 148, height: 210 }; // mm: 25開, a Taiwan trade trim
const [INNER, OUTER] = [18, 21]; // mm: minimum sides; the grid centres its measure between them
const MEASURE = (CHARS * BODY * 25.4) / 72; // 103.7 mm: 28 ems of 五号
const EDGE = OUTER + (TRIM.width - INNER - OUTER - MEASURE) / 2; // 23.6 mm: the outer text edge
// #region answer: the English opens the next verso, the Chinese the recto that faces it
const SINK = 6; // lines of LEAD under both titles, so the two poems start on the same line
const at = (y) => ({ anchor: { to: 'container', edge: 'top' }, offset: { y: mm(y) } });
// A title whose foot is 23 mm down at any size, and the poet's line under it at 24 mm.
const titled = (size, title, poet, under = []) => ({
enabled: true, minHeight: pt(SINK * LEAD),
slot: { elements: [...under,
{ kind: 'text', id: 'title', content: '{titleText}', fontSize: pt(size), lineHeight: 1.2,
align: 'center', overflow: 'wrap', color: col('ink'),
placement: at(23 - (size * 1.2 * 25.4) / 72), ...title },
{ kind: 'text', id: 'poet', align: 'center', overflow: 'wrap', color: col('seal'),
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
#Pon el original en la página par
Las ediciones Loeb y muchos libros bilingües de chino e inglés ponen el original a la izquierda: intercambia las paridades de los dos estilos de encabezado y de las dos cabeceras que muestran el libro y el poeta, y escribe en el Markdown cada título y poema chinos antes que su versión inglesa.
-const english = { id: 'en', breakBefore: { enabled: true, parity: 'even' }, // a verso
+const english = { id: 'en', breakBefore: { enabled: true, parity: 'odd' }, // a recto
-const chinese = { id: 'zh', span: 'page', breakBefore: { enabled: true, parity: 'odd' },
+const chinese = { id: 'zh', span: 'page', breakBefore: { enabled: true, parity: 'even' },
- head('verso-book', '{subtitle}', 'even', 'top-left', EDGE + 8,
+ head('verso-book', '{subtitle}', 'odd', 'top-right', -(EDGE + 8),
- head('recto-poet', '{attr.name}', 'odd', 'top-right', -(EDGE + 8),
+ head('recto-poet', '{attr.name}', 'even', 'top-left', EDGE + 8,#Pon las notas justo debajo del poema
Las antologías chinas anotadas (注釋本) imprimen las notas tras cada poema. Las notas de fin de capítulo lo hacen aquí, porque cada poema es un capítulo.
-const footnotes = { placement: 'column', numbering: 'page', // the page foot; ① again on each page
+const footnotes = { placement: 'chapterEnd', chapterEndAlign: 'text',Errores frecuentes
Error frecuente
Un estilo de título hereda el salto de página de su nivel
Una entrada de headingStyles toma de su nivel de título todo lo que no fija, también breakBefore. Un índice o un colofón con estilo sobre un H1 tras un :::pagebreak hereda la paridad 'odd' y cae detrás de una página en blanco. Dale a ese estilo breakBefore: { enabled: false }. Estilos de título →
Error frecuente
La página 1 es impar: planifica con números físicos
La página 1 queda a la derecha y la 2 es la primera página par, así que planifica los pliegos con números de página físicos: una apertura en página par queda frente a la impar que la sigue. Saltos de página y de columna →
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
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
Una fuente china compone comillas y apóstrofos a ancho completo, también en texto latino
Noto Serif TC y las demás fuentes de chino tradicional dibujan ‘ ’ “ ” con un cuadratín de ancho, como las usa el texto chino, y ese es el signo que recibe una palabra latina compuesta con la fuente: Li Bai’s sale con un hueco ancho tras el apóstrofo y una cita inglesa abre y cierra con un cuadratín en blanco. Una fuente china tampoco tiene cursiva, y la inclinación simulada en pantalla sale recta en el PDF. El texto que mezcla chino y una lengua latina en una sola fuente (las notas al pie, que usan la fuente del cuerpo, o las glosas con pinyin) se lee mejor sin apóstrofos, comillas inglesas ni cursivas; « » y los signos de Latin-1 conservan su ancho. Cuando el texto latino va aparte, dale una fuente latina con un estilo de párrafo. Fuentes chinas, japonesas y coreanas →
Créditos
- Receta
- Ignacio Ferro
- Texto
- Tres poemas Tang en caracteres tradicionales, 靜夜思 y 月下獨酌 de Li Bai y 竹里館 de Wang Wei, como los dan los Trescientos poemas Tang (1763) · Li Bai, Wang Wei · dominio público
- El 絕句 de Du Fu, el segundo de sus 絕句二首, como lo imprime el Quan Tang shi, la poesía completa de los Tang (1705, juan 228) · Du Fu · dominio público
- Las traducciones inglesas en verso, de A History of Chinese Literature (1901), libro electrónico 43711 del Proyecto Gutenberg · Herbert A. Giles · dominio público
- Las notas, los títulos ingleses, la nota sobre el texto y el colofón · Postext Cookbook · original
- Fuentes
- Noto Serif TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (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)


