Saltar al contenido principal
Receta número 126

Recetario · Capítulo 5 · Estructura del libro

Un índice japonés en orden gojūon, por la lectura

Un capítulo sobre términos de composición japonesa y su índice: cada marca da su lectura con furigana o yomi, y las entradas van bajo あ行, か行, さ行 en orden JIS.

En esta página
Salida
Canvas · PDF
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.28.0 · postext-pdf ≥ 1.28.0
Licencia
Actualizada el 11 oct 2026
Código MIT · Texto CC BY 4.0

pp. 10–11 · 2–3 de 3

  • Formato 148 × 210 mm
  • 1 columna
  • Noto Serif JP 9/16
  • Noto Sans JP
  • 3 páginas
  • Nivel
  • Postext 1.65.0
  • Compuesto en 107 ms
  • 122 líneas de código

En pocas palabras

Un capítulo breve sobre las palabras de los cajistas japoneses, con un índice al final. Cada palabra indexada lleva su pronunciación, y Postext la usa para ordenar el índice según el orden del kana, bajo las cabezas あ行, か行 y siguientes.

Lo que vas a componer

Un capítulo de un manual inventado de composición japonesa, 組版の言葉 (Las palabras de la composición), y su índice. El capítulo explica los nombres de las partes de la página, de los cuerpos de letra y de las reglas de puntuación, en una página A5 de 36 caracteres por 28 líneas; cada término se marca para el índice donde se explica. El índice es el tema: el japonés no tiene orden alfabético para los kanji, así que un índice ordena cada entrada por su lectura en kana, según la tabla del gojūon (五十音), bajo las cabezas de fila あ行, か行, さ行. Un término con furigana da su lectura por sí solo; cualquier otro término con un kanji la dice en un atributo yomi. El índice de nombres chinos ordena nombres chinos por pinyin y por trazos.

Esta receta responde a

  • ¿Cómo ordeno un índice japonés en orden gojūon según sus lecturas?

La respuesta corta

script.js · líneas 30–42en el código completo
// 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) },
};

Ingredientes

Tipografía
Noto Serif JP, Noto Sans JP (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Una lectura para cada término con kanji

El código es la respuesta corta de arriba. En el texto, :index[{版面|はん|めん}]{main} imprime 版面 con はんめん encima y ordena la entrada como はんめん; :index[明朝体]{yomi="みんちょうたい" main} no imprime lectura y la ordena como みんちょうたい. Los términos en kana, ノンブル o のど, y los latinos, DTP o JIS X 4051, no necesitan nada (Marcas de índice). La lectura solo decide el orden: la entrada se imprime como está escrita. Las lecturas de los kanji no se pueden adivinar, porque 天 es てん aquí y あめ en otras palabras, así que el motor nunca lo intenta.

#2 · Orden JIS y cabezas de fila

groupBy: 'gojuon' es lo que 'auto' elige con locale: 'ja'. Las entradas se ordenan según JIS X 4061: el katakana como el hiragana, el kana pequeño como el grande, un kana sonoro justo después del sordo, ー como la vocal que lo precede. Así, 級 (きゅう) va antes que 行取り (ぎょうどり), y ゴシック体 (ごしっくたい) después de 小口 (こぐち). Los términos latinos van primero, bajo sus letras, como ordena JIS; los símbolos y las cifras irían antes que ellos (Índice analítico).

Página 11: los términos latinos bajo D y J, y después las filas de kana de か行 a わ行, cada entrada por su lectura.

#3 · → y も見よ

Una remisión es una marca con see, :index{term="振り仮名" yomi="ふりがな" see="ルビ"}, e imprime 振り仮名 →ルビ. Una remisión de «véase también» usa seealso e imprime los destinos antes de も見よ, 級 10 →歯も見よ, como lo escriben los índices japoneses. see: { italic: false } deja las etiquetas en redonda, porque una letra japonesa no tiene cursiva. El espacio ideográfico tras cada término y el 、 entre páginas vienen de separator y locatorSeparator.

#4 · El índice a dos columnas

script.js · líneas 46–60en el código completo
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ítulo del índice es un estilo de encabezado con span: 'page' y un layout de dos columnas: su diseño, una banda pálida con el título, cruza la página, y :::index fluye en dos columnas debajo. Las cabezas de fila van en la gótica bermellón; las entradas, en la mincho del texto a 8,5 pt sobre una línea de 14 pt.

La receta 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) } } };

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

#Cabezas por el primer kana

'kana' encabeza cada grupo con el primer kana de la entrada, como hacen los diccionarios y los índices largos de nombres: か, き, く en lugar de un solo か行.

-  groupBy: 'gojuon', // what 'auto' picks in a 'ja' document: heads あ行 か行 さ行 …
+  groupBy: 'kana', // heads か き く け こ…

#Una lectura sin furigana en el texto

Para dejar sin lectura la primera aparición de un término y aun así darle su lectura, pásala a yomi.

-ページのうち、本文が組まれる範囲を:index[{版面|はん|めん}]{main}という。
+ページのうち、本文が組まれる範囲を:index[版面]{yomi="はんめん" main}という。

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 →

Error frecuente

El chino no tiene cursiva

Las familias CJK no traen cursiva, y la tipografía china marca el énfasis con puntos junto a los caracteres, no inclinándolos. En un documento etiquetado como chino, *…* pone puntos de énfasis en los caracteres chinos que abarca y deja la cursiva para las palabras latinas (cjk.emphasis: 'dots', lo predeterminado en chino); :dots[…] los pone en cualquier sitio. Con cjk.emphasis: 'italic', o en un documento etiquetado en o es, *…* hace que el canvas incline los glifos redondos, una oblicua sintética que la tipografía china nunca usa (el PDF recurre a la redonda): conserva la etiqueta china, o marca el énfasis en negrita o en una fuente Kai (LXGW WenKai) con un estilo de párrafo o de chip. Fuentes chinas, japonesas y coreanas →

Aviso de maquetación · indexReadingMissing

Entrada del índice sin lectura

Por qué. Un índice japonés ordena las entradas por su lectura, y ningún algoritmo lee los kanji con fiabilidad: esta entrada tiene un kanji y ninguna de sus marcas da una lectura (yomi, ruby en kana sobre el texto marcado o una clave sort en kana), así que se ordena después de las entradas en kana, por punto de código.

Solución. Añade yomi="…" con la lectura en kana a una de las marcas de la entrada (:index[東京]{yomi="とうきょう"}), o marca un texto que lleve ruby ({東京|とう|きょう}). Documentación →

  • Un término con un kanji y sin lectura provoca indexReadingMissing. Sin su yomi, 明朝体 cayó al final del índice, después de わ行, sin cabeza, y la composición avisó de que la entrada «tiene un kanji y ninguna lectura».
  • :ruby[…] dentro de :index[…] necesita escapar sus corchetes, porque la marca acaba en el primer ]; usa la forma compacta, {版面|はん|めん}.
  • Una lectura en ruby solo cuenta cuando cubre todos los kanji del término: :index[行{取|ど}り] deja 行 sin leer y avisa. {行取|ぎょう|ど}り da ぎょうどり.

Créditos

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