En pocas palabras
Un libro ilustrado japonés para niños pequeños, todo en hiragana, con un espacio tras cada grupo de palabras y líneas que nunca lo parten, bajo un dibujo en cada página.
Lo que vas a componer
Un libro ilustrado de diez páginas, かみの ふね (El barco de papel), escrito para la receta e ilustrado con diez pinturas: después de la lluvia una niña dobla un barco de papel rojo, y el barco baja por el río, deja atrás una rana, una garza y la luna, y llega al mar. Está compuesto como los libros japoneses para los lectores más pequeños: solo hiragana, a 20 pt en Klee One, una letra hecha a partir del modelo de los libros de texto escolares, y un espacio entre frases, 分かち書き (wakachigaki), para que el niño lea frase a frase. Las páginas son apaisadas, de 260 × 200 mm, en vertical y encuadernadas por la derecha: el dibujo arriba, debajo líneas cortas de ocho caracteres, y el barco avanza hacia la izquierda, al ritmo de las páginas.
Esta receta responde a
- ¿Cómo separo por frases un libro ilustrado japonés (wakachigaki), con líneas que solo se cortan en los espacios?
- ¿Por qué el kana pequeño, ー y los cierres no pueden empezar una línea en japonés, y cómo elijo lo estricta que es la regla?
- ¿Qué fuentes componen el japonés, con los kanji en sus formas japonesas, en pantalla y en el PDF?
La respuesta corta
// The story is typed with an ordinary space (U+0020) after each phrase (文節). Japanese
// text may break between any two kana, so the space alone does not keep a phrase whole:
// keep-all drops the breaks between two letters and keeps those at a space, after 、。」
// and before 「. Kinsoku still applies.
const phrases = { wordBreak: 'keep-all' }; // cjk.wordBreak
const bodyText = {
fontFamily: HAND, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
// Ragged: a justified line would stretch its spaces and its kana to fill the tier.
textAlign: 'left', firstLineIndent: em(0),
};
Ingredientes
- Funciones
- Kana, kanji y rōmajiTexto verticalCorte de líneas japonés (kinsoku)Libros encuadernados por la derechaRetícula de caracteresFuentes chinas, japonesas y coreanasColumna y mediaColumna al margen para flotantesTipos de recurso propiosImágenes en los diseños de páginaCubiertas, portadas y colofonesEstilos de títuloAtributos de títuloEstilos de párrafoSaltos de página y de columnaColor del papelPaleta de color semánticaExportación a PDFFuentes incrustadas en el PDF
- También usa
- Figuras justo aquíAperturas diseñadasFiguras y tablas como recursosCabeceras por secciónCapítulos sin número
- Tipografía
- Klee One, Zen Maru Gothic (SIL OFL 1.1)
- Recursos
bridge-1400.jpgcover-1430.jpgdusk-1400.jpgfrog-1400.jpgheron-1400.jpgnight-1400.jpgrain-1400.jpgsea-1400.jpgstream-1400.jpgwindow-1400.jpg- La portada: un barco de papel rojo en un río entre prados verdes, con el cielo despejado a la derecha para el título (Generated With Diffusion Models, original)
- Mii-chan dobla el barco de papel rojo en una mesa baja junto a la ventana, después de la lluvia (Generated With Diffusion Models, original)
- Mii-chan dice adiós al barco en el arroyo (Generated With Diffusion Models, original)
- Una rana sobre una piedra habla con el barco (Generated With Diffusion Models, original)
- El barco bajo un puente de madera, seguido por peces pequeños (Generated With Diffusion Models, original)
- Una garza blanca en la orilla mira el barco en el río ancho (Generated With Diffusion Models, original)
- Atardecer: un cielo rosa sobre la desembocadura y el mar al fondo (Generated With Diffusion Models, original)
- Noche: el reflejo de la luna llena alumbra el camino del barco (Generated With Diffusion Models, original)
- El barco en el mar, saludado por las gaviotas (Generated With Diffusion Models, original)
- Mii-chan en su ventana, mirando hacia el mar lejano (Generated With Diffusion Models, original)
Elaboración
#1 · Mantén entera cada frase
El código está en la respuesta corta. El japonés puede cortarse entre dos kana cualesquiera, así que un espacio entre frases no hace más que añadir aire: no impide que la línea acabe dentro de あか|い. cjk.wordBreak: 'keep-all' conserva únicamente los cortes en un espacio y junto a la puntuación, tras 、。」 o delante de 「, como el word-break: keep-all de CSS, y el kinsoku sigue valiendo (tipografía de Asia oriental). El espacio es un U+0020 corriente, de 0,35 cuadratines en Klee One, y la línea lo suprime cuando cae al final. Un U+3000 también separa frases, pero es un carácter fijo de un cuadratín que se queda al final de la línea.

