Saltar al contenido principal
Receta número 122

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

Kanbun con sus marcas de lectura y la lectura japonesa

Tres dichos de las Analectas y una cuarteta Tang como en un libro escolar japonés: marcas de retorno y okurigana en bermellón, y la lectura en kana debajo.

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

p. 一 · 1 de 3

  • Formato 148 × 210 mm
  • 1 columna
  • Klee One 10,5/21
  • Noto Sans JP
  • Zen Old Mincho
  • 3 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 55 ms
  • 131 líneas de código

En pocas palabras

El chino clásico como lo aprenden los lectores japoneses: unas marcas rojas pequeñas junto a los caracteres dicen en qué orden leerlos y qué terminaciones japonesas añadir, y la lectura japonesa completa sigue a cada pasaje.

Lo que vas a componer

Tres páginas de un libro escolar japonés de 漢文 (kanbun), el chino clásico leído como japonés, en una página A5 encuadernada por la derecha: tres dichos de las Analectas y la cuarteta Amanecer de primavera de Meng Haoran. Cada pasaje va en Zen Old Mincho de 15 pt, en el orden chino, con sus 訓点 (kunten) junto a los caracteres, en bermellón y a la mitad de su tamaño: las marcas de retorno (返り点) abajo a la izquierda de un carácter dicen a quien lee que siga y vuelva a él, y el okurigana (送り仮名) a su derecha añade las terminaciones japonesas. Bajo cada pasaje, su 書き下し文 (yomikudashi), el mismo texto escrito como japonés, va en Klee One, una letra escolar, con furigana donde la lectura es difícil. Los clásicos chinos con sus propias ayudas de lectura son la Nº 080.

Esta receta responde a

  • ¿Cómo imprimo kanbun con sus marcas de retorno y su okurigana?
  • ¿Cómo pongo furigana sobre los kanji, una lectura por carácter o una para toda la palabra?

La respuesta corta

script.js · líneas 32–52en el código completo
// :kunten[習]{kaeri="レ" okuri="フ"} sets the return mark small at the character's lower
// left and the okurigana at its lower right, down the line; the text keeps its Chinese
// order, which the reader follows by the marks. cjk.kunten sizes and colours them: half
// the character, in vermilion. The Japanese reading under each passage is plain kana and
// kanji with furigana: {君子|くん|し} gives each character its reading (jukugo ruby).
const cjk = {
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
  kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
};
const paragraphStyles = [
  // The text: 15 pt on a pitch of two grid lines, room for the okurigana beside it. A
  // quatrain takes two lines, a couplet to the line with a space between its verses.
  { id: 'kanbun', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
    firstLineIndent: em(0), textAlign: 'justify' },
  { id: 'shi', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
    indent: em(2), firstLineIndent: em(0), marginTop: pt(0), marginBottom: pt(0) },
  // The reading (書き下し文), two characters down in a school-book hand.
  { id: 'kudashi', indent: em(2), firstLineIndent: em(0), marginTop: pt(LEAD) },
  { id: 'kudashi-shi', indent: em(4), firstLineIndent: em(0), marginTop: pt(0),
    marginBottom: pt(0) },
];

Ingredientes

