Saltar al contingut principal
Recepta número 80

Receptari · Capítol 2 · Text i tipografia

Un llibre de lectura vertical amb zhuyin a la dreta

Una lliçó d'un llibre escolar de Taiwan en vertical: {守株|ㄕㄡˇ|ㄓㄨ} posa el zhuyin en columna a la dreta de cada caràcter; a dalt, dibuixos i notes.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Avançat
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0

pp. 86–87 · 1–2 de 4

  • Mostra en castellà: encara no hi ha edició en català
  • Format 184 × 260 mm
  • Columna i mitja, espai entre columnes de 11,3 mm
  • Iansui 16/32
  • Noto Sans TC
  • Noto Serif TC
  • 4 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 138 ms
  • 184 línies de codi

En poques paraules

Un llibre de lectura escolar de Taiwan, escrit en columnes de dalt a baix. Cada caràcter xinès porta al costat una petita guia de pronúncia, perquè els nens llegeixin paraules que encara no coneixen.

Què compondràs

La lliçó 12 del llibre novè de 國語, un llibre taiwanès de lectura de cinquè de primària, inventat: dues faules del Han Feizi, la del pagès de Song que espera una altra llebre al costat d'una soca i la de l'home de Zheng que es fia més de la seva mesura que dels seus peus. A Taiwan aquests llibres es componen en vertical, en lletra Kai, amb el zhuyin de cada caràcter en una columna a la seva dreta, perquè el nen llegeixi un caràcter abans d'aprendre'l. La lliçó s'obre en una doble pàgina amb el llom a la dreta. A dalt, un pis guarda els dibuixos, les notes, l'autor i els caràcters nous; a baix va la lliçó en Iansui de 16 pt, 23 caràcters per línia. La seva parella en escriptura llatina és el llibre de text amb columna al marge: la columna lateral de flotants d'aquella recepta és aquí el pis de dalt, girat un quart de volta.

Aquesta recepta respon a

  • Com poso el zhuyin al costat de cada caràcter d'un text xinès vertical?
  • Com componc un llibre xinès en vertical, enquadernat per la dreta?

La resposta curta

script.js · línies 35–56al codi complet
const layout = {
  writingMode: 'vertical-rl', // lines run down the page, read from the right; bound on the right
  layoutType: 'oneAndHalf', // two tiers: the text below, pictures and notes above
  sideColumnRole: 'floats', sideColumnSide: 'left', // 'left' is the top tier in vertical text
  sideColumnPercent: 34,
  gutterWidth: pt(2 * SIZE),
};
const cjk = {
  // The lower tier: 23 characters down, 13 lines across the page.
  grid: { enabled: true, charsPerLine: 23, linesPerPage: 13 },
  // Readings at half the text size; zhuyin sets its symbols at 60 % of that, 0.3 em,
  // so three symbols fit beside one character, and beside each of two in a row.
  ruby: { fontFamily: ZHUYIN, fontSize: em(0.5) },
};
// The line pitch is twice the size: a gap of one em, which the zhuyin and its tone
// marks half fill. clreq asks for 1.5 em; one em keeps 13 lines of 23 on the page.
const LINE = 2 * SIZE;
const bodyText = {
  fontFamily: KAI, fontSize: pt(SIZE), lineHeight: pt(LINE), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  textAlign: 'justify', firstLineIndent: em(2), indentAfterHeading: true,
};

Ingredients

Tipografia
Iansui, LXGW WenKai TC, Noto Serif TC, Noto Sans TC (SIL OFL 1.1)
Recursos
  • plate-1-1500.jpg
  • plate-2-1500.jpg
  • The farmer waiting by the stump, a brush painting (Generated With Diffusion Models, original)
  • The man of Zheng hurrying home from the shoe stall, a brush painting (Generated With Diffusion Models, original)

Elaboració

#1 · Una columna de zhuyin al costat de cada caràcter

