En pocas palabras
El comienzo de un clásico japonés como libro de bolsillo: el texto corre en columnas de arriba abajo, se lee de derecha a izquierda y lleva kana pequeños junto a los caracteres más difíciles.
Lo que vas a componer
Nueve páginas de un libro de bolsillo japonés (文庫, bunko) con las dos primeras noches de Diez noches de sueños de Natsume Sōseki, en una página A6 de 105 × 148 mm encuadernada por la derecha. La portada queda sola a la izquierda del lomo; desde la página 2 el texto corre de arriba abajo en líneas que se leen desde la derecha, 38 caracteres por línea y 15 líneas por página, en Shippori Mincho B1 de 9 pt con un paso de 1,75 em. Las lecturas que Aozora Bunko da para los kanji difíciles van a su lado en kana de medio cuerpo, el título de cada noche ocupa tres líneas de la retícula y las páginas izquierdas llevan el título del libro por el corte delantero, sobre un folio en numerales kanji. El libro de bolsillo europeo con la misma estructura es la Nº 104, y la novela china en vertical, la Nº 075.
Esta receta responde a
- ¿Cómo compongo una novela japonesa en vertical, encuadernada por la derecha, como un bunko de bolsillo?
- ¿Cómo pongo furigana sobre los kanji, una lectura por carácter o una para toda la palabra?
- ¿Cómo convierto un texto de Aozora Bunko en un libro de Postext?
- ¿Cómo hago que un título japonés ocupe tres líneas del texto (3行取り) para que el texto siga en la retícula?
La respuesta corta
// 'vertical-rl' sets each line top to bottom and the lines from right to left; with the
// binding left to 'auto' the book opens from the right, so page 1 is a left-hand page and
// the spreads read [3 | 2]. locale 'ja' gives the cjk settings Japan's values: they are
// written out below so you can see them, and leaving them out sets the same page.
const page = {
sizePreset: 'custom', width: mm(105), height: mm(148), dpi: 200, // 文庫判 A6
backgroundColor: col('paper'),
// 天 above 地; left is the spine side (the right edge of a left-hand page). The grid
// grows the margins of each pair alike, so the head stays deeper than the foot.
margins: { top: mm(15), bottom: mm(11), left: mm(9), right: mm(12), mirror: true },
pageNumbering: { format: 'japanese-informal' }, // folios 一, 二 … 十, 十一
};
const layout = { layoutType: 'single', writingMode: 'vertical-rl' };
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
lineBreak: 'ja-very-strict', // 行頭禁則: no 、。」ー or small kana at the head of a line
hangingPunctuation: 'allow', // ぶら下げ: a 、。 that would open a line hangs below the last
paragraphStartBracket: 'half', // ③: a 「 that opens a paragraph fills the indent cell
ruby: { align: 'jis', overhang: 'kana' }, // JIS 1:2:1, a reading may run onto kana only
};
Ingredientes
- Funciones
- Texto verticalFurigana: lecturas en kana sobre los kanjiTítulos que ocupan líneas del texto (gyōdori)Libros encuadernados por la derechaCorte de líneas japonés (kinsoku)Espaciado de la puntuación japonesa (yakumono)Retícula de caracteresNumerales japoneses y contadores en kanaImportar textos de Aozora BunkoKana, kanji y rōmajiFuentes chinas, japonesas y coreanasRuby: lecturas en pinyin y zhuyinCabeceras y foliosCabeceras según el tipo de páginaMárgenes simétricosEstilos de títuloNiveles de títuloColor del papelPaleta de color semánticaExportación a PDF
- También usa
- Corte de líneas en chinoAnchura de la puntuación chinaAtributos de títuloAperturas diseñadasFuentes incrustadas en el PDFPreliminares en romanosCabeceras por secciónCapítulos sin número
- Tipografía
- Shippori Mincho B1, Noto Sans JP (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Gira la página, cuéntala en caracteres y etiquétala ja
El código es la respuesta corta de arriba. layout.writingMode: 'vertical-rl' compone cada página como una página horizontal girada un cuarto de vuelta en el sentido de las agujas del reloj, y page.binding, que se queda en 'auto', encuaderna a la derecha un libro vertical: la página 1 sigue siendo impar, pero cae a la izquierda del lomo, y mirror: true pone su margen interior a la derecha (Escritura vertical, Encuadernación). La retícula de caracteres hace que la caja mida 38 caracteres de 9 pt hacia abajo (120,7 mm) y 15 líneas de 15,75 pt a lo ancho (83,3 mm); los márgenes de page son mínimos, y la retícula agranda cada pareja en la misma medida, así que la cabeza sigue 4 mm más honda que el pie. Si pides más líneas de las que caben entre los márgenes, la retícula quita una sin avisar en la página (cjkGridClamped en doc.configWarnings): el lomo de 9 mm y el corte de 12 mm son los que dejan sitio a las 15.
locale: 'ja' deja el resto como lo componen los libros japoneses, de modo que las cuatro líneas de cjk escritas aquí no cambian nada: muestran lo que elige la etiqueta. ja-very-strict es la regla de inicio de línea de JIS X 4051 (行頭禁則): ninguna línea empieza por 、。」, ー ni por un kana pequeño como っ. hangingPunctuation: 'allow' deja que un 、 o un 。 que abriría la línea siguiente cuelgue bajo el último carácter (ぶら下げ), que es lo que hacen los bunko en lugar de apretar la línea. paragraphStartBracket: 'half' es el patrón ③ de JLReq: un párrafo que empieza con 「 pone el corchete en la segunda mitad de su sangría de un carácter, y el primer carácter del diálogo queda donde empieza cualquier otro párrafo (Tipografía de Asia oriental). Los libros chinos lo hacen distinto en ambas cosas: no cuelgan ningún signo por defecto y sangran el párrafo dos caracteres, empiece o no con corchete.
#2 · Da a cada título tres líneas de la retícula
// lineSpan sets the heading in a band of three body lines, its characters centred in it, so
// the text after it stands on the grid's lines. Aozora marks the titles 5字下げ (中見出し);
// indent counts body characters, whatever the heading's own size.
const night = {
level: 1, fontFamily: MINCHO, fontWeight: 600, fontSize: pt(12.5),
lineSpan: 3, indent: em(5), // JLReq §4.1.3
breakBefore: { enabled: false }, // the nights run on
};
Un título japonés ocupa un número entero de líneas del texto, 行取り (gyōdori), para que las líneas que lo siguen queden en la misma retícula que las anteriores. lineSpan: 3 compone 第一夜 en una franja de tres líneas de 15,75 pt con sus caracteres centrados en ella; el cuerpo de 12,5 pt del título no mueve la retícula, y en la página 6 第二夜 ocupa las tres primeras líneas de la página, de modo que el texto que lo sigue empieza en la cuarta línea de la retícula. indent: em(5) cuenta caracteres del texto (五字下げ), que es como marca el texto de Aozora un 中見出し y como cuenta JLReq las sangrías de los títulos (Configuración por nivel).
#3 · Trae el texto y sus lecturas de Aozora Bunko
Las dos noches vienen de la ficha 799 de Aozora Bunko, convertida con aozora.py, del skill postext-port. El conversor lee el archivo como CP932, convierte cada lectura escrita 仰向《あおむき》 en una lectura de grupo {仰向|あおむき}, una sola tira de kana sobre toda la palabra, y cada [#5字下げ]…[#「第一夜」は中見出し] en un título. En un documento ja las lecturas siguen JIS X 4051: una lectura más corta que su base se reparte a lo largo de ella en proporción 1:2:1, y una más larga puede invadir un kana vecino, nunca un kanji (Marcas, ruby y warichu). El interlineado de 1,75 em deja 6,75 pt entre líneas, sitio para lecturas de 4,5 pt.
#4 · Pon el hashira en el corte delantero y los folios en kanji
// anchor 'outer' is the fore-edge: the left margin of an odd page, the right of an even one
// in a book bound on the right. The 柱 starts two characters below the head of the text.
const foreEdge = (id, content, parity, edge, y, pages) => ({
kind: 'text', id, content, parity, pages, writingMode: 'vertical-rl',
fontFamily: GOTHIC, fontSize: pt(7), letterSpacing: pt(1), color: col('muted'),
overflow: 'clip', placement: { anchor: { to: 'outer', edge }, offset: { y: em(y) } },
});
const header = { elements: [
foreEdge('hashira', '{title}', 'odd', 'top', 2, 'body'), // never on the opening page
foreEdge('folio', '{pageNumber}', 'all', 'bottom', -2, 'all'),
] };
const none = { elements: [] };
En un bunko vertical la cabecera (柱, hashira) es pequeña y va en el margen exterior. anchor.to: 'outer' coloca allí un elemento, el margen izquierdo de una página impar y el derecho de una par en un libro encuadernado a la derecha, y writingMode: 'vertical-rl' lo compone de arriba abajo (Elementos de texto verticales). El título 夢十夜 va solo en las páginas izquierdas (parity: 'odd'), y pages: 'body' lo apartaría de cualquier página que abra un capítulo. pageNumbering.format: 'japanese-informal' imprime los folios 二, 三 … 九 (Numeración).
#5 · Centra la portada en el formato
// A design on a vertical page is laid out in the flow frame: x runs down the page and y
// across it, leftwards from the right edge. Anchored to the page (the trim), the frame and
// the title stand on the page's axis, 52.5 mm in, whichever side the spine is on.
const at = (down, across) => ({ anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(down), y: mm(across) } });
const AXIS = 105 / 2; // mm
const TITLE = 28 * PT; // mm: 夢十夜 in 28 pt, three characters and two 8 pt gaps down
const frame = { kind: 'box', id: 'frame', placement: { ...at(30, AXIS - 23),
size: { width: mm(88), height: mm(46) } }, // 88 mm down, 46 mm across
style: { borderColor: col('vermilion'), borderWidth: pt(0.75) } };
const titlePage = {
id: 'title', numbered: false, toc: false, span: 'page', header: none, footer: { elements: [
// The colophon across the foot, in the edition's language: each \n in the attribute
// starts a line; the box hangs from the foot of the page, centred.
// Noto Sans JP: Shippori Mincho B1 has no ō or ū for the rōmaji.
{ kind: 'text', id: 'colophon', content: '{attr.colophon}', fontFamily: GOTHIC,
fontSize: pt(5.25), lineHeight: 1.45, color: col('muted'), overflow: 'wrap',
align: 'center', placement: { anchor: { to: 'page', edge: 'bottom' },
offset: { y: mm(-4) }, size: { width: mm(84) } } }] },
breakBefore: { enabled: true, parity: 'any' },
advancedDesign: { enabled: true, minHeight: lines(LINES), slot: { elements: [
frame,
{ kind: 'text', id: 'book', content: '{titleText}', fontFamily: MINCHO, fontWeight: 800,
fontSize: pt(28), lineHeight: 1, letterSpacing: pt(8), color: col('ink'),
placement: at(44, AXIS - TITLE / 2) },
{ kind: 'text', id: 'author', content: '{author}', fontFamily: MINCHO, fontSize: pt(11),
letterSpacing: pt(4), color: col('ink'), placement: at(92, AXIS + TITLE / 2 + 4) },
] } },
};
La portada es un encabezado de primer nivel con estilo propio, # 夢十夜 {style="title" …}, cuyo diseño ocupa la página. Sus elementos se anclan a la página y no a la caja, porque la caja de una página con márgenes simétricos queda 1,5 mm descentrada: x baja por la página e y la cruza desde el borde derecho, así que AXIS es la mitad del ancho de la página, esté el lomo del lado que esté. El colofón del pie va en Noto Sans JP: Shippori Mincho B1 no tiene ō ni ū, y el PDF dibujaría cajas vacías en «Sōseki».
#6 · Carga cada peso con los caracteres que compone
// Fontsource cuts a Japanese face into about 120 files; loadCjkFonts fetches the ones the
// text touches (gotcha: cjk-fonts-slices). vertical: true loads the face's vertical forms
// for the canvas: 、。「」ー and small kana such as っ stand differently down a line.
const title = markdown.match(/^title: "(.*)"$/m)[1];
const author = markdown.match(/^author: "(.*)"$/m)[1];
const heads = markdown.match(/^# [^{\n]*/gm).join('');
await loadFonts(FONTS, markdown); // the Latin files: the colophon, with ō and ū
await loadCjkFonts({ [MINCHO]: ['400'] }, markdown, { vertical: true });
await loadCjkFonts({ [MINCHO]: ['600', '800'] }, `${heads}${title}${author}`);
await loadCjkFonts({ [GOTHIC]: ['400'] }, `${title}一二三四五六七八九十`, { vertical: true });
Fontsource sirve cada peso de una fuente japonesa en unos 120 archivos, cada uno con un tramo de caracteres, y loadCjkFonts descarga los que toca el texto que recibe. El peso del texto recibe toda la muestra con vertical: true, que además carga las formas verticales de la fuente para el canvas: 、。「」 y ー, y los kana pequeños, que en vertical van en la esquina superior derecha de su casilla. renderToPdf recibe cjkPdfProvider, que incrusta esos mismos archivos como subconjuntos.
La receta completa
// ═══ Postext Cookbook · Nº 117 · A bunko novel set vertically, with furigana ════════
// https://postext.dev/en/cookbook/bunko-novel-furigana
// Code: MIT · Text: 夏目漱石『夢十夜』, Aozora Bunko 799 (public domain) · Pictures: none
// Fonts: Shippori Mincho B1, Noto Sans JP (SIL OFL 1.1) · Needs postext ≥ 1.28.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 novel is Japanese in both
const RECIPE = 'bunko-novel-furigana';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: sumi ink on a cream bunko stock, one vermilion
const palette = {
ink: '#1f1b18', // the text: a warm sumi black
vermilion: '#a8392b', // 朱: the frame of the title page
muted: '#6b635b', // the hashira and the folios
paper: '#fbf7ee', // bunko paper is cream, not white
};
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, GOTHIC] = ['Shippori Mincho B1', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [9, 15.75, 38, 15]; // pt, pt: 38字 × 15行 at 1.75 em
const lines = (n) => pt(n * LEAD); // n lines across the page
const PT = 25.4 / 72; // mm in a point
// #region answer: a bunko page, 38 characters down 15 lines, bound on the right
// 'vertical-rl' sets each line top to bottom and the lines from right to left; with the
// binding left to 'auto' the book opens from the right, so page 1 is a left-hand page and
// the spreads read [3 | 2]. locale 'ja' gives the cjk settings Japan's values: they are
// written out below so you can see them, and leaving them out sets the same page.
const page = {
sizePreset: 'custom', width: mm(105), height: mm(148), dpi: 200, // 文庫判 A6
backgroundColor: col('paper'),
// 天 above 地; left is the spine side (the right edge of a left-hand page). The grid
// grows the margins of each pair alike, so the head stays deeper than the foot.
margins: { top: mm(15), bottom: mm(11), left: mm(9), right: mm(12), mirror: true },
pageNumbering: { format: 'japanese-informal' }, // folios 一, 二 … 十, 十一
};
const layout = { layoutType: 'single', writingMode: 'vertical-rl' };
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
lineBreak: 'ja-very-strict', // 行頭禁則: no 、。」ー or small kana at the head of a line
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
#Marca las palabras que el original destaca
Las dos primeras noches de Sōseki no tienen 傍点, pero muchos textos de Aozora sí, y el conversor los escribe :dots[…]{style=sesame}. En un documento ja, *…* da las mismas marcas de sésamo junto a la línea, nunca cursiva.
-こんな夢を見た。
+こんな*夢*を見た。#Pon todos los corchetes un carácter más abajo
El patrón ① conserva la sangría de un carácter y pone el corchete detrás, como en muchas novelas para lectores jóvenes.
- paragraphStartBracket: 'half', // ③: a 「 that opens a paragraph fills the indent cell
+ paragraphStartBracket: 'indent', // ①: the bracket after the one-character indent#Aprieta en lugar de colgar
Con hangingPunctuation: 'none', un 、 o un 。 que abriría la línea entra en la anterior apretando sus corchetes y comas (追い込み), o el último carácter de esa línea baja con él (追い出し), y ningún signo queda bajo la línea.
- hangingPunctuation: 'allow', // ぶら下げ: a 、。 that would open a line hangs below the last
+ hangingPunctuation: 'none',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 →
Error frecuente
Lee los archivos de Aozora como CP932, no como Shift_JIS
Los archivos de texto de Aozora Bunko están en Windows-31J (CP932). Leídos como Shift_JIS a secas, la raya ―― sale como rayas U+2014, ~ como el guion ondulado 〜, y algunos caracteres de NEC e IBM fallan. Léelos como cp932 y convierte después el marcado: el ruby entre 《》, las notas [#…] y los gaiji ※[#…] no son Markdown y se imprimen tal cual si se dejan. aozora.py, de la skill, hace las dos cosas. Importar textos de Aozora Bunko →
Error frecuente
Un intervalo de Fontsource puede nombrar caracteres que su archivo no tiene
Fontsource da a cada archivo un unicode-range, y loadCjkFonts carga los archivos cuyos intervalos cubren la muestra, pero un intervalo puede prometer más de lo que su archivo tiene. El fragmento de Zen Old Mincho para U+3028–303F no tiene 〻 ni las marcas de repetición largas 〳〴〵, y la fuente tampoco tiene las vocales con macrón ō ū ā; el archivo latin-ext de Shippori Mincho B1 trae unos pocos caracteres y ninguno es ō, ū ni ā. Nada falla mientras corre la receta: en pantalla esos caracteres salen de una fuente del sistema y se miden con ella, y el PDF imprime la caja .notdef de la fuente, que solo la comprobación C25 señala después. Busca en la fuente una marca rara o una palabra en rōmaji antes de elegirla (fontTools sobre el archivo de Fontsource) y compón ese texto con una que la tenga: Shippori Mincho B1 y Noto Serif JP tienen 〻 y 〳〴〵; Noto Serif JP y Noto Sans JP, las vocales con macrón. Fuentes chinas, japonesas y coreanas →
Error frecuente
Una página vertical tiene dos marcos: el del texto girado y el de la hoja
Un documento vertical-rl compone el texto como una página horizontal girada un cuarto de vuelta en el sentido de las agujas del reloj, y el diseño de un título (los elementos de advancedDesign.slot) se coloca en ese marco girado: x baja por la página, y la cruza hacia la izquierda desde el borde derecho, y el ancho de un elemento se mide hacia abajo. Los elementos de la cabecera y el pie siguen en la hoja: x avanza hacia la derecha desde el borde izquierdo e y baja desde arriba. Un marco dibujado en la cabecera y un título colocado en el diseño toman, por tanto, sus desplazamientos en ejes distintos. En una portada vertical, ancla los elementos a `page` y mide desde sus bordes: anclados a `container`, los elementos del pie quedan unos milímetros (unos 5 mm) fuera del centro de la caja de texto. Texto vertical →
Créditos
- Receta
- Ignacio Ferro
- Texto
- 夏目漱石『坊っちゃん』 (Botchan, 1906), comienzo del capítulo primero; ficha 752 de Aozora Bunko, según 「ちくま日本文学全集 夏目漱石」 (Chikuma Shobō, 1992), transcripción de 真先芳秋, corrección de 柳沢成雄, convertida con aozora.py · Natsume Sōseki; Aozora Bunko volunteers · dominio público
- Fuentes
- Shippori Mincho B1 (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)