Tipografía
Zen Old Mincho, Klee One, Noto Sans JP (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Marca cada carácter con :kunten

El código es la respuesta corta de arriba. :kunten[習]{kaeri="レ" okuri="フ"} da a 習 la marca de retorno レ y el okurigana フ; el texto conserva el carácter, así que la búsqueda, la copia y el PDF leen el pasaje tal como está escrito, y las marcas no ocupan ningún carácter suyo (Marcas, ruby y warichu). Lee 学ビテ而時ニ習フレ之ヲ: la レ de 習 manda leer antes 之 y volver, 之を習ふ; 而 no lleva marca y no se lee. En vertical la marca de retorno va abajo a la izquierda de su carácter y ocupa medio carácter de la línea, y el okurigana va a la derecha, empezando a media altura del carácter, como los compone JIS X 4051. cjk.kunten fija su tamaño, la mitad del texto, y su color, el bermellón con que las escribe un lector; un pasaje va en 15 pt sobre dos líneas de la retícula, lo que deja 27 pt junto a cada línea para el okurigana.

#2 · Salta con 一 二 y con 一レ

Los números llevan a quien lee más atrás. En 不二亦タ説バシカラ一乎 se salta 不, que lleva 二, se lee 亦た説ばしから y en el 一 se vuelve a 不: 亦た説ばしからずや. En 為政 la marca combinada 一レ de 為 hace las dos cosas: 可二以テ為一レ師ト矣 se lee 以て, 師と (レ), 為る y de vuelta a 可 (de 一 a 二), 以て師と為るべし. Los puntos de código de kanbun ㆑ ㆒ ㆓ se leen como los caracteres que representan, así que un texto copiado de otra parte conserva sus marcas.

#3 · Deja que un okurigana largo empuje al carácter siguiente

Un okurigana más largo que su carácter no corre junto al siguiente: en 花落ツルコト知ル多少 los cuatro kana de ツルコト ocupan dos caracteres de largo, y 知 baja para empezar tras ellos, como lo compone JIS X 4051 (§5.6.4). La línea crece, y su corte se mueve con ella.

#4 · Da a cada pasaje una etiqueta de dos líneas

script.js · líneas 56–70en el código completo
const at = (down, across) => ({ anchor: { to: 'container', edge: 'top-left' },
  offset: { x: pt(down), y: pt(across) } });
const TITLE = 26; // pt
const part = { level: 1, breakBefore: { enabled: true, parity: 'any' },
  advancedDesign: { enabled: true, minHeight: pt(5 * LEAD), slot: { elements: [
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: MINCHO, fontWeight: 700,
      fontSize: pt(TITLE), lineHeight: 1, letterSpacing: pt(TITLE / 2), color: col('ink'),
      placement: at(2 * BODY, 2 * LEAD - TITLE / 2) },
    { kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: GOTHIC, fontSize: pt(8.5),
      letterSpacing: pt(2), color: col('vermilion'), placement: at(2 * BODY + 3 * TITLE + 18,
        2 * LEAD - 8.5 / 2) },
  ] } } };
// 2行取り, the passage's book and number in gothic, two characters down.
const passage = { level: 2, fontFamily: GOTHIC, fontWeight: 700, fontSize: pt(9.5),
  color: col('muted'), lineSpan: 2, indent: em(2) };

Cada libro de la antología abre página con su título, 論語 o 唐詩, el primero con una nota bermellón pequeña sobre lo que contiene; cada pasaje lleva una etiqueta en gótica de dos líneas del texto (2行取り), 学而第一 o 春暁 孟浩然, para que los pasajes que siguen queden en la retícula. La lectura es un contenedor :::paragraphs{style="kudashi"} dos caracteres más abajo, en la letra y el cuerpo del texto, con furigana jukugo: {君子|くん|し} da a cada carácter su propia lectura, de modo que una línea podría cortarse entre ellos.

#5 · Carga cada voz con sus caracteres

script.js · líneas 173–186en el código completo
const FENCE = /:::paragraphs\{style="([\w-]+)"\}\n([\s\S]*?)\n:::/g;
const fence = (style) => [...markdown.matchAll(FENCE)].filter((m) => m[1] === style)
  .map((m) => m[2]).join('');
const kanbun = `${fence('kanbun')}${fence('shi')}`; // the text and its marks' kana
const reading = `${fence('kudashi')}${fence('kudashi-shi')}`;
const heads = markdown.match(/^#+ [^{\n]*/gm).join('');
const colophon = markdown.match(/colophon="([^"]*)"/)[1];
await loadFonts(FONTS, markdown); // the Latin files: the colophon
await loadCjkFonts({ [MINCHO]: ['400'] }, kanbun, { vertical: true });
await loadCjkFonts({ [MINCHO]: ['700'] }, heads);
await loadCjkFonts({ [KYOKASHO]: ['400'] }, reading, { vertical: true });
await loadCjkFonts({ [GOTHIC]: ['400', '700'] },
  `${heads}${colophon}${markdown.match(/kicker="([^"]*)"/)[1]}漢文訓読一二三四五六七八九十`,
  { vertical: true });

