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
// 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
- Funciones
- Índice en orden gojūonÍndice analíticoFurigana: lecturas en kana sobre los kanjiRuby: lecturas en pinyin y zhuyinFuentes chinas, japonesas y coreanasCorte de líneas japonés (kinsoku)Espaciado de la puntuación japonesa (yakumono)Estilos de títuloCapítulos sin númeroTítulos numeradosTítulos que ocupan líneas del texto (gyōdori)Una o dos columnasRetícula de caracteresAperturas diseñadasAtributos de títuloCabeceras y foliosMárgenes simétricosEstilos de párrafoExportación a PDF
- También usa
- Corte de líneas en chinoEquilibrado de columnasCabeceras según el tipo de páginaFuentes incrustadas en el PDFGeometría por sección
- 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).

#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
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
// ═══ 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 suyomi, 明朝体 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
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