El texto va en bandera. Justificada, una línea corta estiraría sus espacios y los huecos entre sus kana hasta llegar al pie de la franja; un libro ilustrado deja cada línea donde acaba su última frase.
#2 · Pon los dibujos en una franja sobre el texto
// In vertical text 'left' is the top of the page: the side column is a tier that takes
// the pictures (floats), and the text runs in the tier under it, right to left.
const layout = {
layoutType: 'oneAndHalf', writingMode: 'vertical-rl', sideColumnRole: 'floats',
sideColumnSide: 'left', sideColumnPercent: 58, gutterWidth: pt(2 * BODY),
};
const cjk = { ...phrases, grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES } };
const resourceTypes = [{ id: 'picture', name: 'え', shortLabel: 'え', numberingTemplate: '{n}',
resetOn: 'never', counterFormat: 'decimal', captionPrefix: '' }]; // pictures, no captions
En el texto vertical 'left' es lo alto de la página, así que una maqueta de columna y media con la columna lateral a la izquierda son dos franjas: los dibujos flotan en la de arriba (14 caracteres de alto) y el texto corre por la de abajo (8 caracteres). Cada página cita su dibujo con ::resource{id="…"} y acaba con :::pagebreak. El tipo de recurso de los dibujos no lleva prefijo en el pie, y los dibujos son 2,186 veces más anchos que altos, la forma de la franja, así que la llenan (escritura vertical).
#3 · Haz de la portada un dibujo a toda página
// In the flow frame of a vertical page x runs down the sheet and y leftward from its right
// edge; a box's width runs down the sheet.
const at = (down, across) => ({ anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(down), y: mm(across) } });
const cover = {
id: 'cover', numbered: false, toc: false, span: 'page', header: { elements: [] },
breakBefore: { enabled: true, parity: 'any' },
advancedDesign: { enabled: true, minHeight: mm(TRIM.w - 40), slot: { elements: [
{ kind: 'image', id: 'art', resourceId: 'cover', decorative: true,
placement: { anchor: { to: 'bleed', edge: 'top-left' },
size: { width: mm(TRIM.h), height: mm(TRIM.w) } } },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: ROUND, fontWeight: 700,
fontSize: pt(60), lineHeight: 1, letterSpacing: pt(6), color: col('boat'),
placement: at(22, 34) },
{ kind: 'text', id: 'latin', content: '{attr.latin}', fontFamily: ROUND, fontWeight: 700,
fontSize: pt(9), lineHeight: 1.4, color: col('ink'), placement: at(22, 62) },
] } },
};
La portada es un diseño de encabezado a toda la página: el dibujo se ancla al sangrado con el tamaño de la página (en el flujo vertical su width baja por la hoja), y el título baja por el cielo, a la derecha, en Zen Maru Gothic de 60 pt.
#4 · Carga las pinturas como mapas de bits
// The scenes have the tier's shape, 612 : 280 (ART); the cover has the page's, 260 : 200.
const PICTURES = { // id: [file, width, height, alt text in the book's language]
cover: ['cover-1430.jpg', 1430, 1100, 'あおい かわに あかい かみの ふねが うかんで いる。'],
rain: ['rain-1400.jpg', 1400, 641, 'まどべの ちゃぶだいで、みいちゃんが あかい かみで ふねを おって いる。'],
stream: ['stream-1400.jpg', 1400, 641, 'みいちゃんが おがわに ふねを ながし、てを ふって いる。'],
frog: ['frog-1400.jpg', 1400, 641, 'かわの いしの うえの かえるが、ながれて いく ふねに はなしかけて いる。'],
bridge: ['bridge-1400.jpg', 1400, 641, 'きの はしの したを ふねが くぐり、ちいさな さかなが ついて くる。'],
heron: ['heron-1400.jpg', 1400, 641, 'ひろい かわの きしで、しろい さぎが ふねを みおくって いる。'],
dusk: ['dusk-1400.jpg', 1400, 641, 'ももいろの ゆうやけの かわに ふねが うかび、とおくに うみが みえる。'],
night: ['night-1400.jpg', 1400, 641, 'まんげつが かわに うつり、ひかりの みちの そばを ふねが すすむ。'],
sea: ['sea-1400.jpg', 1400, 641, 'あおい うみに でた ふねの うえを、かもめが とんで いる。'],
window: ['window-1400.jpg', 1400, 641, 'みいちゃんが まどから、まちの むこうの うみを みて いる。'],
};
const pictures = Object.entries(PICTURES).map(([id, [fileId, w, h, altText]]) => ({
id, typeId: 'picture', kind: 'bitmap', createdAt: 0, updatedAt: 0, altText,
placement: { span: 'side' }, bitmap: { fileId, format: 'jpeg', width: w, height: h } }));
Las diez ilustraciones son pinturas, archivos JPEG en assets/ de la receta. Las nueve escenas están cortadas con la forma de la franja, 612 : 280, y la portada con la de la página, 260 : 200, así que cada una llena su marco y no se recorta nada. Cada una es un recurso bitmap declarado con su tamaño en píxeles, con texto alternativo en la lengua del libro, y su archivo se carga con el fileId del recurso antes de componer. Con 1.400 px de ancho, las escenas se imprimen a unos 165 ppp a lo largo de la franja (tipos de recurso).
La receta completa
// ═══ Postext Cookbook · Nº 127 · A hiragana picture book, spaced by phrase ══════════
// https://postext.dev/en/cookbook/hiragana-picture-book
// Code: MIT · Story: written for the recipe (CC BY 4.0) · Pictures: generated with diffusion models
// Fonts: Klee One, Zen Maru Gothic (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// A picture book for small readers: hiragana only, a space between phrases, vertical.
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 frame; the story is Japanese in both editions
const RECIPE = 'hiragana-picture-book';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the paper boat's red, river blues, a warm paper
const palette = {
ink: '#2e2a26', // the text: a soft near-black
boat: '#cf4430', // the boat, the title (4.6:1 on the paper)
river: '#5d93ad',
grass: '#86b665',
muted: '#6e675f', // the colophon
paper: '#fbf6ea',
};
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: 'boat (defaults)', value: { hex: palette.boat, model: 'hex' } },
];
// #endregion
const HAND = 'Klee One'; // 教科書体: the hand a child learns to write kana from
const ROUND = 'Zen Maru Gothic'; // the cover's title
const [BODY, LEAD] = [20, 36]; // pt: large kana, a line gap of 0.8 em
const PT = 25.4 / 72; // mm in a point
const TRIM = { w: 260, h: 200 }; // mm: a landscape picture book (横長)
const [CHARS, PICTURE, LINES] = [8, 14, 17]; // characters: text tier, picture tier; lines
const ART = { w: LINES * LEAD * PT, h: PICTURE * BODY * PT }; // mm: 215.9 × 98.8
// #region answer: わかち書き — a space between phrases, and lines that break only there
// The story is typed with an ordinary space (U+0020) after each phrase (文節). Japanese
// text may break between any two kana, so the space alone does not keep a phrase whole:
// keep-all drops the breaks between two letters and keeps those at a space, after 、。」
// and before 「. Kinsoku still applies.
const phrases = { wordBreak: 'keep-all' }; // cjk.wordBreak
const bodyText = {
fontFamily: HAND, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
// Ragged: a justified line would stretch its spaces and its kana to fill the tier.
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
#Justifica las líneas
Justificada, cada línea llega al pie de la franja: primero se estiran los espacios entre frases, hasta medio cuadratín, y después los huecos entre los kana (JLReq §3.8). Una línea corta de kana de 20 pt muestra entonces huecos anchos; por eso la receta deja las líneas en bandera.
- textAlign: 'left', firstLineIndent: em(0),
+ textAlign: 'justify', firstLineIndent: em(0),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
Compón el japonés con una fuente japonesa
Noto Serif SC y TC tienen kana, pero dibujan los kanji con formas chinas (直, 骨 y 角 cambian) y el kana con un diseño chino. Compón el texto en Noto Serif JP o Shippori Mincho B1 y los títulos en Noto Sans JP, cargadas con loadCjkFonts. Los archivos japoneses de Fontsource no tienen hentaigana ni otros kana históricos (U+1B000–1B16F): loadCjkFonts falla con ellos y el PDF imprime cajas, así que escribe el kana moderno o lleva en los recursos de la receta una fuente que los tenga. Shippori Mincho tampoco tiene las vocales con macrón ō y ū: compón el rōmaji con una fuente latina. Kana, kanji y rōmaji →
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 →
keep-allsolo conserva los cortes que el texto ya trae: Postext no busca las frases, así que los espacios los escribe el autor. Una frase más larga que la línea se sigue cortando por dentro, en el último punto que permite el kinsoku.- El chino nunca separa sus palabras, y el libro de lectura chino Un libro de lectura vertical con zhuyin a la derecha ayuda a sus lectores con lecturas sobre los caracteres; un libro ilustrado japonés no usa kanji, así que no necesita furigana, y los espacios entre frases guían la lectura.
Créditos
- Receta
- Ignacio Ferro
- Texto
- かみの ふね (El barco de papel), un cuento ilustrado en hiragana escrito para esta receta · Postext Cookbook · CC BY 4.0
- Imágenes
- La portada: un barco de papel rojo en un río entre prados verdes, con el cielo despejado a la derecha para el título · Generated With Diffusion Models · original
- Mii-chan dobla el barco de papel rojo en una mesa baja junto a la ventana, después de la lluvia · Generated With Diffusion Models · original
- Mii-chan dice adiós al barco en el arroyo · Generated With Diffusion Models · original
- Una rana sobre una piedra habla con el barco · Generated With Diffusion Models · original
- El barco bajo un puente de madera, seguido por peces pequeños · Generated With Diffusion Models · original
- Una garza blanca en la orilla mira el barco en el río ancho · Generated With Diffusion Models · original
- Atardecer: un cielo rosa sobre la desembocadura y el mar al fondo · Generated With Diffusion Models · original
- Noche: el reflejo de la luna llena alumbra el camino del barco · Generated With Diffusion Models · original
- El barco en el mar, saludado por las gaviotas · Generated With Diffusion Models · original
- Mii-chan en su ventana, mirando hacia el mar lejano · Generated With Diffusion Models · original
- Fuentes
- Klee One (SIL OFL 1.1) · Zen Maru Gothic (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)


