En pocas palabras
El comienzo de un relato de Lu Xun compuesto como un libro de bolsillo chino. Enseña a meter justo 28 caracteres por línea y 28 líneas por página, con las normas chinas de puntuación.
Lo que vas a componer
El comienzo de «El pueblo natal» (故乡, 1921), de Lu Xun, como lo compondría una edición continental en rústica de su primer libro: una página 大32开 de 140 × 203 mm cuya caja de texto se cuenta en caracteres, 28 por línea y 28 líneas por página, en Noto Serif SC de cuerpo 五号 (10,5 pt). Cada párrafo entra dos caracteres; las comas y las comillas ocupan medio carácter, como en la mayoría de los libros continentales; ninguna línea empieza con 。 o , ni acaba con “. El relato se abre en una página impar, bajo su título en el peso negro de la Song. Enfrente, una lámina pintada muestra el campo de sandías bajo la luna que recuerda el narrador, con la frase que lo describe en la letra de pincel Ma Shan Zheng. Español justificado en una novela de bolsillo hace el mismo trabajo con una escritura latina.
Esta receta responde a
- ¿Cómo defino la mancha en caracteres, tantos por línea y tantas líneas por página?
- ¿Cómo evito que 。 y , empiecen una línea?
- ¿Cómo compongo la puntuación china en Kaiming, como los libros de la China continental, o a medio ancho?
- ¿Cómo dejo espacio entre palabras chinas y latinas sin teclearlo?
La respuesta corta
const cjk = {
// The type area in characters: 28 ems wide, 28 lines of LEAD tall. page.margins become
// minimums, and the grid centres the type area in the room they leave.
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
// What 'zh-Hans' gives by itself, written out so a reader can compare regions and styles.
region: 'mainland',
lineBreak: 'gb', // no 。,、”》 opens a line, no “《( ends one, and no / at either end
punctuationWidth: 'kaiming', // ,、:; quotes, brackets ½ em; 。?! one em, ½ at a line end
compressAdjacent: true, // idle under Kaiming (no pair tops 1.5 em); 'fullwidth' needs it
latinSpacing: em(0.25), // 1921年, 用Noto Serif SC五号: a quarter em, none of it typed
};
const bodyText = {
fontFamily: SONG, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', // spread between the characters, never between words
firstLineIndent: em(2), indentAfterHeading: true, // two characters, every paragraph
};
Ingredientes
- Funciones
- Retícula de caracteresCorte de líneas en chinoAnchura de la puntuación chinaJustificación entre caracteresEspacio entre chino y latínFuentes chinas, japonesas y coreanasSangrías, alineación y separación de párrafosTipografía del textoCabeceras y foliosAperturas diseñadasEstilos de títuloAtributos de títuloTextos, filetes y cajas en los diseños de páginaCabeceras según el tipo de páginaMárgenes simétricosEstilos de párrafoMarcadores del PDF
- También usa
- Color del papelExportación a PDFFuentes incrustadas en el PDFFiguras y tablas como recursosCabeceras por sección
- Tipografía
- Noto Serif SC, Noto Sans SC, Ma Shan Zheng (SIL OFL 1.1)
- Recursos
plate-1120.jpg- La lámina: el campo de sandías bajo la luna del relato, una pintura (Generated With Diffusion Models, original)
Elaboración
#1 · Una página contada en caracteres
El código está en la respuesta corta, más arriba. cjk.grid da a la medida 28 em de bodyText.fontSize (294 pt, 103,7 mm) y a la caja de texto 28 líneas de lineHeight (462 pt, 163 mm), y mueve los márgenes para que quepan, así que una línea llena de caracteres chinos tiene exactamente 28 y todas las páginas llenas acaban en la misma línea (Retícula de caracteres). Los cinco ajustes que siguen a la retícula son los que locale: 'zh-Hans' ya da por sí solo; van escritos para que puedas cambiarlos de uno en uno, aunque compressAdjacent no cambia nada mientras punctuationWidth no sea 'fullwidth': con Kaiming, dos signos seguidos nunca ocupan más de 1,5 em. En la página 71, el 。 que cierra un párrafo no cabe, y las reglas de principio de línea (todos los niveles de lineBreak salvo 'none'; 'gb' añade la barra) le prohíben abrir línea. La línea lo recoge componiendo a medio carácter el 。 que sigue a 事, y así 事。宏 se aprieta y el párrafo no gana una línea (Anchos de la puntuación). El blanco de las líneas cortas se reparte entre los caracteres, nunca entre palabras, y en estas páginas nunca pasa de 0,05 em (Chino, japonés y coreano).

