Saltar al contingut principal
Recepta número 126

Receptari · Capítol 5 · Estructura del llibre

Un índex japonès en ordre gojūon, per la lectura

Un capítol sobre termes de composició japonesa i el seu índex: cada marca dona la lectura amb furigana o yomi, i les entrades van sota あ行, か行, さ行 en ordre JIS.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.28.0 · postext-pdf ≥ 1.28.0
Llicència
Actualitzada el 11 d’oct. del 2026
Codi MIT · Text CC BY 4.0

pp. 10–11 · 2–3 de 3

  • Mostra en castellà: encara no hi ha edició en català
  • Format 148 × 210 mm
  • 1 columna
  • Noto Serif JP 9/16
  • Noto Sans JP
  • 3 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 107 ms
  • 122 línies de codi

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

script.js · línies 30–42al codi complet
// 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

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).

Pàgina 11: els termes llatins sota D i J, i després les files de kana de か行 a わ行, cada entrada per la seva lectura.

#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

script.js · línies 46–60al codi complet
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

Sandbox
// ═══ 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 seu yomi, 明朝体 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

Text
Text original, CC BY 4.0
Fonts
Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
SandboxPDF