En poques paraules
Pàgines de mostra d'un clàssic de la història xinesa. Ensenya a marcar en vermell els noms amb una línia recta i els títols de llibres amb una d'ondulada, en text vertical i horitzontal.
Què compondràs
Tres pàgines de mostra per a una antologia de les Memòries històriques, en el format de 140 × 203 mm d'un llibre xinès 大32開. El passatge és el començament dels Annals bàsics de Xiang Yu amb la puntuació completa d'una edició de clàssics: una línia recta al costat de cada persona, lloc, estat i dinastia, i una línia ondulada al costat de cada títol de llibre o de capítol, totes dues en vermelló. La pàgina 1 porta la presentació i les normes de l'edició en lletra Kai. Les pàgines 2 i 3 componen dues vegades el mateix Markdown, en vertical i en horitzontal, i la doble pàgina mostra on va cada marca: a l'esquerra del nom a les línies verticals, a sota a les horitzontals. El llibre s'enquaderna per la dreta i una banda anyil porta cada títol. La recepta Núm. 044, Lycidas en el text de 1645, distingeix els noms a la manera europea, en cursiva.
Aquesta recepta respon a
- Com marco els noms propis i els títols d'un text xinès amb una línia recta i una d'ondulada?
- Per què l'èmfasi del meu text xinès surt inclinat i què he de fer servir en el seu lloc?
- Com componc un llibre xinès en vertical, enquadernat per la dreta?
La resposta curta
// :name[項梁] draws the proper-name line, :book[史記] the book-title mark, :dots[…] dots.
const cjk = {
bookTitleMark: 'wavy', // zh-Hant's default; mainland editions of the classics use it too
annotationColor: col('mark'), // unset, the marks print in the colour of the text
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
};
// The book runs down the page, bound on the right: the lines stand left of the names.
const layout = { layoutType: 'single', writingMode: 'vertical-rl' };
// # 項羽本紀 {style="across"} sets the same Markdown across the page, 28 characters to
// the line: the lines run under the names. Its margins set its grid; the book's grid
// counts down the page.
const MEASURE = 28 * SIZE * PT; // mm
const across = {
id: 'across',
layout: { layoutType: 'single', writingMode: 'horizontal-tb' },
margins: { top: mm(SIDE), bottom: mm(H - SIDE - 25 * LEAD * PT), // 25 lines
left: mm((W - MEASURE) / 2), right: mm((W - MEASURE) / 2) },
};
Ingredients
- Funcions
- Punts d'èmfasi i línies de nom i de títolText verticalLlibres enquadernats per la dretaAmplada de la puntuació xinesaTall de línies en xinèsRetícula de caràctersFonts xineses, japoneses i coreanesFonts incrustades al PDFExportació a PDFNumeració xinesaEstils de títolGeometria per seccióObertures dissenyadesBanda de capítol d'amplada completaAtributs de títolLlistes numeradesSagnats, alineació i separació de paràgrafsEstils de paràgrafPaleta de color semàntica
- També fa servir
- Preliminars en romansEspai vertical explícit
- Tipografia
- Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · El marcatge posa les marques; la direcció d'escriptura, el seu costat
El codi és la resposta curta de dalt. :name[項梁] i :book[史記] conserven els seus caràcters en el text, de manera que la cerca, el text copiat i el PDF llegeixen 項梁 i 史記, i hi afegeixen les marques al costat (Marques xineses, ruby i warichu). El costat el decideix només la direcció d'escriptura: layout.writingMode: 'vertical-rl' posa les línies a l'esquerra dels caràcters, i l'estil d'encapçalament across, amb la disposició 'horizontal-tb', a sota. bookTitleMark: 'wavy' és el que un document zh-Hant rep per defecte; hi va escrit perquè, en passar a zh-Hans, els títols sortirien entre 《》. Quan dues marques del mateix tipus es toquen, com a 東漢班固 o a 史記項羽本紀, cadascuna cedeix un vuitè de quadratí al punt de trobada, i les línies es llegeixen com dos noms.
#2 · Un interlineat amb lloc per a les marques
const [SONG, HEI, KAI] = ['Noto Serif TC', 'Noto Sans TC', 'LXGW WenKai TC']; // 宋, 黑, 楷
const PT = 25.4 / 72; // mm in a point
const [W, H] = [140, 203]; // mm: 大32開
const SIZE = 10.5; // pt: 五號
// A gap of 7.5 pt (0.71 em) between lines: a line of marks needs half an em of it, dots on
// one side and lines on the other five eighths. At 15 pt the build reports every marked
// paragraph (cjkMarksExceedLeading: gap 0.43 em).
const LEAD = 18; // pt
const [CHARS, LINES] = [42, 17]; // the vertical grid: characters down a line, lines across
const SIDE = (W - LINES * LEAD * PT) / 2; // mm: the side margins of a vertical page
Les marques viuen a l'espai entre línies i mai no canvien el pas de línia (Marques, ruby i warichu). Amb 10,5 pt sobre 18 pt l'espai és de 0,71 quadratins, i hi caben les línies de nom d'una columna i els punts de la següent, com a la cinquena norma de la pàgina 1. La retícula compta la pàgina en caràcters, 42 al llarg de cada línia i 17 línies a l'ample, i mou els marges perquè la caixa mesuri exactament això: 25,7 mm de marge al cap i 21,7 mm al peu (Retícula de caràcters).
#3 · Una obertura que gira amb la pàgina
// The grid centres the text between the minimum margins; the band stops at its foot.
const FOOT = 20 + (H - 24 - 20 - CHARS * SIZE * PT) / 2; // mm, with minimums of 24 and 20
const BAND = SIDE + 3.5 * LEAD * PT; // mm from the trim, which is the right edge down the page
const onBand = { align: 'left', overflow: 'wrap' }; // design text centres and cuts by default
const next = (id, y) => ({ anchor: { to: `#${id}`, edge: 'below' }, offset: { y: mm(y) } });
const opener = {
enabled: true,
minHeight: pt(4 * LEAD), // the text starts on the fifth line, half a line clear of the band
slot: { elements: [
// Across the page the band's length runs past the trim; down it, it ends at the text's
// foot, clear of the folio.
{ kind: 'box', id: 'band', style: { backgroundColor: col('band') },
placement: { anchor: { to: 'bleed', edge: 'top-left' },
size: { width: mm(H - FOOT), height: mm(BAND) } } },
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', ...onBand, fontFamily: HEI,
fontWeight: 700, fontSize: pt(8), letterSpacing: pt(1.6), color: col('tint'),
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(6 - SIDE) } } },
{ kind: 'text', id: 'title', content: '{titleText}', ...onBand, fontFamily: SONG,
fontWeight: 700, fontSize: pt(46), lineHeight: 1, letterSpacing: pt(3),
color: col('paper'), placement: next('kicker', 2) },
{ kind: 'text', id: 'byline', content: '{attr.byline}', ...onBand, fontFamily: KAI,
fontSize: pt(10), color: col('tint'), placement: next('title', 2) },
] },
};
El disseny d'un títol es compon en el flux de la seva pàgina, de manera que un mateix joc d'elements serveix en les dues direccions (Escriptura vertical). Ancorada a la cantonada superior esquerra de la sang, la banda travessa el cap de la pàgina horitzontal i baixa per la vora dreta de les verticals, que és on comença la lectura. L'avanttítol, el títol i l'autor també s'apilen en el flux: un sota l'altre en horitzontal, un a l'esquerra de l'altre en vertical. La longitud de la banda es mesura al llarg del flux: 181,3 mm l'aturen al peu del text vertical, lluny del foli, i a la pàgina horitzontal passen del tall.
#4 · Folis en un llibre enquadernat per la dreta
const foot = (id, content, parity, edge, x, extra) => ({ kind: 'text', id, content, parity,
fontFamily: HEI, fontSize: pt(7), color: col('muted'), ...extra,
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(-11) } } });
const folio = { fontFamily: SONG, fontSize: pt(9) };
// Bound on the right, a recto (odd) lies left of the spine: its outer edge is its left one.
const footer = { elements: [
foot('folio-odd', '{pageNumber}', 'odd', 'bottom-left', SIDE, folio),
foot('folio-even', '{pageNumber}', 'even', 'bottom-right', -SIDE, folio),
foot('slug', '{attr.slug}', 'all', 'bottom', 0, { letterSpacing: pt(0.4) }),
] };
El text vertical enquaderna el llibre per la dreta (Enquadernació): la pàgina 1 queda a l'esquerra del llom i la vora exterior d'una pàgina senar és l'esquerra. El foli senar va a baix a l'esquerra i el parell a baix a la dreta, al revés que en un llibre occidental, i pageNumbering.format: 'trad-chinese-informal' els imprimeix 一, 二, 三. El rètol entre tots dos surt d'un atribut de cada títol, slug="…"; amb el colofó, és l'únic que canvia entre l'edició anglesa i l'espanyola.
#5 · Una segona tinta
const palette = {
ink: '#221e1b', // the text
band: '#23394b', // the opener band and the small heads
mark: '#b5412c', // the name, title and emphasis marks: the second ink
tint: '#c7d2da', // kickers and bylines on the band
muted: '#6f6a64', // folios, slug lines, the colophon
paper: '#ffffff',
};
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: 'band (defaults)', value: { hex: palette.band, model: 'hex' } },
];
Una edició de clàssics imprimeix les marques amb la tinta del text. Una antologia escolar les pot imprimir en un segon color, per separar-les dels traços dels caràcters: annotationColor les enllaça amb l'entrada mark de la paleta, el vermelló dels comentaris en tinta vermella, i un sol canvi en aquesta entrada canvia el to de totes les línies i tots els punts del llibre.
La recepta completa
// ═══ Postext Cookbook · Nº 077 · Proper-name and book-title marks, across and down ═════
// https://postext.dev/en/cookbook/proper-name-marks
// Code: MIT · Text: Sima Qian, Shiji 7 (PD) · Punctuation, headnote, conventions: CC BY 4.0
// Fonts: Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// Specimen pages for a classical reader: the opening of the Basic Annals of Xiang Yu with
// its proper-name lines and wavy title lines, set down the page and then across it.
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 slug lines and the colophon ('en' | 'es')
const RECIPE = 'proper-name-marks';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the indigo of a thread-bound cover, vermilion for the marks
const palette = {
ink: '#221e1b', // the text
band: '#23394b', // the opener band and the small heads
mark: '#b5412c', // the name, title and emphasis marks: the second ink
tint: '#c7d2da', // kickers and bylines on the band
muted: '#6f6a64', // folios, slug lines, the colophon
paper: '#ffffff',
};
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: 'band (defaults)', value: { hex: palette.band, model: 'hex' } },
];
// #endregion
// #region type: 五號 on 18 pt, 42 characters by 17 lines down the page
const [SONG, HEI, KAI] = ['Noto Serif TC', 'Noto Sans TC', 'LXGW WenKai TC']; // 宋, 黑, 楷
const PT = 25.4 / 72; // mm in a point
const [W, H] = [140, 203]; // mm: 大32開
const SIZE = 10.5; // pt: 五號
// A gap of 7.5 pt (0.71 em) between lines: a line of marks needs half an em of it, dots on
// one side and lines on the other five eighths. At 15 pt the build reports every marked
// paragraph (cjkMarksExceedLeading: gap 0.43 em).
const LEAD = 18; // pt
const [CHARS, LINES] = [42, 17]; // the vertical grid: characters down a line, lines across
const SIDE = (W - LINES * LEAD * PT) / 2; // mm: the side margins of a vertical page
// #endregion
// #region answer: marks by the markup, their side by the writing mode
// :name[項梁] draws the proper-name line, :book[史記] the book-title mark, :dots[…] dots.
const cjk = {
bookTitleMark: 'wavy', // zh-Hant's default; mainland editions of the classics use it too
annotationColor: col('mark'), // unset, the marks print in the colour of the text
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 títols entre 《》
Els llibres de la Xina continental que no són de clàssics posen els títols entre claudàtors angulars: el Markdown no canvia i els claudàtors s'imprimeixen com a puntuació del text.
- bookTitleMark: 'wavy', // zh-Hant's default; mainland editions of the classics use it too
+ bookTitleMark: 'brackets', // 《史記》《項羽本紀》#Imprimeix les marques amb la tinta del text
Sense annotationColor, cada marca pren el color del bloc que marca.
- annotationColor: col('mark'), // unset, the marks print in the colour of the textErrors freqüents
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
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
El xinès no té cursiva
Les famílies CJK no porten cursiva, i la tipografia xinesa marca l'èmfasi amb punts al costat dels caràcters, no pas inclinant-los. En un document etiquetat com a xinès, *…* posa punts d'èmfasi als caràcters xinesos que abasta i deixa la cursiva per a les paraules llatines (cjk.emphasis: 'dots', el valor predeterminat en xinès); :dots[…] els posa a qualsevol lloc. Amb cjk.emphasis: 'italic', o en un document etiquetat en o es, *…* fa que el canvas inclini els glifs rodons, una obliqua sintètica que la tipografia xinesa no fa servir mai (el PDF recorre a la rodona): conserva l'etiqueta xinesa, o marca l'èmfasi en negreta o amb una font Kai (LXGW WenKai) amb un estil de paràgraf o de xip. Fonts xineses, japoneses i coreanes →
Avís de maquetació · cjkMarksExceedLeading
Marques enganxades a la línia veïna
Per què. Un paràgraf amb punts d'èmfasi o línies de nom propi i de títol té una interlínia de menys de mig quadratí (cinc vuitens amb marques pels dos costats): les marques ocupen l'interlineat, que no creix per elles, de manera que toquen la línia veïna.
Solució. Dona al paràgraf un estil de paràgraf amb més interlineat, o apuja `bodyText.lineHeight`. Documentació →
- Un títol que dibuixa un disseny imprimeix el seu text a través del disseny, i el text de disseny perd les marques:
# :book[項羽本紀]no mostraria cap línia ondulada a la banda. Les capçaleres, els peus de figura i les cel·les de taula també imprimeixen el seu text sense marques. - Postext no s'atura per
cjkMarksExceedLeading: la composició ho anota adoc.contentWarningsi el tauler Revisió del Sandbox ho mostra, però les pàgines s'imprimeixen igualment, amb les marques enganxades a la línia veïna. Si canvies l'interlineat, revisa aquesta llista; amb 15 pt recull tots els paràgrafs marcats d'aquestes pàgines.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- The opening of the Basic Annals of Xiang Yu (項羽本紀), Records of the Grand Historian (史記), chapter 7; characters from the zh.wikisource transcription · Sima Qian (司馬遷) · domini públic
- The punctuation, the paragraphs and the marks of the passage, the headnote (題解), the conventions (凡例), the slug lines and the colophon · Ignacio Ferro · CC BY 4.0
- Fonts
- Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · LXGW WenKai 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)


