En pocas palabras
Páginas de muestra de un clásico de la historia china. Enseña a marcar en rojo los nombres con una línea recta y los títulos de libros con una ondulada, en texto vertical y horizontal.
Lo que vas a componer
Tres páginas de muestra para una antología de las Memorias históricas, en el formato de 140 × 203 mm de un libro chino 大32開. El pasaje es el comienzo de los Anales básicos de Xiang Yu con la puntuación completa de una edición de clásicos: una línea recta junto a cada persona, lugar, estado y dinastía, y una línea ondulada junto a cada título de libro o de capítulo, las dos en bermellón. La página 1 lleva la presentación y las normas de la edición en letra Kai. Las páginas 2 y 3 componen dos veces el mismo Markdown, en vertical y en horizontal, y la doble página enseña adónde va cada marca: a la izquierda del nombre en las líneas verticales, debajo en las horizontales. El libro se encuaderna por la derecha y una banda añil lleva cada título. La receta Nº 044, Lycidas en el texto de 1645, distingue los nombres a la manera europea, en cursiva.
Esta receta responde a
- ¿Cómo marco los nombres propios y los títulos de un texto chino con una línea recta y una ondulada?
- ¿Por qué el énfasis de mi texto chino sale inclinado y qué debo usar en su lugar?
- ¿Cómo compongo un libro chino en vertical, encuadernado por la derecha?
La respuesta corta
// :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) },
};
Ingredientes
- Funciones
- Puntos de énfasis y líneas de nombre y de títuloTexto verticalLibros encuadernados por la derechaAnchura de la puntuación chinaCorte de líneas en chinoRetícula de caracteresFuentes chinas, japonesas y coreanasFuentes incrustadas en el PDFExportación a PDFNumeración chinaEstilos de títuloGeometría por secciónAperturas diseñadasBanda de capítulo a todo el anchoAtributos de títuloListas numeradasSangrías, alineación y separación de párrafosEstilos de párrafoPaleta de color semántica
- Tipografía
- Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · El marcado pone las marcas; la dirección de escritura, su lado
El código es la respuesta corta de arriba. :name[項梁] y :book[史記] conservan sus caracteres en el texto, así que la búsqueda, el texto copiado y el PDF leen 項梁 y 史記, y les añaden las marcas al lado (Marcas chinas, ruby y warichu). El lado lo decide solo la dirección de escritura: layout.writingMode: 'vertical-rl' pone las líneas a la izquierda de los caracteres, y el estilo de encabezado across, cuya disposición es 'horizontal-tb', debajo. bookTitleMark: 'wavy' es lo que un documento zh-Hant recibe por defecto; va escrito porque, al pasar a zh-Hans, los títulos saldrían entre 《》. Cuando dos marcas del mismo tipo se tocan, como en 東漢班固 o en 史記項羽本紀, cada una cede un octavo de cuadratín en el punto de encuentro, y las líneas se leen como dos nombres.
#2 · Un interlineado con sitio para las marcas
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
Las marcas están en el hueco entre líneas y nunca cambian el paso de línea (Marcas, ruby y warichu). Con 10,5 pt sobre 18 pt el hueco es de 0,71 cuadratines, y caben en él las líneas de nombre de una columna y los puntos de la siguiente, como en la quinta norma de la página 1. La retícula cuenta la página en caracteres, 42 a lo largo de cada línea y 17 líneas a lo ancho, y mueve los márgenes para que la caja mida justo eso: 25,7 mm de margen en la cabeza y 21,7 mm al pie (Retícula de caracteres).
#3 · Una apertura que gira con 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 diseño de un título se compone en el flujo de su página, así que un mismo juego de elementos sirve en las dos direcciones (Escritura vertical). Anclada a la esquina superior izquierda del sangrado, la banda cruza la cabeza de la página horizontal y baja por el borde derecho de las verticales, que es donde empieza la lectura. El antetítulo, el título y el autor se apilan también en el flujo: uno debajo de otro en horizontal, uno a la izquierda de otro en vertical. La longitud de la banda se mide a lo largo del flujo: 181,3 mm la detienen al pie del texto vertical, lejos del folio, y en la página horizontal pasan del corte.
#4 · Folios en un libro encuadernado por la derecha
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 texto vertical encuaderna el libro por la derecha (Encuadernación): la página 1 queda a la izquierda del lomo y el borde exterior de una página impar es el izquierdo. El folio impar va abajo a la izquierda y el par abajo a la derecha, al revés que en un libro occidental, y pageNumbering.format: 'trad-chinese-informal' los imprime 一, 二, 三. El rótulo entre los dos sale de un atributo de cada título, slug="…"; con el colofón, es lo único que cambia entre la edición inglesa y la española.
#5 · Una segunda 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ón de clásicos imprime las marcas con la tinta del texto. Una antología escolar puede imprimirlas en un segundo color, para separarlas de los trazos de los caracteres: annotationColor las enlaza con la entrada mark de la paleta, el bermellón de los comentarios en tinta roja, y un solo cambio en esa entrada cambia el tono de todas las líneas y todos los puntos del libro.
La receta 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
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 títulos entre 《》
Los libros de China continental que no son de clásicos ponen los títulos entre corchetes angulares: el Markdown no cambia y los corchetes se imprimen como puntuación del texto.
- bookTitleMark: 'wavy', // zh-Hant's default; mainland editions of the classics use it too
+ bookTitleMark: 'brackets', // 《史記》《項羽本紀》#Imprime las marcas con la tinta del texto
Sin annotationColor, cada marca toma el color del bloque que marca.
- annotationColor: col('mark'), // unset, the marks print in the colour of the textErrores frecuentes
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
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
El chino no tiene cursiva
Las familias CJK no traen cursiva, y la tipografía china marca el énfasis con puntos junto a los caracteres, no inclinándolos. En un documento etiquetado como chino, *…* pone puntos de énfasis en los caracteres chinos que abarca y deja la cursiva para las palabras latinas (cjk.emphasis: 'dots', lo predeterminado en chino); :dots[…] los pone en cualquier sitio. Con cjk.emphasis: 'italic', o en un documento etiquetado en o es, *…* hace que el canvas incline los glifos redondos, una oblicua sintética que la tipografía china nunca usa (el PDF recurre a la redonda): conserva la etiqueta china, o marca el énfasis en negrita o en una fuente Kai (LXGW WenKai) con un estilo de párrafo o de chip. Fuentes chinas, japonesas y coreanas →
Aviso de maquetación · cjkMarksExceedLeading
Marcas pegadas a la línea vecina
Por qué. Un párrafo con puntos de énfasis o líneas de nombre propio y de título tiene un hueco entre líneas de menos de medio em (cinco octavos con marcas por los dos lados): las marcas están en el interlineado, que no crece por ellas, así que tocan la línea vecina.
Solución. Dale al párrafo un estilo de párrafo con más interlineado, o sube `bodyText.lineHeight`. Documentación →
- Un título que dibuja un diseño imprime su texto a través del diseño, y el texto de diseño pierde las marcas:
# :book[項羽本紀]no mostraría ninguna línea ondulada en la banda. Las cabeceras, los pies de figura y las celdas de tabla también imprimen su texto sin marcas. - Postext no se detiene por
cjkMarksExceedLeading: la composición lo anota endoc.contentWarningsy el panel Revisión del Sandbox lo muestra, pero las páginas se imprimen igual, con las marcas pegadas a la línea vecina. Si cambias el interlineado, revisa esa lista; con 15 pt recoge todos los párrafos marcados de estas páginas.
Créditos
- Receta
- Ignacio Ferro
- Texto
- El comienzo de los Anales básicos de Xiang Yu (項羽本紀), Memorias históricas (史記), capítulo 7; los caracteres, según la transcripción de zh.wikisource · Sima Qian (司馬遷) · dominio público
- La puntuación, los párrafos y las marcas del pasaje, la presentación (題解), las normas de la edición (凡例), los rótulos al pie y el colofón · Ignacio Ferro · CC BY 4.0
- Fuentes
- Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · LXGW WenKai 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)


