Saltar al contenido principal
Receta número 80

Recetario · Capítulo 2 · Texto y tipografía

Un libro de lectura vertical con zhuyin a la derecha

Una lección de un libro escolar de Taiwán en vertical: {守株|ㄕㄡˇ|ㄓㄨ} pone el zhuyin en columna a la derecha de cada carácter; arriba, dibujos y notas.

En esta página
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Licencia
Actualizada el 10 oct 2026
Código MIT · Texto CC BY 4.0

pp. 86–87 · 1–2 de 4

  • Formato 184 × 260 mm
  • Columna y media, medianil de 11,3 mm
  • Iansui 16/32
  • Noto Sans TC
  • Noto Serif TC
  • 4 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 138 ms
  • 184 líneas de código

En pocas palabras

Un libro de lectura escolar de Taiwán, escrito en columnas de arriba abajo. Cada carácter chino lleva al lado una pequeña guía de pronunciación, para que los niños lean palabras que aún no conocen.

Lo que vas a componer

La lección 12 del libro noveno de 國語, un libro taiwanés de lectura de quinto de primaria, inventado: dos fábulas del Han Feizi, la del campesino de Song que espera otra liebre junto a un tocón y la del hombre de Zheng que se fía más de su medida que de sus pies. En Taiwán estos libros se componen en vertical, en letra Kai, con el zhuyin de cada carácter en una columna a su derecha, para que el niño lea un carácter antes de aprenderlo. La lección se abre en una doble página con el lomo a la derecha. Arriba, un piso guarda los dibujos, las notas, el autor y los caracteres nuevos; abajo va la lección en Iansui de 16 pt, 23 caracteres por línea. Su pareja en escritura latina es el libro de texto con columna al margen, cuya columna lateral de flotantes es aquí el piso de arriba, girado un cuarto de vuelta.

Esta receta responde a

  • ¿Cómo pongo el zhuyin junto a cada carácter de un texto chino vertical?
  • ¿Cómo compongo un libro chino en vertical, encuadernado por la derecha?

La respuesta corta

script.js · líneas 35–56en el código completo
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,
};

Ingredientes

Tipografía
Iansui, LXGW WenKai TC, Noto Serif TC, Noto Sans TC (SIL OFL 1.1)
Recursos
  • plate-1-1500.jpg
  • plate-2-1500.jpg
  • El campesino que espera junto al tocón, una pintura a pincel (Generated With Diffusion Models, original)
  • El hombre de Zheng que vuelve deprisa del puesto de zapatos, una pintura a pincel (Generated With Diffusion Models, original)

Elaboración

#1 · Una columna de zhuyin junto a cada carácter

El código es la respuesta corta de arriba. {宋人|ㄙㄨㄥˋ|ㄖㄣˊ} da a cada carácter su lectura, una por cada |; la puntuación queda fuera de las llaves, así que 。 y , no llevan ninguna. En texto vertical, una lectura en bopomofo va a la derecha de la columna, con los signos uno debajo de otro, la marca de tono a la derecha del último y el punto del tono neutro encima del primero. A la mitad del cuerpo del texto, cjk.ruby.fontSize deja los signos en 0,3 em, así que tres signos caben junto a un carácter, y dos lecturas así seguidas, como en 就像, guardan entre sí al menos un cuarto de signo sin ensanchar ninguno de los dos caracteres; con 0,6 em, ㄇㄧㄥˊ es más alta que 明 y separa los dos 明 de 明明. El interlineado de 32 pt deja un hueco de un cuadratín entre líneas, que el zhuyin y sus tonos llenan a medias. clreq pide 1,5 em cuando el zhuyin va entre líneas verticales; eso son 40 pt de interlineado y diez líneas por página, así que esta página se queda en un cuadratín para meter 13 líneas de 23, y cada lectura queda a unos 8 pt de la línea vecina.

#2 · Dibujos y notas en el piso de arriba

script.js · líneas 60–74en el código completo
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 texto vertical, las columnas de una maquetación oneAndHalf son pisos, y sideColumnSide: 'left' pone arriba el que solo admite flotantes. ::resource{id="plate-1"} en el texto manda allí el primer dibujo; el tipo plate no tiene prefijo de pie y los dibujos no llevan pie, así que debajo no se imprime nada. Un recuadro abierto con span="side" cae en el piso a partir de la línea donde se abre, y su texto corre hacia abajo dentro del piso. Las notas de las dos fábulas van en un solo recuadro, numeradas de corrido; se abre tras el primer original, que termina en la página 86, y llena el piso de la página 87, así que las notas de cada fábula quedan en la doble página de su original. El zhuyin mide 0,3 em del texto que lee y cjk.ruby es un ajuste para todo el libro, así que las notas y el recuadro del autor van en 13 pt para que sus lecturas no bajen de 3,9 pt.

#3 · Cuatro fuentes, cada una cargada con su texto

