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
// :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
- Funciones
- Marcas de lectura del kanbun (kunten)Furigana: lecturas en kana sobre los kanjiTexto verticalLibros encuadernados por la derechaRuby: lecturas en pinyin y zhuyinEstilos de párrafoTítulos que ocupan líneas del texto (gyōdori)Kana, kanji y rōmajiCorte de líneas japonés (kinsoku)Numerales japoneses y contadores en kanaRetícula de caracteresFuentes chinas, japonesas y coreanasEstilos de títuloAperturas diseñadasCabeceras y foliosCabeceras según el tipo de páginaMárgenes simétricosPaleta de color semánticaExportación a PDF
- También usa
- Corte de líneas en chinoAtributos de títuloColor del papelFuentes incrustadas en el PDFPreliminares en romanosCabeceras por sección
- 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
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
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
// ═══ 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
- Receta
- Ignacio Ferro
- 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)
- 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)