#2 · Un 大32开 con más cabeza que pie
const page = {
width: mm(TRIM.width), height: mm(TRIM.height), dpi: 150, backgroundColor: col('paper'),
// 22 + 18 mm leave 163 mm, exactly 28 lines of 16.5 pt; 18 mm a side leave the 103.7 mm
// measure 0.3 mm to share. A grid that no longer fits is cut down (cjkGridClamped).
margins: { top: mm(22), bottom: mm(18), left: mm(18), right: mm(18), mirror: true },
};
Con la retícula activada, los márgenes son mínimos: la retícula coloca la caja de texto en el hueco que dejan y reparte lo que sobra. Arriba 22 mm y abajo 18 dejan justo 163 mm, así que el margen de cabeza sigue siendo 4 mm más alto que el de pie, como en los libros chinos; a los lados, 18 mm por lado dejan 0,3 mm que repartir. Si pides más caracteres o líneas de los que caben, la retícula se reduce a lo que cabe y avisa con cjkGridClamped; el cuerpo y el interlineado no cambian.
#3 · Un título hundido un número entero de líneas
const SINK = 8; // lines of LEAD: a whole number, so the text under it keeps to the grid
const centred = (y) => ({ anchor: { to: 'container', edge: 'top' }, offset: { y: mm(y) } });
const opener = {
enabled: true,
minHeight: pt(SINK * LEAD),
slot: { elements: [
// The spacing after the last character is advance, not ink: the title stays centred.
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: SONG, fontWeight: 900,
fontSize: pt(46), letterSpacing: pt(23), lineHeight: 1.1, color: col('ink'),
align: 'center', placement: centred(6) },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1.2),
color: col('night'), placement: { ...centred(30), size: { width: mm(8) } } },
{ kind: 'text', id: 'author', content: '{author}', fontFamily: HEI, fontSize: pt(10.5),
letterSpacing: pt(5), color: col('ink'), align: 'center', placement: centred(34) },
] },
};
// parity 'any': a story opens on the next page, left or right.
const chapter = { level: 1, breakBefore: { enabled: true, parity: 'any' },
marginTop: pt(0), marginBottom: pt(0), advancedDesign: opener };
minHeight mide ocho líneas de 16,5 pt, de modo que el texto empieza en la novena línea de la retícula, sobre las mismas líneas de base que en cualquier otra página. Los 23 pt de espaciado separan 故 y 乡 medio carácter, lo habitual en un título de dos caracteres; Postext no cuenta el espaciado que queda tras el último carácter al centrar la línea, así que el título queda en el eje de la página (Estilos de encabezado).
#4 · El libro en la página par, el relato en la impar
const HEAD_Y = 11; // mm from the top edge to the heads; the hairline 5 mm lower
const label = { fontFamily: HEI, fontSize: pt(8), color: col('muted'), pages: 'body' };
const at = (edge, x, y = HEAD_Y) => ({ anchor: { to: 'page', edge },
offset: { x: mm(x), y: mm(y) } });
const header = { elements: [
{ kind: 'text', id: 'verso-folio', content: '{pageNumber}', parity: 'even', ...label,
placement: at('top-left', SIDE) },
{ kind: 'text', id: 'verso-book', content: '{title}', parity: 'even', ...label,
letterSpacing: pt(4), placement: at('top', 0) },
{ kind: 'text', id: 'recto-story', content: '{chapterTitle}', parity: 'odd', ...label,
letterSpacing: pt(4), placement: at('top', 0) },
{ kind: 'text', id: 'recto-folio', content: '{pageNumber}', parity: 'odd', ...label,
placement: at('top-right', -SIDE) },
{ kind: 'rule', id: 'hairline', direction: 'horizontal', thickness: pt(0.5), color: col('rule'),
pages: 'body', placement: { ...at('top-left', SIDE, HEAD_Y + 5), size: { width: mm(MEASURE) } },
},
] };
// The opener has no head: its folio drops to the foot, centred under the text.
const footer = { elements: [{ kind: 'text', id: 'drop-folio', content: '{pageNumber}',
...label, pages: 'opener', align: 'center', placement: at('bottom', 0, -10) }] };
Las novelas continentales llevan el título del libro sobre las páginas pares y el del relato sobre las impares, centrados, con el folio en el borde exterior y un filete fino debajo. pages: 'body' deja las cabeceras fuera de la apertura y de la lámina, y la apertura lleva el folio al pie. Las cabeceras van en Noto Sans SC, la Hei, a 8 pt: pequeñas, pero con una voz distinta de la Song del texto.
#5 · Una lámina a toda página
// The plate, a painting: a JPEG in assets/ cut to the 140 × 203 mm trim, declared at its pixels.
const resources = [{
id: 'moon', typeId: 'figure', kind: 'bitmap', createdAt: 0, updatedAt: 0,
bitmap: { fileId: 'plate-1120.jpg', format: 'jpeg', width: 1120, height: 1624 },
altText: t({
en: 'A golden full moon in a deep blue sky over a strip of sea. On the sand below, among '
+ 'rows of striped watermelons, a boy with a silver collar stabs a steel fork at the '
+ 'sand ahead of him, and the small animal he aimed at runs off between his legs.',
es: 'Una luna llena dorada en un cielo azul oscuro sobre una franja de mar. En la arena, '
+ 'entre hileras de sandías rayadas, un muchacho con un aro de plata al cuello clava una '
+ 'horquilla de acero en la arena, delante de él, y el animalillo al que apuntaba huye '
+ 'entre sus piernas.',
}),
}];
const quote = { fontFamily: KAI, fontSize: pt(14), lineHeight: 1.5, color: col('paper') };
// # 月下的瓜地 {style="plate" line1="…" line2="…" line3="…"}: a page with no head or folio.
// 'page' spans the design over the sheet: a heading's design in the column is cut at its foot.
const plate = {
id: 'plate', span: 'page', runningChapter: false, toc: false, // out of the PDF outline
breakBefore: { enabled: true, parity: 'any' }, // (gotcha: style-inherits-break)
header: { elements: [] }, footer: { elements: [] },
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'image', id: 'picture', resourceId: 'moon', placement: { // the whole trim
anchor: { to: 'bleed', edge: 'top-left' },
size: { width: mm(TRIM.width), height: mm(TRIM.height) } } },
{ kind: 'text', id: 'line1', content: '{attr.line1}', ...quote, align: 'left',
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(2) } } },
{ kind: 'text', id: 'line2', content: '{attr.line2}', ...quote, align: 'left',
placement: { anchor: { to: '#line1', edge: 'below' } } },
{ kind: 'text', id: 'line3', content: '{attr.line3}', ...quote, align: 'left',
placement: { anchor: { to: '#line2', edge: 'below' } } },
] } },
};
La ilustración pertenece a un título propio, # 月下的瓜地 {style="plate" …}, cuyo estilo dibuja la página y le quita la cabecera y el folio. La lámina necesita span: 'page', porque el diseño de un título que se queda en la columna se corta al pie de la columna, 18 mm antes del borde. runningChapter: false con toc: false la deja fuera de los marcadores del PDF, que empiezan por 故乡. Las tres líneas de la cita son tres atributos y tres elementos de texto, porque el texto de diseño tiene su propio corte de líneas y no aplica los anchos de la puntuación china; al partirlas a mano, las líneas pierden además sus comas, como suele hacerse con las líneas de exhibición en chino.
#6 · Letras latinas y cifras en el texto chino
const paragraphStyles = [
// 小五 (9 pt) nudged to 9.1875 pt: 32 of its characters fill the 28-em measure exactly.
{ id: 'note', fontSize: pt((CHARS * BODY) / 32), lineHeight: pt(LEAD), color: col('ink'),
firstLineIndent: em(2), marginTop: pt(LEAD) }, // on the grid, a line below the text
{ id: 'colophon', fontFamily: HEI, fontSize: pt(7), lineHeight: pt(11), color: col('muted'),
textAlign: 'left', firstLineIndent: pt(0), marginTop: pt(LEAD / 2) },
];
La nota y el colofón de la página 76 son el sitio donde las cifras y los nombres latinos tocan los caracteres chinos. latinSpacing pone un cuarto de cuadratín allí donde se tocan, como en el 1921年 de la nota y en el 用Noto Serif SC五号 del colofón, escritos sin ningún espacio (Espacio entre chino y latín); en una línea justificada, ese espacio es lo primero que crece, hasta medio cuadratín. La nota va a 9,1875 pt y no a los 9 pt del 小五 para que 32 de sus caracteres llenen la medida: a 9 pt a cada línea le sobraban dos tercios de em, y se los quedaban los espacios entre chino y latín. En el Markdown, los nombres de las fuentes llevan espacios de no separación (U+00A0), que el espacio entre chino y latín respeta: con espacios normales, las líneas en bandera del colofón partían Noto Sans / SC.
La receta completa
// ═══ Postext Cookbook · Nº 074 · A Chinese novel page on a 28 × 28 grid ════════════
// https://postext.dev/en/cookbook/chinese-novel-horizontal
// Code: MIT · Text: Lu Xun, 故乡 (1921), public domain, zh.wikisource · Plate: diffusion models
// Fonts: Noto Serif SC, Noto Sans SC, Ma Shan Zheng (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage,
} 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 = 'chinese-novel-horizontal';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// The night of the story's memory, and ink on a cream paper.
const palette = {
ink: '#1f1c19', // text: a warm near-black
night: '#1d3150', // the accent: the deep blue of the plate's sky, the opener's rule
rule: '#c9c1b2', // the hairline under the running heads
muted: '#6a645b', // running heads, folios, the colophon
paper: '#fbf8f1', // a cream book 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: 'night (defaults)', value: { hex: palette.night, model: 'hex' } },
];
const SONG = 'Noto Serif SC'; // 宋: the text, and the title in its black weight
const HEI = 'Noto Sans SC'; // 黑: running heads, folios, the author, the colophon
const KAI = 'Ma Shan Zheng'; // 楷: a brush regular script for the plate's quotation
const [BODY, LEAD] = [10.5, 16.5]; // pt: 五号 on a 6 pt line gap, the grid's pitch
const [CHARS, LINES] = [28, 28];
const TRIM = { width: 140, height: 203 }; // mm: 大32开
const MEASURE = (CHARS * BODY * 25.4) / 72; // 103.7 mm: 28 ems of 五号
const SIDE = (TRIM.width - MEASURE) / 2; // 18.1 mm: the grid centres the measure
// #region answer: 28 characters × 28 lines of 五号, mainland line breaks and Kaiming marks
const cjk = {
// The type area in characters: 28 ems wide, 28 lines of LEAD tall. page.margins become
// minimums, and the grid centres the type area in the room they leave.
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
// What 'zh-Hans' gives by itself, written out so a reader can compare regions and styles.
region: 'mainland',
lineBreak: 'gb', // no 。,、”》 opens a line, no “《( ends one, and no / at either end
punctuationWidth: 'kaiming', // ,、:; quotes, brackets ½ em; 。?! one em, ½ at a line end
compressAdjacent: true, // idle under Kaiming (no pair tops 1.5 em); 'fullwidth' needs it
latinSpacing: em(0.25), // 1921年, 用Noto Serif SC五号: a quarter em, none of it typed
};
const bodyText = {
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
#Compón toda la puntuación a ancho completo (全角式)
Las comas, las comas de enumeración y las comillas ocupan un carácter entero, 。” ocupa dos y en cada línea cabe menos texto.
- punctuationWidth: 'kaiming', // ,、:; quotes, brackets ½ em; 。?! one em, ½ at a line end
- compressAdjacent: true, // idle under Kaiming (no pair tops 1.5 em); 'fullwidth' needs it
+ punctuationWidth: 'fullwidth',
+ compressAdjacent: false,#Muestra la retícula mientras compones
El canvas dibuja un cuadrado gris claro por cada posición de carácter de cada línea (稿纸); el PDF no lo incluye salvo que renderToPdf reciba characterGrid: true.
- grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
+ grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES, show: true },Errores frecuentes
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
Compón la puntuación de cada región con una fuente de esa región
Los anchos de la puntuación mueven el blanco de cada signo al lado donde lo pone la región del documento, no al lado donde lo dibuja la fuente: con zh-Hans, una coma Kaiming conserva la mitad izquierda de su caja, donde una fuente simplificada dibuja el signo, y cede la derecha. Una fuente tradicional centra ,。 en la caja, así que la mitad que se va se lleva parte del signo y la coma se pega al carácter siguiente. LXGW WenKai TC, la única Kai de texto de Fontsource, lo hace en texto simplificado. Compón el texto, las notas y las citas continentales en Noto Serif SC o Noto Sans SC, deja las fuentes TC para zh-Hant y usa una letra de pincel simplificada (Ma Shan Zheng) solo en líneas de exhibición, donde el texto de diseño no aplica anchos de puntuación. Además dibuja formas heredadas que no imprime ni el estándar continental ni el de Taiwán, 為 con el 爫 de 爲 y 令 (en 冷, 領) con el pie de 卩: revisa los caracteres que compone en cada página. Anchura de la puntuación china →
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 →
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 →
Aviso de maquetación · cjkGridClamped
Retícula de caracteres demasiado grande
Por qué. `cjk.grid` pide más caracteres por línea o más líneas por página de los que caben entre los márgenes con ese cuerpo e interlineado, así que la retícula se compone con los que caben.
Solución. Baja `charsPerLine` o `linesPerPage`, estrecha los márgenes (son mínimos) o reduce `bodyText.fontSize` o `lineHeight`. Documentación →
- La lámina es un título, y un título tiene marcador en el PDF: sin
runningChapter: falseytoc: falseen el estilo de la lámina, los marcadores empezarían por 月下的瓜地, en el primer nivel, antes de 故乡. Con uno solo de los dos ajustes, el marcador sigue ahí. El PDF etiquetado conserva el título de la lámina como H1. - La fuente de los títulos tiene que ser una de las que carga
FONTS, aunque un diseño pinte todos los títulos: con el peso 700 por defecto, el kit encontró Noto Serif SC 700 en la maqueta y cargó su archivo latino con un aviso.headings.fontWeight: 400deja los bloques de título en la fuente del texto.
Créditos
- Receta
- Ignacio Ferro
- Texto
- «El pueblo natal» (故乡, 1921), primera mitad, de las Obras completas de 1948, en caracteres simplificados · Lu Xun (鲁迅) · dominio público
- La nota del editor y el colofón · Postext Cookbook · original
- Imágenes
- La lámina: el campo de sandías bajo la luna del relato, una pintura · Generated With Diffusion Models · original
- Fuentes
- Noto Serif SC (SIL OFL 1.1) · Noto Sans SC (SIL OFL 1.1) · Ma Shan Zheng (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)


