En poques paraules
Una pàgina d'un llibre de lectura japonès amb kana petits sobre cada kanji, perquè un infant el llegeixi en veu alta. Postext posa cada lectura sobre els seus caràcters, i una de llarga pot passar al kana veí, mai a un altre kanji.
Què compondràs
Les primeres pàgines de «Gon, la guineu» (ごんぎつね, 1932), de Niimi Nankichi, tal com les imprimeix un llibre de lectura de quart: el conte que tots els infants japonesos llegeixen als nou o deu anys. Una pàgina B5 porta 28 caràcters per 21 línies de Klee One, una lletra dibuixada a partir de la mà dels llibres de text escolars, de 14 pt sobre una línia de 28 pt, amb una lectura en kana petit sobre cada kanji. Les lectures són el tema: una per caràcter sobre 村 i 森, una per a tota la paraula sobre 百舌鳥 (mozu), una paraula amb kanji sense lectura pròpia, i lectures jukugo sobre 兵十 (Hyōjū), cadascuna sobre el seu kanji fins que una no hi cap. Un requadre al final mostra els tres casos per al mestre. La cartilla amb pinyin posa lectures xineses sobre cada caràcter de la mateixa manera.
Aquesta recepta respon a
- Com poso furigana damunt dels kanji, una lectura per caràcter o una per a tota la paraula?
La resposta curta
// In a document tagged 'ja' the compact {漢字|かん|じ} (one reading per character) is jukugo
// ruby: each reading stays over its own kanji when it fits, and when one is longer it may run
// onto the next kanji of the same word; a break may fall between the two. {百舌鳥|もず} (one
// reading for the word) is group ruby, spread over the word 1:2:1. :ruby[菜種]{rt="な たね"
// mode=jukugo} says the same as the compact form; mode=mono keeps each reading to its kanji.
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
ruby: {
fontSize: em(0.5), // 7 pt: half the text, the size JLReq gives furigana
color: col('reading'),
align: 'jis', // a reading shorter than its base: ½ unit at each end, 1 between (1:2:1)
overhang: 'kana', // a longer reading may run one ruby character onto a kana, never a kanji
smallKana: 'keep', // ひょう with its small ょ, as today's books print it
},
};
// The line gap (28 − 14 = 14 pt) holds a 7 pt reading with room to spare: no line moves for one.
const bodyText = {
fontFamily: TEXT, fontSize: pt(SIZE), lineHeight: pt(PITCH), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', firstLineIndent: em(1), indentAfterHeading: true,
avoidRunts: true, // no paragraph ends on one character
};
Ingredients
- Funcions
- Furigana: lectures en kana sobre els kanjiRuby: lectures en pinyin i zhuyinKana, kanji i rōmajiMarques d'èmfasi japoneses (bōten)Fonts xineses, japoneses i coreanesRetícula de caràctersEspaiat de la puntuació japonesa (yakumono)Tall de línies japonès (kinsoku)Títols que ocupen línies del text (gyōdori)Obertures dissenyadesAtributs de títolRequadresCapçaleres i folisMarges simètricsColor del paperEstils de paràgrafPaleta de color semànticaImportar textos d'Aozora BunkoExportació a PDF
- També fa servir
- Tall de línies en xinèsEquilibri de columnesPunts d'èmfasi i línies de nom i de títolSortir de la retícula a propòsitFonts incrustades al PDF
- Tipografia
- Klee One, Zen Maru Gothic (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Tres maneres d'escriure una lectura
El codi és la resposta curta de més amunt. Al Markdown, {村|むら} posa むら sobre 村, i {兵十|ひょう|じゅう} dona a cada kanji la seva lectura. En un document amb l'etiqueta 'ja', això és ruby jukugo: les lectures es queden sobre els seus kanji quan hi caben, i una de més llarga es pot recolzar en el kanji següent de la mateixa paraula, mai en el d'una altra. {百舌鳥|もず}, una lectura per a tres kanji, és ruby de grup, repartit sobre la paraula sencera. :ruby[菜種]{rt="な たね" mode=jukugo} escriu l'últim exemple del requadre amb la directiva, que també admet mode=mono i align (Marques, ruby i warichu).

#2 · 1:2:1, i lectures que només es recolzen en kana
Els dos ajustos sota cjk.ruby són els que 'ja' tria tot sol. align: 'jis' compon una lectura més curta que la base a la manera de JIS X 4051: mitja unitat d'espai a cada extrem i una de sencera entre els kana. Així も i ず queden sobre les juntures de 百舌鳥 a la pàgina 25 en lloc d'amuntegar-se al centre. overhang: 'kana' deixa que una lectura més llarga que la base ocupi fins a un caràcter de ruby d'un kana o del blanc d'un signe veí, mai d'un kanji: ぎつね sobre el 狐 de 「ごん狐」 es recolza en ん i en el claudàtor que el segueix, i el じゅう de 兵十だな, en だ. On no hi ha cap kana per recolzar-s'hi, els kanji se separen fins a l'amplada de la lectura. A la vora d'una línia, la lectura no surt de la mida.

#3 · Un interlineat que fa lloc a les lectures
Les lectures fan 7 pt, la meitat dels 14 pt del text, i la línia en fa 28, així que els 14 pt que hi ha entre dues línies les encabeixen de sobres i totes les línies de la retícula es queden al seu lloc. Si el pas és més petit que el text més les lectures, la composició avisa amb rubyExceedsLeading.
#4 · L'obertura no imprimeix lectures
// Design text sets no furigana (gotcha: ruby-not-in-designs): the author's reading is a
// line of its own.
const BAND = 92; // mm from the trim's top
const opener = { enabled: true, minHeight: pt(PITCH * 6), slot: { elements: [
{ kind: 'box', id: 'band', reserve: false, style: { backgroundColor: col('straw') },
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: 'fill', height: mm(BAND) } } },
{ kind: 'text', id: 'unit', content: '{attr.unit}', fontFamily: ROUND, fontSize: pt(16),
fontWeight: 700, color: col('paper'), align: 'center', verticalAlign: 'middle',
overflow: 'clip', box: { backgroundColor: col('red'), borderRadius: mm(6) },
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(-2) },
size: { width: mm(12), height: mm(12) } } },
{ kind: 'text', id: 'series', content: '{title}', fontFamily: ROUND, fontSize: pt(9),
fontWeight: 700, letterSpacing: pt(2), color: col('red'), align: 'left',
verticalAlign: 'middle', placement: { anchor: { to: 'container', edge: 'top-left' },
offset: { x: mm(16), y: mm(-2) }, size: { width: mm(80), height: mm(12) } } },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: ROUND, fontSize: pt(48),
lineHeight: 1.1, fontWeight: 700, color: col('ink'), align: 'left',
placement: { anchor: { to: '#unit', edge: 'below' }, offset: { y: mm(7) } } },
{ kind: 'text', id: 'kana', content: '{attr.kana}', fontFamily: ROUND, fontSize: pt(8),
letterSpacing: pt(1), color: col('muted'), align: 'left',
placement: { anchor: { to: '#title', edge: 'below' }, offset: { y: mm(5) } } },
{ kind: 'text', id: 'author', content: '{attr.author} 作', fontFamily: ROUND,
fontSize: pt(13), fontWeight: 500, color: col('ink'), align: 'left',
placement: { anchor: { to: '#kana', edge: 'below' }, offset: { y: mm(1) } } },
] } };
El títol i el nom de l'autor són text de disseny, que no compon ruby, així que la lectura de 新美南吉 va en una línia pròpia sobre el nom, en kana, com la imprimeixen els llibres de lectura. El títol també va en kana, ごんぎつね, com l'escriuen els llibres escolars, tot i que el text d'Aozora l'encapçala ごん狐.
#5 · Un accent, i lectures un to més clares
const palette = {
ink: '#2a2420', // text: a warm near-black
red: '#b2402c', // the one accent: the unit badge, the section numbers, the box title
reading: '#5a4e45', // the furigana, a shade off the ink so the two layers part
straw: '#f6ecd6', // the opener band and the box
muted: '#7a6d62', // folios, the series line, the colophon
paper: '#fffdf8',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.red })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
Les lectures prenen reading, un marró un grau més clar que la tinta, perquè l'ull distingeixi les dues capes sense que el kana es torni pàl·lid. El vermell de les higanbana que floreixen al conte marca la insígnia, el número de secció i el títol del requadre.
La recepta completa
// ═══ Postext Cookbook · Nº 124 · A school reader with furigana: per character, per word ═══
// https://postext.dev/en/cookbook/jukugo-furigana-textbook
// Code: MIT · Text: 新美南吉「ごん狐」(1932), Aozora Bunko 628 (PD); readings: CC BY 4.0
// Fonts: Klee One, Zen Maru Gothic (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import { buildDocument, withLoadedFonts, renderPageToCanvas } 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
const RECIPE = 'jukugo-furigana-textbook';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: an autumn reader: ink, the red of the higanbana, a pale straw ground
const palette = {
ink: '#2a2420', // text: a warm near-black
red: '#b2402c', // the one accent: the unit badge, the section numbers, the box title
reading: '#5a4e45', // the furigana, a shade off the ink so the two layers part
straw: '#f6ecd6', // the opener band and the box
muted: '#7a6d62', // folios, the series line, the colophon
paper: '#fffdf8',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.red })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [TEXT, ROUND] = ['Klee One', 'Zen Maru Gothic']; // 教科書体-like text, rounded gothic
const [SIZE, PITCH] = [14, 28]; // pt: a fourth-year reader's size, on a line twice as tall
const [CHARS, LINES] = [28, 21]; // the type area in characters
// #region answer: readings over every kanji: by character, by word, jukugo, JIS 1:2:1
// In a document tagged 'ja' the compact {漢字|かん|じ} (one reading per character) is jukugo
// ruby: each reading stays over its own kanji when it fits, and when one is longer it may run
// onto the next kanji of the same word; a break may fall between the two. {百舌鳥|もず} (one
// reading for the word) is group ruby, spread over the word 1:2:1. :ruby[菜種]{rt="な たね"
// mode=jukugo} says the same as the compact form; mode=mono keeps each reading to its kanji.
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
ruby: {
fontSize: em(0.5), // 7 pt: half the text, the size JLReq gives furigana
color: col('reading'),
align: 'jis', // a reading shorter than its base: ½ unit at each end, 1 between (1:2:1)
overhang: 'kana', // a longer reading may run one ruby character onto a kana, never a kanji
smallKana: 'keep', // ひょう with its small ょ, as today's books print it
},
};
// The line gap (28 − 14 = 14 pt) holds a 7 pt reading with room to spare: no line moves for one.
const bodyText = {
fontFamily: TEXT, fontSize: pt(SIZE), lineHeight: pt(PITCH), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
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
#Kana de mida completa a les lectures
Els llibres antics imprimien っ i ょ a mida completa al ruby, がつこう per がっこう. smallKana: 'full' fa el mateix i deixa intacte el text que es llegeix en veu alta i el que es copia.
- smallKana: 'keep', // ひょう with its small ょ, as today's books print it
+ smallKana: 'full', // ひよう: the small kana at full size, as letterpress books printed them#Centra totes les lectures
align: 'center' posa una lectura curta al centre de la base, com fan gairebé tots els llibres xinesos; 1:2:1 és el valor per defecte en japonès.
- align: 'jis', // a reading shorter than its base: ½ unit at each end, 1 between (1:2:1)
+ align: 'center', // も ず together in the middle of 百舌鳥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 →
Error freqüent
Les lectures s'imprimeixen al text, no en dissenys, peus ni cel·les
Les lectures ruby es dibuixen en paràgrafs, títols, elements de llista, cites i requadres. Un element de text d'un disseny (una obertura, una capçalera, una etiqueta), un peu, una nota a peu de pàgina i una cel·la de taula imprimeixen els caràcters base sense les seves lectures. Un títol que necessita el seu pinyin és un títol sense disseny propi: dibuixa el que l'envolta (una banda, el número de la lliçó) amb el disseny del títol anterior, els elements del qual amb reserve: false es pinten sota el text d'una obertura span: 'page'. Ruby: lectures en pinyin i zhuyin →
Error freqüent
Llegeix els fitxers d'Aozora com a CP932, no com a Shift_JIS
Els fitxers de text d'Aozora Bunko són en Windows-31J (CP932). Llegits com a Shift_JIS a seques, el guió ―― surt com a guions U+2014, ~ com el guió ondulat 〜, i alguns caràcters de NEC i IBM fallen. Llegeix-los com a cp932 i després converteix el marcatge: el ruby entre 《》, les notes [#…] i els gaiji ※[#…] no són Markdown i s'imprimeixen tal qual si s'hi deixen. aozora.py, de la skill, fa totes dues coses. Importar textos d'Aozora Bunko →
Avís de maquetació · rubyExceedsLeading
Lectures enganxades a la línia veïna
Per què. Un paràgraf amb lectures ruby damunt o sota del text té una interlínia més estreta que les lectures: ocupen l'interlineat i toquen la línia veïna.
Solució. Compon el paràgraf amb més interlineat (com a mínim el cos més `cjk.ruby.fontSize`), o redueix les lectures. Documentació →
- Aozora Bunko escriu una sola lectura per a tota la paraula, 兵十《ひょうじゅう》, i el convertidor la conserva com a ruby de grup,
{兵十|ひょうじゅう}. Per tenir ruby jukugo, divideix la lectura per kanji a mà:{兵十|ひょう|じゅう}. - Una lectura es reparteix per la barra en una part per caràcter només quan les parts coincideixen amb la base.
{一人|ひ|と|り}té tres parts per a dos kanji i es compon com una lectura per a la paraula, que és el que necessita 一人.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- “Gon gitsune” (ごん狐), section 1, by Niimi Nankichi (1932): Aozora Bunko card 628, base text 新美南吉童話集 (Iwanami Bunko, 1996, second printing 1997), input by 林裕司, proofing by 浜野智 · Niimi Nankichi (1913–1943) · domini públic
- The readings over every kanji, the box on furigana and the opener’s labels · Postext Cookbook · CC BY 4.0
- 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)