El codi és la resposta curta de més amunt. {宋人|ㄙㄨㄥˋ|ㄖㄣˊ} dona a cada caràcter la seva lectura, una per cada |; la puntuació queda fora de les claus, així que 。 i , no en porten cap. En text vertical, una lectura en bopomofo va a la dreta de la columna, amb els signes l'un sota l'altre, la marca de to a la dreta de l'últim i el punt del to neutre damunt del primer. A la meitat del cos del text, cjk.ruby.fontSize deixa els signes en 0,3 em, així que tres signes caben al costat d'un caràcter, i dues lectures així seguides, com a 就像, guarden entre elles almenys un quart de signe sense eixamplar cap dels dos caràcters; amb 0,6 em, ㄇㄧㄥˊ és més alta que 明 i separa els dos 明 de 明明. L'interlineat de 32 pt deixa un buit d'un quadratí entre línies, que el zhuyin i els seus tons omplen a mitges. clreq demana 1,5 em quan el zhuyin va entre línies verticals; això són 40 pt d'interlineat i deu línies per pàgina, així que aquesta pàgina es queda en un quadratí per encabir-hi 13 línies de 23, i cada lectura queda a uns 8 pt de la línia veïna.

#2 · Dibuixos i notes al pis de dalt

script.js · línies 60–74al codi complet
const resourceTypes = [{ id: 'plate', name: '插圖', shortLabel: '圖', numberingTemplate: '{n}',
  resetOn: 'never', counterFormat: 'decimal', captionPrefix: '' }]; // no prefix, no caption
const box = (id, title, body) => ({ id, title, background: col('tint'),
  padding: { top: mm(3), right: mm(3), bottom: mm(3), left: mm(3) },
  titleStyle: { fontFamily: HEI, fontSize: pt(11), fontWeight: 700, color: col('accent') },
  body: { color: col('ink'), firstLineIndent: pt(0), textAlign: 'left', boldColor: col('ink'),
    italicColor: col('ink'), ...body } });
// Zhuyin is 0.3 em of the text it reads: at 13 pt the notes' readings are 3.9 pt.
const calloutStyles = [ // fenced :::callout{type="notes" span="side"} in the text
  box('notes', '注釋', { fontFamily: MING, fontSize: pt(13), lineHeight: pt(24) }),
  box('author', '作者', { fontFamily: MING, fontSize: pt(13), lineHeight: pt(24),
    textAlign: 'justify', firstLineIndent: em(2) }),
  box('chars', '生字', { fontFamily: KAI, fontSize: pt(22), lineHeight: pt(40),
    textAlign: 'center' }),
];

En text vertical, les columnes d'una maquetació oneAndHalf són pisos, i sideColumnSide: 'left' posa a dalt el que només admet flotants. ::resource{id="plate-1"} al text hi envia el primer dibuix; el tipus plate no té prefix de peu i els dibuixos no porten peu, així que a sota no s'imprimeix res. Un requadre obert amb span="side" cau al pis a partir de la línia on s'obre, i el seu text corre cap avall dins del pis. Les notes de les dues faules van en un sol requadre, numerades correlativament; s'obre després del primer original, que acaba a la pàgina 86, i omple el pis de la pàgina 87, així que les notes de cada faula queden a la doble pàgina del seu original. El zhuyin fa 0,3 em del text que llegeix i cjk.ruby és un paràmetre per a tot el llibre, així que les notes i el requadre de l'autor van en 13 pt perquè les seves lectures no baixin de 3,9 pt.

#3 · Quatre fonts, cadascuna carregada amb el seu text

script.js · línies 270–289al codi complet
// {株|ㄓㄨ}: the characters are the text, the readings go to the zhuyin face.
const BOXES = /^:::callout\{type="(?:notes|author)"[^}]*\}\n([\s\S]*?)^:::$/gm;
const bases = (md) => md.replace(/\{([^|{}]+)((?:\|[^|{}]+)+)\}/g, '$1');
const readings = [...markdown.matchAll(/\{[^|{}]+((?:\|[^|{}]+)+)\}/g)].map((m) => m[1]).join('');
await loadFonts(FONTS, markdown);
await loadCjkFonts({ [KAI]: ['400'] }, bases(markdown.replace(BOXES, '')), { vertical: true });
const notesText = [...markdown.matchAll(BOXES)].map((m) => m[1]).join('\n');
await loadCjkFonts({ [MING]: ['400'] }, bases(notesText), { vertical: true });
await loadCjkFonts({ [ZHUYIN]: ['400'] }, readings.replaceAll('|', ''), { vertical: true });
await loadCjkFonts({ [HEI]: ['400', '700'] }, LABELS, { vertical: true });
await Promise.all(Object.values(plates).map((fileId) => loadImage(fileId, asset(fileId))));
// Lesson 12 of a reader: page 86 is a verso, so the lesson opens on a spread.
const continuation = { pageIndexOffset: 1, pageNumbering: { startAt: 86 } };
const doc = await withLoadedFonts(
  () => buildDocument({ markdown, resources, continuation }, config()),
  { ...kitFonts(FONTS), text: markdown });
