En poques paraules
Un capítol breu sobre les paraules dels caixistes japonesos, amb un índex al final. Cada paraula indexada porta la seva pronúncia, i Postext la fa servir per ordenar l'índex segons l'ordre del kana, sota els encapçalaments あ行, か行, etc.
Què compondràs
Un capítol d'un manual inventat de composició japonesa, 組版の言葉 (Les paraules de la composició), i el seu índex. El capítol explica els noms de les parts de la pàgina, dels cossos de lletra i de les regles de puntuació, en una pàgina A5 de 36 caràcters per 28 línies, i cada terme es marca per a l'índex allà on s'explica. L'índex és el tema. El japonès no té ordre alfabètic per als kanji, així que un índex ordena cada entrada per la seva lectura en kana, segons la taula del gojūon (五十音), sota els encapçalaments de fila あ行, か行, さ行. Un terme amb furigana ja dona la seva lectura; qualsevol altre terme amb un kanji la indica en un atribut yomi. L'índex de noms xinesos ordena noms xinesos per pinyin i per traços.
Aquesta recepta respon a
- Com ordeno un índex japonès en ordre gojūon segons les seves lectures?
La resposta curta
// Each mark gives the reading the entry sorts by. A term written with furigana gives it
// itself: :index[{版面|はん|めん}] files 版面 as はんめん. Any other term with a kanji says it
// with yomi: :index[明朝体]{yomi="みんちょうたい"}. Kana and Latin terms need nothing. The
// reading orders the entries in JIS X 4061 order (katakana as hiragana, small kana as large,
// voiced after plain, ー as the vowel before it); Latin terms come first, under A to Z.
const index = {
groupBy: 'gojuon', // what 'auto' picks in a 'ja' document: heads あ行 か行 さ行 …
fontFamily: MINCHO, fontSize: pt(8.5), lineHeight: pt(14),
separator: ' ', locatorSeparator: '、', // 版面 3、5: an ideographic space, then 、
see: { italic: false }, // → ルビ, → 柱も見よ: upright, no italic in Japanese
groups: { fontFamily: GOTHIC, fontSize: pt(9), fontWeight: 700, color: col('vermilion'),
marginTop: pt(7) },
};
Ingredients
- Funcions
- Índex en ordre gojūonÍndex analíticFurigana: lectures en kana sobre els kanjiRuby: lectures en pinyin i zhuyinFonts xineses, japoneses i coreanesTall de línies japonès (kinsoku)Espaiat de la puntuació japonesa (yakumono)Estils de títolCapítols sense númeroTítols numeratsTítols que ocupen línies del text (gyōdori)Una o dues columnesRetícula de caràctersObertures dissenyadesAtributs de títolCapçaleres i folisMarges simètricsEstils de paràgrafExportació a PDF
- També fa servir
- Tall de línies en xinèsEquilibri de columnesCapçaleres segons el tipus de pàginaFonts incrustades al PDFGeometria per secció
- Tipografia
- Noto Serif JP, Noto Sans JP (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Una lectura per a cada terme amb kanji
El codi és la resposta curta de més amunt. Al text, :index[{版面|はん|めん}]{main} imprimeix 版面 amb はんめん a sobre i ordena l'entrada com a はんめん, i :index[明朝体]{yomi="みんちょうたい" main} no imprimeix cap lectura i l'ordena com a みんちょうたい. Els termes en kana, ノンブル o のど, i els llatins, DTP o JIS X 4051, no necessiten res (Marques d'índex). La lectura només decideix l'ordre: l'entrada s'imprimeix tal com està escrita. Les lectures dels kanji no es poden endevinar, perquè 天 aquí és てん i en altres paraules あめ, així que el motor no ho intenta mai.
#2 · Ordre JIS i encapçalaments de fila
groupBy: 'gojuon' és el que 'auto' tria amb locale: 'ja'. Les entrades s'ordenen segons la JIS X 4061: el katakana com l'hiragana, el kana petit com el gran, un kana sonor just després del sord, i ー com la vocal que el precedeix. Per això 級 (きゅう) va abans de 行取り (ぎょうどり), i ゴシック体 (ごしっくたい) després de 小口 (こぐち). Els termes llatins van primer, sota les seves lletres, com ordena la JIS; els símbols i les xifres anirien abans que ells (Índex analític).

#3 · → i も見よ
Una remissió és una marca amb see, :index{term="振り仮名" yomi="ふりがな" see="ルビ"}, i imprimeix 振り仮名 →ルビ. Una remissió de «vegeu també» fa servir seealso i imprimeix els destins abans de も見よ, 級 10 →歯も見よ, com ho escriuen els índexs japonesos. see: { italic: false } deixa les etiquetes en rodona, perquè una lletra japonesa no té cursiva. L'espai ideogràfic després de cada terme i el 、 entre pàgines surten de separator i locatorSeparator.
#4 · L'índex a dues columnes
const band = { kind: 'box', id: 'band', reserve: false, style: { backgroundColor: col('tint') },
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: 'fill', height: mm(56) } } };
const opener = (sink, ground = []) => ({ enabled: true, minHeight: pt(PITCH * sink),
slot: { elements: [...ground,
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: GOTHIC, fontSize: pt(9),
fontWeight: 700, letterSpacing: pt(2), color: col('vermilion'), align: 'left',
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(10) } } },
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: GOTHIC, fontSize: pt(22),
fontWeight: 700, color: col('ink'), align: 'left', overflow: 'wrap',
placement: { anchor: { to: '#kicker', edge: 'below' }, offset: { y: mm(3) } } },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(1.5),
color: col('vermilion'), placement: { anchor: { to: '#title', edge: 'below' },
offset: { y: mm(4) }, size: { width: mm(12) } } },
] } });
El títol de l'índex és un estil d'encapçalament amb span: 'page' i un layout de dues columnes. El seu disseny, una banda pàl·lida amb el títol, travessa la pàgina, i :::index flueix en dues columnes a sota. Els encapçalaments de fila van en la gòtica vermelló, i les entrades, en la mincho del text de 8,5 pt sobre una línia de 14 pt.
La recepta completa
// ═══ Postext Cookbook · Nº 126 · A Japanese index in gojūon order, read from its readings ═══
// https://postext.dev/en/cookbook/gojuon-index
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Noto Serif JP, Noto Sans JP (SIL OFL 1.1) · Needs postext ≥ 1.28.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 chapter is Japanese in both
const RECIPE = 'gojuon-index';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, one vermilion for the row heads and the chapter label, pale rules
const palette = {
ink: '#211e1c', // text: a warm near-black
vermilion: '#b33a22', // the one accent: あ行 heads, the kicker, folios
tint: '#f5ece6', // the index heading's band
rule: '#d3c8c0', // the rule under each title
muted: '#6c625b', // running heads, the colophon
paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.vermilion })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [MINCHO, GOTHIC] = ['Noto Serif JP', 'Noto Sans JP'];
const [BODY, PITCH] = [9, 16]; // pt: 9 pt text on a 16 pt line
const [CHARS, LINES] = [36, 28]; // the type area in characters
// #region answer: the index in gojūon order: by reading, under あ行 か行 さ行…
// Each mark gives the reading the entry sorts by. A term written with furigana gives it
// itself: :index[{版面|はん|めん}] files 版面 as はんめん. Any other term with a kanji says it
// with yomi: :index[明朝体]{yomi="みんちょうたい"}. Kana and Latin terms need nothing. The
// reading orders the entries in JIS X 4061 order (katakana as hiragana, small kana as large,
// voiced after plain, ー as the vowel before it); Latin terms come first, under A to Z.
const index = {
groupBy: 'gojuon', // what 'auto' picks in a 'ja' document: heads あ行 か行 さ行 …
fontFamily: MINCHO, fontSize: pt(8.5), lineHeight: pt(14),
separator: ' ', locatorSeparator: '、', // 版面 3、5: an ideographic space, then 、
see: { italic: false }, // → ルビ, → 柱も見よ: upright, no italic in Japanese
groups: { fontFamily: GOTHIC, fontSize: pt(9), fontWeight: 700, color: col('vermilion'),
marginTop: pt(7) },
};
// #endregion
// #region opener: the chapter label, the title and a short rule; the index's on a band
const band = { kind: 'box', id: 'band', reserve: false, style: { backgroundColor: col('tint') },
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: 'fill', height: mm(56) } } };
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
#Encapçalaments pel primer kana
'kana' encapçala cada grup amb el primer kana de l'entrada, com fan els diccionaris i els índexs llargs de noms: か, き, く en lloc d'un sol か行.
- groupBy: 'gojuon', // what 'auto' picks in a 'ja' document: heads あ行 か行 さ行 …
+ groupBy: 'kana', // heads か き く け こ…#Una lectura sense furigana al text
Per deixar sense lectura la primera aparició d'un terme i tot i així donar-ne la lectura a l'índex, passa-la a yomi.
-ページのうち、本文が組まれる範囲を:index[{版面|はん|めん}]{main}という。
+ページのうち、本文が組まれる範囲を:index[版面]{yomi="はんめん" main}という。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
El xinès no té cursiva
Les famílies CJK no porten cursiva, i la tipografia xinesa marca l'èmfasi amb punts al costat dels caràcters, no pas inclinant-los. En un document etiquetat com a xinès, *…* posa punts d'èmfasi als caràcters xinesos que abasta i deixa la cursiva per a les paraules llatines (cjk.emphasis: 'dots', el valor predeterminat en xinès); :dots[…] els posa a qualsevol lloc. Amb cjk.emphasis: 'italic', o en un document etiquetat en o es, *…* fa que el canvas inclini els glifs rodons, una obliqua sintètica que la tipografia xinesa no fa servir mai (el PDF recorre a la rodona): conserva l'etiqueta xinesa, o marca l'èmfasi en negreta o amb una font Kai (LXGW WenKai) amb un estil de paràgraf o de xip. Fonts xineses, japoneses i coreanes →
Avís de maquetació · indexReadingMissing
Entrada de l'índex sense lectura
Per què. Un índex japonès ordena les entrades per la lectura, i cap algorisme no llegeix els kanji amb fiabilitat: aquesta entrada té un kanji i cap de les marques no en dona la lectura (yomi, ruby en kana sobre el text marcat o una clau sort en kana), de manera que s'ordena després de les entrades en kana, per punt de codi.
Solució. Afegeix yomi="…" amb la lectura en kana a una de les marques de l'entrada (:index[東京]{yomi="とうきょう"}), o marca un text que porti ruby ({東京|とう|きょう}). Documentació →
- Un terme amb un kanji i sense lectura provoca
indexReadingMissing. Sense el seuyomi, 明朝体 va caure al final de l'índex, després de わ行, sense encapçalament, i la composició va avisar que l'entrada «té un kanji i cap lectura». :ruby[…]dins de:index[…]necessita els claudàtors escapats, perquè la marca acaba al primer]. Fes servir la forma compacta,{版面|はん|めん}.- Una lectura en ruby només compta quan cobreix tots els kanji del terme:
:index[行{取|ど}り]deixa 行 sense lectura i avisa.{行取|ぎょう|ど}りdona ぎょうどり.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Fonts
- Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (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)