El texto clásico y la lectura van en letras distintas, así que cada una carga los archivos de sus propios caracteres: Zen Old Mincho para los pasajes y sus marcas, cuyos kana van dentro de los atributos de :kunten; Klee One para las lecturas y su furigana; Noto Sans JP para las etiquetas. La cuarteta va con dos versos por línea y un espacio ideográfico entre ellos, una forma habitual de imprimirla, para que el poema y su lectura quepan en la página bajo el título.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 122 · Kanbun with its reading marks, and the Japanese reading ═══
// https://postext.dev/en/cookbook/kanbun-kundoku
// Code: MIT · Text: 論語, 孟浩然「春暁」 (public domain); kunten and readings CC BY 4.0
// Fonts: Zen Old Mincho, Klee One, Noto Sans JP (SIL OFL 1.1) · Needs postext ≥ 1.25.0
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 colophon; the page is Japanese in both
const RECIPE = 'kanbun-kundoku';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, the vermilion of hand-written kunten, a school-book paper
const palette = {
  ink: '#1e1c1a', // the text
  vermilion: '#c0392b', // 朱: the reading marks, as a reader adds them by hand
  muted: '#6a635c', // the headings' labels, the folios
  paper: '#fcfbf7',
};
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: 'defaults', value: { hex: palette.vermilion, model: 'hex' } },
];
// #endregion
const [MINCHO, KYOKASHO, GOTHIC] = ['Zen Old Mincho', 'Klee One', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [10.5, 21, 36, 16]; // pt, pt: 36字 × 16行, a 2 em pitch
const KANBUN = 15; // pt: the classical text, set larger on two lines of the grid

// #region answer: kanbun with 返り点 and 送り仮名, its yomikudashi beside it in furigana
// :kunten[習]{kaeri="レ" okuri="フ"} sets the return mark small at the character's lower
// left and the okurigana at its lower right, down the line; the text keeps its Chinese
// order, which the reader follows by the marks. cjk.kunten sizes and colours them: half
// the character, in vermilion. The Japanese reading under each passage is plain kana and
// kanji with furigana: {君子|くん|し} gives each character its reading (jukugo ruby).
const cjk = {
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
  kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
};
const paragraphStyles = [
  // The text: 15 pt on a pitch of two grid lines, room for the okurigana beside it. A
  // quatrain takes two lines, a couplet to the line with a space between its verses.
  { id: 'kanbun', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
    firstLineIndent: em(0), textAlign: 'justify' },
  { id: 'shi', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
    indent: em(2), firstLineIndent: em(0), marginTop: pt(0), marginBottom: pt(0) },
  // The reading (書き下し文), two characters down in a school-book hand.

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 las marcas en negro

Un libro impreso compone los kunten con la tinta del texto; quita el color.

-  kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
+  kunten: { fontSize: em(0.5), placement: 'inline' },

#Pon las marcas entre las líneas

placement: 'interlinear' saca las marcas de retorno de la línea al hueco junto a la mitad inferior del carácter, de modo que el pasaje conserva el espaciado del texto desnudo (白文). JIS las pone en la línea, el valor por defecto.

-  kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
+  kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'interlinear' },

Errores frecuentes

Error frecuente

Etiqueta un texto japonés 'ja', nunca zh-Hans ni LANG

Las ediciones de una receta son en y es, pero una muestra japonesa es japonesa en las dos: `locale: LANG` la etiquetaría como inglés o español, y una etiqueta china la compondría con las reglas chinas (puntuación Kaiming, kana pequeño libre de empezar línea, 图 en lugar de 図, formas chinas de los caracteres en el PDF). 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 cualquier etiqueta que no sea 'ja' da otras formas de glifo que las japonesas (las chinas, con una etiqueta china) y otros cortes de línea. Escribe 'ja': elige la región de Japón (corte y puntuación de la JLReq, puntos de sésamo, reparto de los furigana, etiquetas 図 y 表) y desactiva la separación silábica. El lint falla un texto con kana bajo una etiqueta zh o ko. Corte de líneas japonés (kinsoku) →

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 →

Créditos

Texto
  • 論語 (las Analectas de Confucio), 學而 1 y 3, 爲政 11, y 孟浩然「春曉」 (Amanecer de primavera), en shinjitai; los kunten (返り点, 送り仮名) y el yomikudashi siguen la lectura escolar japonesa habitual y se compusieron para esta receta (CC BY 4.0) · Confucius and his disciples; Meng Haoran; Ignacio Ferro (kunten and reading) · dominio público
Fuentes
Zen Old Mincho (SIL OFL 1.1) · Klee One (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
SandboxPDF