En poques paraules
Sis pàgines d'una novel·la clàssica xinesa, escrita en columnes que es llegeixen de dalt a baix. Les notes antigues d'un lector surten en vermell dins les línies i en una franja sobre el text.
Què compondràs
El començament del capítol 1 de la Història de la pedra en el manuscrit Jiaxu, la còpia que conserva els comentaris de Zhiyan Zhai, compost en sis pàgines d'una edició comentada en format 16开, de 184 × 260 mm, en vertical i enquadernada per la dreta. El text de Cao Xueqin va en Noto Serif TC, amb 36 caràcters per columna i 18 columnes per pàgina. El manuscrit escriu en vermell, al costat de les columnes, els 61 comentaris laterals (側批) d'aquest fragment. Postext no compon res entre dues columnes, així que aquesta edició els posa en línia, cadascun plegat en dues files de vermelló a la meitat del cos just després de les paraules que glossa, com les edicions comentades impreses componen els seus 雙行夾批. Els deu comentaris del marge superior (眉批) van en lletra Kai vermella, en un pis de 42 mm sobre el text i damunt del passatge que discuteixen, de manera que el lector segueix el text i el comentari d'una sola passada.
Aquesta recepta respon a
- Com componc una edició comentada, amb notes petites a dues línies dins de la línia i comentaris al marge superior?
- Com componc un llibre xinès en vertical, enquadernat per la dreta?
La resposta curta
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) },
};
Ingredients
- Funcions
- Warichu: notes a dues línies dins de la líniaNotes al margeText verticalLlibres enquadernats per la dretaColumna al marge per a flotantsColumna i mitjaRetícula de caràctersFonts xineses, japoneses i coreanesAmplada de la puntuació xinesaTall de línies en xinèsNumeració xinesaObertures dissenyadesAtributs de títolCapçaleres i folisRequadresEstils de paràgrafPaleta de color semànticaMarges simètrics
- També fa servir
- Filet de columnaSortir de la retícula a propòsitColor del paperCapçaleres segons el tipus de pàginaExportació a PDFFonts incrustades al PDFPreliminars en romans
- Tipografia
- Noto Serif TC, LXGW WenKai TC, Noto Sans TC (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Converteix la columna lateral en el marge superior
El codi és la resposta curta de dalt. Una pàgina vertical és una pàgina horitzontal girada un quart de volta, així que la columna lateral d'una disposició en columna i mitja es converteix en un pis que travessa la pàgina, i sideColumnSide: 'left' el col·loca a dalt (Escriptura vertical). La retícula de caràcters arrodoneix sideColumnPercent: 19 a 10 caràcters del cos, 120 pt, i l'espai entre columnes a dos; el filet de columna passa a ser la línia fina que separa els comentaris del text. L'estil dels comentaris no dibuixa caixa: Kai de 7 pt, 17 caràcters per columna, un cos amb què cap dels deu comentaris no acaba en una columna d'un sol caràcter, i snapToGrid: false, perquè els comentaris s'apilin amb el seu propi pas de 10 pt i no amb els 21 pt del cos.
Els dos tipus de comentari es marquen on els posa el manuscrit. Un comentari lateral és un :warichu[…], al qual cjk.warichu dona el color; un comentari del marge superior és un requadre amb span="side" que s'obre just abans del passatge que comenta:
:::callout{type="meipi" span="side"}
妙!自謂落墮情根,故無補天之用。
:::
原來女媧氏煉石補天之時,:warichu[補天濟世,勿認真,用常言。]于大荒山:warichu[荒唐也。]…#2 · Fes baixar el número del capítol i el seu dístic per les primeres columnes
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 l'obertura es compon en el marc del flux: el text hi baixa, below vol dir a l'esquerra i un desplaçament x fa baixar l'element per la columna. Primer va el títol del llibre en Hei vermella; després, 第一回 a 30 pt, dos dels seus propis caràcters més avall, i tot seguit les dues meitats del dístic, tretes dels atributs del títol {a="…" b="…"} i encara més baixes, de manera que el número i el dístic descendeixen en escala com en un 回目 imprès. minHeight: mm(46) deixa una columna lliure entre el dístic i el text.
#3 · Porta les capçaleres pel tall 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
] };
Són les capçaleres del tall exterior que descriuen els Elements de text verticals: anchor.to: 'outer' és el marge del costat contrari al llom, l'esquerre en una pàgina senar i el dret en una de parella quan el llibre s'enquaderna per la dreta, i writingMode: 'vertical-rl' compon el text de dalt a baix. Aquí la caixa inclou el pis dels comentaris, així que els «quatre caràcters per sota del cap» es compten des de la vora superior dels comentaris vermells. trad-chinese-informal imprimeix els folis del 一 al 六.
#4 · Carrega cada veu amb el text que compon
// 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 serveix cada font xinesa en un centenar de fitxers per gruix. La Song compon tota la mostra en el seu gruix normal i en negreta només 第一回; la Kai, només els comentaris del marge superior i la nota de l'edició, i la Hei, les capçaleres, els folis i el colofó, així que cada crida baixa només els fitxers dels seus propis caràcters. vertical: true carrega a més la puntuació vertical de cada font per al canvas.
#5 · Dues tintes
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 s'imprimeix a dos colors, com es va escriure el manuscrit: un negre càlid per al text i un vermelló per a cada comentari, l'avanttítol del capítol i res més. El vermelló té un contrast de 5,5 : 1 amb el paper, prou per a les files de 6 pt dels comentaris laterals. main-color hi apunta, així que qualsevol valor per defecte que la configuració no redefineixi surt en vermell, mai en blau.
La recepta 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 行
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
#Imprimeix els comentaris a una tinta
Per imprimir a un sol color, compon les notes en negre entre claudàtors i els comentaris del marge superior en la tinta apagada; els claudàtors van al cos del text, abans de la primera fila de la nota i després de l'ú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'),#Compara-la amb una edició en alfabet llatí
La mateixa tècnica en una pàgina horitzontal és el clàssic anotat amb glosses al marge: allà la columna lateral va al costat del tall exterior (sideColumnSide: 'outer') i cada glossa es col·loca al costat del paràgraf que explica, no a sobre.
Errors freqüents
Error freqüent
Un requadre lateral comença a l'altura del bloc que segueix la seva tanca
A postext 1.4.1, un requadre amb span: 'side' es col·loca a la columna lateral a l'altura on ha arribat el text a la seva tanca, a la línia següent de la retícula i sota els requadres que ja hi hagi. Posa la tanca d'una glossa just abans del paràgraf que explica: si va després, la glossa comença al costat del paràgraf següent. Un requadre que passaria del peu de la columna puja fins que el seu peu coincideix amb el de la columna, si el requadre de sobre li deixa lloc; si tot i així no hi cap, espera la columna lateral de la pàgina següent. Notes al marge →
Error freqüent
En text vertical la columna lateral és un pis, i 'left' és el de dalt
Amb layout.writingMode 'vertical-rl' la pàgina és una pàgina horitzontal girada un quart de volta, de manera que la columna lateral d'una disposició oneAndHalf passa a ser un pis que travessa la pàgina: sideColumnSide 'left' la posa a dalt, on van els comentaris del marge superior (眉批), i 'right' al peu. 'outer' i 'inner' es llegeixen com a 'right' i 'left' (un pis no té vora exterior), de manera que el valor 'outer' de la columna de notes d'un llibre de text envia les notes al peu. sideColumnPercent és una fracció de l'alçada de la pàgina. Columna al marge per a flotants →
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
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 →
- Un comentari del marge superior queda a l'altura de la columna on ha arribat el text quan s'obre, així que la línia d'obertura va just abans del passatge que discuteix; si va després, el comentari comença al costat del paràgraf següent. Un requadre s'obre entre dos blocs, mai dins d'un paràgraf, així que quan el manuscrit comenta una frase de l'interior d'un paràgraf llarg, aquesta edició talla el paràgraf en aquell punt: abans de 石頭聽了, abans de 廟傍住着 i una vegada dins del discurs de la pedra, abans de 竟不如我, on el paràgraf nou torna a obrir amb 「, com fa una cita que ocupa dos paràgrafs.
- Al pis hi cap el que cap a la seva pàgina. Un comentari que no cap en el que en queda es desplaça cap a la dreta fins que la seva última columna toca la vora esquerra de la caixa, i si tot i així no hi cap, espera a la pàgina següent juntament amb tots els comentaris que van darrere. Cada comentari comença a més en una columna del text i deixa lliure una columna del cos després de l'anterior. Els tres comentaris del manuscrit sobre el discurs de la pedra ocupen onze columnes del pis: amb la línia d'obertura abans de 今之人, on els posa la transcripció, l'últim, 斯亦太過, passava a la pàgina 5 i desplaçava un pas els comentaris d'aquella pàgina. Aquesta edició talla el discurs una frase abans, davant de 竟不如我, i els tres queden a la pàgina 4.
- La retícula omple cada pàgina amb les seves 18 columnes sense cap ajust: en una retícula de caràcters
avoidWidowsve desactivat, així que un paràgraf pot començar a l'última columna d'una pàgina. Activat, passaria aquell paràgraf sencer a la següent, la pàgina es quedaria amb una columna de menys i el comentari que s'obre abans del paràgraf es quedaria enrere.avoidOrphanscontinua actiu, com el té per defecte una retícula xinesa: l'última columna d'un paràgraf sola al cap d'una pàgina (孤行) és justament el que un editor xinès evita. - Dos comentaris laterals escrits l'un darrere l'altre es pleguen en files que es llegeixen com una sola nota. El Markdown deixa entre ells un espai ideogràfic (U+3000).
- Noto Serif TC no té glif per a algunes formes del manuscrit, com 縂, 竒 o 数. El canvas les pren d'una font del sistema, i el PDF les deixa en blanc i les anota a C25. Aquesta edició fa servir les seves formes normalitzades i conserva les variants que sí que tenen les fonts.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- 脂硯齋重評石頭記 (The Story of the Stone, re-annotated by Zhiyan Zhai), Jiaxu manuscript (1754), chapter 1 from its opening to the Zhen household, with the commentary; Wikisource transcription, revision 2644544 · Cao Xueqin and Zhiyan Zhai; transcription by Wikisource editors · CC BY-SA 4.0
- The note on this edition (本編說明) and the paragraph breaks added for the head-margin comments · Ignacio Ferro · CC BY 4.0
- Fonts
- Noto Serif TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1) · Noto Sans 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)


