En poques paraules
El començament d'un relat de Lu Xun compost com un llibre de butxaca xinès. Ensenya a posar just 28 caràcters per línia i 28 línies per pàgina, amb les normes xineses de puntuació.
Què compondràs
El començament d'«El poble natal» (故乡, 1921), de Lu Xun, tal com el compondria una edició continental en rústica del seu primer llibre: una pàgina 大32开 de 140 × 203 mm amb la caixa comptada en caràcters, 28 per línia i 28 línies per pàgina, en Noto Serif SC de cos 五号 (10,5 pt). Cada paràgraf té un sagnat de dos caràcters; les comes i les cometes ocupen mig caràcter, com a la majoria dels llibres continentals; cap línia no comença amb 。 o , ni acaba amb “. El relat s'obre en una pàgina senar, sota el títol en el gruix negre de la Song. Al davant, una làmina pintada mostra el camp de síndries sota la lluna que recorda el narrador, amb la frase que el descriu en la lletra de pinzell Ma Shan Zheng. Castellà justificat en una novel·la de butxaca fa la mateixa feina amb una escriptura llatina.
Aquesta recepta respon a
- Com defineixo la caixa en caràcters, tants per línia i tantes línies per pàgina?
- Com evito que 。 i , comencin una línia?
- Com componc la puntuació xinesa en Kaiming, com els llibres de la Xina continental, o a mitja amplada?
- Com deixo espai entre paraules xineses i llatines sense teclejar-lo?
La resposta curta
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
};
Ingredients
- Funcions
- Retícula de caràctersTall de línies en xinèsAmplada de la puntuació xinesaJustificació entre caràctersEspai entre xinès i llatíFonts xineses, japoneses i coreanesSagnats, alineació i separació de paràgrafsTipografia del textCapçaleres i folisObertures dissenyadesEstils de títolAtributs de títolTextos, filets i caixes als dissenys de pàginaCapçaleres segons el tipus de pàginaMarges simètricsEstils de paràgrafMarcadors del PDF
- També fa servir
- Color del paperExportació a PDFFonts incrustades al PDFFigures i taules com a recursosCapçaleres per secció
- Tipografia
- Noto Serif SC, Noto Sans SC, Ma Shan Zheng (SIL OFL 1.1)
- Recursos
plate-1120.jpg- The plate: the moonlit melon field of the story, a painting (Generated With Diffusion Models, original)
Elaboració
#1 · Una pàgina comptada en caràcters
El codi és a la resposta curta, més amunt. cjk.grid dona a la mesura 28 em de bodyText.fontSize (294 pt, 103,7 mm) i a la caixa 28 línies de lineHeight (462 pt, 163 mm), i mou els marges perquè hi càpiguen, de manera que una línia plena de caràcters xinesos en té exactament 28 i totes les pàgines plenes acaben a la mateixa línia (Retícula de caràcters). Els cinc paràmetres que segueixen la retícula són els que locale: 'zh-Hans' ja dona per si sol; van escrits perquè els puguis canviar d'un en un, tot i que compressAdjacent no canvia res mentre punctuationWidth no sigui 'fullwidth': amb Kaiming, dos signes seguits mai no ocupen més d'1,5 em. A la pàgina 71, el 。 que tanca un paràgraf no hi cap, i les regles de principi de línia (tots els nivells de lineBreak llevat de 'none'; 'gb' hi afegeix la barra) li prohibeixen obrir línia. La línia el recull component a mig caràcter el 。 que segueix 事, i així 事。宏 s'estreny i el paràgraf no guanya cap línia (Amplades de la puntuació). El blanc de les línies curtes es reparteix entre els caràcters, mai entre paraules, i en aquestes pàgines mai no passa de 0,05 em (Xinès, japonès i coreà).