script.js · líneas 270–289en el código completo
// {株|ㄓㄨ}: 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 lección va en Iansui, una letra Kai dibujada a partir de Klee One con las formas estándar de Taiwán, las que los niños aprenden a escribir. Las lecturas van en LXGW WenKai TC, cuyo punto de tono neutro sigue redondo a 4,8 pt; las notas, en Noto Serif TC, y las etiquetas, en Noto Sans TC. Cada fuente carga los archivos que tienen los caracteres que compone: las lecturas se separan de sus caracteres y los recuadros de notas van solo a la fuente Ming. vertical: true añade las formas verticales, para que 「」 y 、 queden bien en la columna. pageIndexOffset: 1 hace de la página 86 una página par, así que la lección se abre en una doble página.

#4 · La pestaña y los folios en el borde exterior

script.js · líneas 78–103en el código completo
// 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 libro con el lomo a la derecha, la página par queda a la derecha de la doble página, así que las pares llevan la pestaña de la unidad y el folio en el borde derecho y las impares en el izquierdo. La pestaña es una caja con un elemento de texto encima; writingMode: 'vertical-rl' en el elemento compone 第三單元 寓言故事 de arriba abajo, mientras los folios y las líneas del pie siguen en horizontal. Los números de la lección y de las fábulas salen del numberingTemplate de los títulos (第{1:一}課 y {2:一}, con un espacio ideográfico como numberSeparator y {startAt=12} en la lección), aparte del título, de modo que el zhuyin de 寓 queda sobre 寓; la línea del pie de las impares imprime {chapterNumber} {chapterTitle}, porque {chapterTitle} deja fuera el número.

La receta 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) },
};

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

Algunos libros imprimen las lecturas más claras que el texto, para que los caracteres destaquen.

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

#Pon las lecturas sobre texto horizontal

La cartilla con pinyin pone una sílaba sobre cada carácter en líneas horizontales, como las primeras cartillas de China continental y Hong Kong.

Errores frecuentes

Error frecuente

Las lecturas se imprimen en el texto, no en diseños, pies ni celdas

Las lecturas ruby se dibujan en párrafos, títulos, elementos de lista, citas y recuadros. Un elemento de texto de un diseño (una apertura, una cabecera, una etiqueta), un pie, una nota al pie y una celda de tabla imprimen los caracteres base sin sus lecturas. Un título que necesita su pinyin es un título sin diseño propio: dibuja lo que lo rodea (una banda, el número de la lección) con el diseño del título anterior, cuyos elementos con reserve: false se pintan bajo el texto de una apertura span: 'page'. Ruby: lecturas en pinyin y zhuyin →

Error frecuente

En texto vertical la columna lateral es un piso, y 'left' es el de arriba

Con layout.writingMode 'vertical-rl' la página es una página horizontal girada un cuarto de vuelta, así que la columna lateral de una disposición oneAndHalf pasa a ser un piso que cruza la página: sideColumnSide 'left' la pone arriba, donde van los comentarios del margen superior (眉批), y 'right' al pie. 'outer' e 'inner' se leen como 'right' y 'left' (un piso no tiene borde exterior), así que el 'outer' de la columna de notas de un libro de texto manda las notas al pie. sideColumnPercent es una fracción de la altura de la página. Columna al margen para flotantes →

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

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 →

  • Toma las lecturas del diccionario de Taiwán. Las herramientas hechas sobre diccionarios del continente, pypinyin entre ellas, dan 度 duó, 寧 nìng, 時候 shíhou y 市場 shìchǎng; el Diccionario Revisado de Chino Mandarín del Ministerio de Educación, que siguen los libros de Taiwán, lee ㄉㄨㄛˋ, ㄋㄧㄥˊ, ㄕˊ ㄏㄡˋ y ㄕˋ ㄔㄤˊ, y pone en tono neutro la segunda sílaba de 故事, 家裡 y 過來. moedict.tw lo sirve palabra por palabra. Mantiene 一 y 不 en su tono propio, y esta lección también.

  • Dibuja unos cuantos caracteres en cada fuente antes de mezclarlas. LXGW WenKai TC sigue las formas heredadas y dibuja 為 (U+70BA) como 爲, así que una lección compuesta con ella imprimía 爲宋國笑 en el texto y 為宋國笑 en la nota en Ming de la misma doble página. Iansui dibuja el 為 estándar.

  • Iansui tiene un solo grosor. Los títulos destacan por el tamaño y los lemas de las frases hechas por el color: el estilo idiom fija boldFontWeight: 400 con el acento como boldColor, así que **…** cambia el color y no la letra.

Créditos

Texto
Imágenes
  • El campesino que espera junto al tocón, una pintura a pincel · Generated With Diffusion Models · original
  • El hombre de Zheng que vuelve deprisa del puesto de zapatos, una pintura a pincel · Generated With Diffusion Models · original
Fuentes
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