showBook(doc, { title: t({ en: 'A vertical reader with zhuyin',
  es: 'Un libro de lectura vertical con zhuyin' }) });
offerPdf(() => renderToPdf(doc, { fontProvider: cjkPdfProvider, resourceBytes: imageBytes }),
  `${RECIPE}.pdf`);

La lliçó va en Iansui, una lletra Kai dibuixada a partir de Klee One amb les formes estàndard de Taiwan, les que els nens aprenen a escriure. Les lectures van en LXGW WenKai TC, que manté rodó el punt de to neutre a 4,8 pt; les notes, en Noto Serif TC, i les etiquetes, en Noto Sans TC. Cada font carrega els fitxers que tenen els caràcters que compon: les lectures se separen dels seus caràcters i els requadres de notes van només a la font Ming. vertical: true hi afegeix les formes verticals, perquè 「」 i 、 quedin bé a la columna. pageIndexOffset: 1 fa de la pàgina 86 una pàgina parella, així que la lliçó s'obre en una doble pàgina.

#4 · La pestanya i els folis a la vora exterior

script.js · línies 78–103al codi complet
// The verso lies on the right of the spread, so even pages carry both at the right edge.
const tab = (parity, edge) => [
  { kind: 'box', id: `tab-${parity}`, parity, pages: 'all',
    placement: { anchor: { to: 'page', edge }, offset: { y: mm(24) },
      size: { width: mm(9), height: mm(64) } }, style: { backgroundColor: col('accent') } },
  { kind: 'text', id: `unit-${parity}`, content: '第三單元 寓言故事', parity, pages: 'all',
    writingMode: 'vertical-rl', fontFamily: HEI, fontSize: pt(9), fontWeight: 700,
    color: col('paper'), align: 'center', verticalAlign: 'middle',
    placement: { anchor: { to: `#tab-${parity}`, edge: 'align-top' },
      size: { width: mm(9), height: mm(64) } } },
];
const foot = (id, parity, edge, x, content, extra = {}) => ({
  kind: 'text', id, content, parity, pages: 'all', fontFamily: HEI, fontSize: pt(8),
  color: col('muted'), placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(-9) } },
  ...extra,
});
const folio = { fontSize: pt(9), fontWeight: 700 };
const header = { elements: [...tab('even', 'top-right'), ...tab('odd', 'top-left')] };
const footer = {
  elements: [
    foot('folio-even', 'even', 'bottom-right', -16, '{pageNumber}', folio),
    foot('book', 'even', 'bottom-right', -26, '國語 第九冊'),
    foot('folio-odd', 'odd', 'bottom-left', 16, '{pageNumber}', folio),
    foot('lesson', 'odd', 'bottom-left', 26, '{chapterNumber} {chapterTitle}'),
  ],
};

En un llibre amb el llom a la dreta, la pàgina parella queda a la dreta de la doble pàgina, així que les parelles porten la pestanya de la unitat i el foli a la vora dreta i les senars a l'esquerra. La pestanya és una caixa amb un element de text a sobre; writingMode: 'vertical-rl' a l'element compon 第三單元 寓言故事 de dalt a baix, mentre que els folis i les línies del peu continuen en horitzontal. Els números de la lliçó i de les faules surten del numberingTemplate dels títols (第{1:一}課 i {2:一}, amb un espai ideogràfic com a numberSeparator i {startAt=12} a la lliçó), separats del títol, de manera que el zhuyin de 寓 queda sobre 寓; la línia del peu de les senars imprimeix {chapterNumber} {chapterTitle}, perquè {chapterTitle} deixa fora el número.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 080 · A vertical reader with zhuyin to the right ═════════
// https://postext.dev/en/cookbook/zhuyin-vertical-reader
// Code: MIT · Text: Han Feizi, zh.wikisource (CC BY-SA 4.0) · Pictures: diffusion models
// Fonts: Iansui, LXGW WenKai TC, Noto Serif TC, Noto Sans TC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage, 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 = 'zhuyin-vertical-reader';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: semantic colours, every one linked by id
const palette = {
  ink: '#2b2520', // text and zhuyin
  accent: '#b83f28', // lesson title, labels, the unit's tab (4.9:1 on the tint)
  tint: '#f7efdf', // the boxes of the upper tier
  muted: '#72675b', // lead, folios, colophon
  paper: '#ffffff', // the lettering on the tab
};
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: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
// #endregion
const KAI = 'Iansui'; // 楷: the lesson, drawn to Taiwan's standard forms (為, not 爲)
const ZHUYIN = 'LXGW WenKai TC'; // the readings: a round dot for the neutral tone
const MING = 'Noto Serif TC'; // 明: notes and the author box
const HEI = 'Noto Sans TC'; // 黑: labels, folios, the tab
const SIZE = 16; // the text size (三號)