#2 · Un 大32开 amb més cap que peu
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 },
};
Amb la retícula activada, els marges són mínims: la retícula col·loca la caixa en l'espai que deixen i reparteix el que sobra. A dalt 22 mm i a baix 18 deixen just 163 mm, així que el marge de cap continua sent 4 mm més alt que el de peu, com als llibres xinesos; als costats, 18 mm per banda deixen 0,3 mm per repartir. Si demanes més caràcters o línies dels que hi caben, la retícula es redueix al que hi cap i avisa amb cjkGridClamped; el cos i l'interlineat no canvien.
#3 · Un títol enfonsat un nombre enter de línies
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 mesura vuit línies de 16,5 pt, de manera que el text comença a la novena línia de la retícula, sobre les mateixes línies de base que a qualsevol altra pàgina. Els 23 pt d'espaiat separen 故 i 乡 mig caràcter, l'habitual en un títol de dos caràcters; Postext no compta l'espaiat que queda després de l'últim caràcter en centrar la línia, així que el títol queda a l'eix de la pàgina (Estils d'encapçalament).
#4 · El llibre a la pàgina parella, el relat a la senar
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) }] };
Les novel·les continentals porten el títol del llibre sobre les pàgines parelles i el del relat sobre les senars, centrats, amb el foli a la vora exterior i un filet fi a sota. pages: 'body' deixa les capçaleres fora de l'obertura i de la làmina, i l'obertura porta el foli al peu. Les capçaleres van en Noto Sans SC, la Hei, a 8 pt: petites, però amb una veu diferent de la Song del text.
#5 · Una làmina a tota 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 il·lustració pertany a un títol propi, # 月下的瓜地 {style="plate" …}, amb un estil que dibuixa la pàgina i li treu la capçalera i el foli. La làmina necessita span: 'page', perquè el disseny d'un títol que es queda a la columna es talla al peu de la columna, 18 mm abans de la vora. runningChapter: false amb toc: false la deixa fora dels marcadors del PDF, que comencen per 故乡. Les tres línies de la cita són tres atributs i tres elements de text, perquè el text de disseny té el seu propi tall de línies i no aplica les amplades de la puntuació xinesa; en partir-les a mà, les línies perden a més les comes, com se sol fer amb les línies d'exhibició en xinès.
#6 · Lletres llatines i xifres en el text xinès
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 i el colofó de la pàgina 76 són el lloc on les xifres i els noms llatins toquen els caràcters xinesos. latinSpacing posa un quart de quadratí allà on es toquen, com al 1921年 de la nota i al 用Noto Serif SC五号 del colofó, escrits sense cap espai (Espai entre xinès i llatí); en una línia justificada, aquest espai és el primer que creix, fins a mig quadratí. La nota va a 9,1875 pt i no als 9 pt del 小五 perquè 32 dels seus caràcters omplin la mesura: a 9 pt a cada línia li sobraven dos terços d'em, i se'ls quedaven els espais entre xinès i llatí. Al Markdown, els noms de les fonts porten espais de no separació (U+00A0), que l'espai entre xinès i llatí respecta: amb espais normals, les línies en bandera del colofó partien Noto Sans / SC.
La recepta 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 = {
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
#Compon tota la puntuació a amplada completa (全角式)
Les comes, les comes d'enumeració i les cometes ocupen un caràcter sencer, 。” n'ocupa dos i a cada línia hi cap menys text.
- 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,#Mostra la retícula mentre compons
El canvas dibuixa un quadrat gris clar per cada posició de caràcter de cada línia (稿纸); el PDF no l'inclou llevat que renderToPdf rebi characterGrid: true.
- grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
+ grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES, show: true },Errors freqüents
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
Compon la puntuació de cada regió amb una font d'aquella regió
Les amplades de la puntuació mouen el blanc de cada signe al costat on el posa la regió del document, no al costat on el dibuixa la font: amb zh-Hans, una coma Kaiming conserva la meitat esquerra de la seva caixa, on una font simplificada dibuixa el signe, i cedeix la dreta. Una font tradicional centra ,。 a la caixa, de manera que la meitat que se'n va s'emporta part del signe i la coma s'enganxa al caràcter següent. LXGW WenKai TC, l'única Kai de text de Fontsource, ho fa en text simplificat. Compon el text, les notes i les cites continentals en Noto Serif SC o Noto Sans SC, deixa les fonts TC per a zh-Hant i fes servir una lletra de pinzell simplificada (Ma Shan Zheng) només en línies d'exhibició, on el text de disseny no aplica amplades de puntuació. A més, dibuixa formes heretades que no imprimeix ni l'estàndard continental ni el de Taiwan, 為 amb el 爫 de 爲 i 令 (a 冷, 領) amb el peu de 卩: revisa els caràcters que compon a cada pàgina. Amplada de la puntuació xinesa →
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 →
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 →
Avís de maquetació · cjkGridClamped
Retícula de caràcters massa gran
Per què. `cjk.grid` demana més caràcters per línia o més línies per pàgina dels que hi caben entre els marges amb aquest cos i aquest interlineat, de manera que la retícula es compon amb els que hi caben.
Solució. Abaixa `charsPerLine` o `linesPerPage`, estreny els marges (són mínims) o redueix `bodyText.fontSize` o `lineHeight`. Documentació →
- La làmina és un títol, i un títol té marcador al PDF: sense
runningChapter: falseitoc: falsea l'estil de la làmina, els marcadors començarien per 月下的瓜地, al primer nivell, abans de 故乡. Amb només un dels dos paràmetres, el marcador continua allà. El PDF etiquetat conserva el títol de la làmina com a H1. - La font dels títols ha de ser una de les que carrega
FONTS, encara que un disseny pinti tots els títols: amb el gruix 700 per defecte, el kit va trobar Noto Serif SC 700 a la maqueta i en va carregar el fitxer llatí amb un avís.headings.fontWeight: 400deixa els blocs de títol en la font del text.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- “My Old Home” (故乡, 1921), the first half, from the 1948 Complete Works, in simplified characters · Lu Xun (鲁迅) · domini públic
- The editor’s note and the colophon · Postext Cookbook · original
- Imatges
- The plate: the moonlit melon field of the story, a painting · Generated With Diffusion Models · original
- Fonts
- Noto Serif SC (SIL OFL 1.1) · Noto Sans SC (SIL OFL 1.1) · Ma Shan Zheng (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)


