En poques paraules
Un llibret de poemes xinesos de la dinastia Tang amb una traducció anglesa antiga a la pàgina del davant. Cada filera de versos xinesos queda a l'altura dels versos anglesos que la tradueixen.
Què compondràs
Un petit llibre bilingüe de poemes Tang, compost com les edicions bilingües dels clàssics: el xinès a la pàgina senar, sobre un full tenyit com paper vell, i els versos rimats d'Herbert A. Giles, de 1901, a la parella del davant. Quatre poemes de Li Bai, Du Fu i Wang Wei ocupen una doble pàgina cadascun, amb títol en cada llengua i el nom del poeta. El xinès va en LXGW WenKai, una Kai dibuixada a partir del pinzell, a dos versos per renglera, de manera que cada renglera queda a l'altura dels dos versos anglesos que la tradueixen. Al peu de la pàgina xinesa van les notes, en la llengua del lector. Traducció encarada, estrofa a estrofa posa un poema espanyol al costat de la seva versió anglesa en una sola pàgina; aquí cada llengua té la seva pàgina.
Aquesta recepta respon a
- Com componc un poema i la seva traducció en pàgines enfrontades, amb l'original sempre a la senar?
- Com componc poesia: un vers per línia, espai entre estrofes, sagnat francès als versos que no hi caben i sense partició de mots?
- Com faig notes a peu de pàgina?
- Com forço un salt de pàgina o de columna, i faig que cada capítol comenci en pàgina senar?
La resposta curta
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' } } }]) };
Ingredients
- Funcions
- Capítols que obren en pàgina senarEstils de títolNotes a peu de pàginaVers línia a líniaEstils de paràgrafRetícula de caràctersFonts xineses, japoneses i coreanesTall de línies en xinèsObertures dissenyadesAtributs de títolTextos, filets i caixes als dissenys de pàginaCobertes, portades i colofonsCapçaleres i folisCapçaleres per seccióMarges simètricsColor del paperPaleta de color semànticaEspai vertical explícitExportació a PDFFonts incrustades al PDF
- També fa servir
- Capçaleres segons el tipus de pàgina
- Tipografia
- Noto Serif TC, LXGW WenKai TC, Noto Sans TC, Source Serif 4, Source Sans 3 (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Un estil d'encapçalament per a cada costat del plec
El codi és a la resposta curta, més amunt. Cada poema són dos títols de nivell 1: # Night Thoughts {style="en" …} amb els versos de Giles i després # 靜夜思 {style="zh" …} amb el poema. L'estil en salta a la pàgina parella següent; el zh, a la senar següent, la que queda al davant. Mentre cada poema càpiga a la seva pàgina no hi entra cap pàgina en blanc; una versió anglesa que passés de pàgina empenyeria el seu original a la senar següent, darrere d'una parella en blanc (Salt de pàgina previ). Els dos dissenys reserven sis línies de la retícula, així que l'anglès i el xinès comencen a la mateixa línia. L'estil xinès porta span: 'page' perquè el seu primer element, una caixa de la mida de la pàgina, és el full tenyit, i un disseny que es queda a la columna es talla al peu de la columna (Extensió i disseny avançat).

#2 · Una renglera xinesa per cada dos versos anglesos
// 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) };
Les rengleres xineses tenen el doble d'interlineat que els versos anglesos, 32 pt contra 16, i així una renglera de dos versos de cinc caràcters queda davant de l'apariat que Giles en treu. Al poema de la lluna de les pàgines 4 i 5 una línia en blanc entre les estrofes angleses i un :::space{lines=1} entre les xineses deixen una línia cadascun, i les seves tres estrofes continuen a la mateixa altura en tota la doble pàgina. La renglera xinesa entra 51 pt, cosa que centra els seus dotze quadratins en els 28 de la retícula, i cada crida de nota va després del 。 de la seva renglera, fora dels dotze: dins de la renglera empenyeria sis dècimes de quadratí a la dreta tots els caràcters que la segueixen, que deixarien de caure sobre els de la renglera de sota. Cada poema anglès és un bloc :::verse, centrat sobre el seu vers més llarg, així que no cal mesurar cap sagnat. Giles sagna un vers de cada dos; el Markdown conserva els seus dos espais, que bodyText.verse.indentStep converteix en dos quadratins de sagnat.
#3 · Notes a peu de la pàgina xinesa
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
Les notes són notes a peu de pàgina, una per renglera: 疑是地上霜。[^bed] tanca la primera renglera del poema i [^bed]: … va després, amb les paraules que glossa en negreta, perquè la crida ja no és al seu costat. Es numeren com numera les notes un llibre xinès (页下注): números en cercle sobre la línia de base, comptats de nou des de ① a cada pàgina (numberFormat: 'circled-decimal', numbering: 'page'). Al vers la crida es compon a sis dècimes de la mida del poema, markerSize: em(0.6), a prop de la mida de les notes; al peu de la pàgina cada nota comença amb el seu ① a la mida del text de la nota (Notes a peu de pàgina). Les notes es componen amb la font del cos, i la d'aquest llibre és Noto Serif TC perquè una nota barreja caràcters i pinyin; les lletres llatines de Noto Serif TC són les de Source Serif, i per això les pàgines angleses van en Source Serif 4. Les notes s'escriuen en la llengua de l'edició: amb la capçalera de la pàgina parella i la nota sobre el text, són el que canvia a l'edició espanyola.
#4 · Capçaleres en la llengua 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') }),
] };
Totes les pàgines d'aquest llibre comencen amb un títol, així que totes són obertures, i les capçaleres porten pages: 'opener'. Una pàgina en blanc que afegís un salt quedaria neta, i la portada les treu amb una capçalera buida pròpia. La pàgina parella pren el títol del llibre del subtitle del frontmatter, que cada edició escriu en la seva llengua; la senar pren el nom del poeta de l'atribut name del títol xinès (Capçaleres i peus).
#5 · Una portada sobre una lluna
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 també és un estil d'encapçalament, amb runningChapter: false perquè no anomeni cap capítol. La lluna és una caixa de disseny amb un radi de cantonada de la meitat del costat, i 唐詩 es centra al damunt amb un càlcul: el centre de la lluna menys la meitat de l'alçada del títol. El segell compon 明月 amb writingMode: 'vertical-rl', un caràcter sobre l'altre, com es graven els segells.
#6 · Cada font xinesa carrega el que compon
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 parteix cada font xinesa en uns cent fitxers per rangs de caràcters, i loadCjkFonts baixa només els que necessita el seu text (Fonts xineses, japoneses i coreanes). La Kai rep els poemes i el segell; la Hei, els noms dels poetes; la Song en negreta, els quatre títols i les paraules glossades de les notes, i el seu gruix més negre, els dos caràcters de la portada.
La recepta 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'),
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
#Posa l'original a la pàgina parella
Les edicions Loeb i molts llibres bilingües de xinès i anglès posen l'original a l'esquerra: intercanvia les paritats dels dos estils d'encapçalament i de les dues capçaleres que anomenen el llibre i el poeta, i escriu al Markdown cada títol i poema xinesos abans que la seva versió anglesa.
-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,#Posa les notes just a sota del poema
Les antologies xineses anotades (注釋本) imprimeixen les notes després de cada poema. Les notes de final de capítol ho fan aquí, perquè cada poema és un capítol.
-const footnotes = { placement: 'column', numbering: 'page', // the page foot; ① again on each page
+const footnotes = { placement: 'chapterEnd', chapterEndAlign: 'text',Errors freqüents
Error freqüent
Un estil de títol hereta el salt de pàgina del seu nivell
Una entrada de headingStyles pren del seu nivell de títol tot allò que no fixa, també breakBefore. Un índex o un colofó amb estil sobre un H1 després d'un :::pagebreak hereta la paritat 'odd' i cau darrere d'una pàgina en blanc. Dona a aquest estil breakBefore: { enabled: false }. Estils de títol →
Error freqüent
La pàgina 1 és senar: planifica amb números físics
La pàgina 1 queda a la dreta i la 2 és la primera pàgina parella, així que planifica els plecs amb números de pàgina físics: una obertura en pàgina parella queda davant de la senar que la segueix. Salts de pàgina i de columna →
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 →
Error freqüent
Una font xinesa compon cometes i apòstrofs d'amplada completa, també en text llatí
Noto Serif TC i les altres fonts de xinès tradicional dibuixen ‘ ’ “ ” amb un quadratí d'amplada, com les fa servir el text xinès, i aquest és el signe que rep una paraula llatina composta amb la font: Li Bai’s surt amb un buit ample després de l'apòstrof i una cita anglesa obre i tanca amb un quadratí en blanc. Una font xinesa tampoc no té cursiva, i la inclinació simulada a la pantalla surt recta al PDF. El text que barreja xinès i una llengua llatina en una sola font (les notes a peu de pàgina, que fan servir la font del cos, o les glosses amb pinyin) es llegeix millor sense apòstrofs, cometes angleses ni cursives; « » i els signes de Latin-1 conserven la seva amplada. Quan el text llatí va a part, dona-li una font llatina amb un estil de paràgraf. Fonts xineses, japoneses i coreanes →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Three Tang poems in traditional characters, Li Bai’s 靜夜思 and 月下獨酌 and Wang Wei’s 竹里館, as Three Hundred Tang Poems (1763) gives them · Li Bai, Wang Wei · domini públic
- Du Fu’s 絕句, the second of his 絕句二首, as the Complete Tang Poems (1705, juan 228) prints it · Du Fu · domini públic
- The English verse translations, from A History of Chinese Literature (1901), Project Gutenberg eBook 43711 · Herbert A. Giles · domini públic
- The notes, the English titles, the note on the text and the colophon · Postext Cookbook · original
- Fonts
- 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)
- 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)