// #region answer: vertical text with a zhuyin column right of every character
const layout = {
  writingMode: 'vertical-rl', // lines run down the page, read from the right; bound on the right
  layoutType: 'oneAndHalf', // two tiers: the text below, pictures and notes above
  sideColumnRole: 'floats', sideColumnSide: 'left', // 'left' is the top tier in vertical text
  sideColumnPercent: 34,
  gutterWidth: pt(2 * SIZE),
};
const cjk = {
  // The lower tier: 23 characters down, 13 lines across the page.
  grid: { enabled: true, charsPerLine: 23, linesPerPage: 13 },
  // Readings at half the text size; zhuyin sets its symbols at 60 % of that, 0.3 em,
  // so three symbols fit beside one character, and beside each of two in a row.
  ruby: { fontFamily: ZHUYIN, fontSize: em(0.5) },
};

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 el zhuyin en un altre color

Alguns llibres imprimeixen les lectures més clares que el text, perquè els caràcters destaquin.

-  ruby: { fontFamily: ZHUYIN, fontSize: em(0.5) },
+  ruby: { fontFamily: ZHUYIN, fontSize: em(0.5), color: col('muted') },

#Posa les lectures sobre text horitzontal

La cartilla amb pinyin posa una síl·laba sobre cada caràcter en línies horitzontals, com les primeres cartilles de la Xina continental i Hong Kong.

Errors freqüents

Error freqüent

Les lectures s'imprimeixen al text, no en dissenys, peus ni cel·les

Les lectures ruby es dibuixen en paràgrafs, títols, elements de llista, cites i requadres. Un element de text d'un disseny (una obertura, una capçalera, una etiqueta), un peu, una nota a peu de pàgina i una cel·la de taula imprimeixen els caràcters base sense les seves lectures. Un títol que necessita el seu pinyin és un títol sense disseny propi: dibuixa el que l'envolta (una banda, el número de la lliçó) amb el disseny del títol anterior, els elements del qual amb reserve: false es pinten sota el text d'una obertura span: 'page'. Ruby: lectures en pinyin i zhuyin →

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 →

  • Pren les lectures del diccionari de Taiwan. Les eines fetes sobre diccionaris del continent, pypinyin entre elles, donen 度 duó, 寧 nìng, 時候 shíhou i 市場 shìchǎng; el Diccionari Revisat de Xinès Mandarí del Ministeri d'Educació, que segueixen els llibres de Taiwan, llegeix ㄉㄨㄛˋ, ㄋㄧㄥˊ, ㄕˊ ㄏㄡˋ i ㄕˋ ㄔㄤˊ, i posa en to neutre la segona síl·laba de 故事, 家裡 i 過來. moedict.tw el serveix paraula per paraula. Manté 一 i 不 en el seu to propi, i aquesta lliçó també.

  • Dibuixa uns quants caràcters en cada font abans de barrejar-les. LXGW WenKai TC segueix les formes heretades i dibuixa 為 (U+70BA) com 爲, així que una lliçó composta amb aquesta font imprimia 爲宋國笑 al text i 為宋國笑 a la nota en Ming de la mateixa doble pàgina. Iansui dibuixa el 為 estàndard.

  • Iansui té un sol gruix. Els títols destaquen per la mida i els lemes de les frases fetes pel color: l'estil idiom fixa boldFontWeight: 400 amb l'accent com a boldColor, així que **…** canvia el color i no la lletra.

Crèdits

Text
Imatges
  • The farmer waiting by the stump, a brush painting · Generated With Diffusion Models · original
  • The man of Zheng hurrying home from the shoe stall, a brush painting · Generated With Diffusion Models · original
Fonts
Iansui (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1) · Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1)
SandboxPDF