En poques paraules
Un llibre il·lustrat japonès per a infants, tot en hiragana, amb un espai després de cada grup de paraules i línies que no el parteixen mai, sota un dibuix a cada pàgina.
Què compondràs
Un llibre il·lustrat de deu pàgines, かみの ふね (El vaixell de paper), escrit per a la recepta i il·lustrat amb deu pintures: després de la pluja una nena plega un vaixell de paper vermell, i el vaixell baixa pel riu, deixa enrere una granota, un bernat i la lluna, i arriba al mar. Està compost com els llibres japonesos per als lectors més petits: només hiragana, a 20 pt en Klee One, una lletra feta a partir del model dels llibres de text escolars, i un espai entre frases, 分かち書き (wakachigaki), perquè l'infant llegeixi frase a frase. Les pàgines són apaïsades, de 260 × 200 mm, en vertical i enquadernades per la dreta: el dibuix a dalt, a sota línies curtes de vuit caràcters, i el vaixell avança cap a l'esquerra, al ritme de les pàgines.
Aquesta recepta respon a
- Com separo per frases un llibre il·lustrat japonès (wakachigaki), amb línies que només es tallen als espais?
- Per què el kana petit, ー i els tancaments no poden començar una línia en japonès, i com trio com d'estricta és la regla?
- Quines fonts componen el japonès, amb els kanji en les seves formes japoneses, a la pantalla i al PDF?
La resposta curta
// 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),
};
Ingredients
- Funcions
- Kana, kanji i rōmajiText verticalTall de línies japonès (kinsoku)Llibres enquadernats per la dretaRetícula de caràctersFonts xineses, japoneses i coreanesColumna i mitjaColumna al marge per a flotantsTipus de recurs propisImatges als dissenys de pàginaCobertes, portades i colofonsEstils de títolAtributs de títolEstils de paràgrafSalts de pàgina i de columnaColor del paperPaleta de color semànticaExportació a PDFFonts incrustades al PDF
- També fa servir
- Figures just aquíObertures dissenyadesFigures i taules com a recursosCapçaleres per seccióCapítols sense número
- Tipografia
- 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- The cover: a red paper boat on a river through green meadows, a clear sky on the right for the title (Generated With Diffusion Models, original)
- Mii-chan folding the red paper boat at a low table by the window, after the rain (Generated With Diffusion Models, original)
- Mii-chan waving goodbye to the boat on the stream (Generated With Diffusion Models, original)
- A frog on a stone talking to the boat (Generated With Diffusion Models, original)
- The boat under a wooden footbridge, little fish following it (Generated With Diffusion Models, original)
- A white heron on the bank watching the boat on the wide river (Generated With Diffusion Models, original)
- Dusk: a pink sky over the river mouth and the sea beyond (Generated With Diffusion Models, original)
- Night: the full moon's reflection lighting the boat's way (Generated With Diffusion Models, original)
- The boat at sea, greeted by seagulls (Generated With Diffusion Models, original)
- Mii-chan at her window, looking towards the distant sea (Generated With Diffusion Models, original)
Elaboració
#1 · Mantén sencera cada frase
El codi és la resposta curta de més amunt. El japonès es pot tallar entre dos kana qualssevol, així que un espai entre frases no fa més que afegir aire: no impedeix que la línia acabi dins de あか|い. cjk.wordBreak: 'keep-all' només conserva els talls en un espai i al costat de la puntuació, després de 、。」 o davant de 「, com el word-break: keep-all de CSS, i el kinsoku continua valent (tipografia de l'Àsia oriental). L'espai és un U+0020 corrent, de 0,35 quadratins en Klee One, i la línia el suprimeix quan cau al final. Un U+3000 també separa frases, però és un caràcter fix d'un quadratí que es queda al final de la línia.

El text va en bandera. Justificada, una línia curta estiraria els espais i els buits entre els kana fins a arribar al peu de la franja; un llibre il·lustrat deixa cada línia on acaba la seva última frase.
#2 · Posa els dibuixos en una franja sobre el text
// 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 text vertical 'left' és el capdamunt de la pàgina, així que una maqueta de columna i mitja amb la columna lateral a l'esquerra són dues franges: els dibuixos floten a la de dalt (14 caràcters d'alt) i el text corre per la de baix (8 caràcters). Cada pàgina cita el seu dibuix amb ::resource{id="…"} i acaba amb :::pagebreak. El tipus de recurs dels dibuixos no porta prefix al peu, i els dibuixos són 2,186 vegades més amples que alts, la forma de la franja, així que l'omplen (escriptura vertical).
#3 · Fes de la portada un dibuix a tota 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 és un disseny de títol a tota la pàgina: el dibuix s'ancora a la sang amb la mida de la pàgina (en el flux vertical el seu width baixa pel full), i el títol baixa pel cel, a la dreta, en Zen Maru Gothic de 60 pt.
#4 · Carrega les pintures com a mapes 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 } }));
Les deu il·lustracions són pintures, fitxers JPEG a assets/ de la recepta. Les nou escenes estan tallades amb la forma de la franja, 612 : 280, i la portada amb la de la pàgina, 260 : 200, de manera que cadascuna omple el seu marc i no es retalla res. Cadascuna és un recurs bitmap declarat amb la seva mida en píxels, amb text alternatiu en la llengua del llibre, i el seu fitxer es carrega amb el fileId del recurs abans de compondre. Amb 1.400 px d'amplada, les escenes s'imprimeixen a uns 165 ppp al llarg de la franja (tipus de recurs).
La recepta 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.
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Justifica les línies
Justificada, cada línia arriba al peu de la franja: primer s'estiren els espais entre frases, fins a mig quadratí, i després els buits entre els kana (JLReq §3.8). Una línia curta de kana de 20 pt mostra llavors buits amples; per això la recepta deixa les línies en bandera.
- textAlign: 'left', firstLineIndent: em(0),
+ textAlign: 'justify', firstLineIndent: em(0),Errors freqüents
Error freqüent
Etiqueta un text japonès 'ja', mai zh-Hans ni LANG
Les edicions d'una recepta són en i es, però una mostra japonesa és japonesa en totes dues: `locale: LANG` l'etiquetaria com a anglès o castellà, i una etiqueta xinesa la compondria amb les regles xineses (puntuació Kaiming, kana petit lliure de començar línia, 图 en lloc de 図, formes xineses dels caràcters al PDF). Des de postext 1.30 l'etiqueta és a més la llengua en què es compon el text (en què es mesura, es pinta i s'incrusta), de manera que qualsevol etiqueta que no sigui 'ja' dona altres formes de glif que les japoneses (les xineses, amb una etiqueta xinesa) i altres talls de línia. Escriu 'ja': tria la regió del Japó (tall i puntuació de la JLReq, punts de sèsam, repartiment dels furigana, etiquetes 図 i 表) i desactiva la partició de mots. El lint falla un text amb kana sota una etiqueta zh o ko. Tall de línies japonès (kinsoku) →
Error freqüent
Compon el japonès amb una font japonesa
Noto Serif SC i TC tenen kana, però dibuixen els kanji amb formes xineses (直, 骨 i 角 canvien) i el kana amb un disseny xinès. Compon el text en Noto Serif JP o Shippori Mincho B1 i els títols en Noto Sans JP, carregades amb loadCjkFonts. Els fitxers japonesos de Fontsource no tenen hentaigana ni altres kana històrics (U+1B000–1B16F): loadCjkFonts hi falla i el PDF imprimeix caixes, així que escriu el kana modern o porta als recursos de la recepta una font que els tingui. Shippori Mincho tampoc no té les vocals amb macró ō i ū: compon el rōmaji amb una font llatina. Kana, kanji i rōmaji →
Error freqüent
Les fonts xineses es carreguen per fragments, amb el bloc cjk
Fontsource serveix una família xinesa, japonesa o coreana en un centenar de fitxers per pes, cadascun amb un interval de caràcters. loadFonts només baixa el fitxer latin, així que a la pantalla els caràcters xinesos surten d'una font del sistema i es mesuren malament, i fontsourceProvider lliura al PDF aquest fitxer latin, que els imprimeix com a caixes buides. Afegeix el bloc cjk del kit, crida loadCjkFonts(FONTS, markdown) després de loadFonts (una vegada per veu, amb el text que compon, si el llibre fa servir diverses fonts xineses) i passa a renderToPdf fontProvider: cjkPdfProvider: tots dos agafen els fitxers que contenen els caràcters del text. Fonts xineses, japoneses i coreanes →
keep-allnomés conserva els talls que el text ja porta: Postext no busca les frases, així que els espais els escriu l'autor. Una frase més llarga que la línia es continua tallant per dins, en l'últim punt que permet el kinsoku.- El xinès no separa mai les paraules, i el llibre de lectura xinès Un llibre de lectura vertical amb zhuyin a la dreta ajuda els lectors amb lectures als caràcters; un llibre il·lustrat japonès no fa servir kanji, així que no necessita furigana, i els espais entre frases guien la lectura.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- かみの ふね (The Paper Boat), a picture-book story in hiragana written for this recipe · Postext Cookbook · CC BY 4.0
- Imatges
- The cover: a red paper boat on a river through green meadows, a clear sky on the right for the title · Generated With Diffusion Models · original
- Mii-chan folding the red paper boat at a low table by the window, after the rain · Generated With Diffusion Models · original
- Mii-chan waving goodbye to the boat on the stream · Generated With Diffusion Models · original
- A frog on a stone talking to the boat · Generated With Diffusion Models · original
- The boat under a wooden footbridge, little fish following it · Generated With Diffusion Models · original
- A white heron on the bank watching the boat on the wide river · Generated With Diffusion Models · original
- Dusk: a pink sky over the river mouth and the sea beyond · Generated With Diffusion Models · original
- Night: the full moon's reflection lighting the boat's way · Generated With Diffusion Models · original
- The boat at sea, greeted by seagulls · Generated With Diffusion Models · original
- Mii-chan at her window, looking towards the distant sea · Generated With Diffusion Models · original
- Fonts
- Klee One (SIL OFL 1.1) · Zen Maru Gothic (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


