Pular para o conteúdo principal
Receita número 126

Receitas · Capítulo 5 · Estrutura do livro

Um índice japonês em ordem gojūon, pela leitura

Um capítulo sobre termos de composição japonesa e o índice: cada marca dá a leitura por furigana ou yomi, e as entradas ficam sob あ行, か行, さ行 em ordem JIS.

Nesta página
Saída
Canvas · PDF
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.28.0 · postext-pdf ≥ 1.28.0
Licença
Atualizada em 11 de out. de 2026
Código MIT · Texto CC BY 4.0

p. 10–11 · 2–3 de 3

  • Amostra em inglês: ainda sem edição em português
  • Refile 148 × 210 mm
  • 1 coluna
  • Noto Serif JP 9/16
  • Noto Sans JP
  • 3 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 108 ms
  • 122 linhas de código

Em poucas palavras

Um capítulo curto que explica as palavras usadas pelos tipógrafos japoneses, com um índice no fim. Cada palavra indexada traz a pronúncia, e o Postext a usa para ordenar o índice na ordem dos kana, sob os grupos あ行, か行 e seguintes.

O que você vai compor

Um capítulo de um manual inventado de composição japonesa, 組版の言葉 (As palavras da composição), e o índice. O capítulo explica os nomes das partes da página, dos tamanhos de tipo e das regras de pontuação, numa página A5 de 36 caracteres por 28 linhas; cada termo é marcado para o índice onde é explicado. O índice é o assunto: o japonês não tem ordem alfabética para os kanji, por isso um índice organiza cada entrada pela leitura em kana, na ordem da tabela gojūon (五十音), sob os cabeços de linha あ行, か行, さ行. Um termo com furigana dá a leitura por si só; qualquer outro termo com kanji a informa num atributo yomi. O índice de nomes chineses ordena nomes chineses por pinyin e por traços.

Esta receita responde a

  • Como ordeno um índice japonês na ordem gojūon pelas leituras?

A resposta curta

script.js · linhas 30–42no 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

Tipografia
Noto Serif JP, Noto Sans JP (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Uma leitura para cada termo com kanji

O código está na resposta curta, mais acima. No texto, :index[{版面|はん|めん}]{main} imprime 版面 com はんめん em cima e arquiva a entrada como はんめん; :index[明朝体]{yomi="みんちょうたい" main} não imprime leitura e a arquiva como みんちょうたい. Termos em kana, ノンブル ou のど, e termos latinos, DTP ou JIS X 4051, não precisam de nada (Marcas de índice). A leitura decide só a ordem: a entrada sai impressa como foi escrita. Leituras de kanji não podem ser adivinhadas, já que 天 é てん aqui e あめ em outras palavras, por isso o motor nunca tenta.

#2 · Ordem JIS e cabeços de linha

groupBy: 'gojuon' é o que 'auto' escolhe para locale: 'ja'. As entradas são ordenadas pela JIS X 4061: katakana como hiragana, kana pequeno como grande, um kana sonoro logo depois do surdo, ー como a vogal que vem antes dele. Assim, 級 (きゅう) vem antes de 行取り (ぎょうどり), e ゴシック体 (ごしっくたい) depois de 小口 (こぐち). Os termos latinos vêm primeiro, sob as letras, como a JIS os ordena; símbolos e algarismos viriam antes deles (Índice remissivo).

Página 11: termos latinos sob D e J, depois as linhas de kana de か行 a わ行, cada entrada pela leitura.

#3 · → e も見よ

Uma remissão é uma marca com see, :index{term="振り仮名" yomi="ふりがな" see="ルビ"}, e imprime 振り仮名 →ルビ. Uma remissão do tipo “ver também” usa seealso e imprime os destinos antes de も見よ, 級 10 →歯も見よ, como os índices japoneses escrevem. see: { italic: false } mantém os rótulos em redondo, já que uma fonte japonesa não tem itálico. O espaço ideográfico depois de cada termo e o 、 entre as páginas vêm de separator e locatorSeparator.

#4 · O índice em duas colunas

script.js · linhas 46–60no 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) } } },
] } });

O título do índice é um estilo de título com span: 'page' e um layout de duas colunas: o design dele, uma faixa clara com o título, ocupa a largura da página, e :::index corre em duas colunas embaixo. Os cabeços de linha são compostos na gótica vermelhão, e as entradas no mincho do texto a 8,5 pt numa linha de 14 pt.

A receita 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 = 'en'; // @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) } } };

O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)

Variações

#Cabeços pelo primeiro kana

'kana' encabeça cada grupo com o primeiro kana da entrada, como fazem os dicionários e os índices longos de nomes: か, き, く em vez de um único か行.

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

#Uma leitura sem furigana no texto

Para deixar sem leitura a primeira menção de um termo e ainda assim dar a leitura dele, passe a leitura para yomi.

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

Erros comuns

Erro comum

Marque um texto japonês como 'ja', nunca com zh-Hans nem LANG

As edições de uma receita são en e es, mas uma amostra japonesa é japonesa nas duas: `locale: LANG` a marcaria como inglês ou espanhol, e uma marcação chinesa a comporia pelas regras chinesas (pontuação Kaiming, kana pequeno livre para começar linha, 图 no lugar de 図, formas chinesas dos glifos no PDF). Desde o postext 1.30 a marcação é também o idioma em que o texto é composto (em que é medido, pintado e incorporado), então qualquer marcação que não seja 'ja' dá outras formas de glifo que não as japonesas (as chinesas, sob uma marcação chinesa) e outras quebras de linha. Escreva 'ja': isso escolhe a região do Japão (quebra de linha e pontuação da JLReq, pontos de ênfase em gergelim, espaçamento dos furigana, rótulos 図 e 表) e desativa a hifenização. O lint reprova um texto com kana sob uma marcação zh ou ko. Quebra de linha em japonês (kinsoku) →

Erro comum

Componha o japonês com uma fonte japonesa

A Noto Serif SC e a TC têm kana, mas desenham os kanji com formas chinesas (直, 骨 e 角 mudam) e o kana com desenho chinês. Componha o texto em Noto Serif JP ou Shippori Mincho B1 e os títulos em Noto Sans JP, carregadas com loadCjkFonts. Os arquivos japoneses do Fontsource não têm hentaigana nem outros kana históricos (U+1B000–1B16F): loadCjkFonts falha com eles e o PDF imprime caixas, então escreva o kana moderno ou inclua nos recursos da receita uma fonte que os tenha. A Shippori Mincho também não tem as vogais com mácron ō e ū: componha o rōmaji com uma fonte latina. Kana, kanji e rōmaji →

Erro comum

Fontes chinesas são carregadas em fatias, pelo bloco cjk

O Fontsource serve uma família chinesa, japonesa ou coreana em cerca de cem arquivos por peso, cada um com um intervalo de caracteres. loadFonts baixa só o arquivo latin, então na tela os caracteres chineses vêm de uma fonte do sistema e são medidos errado, e o fontsourceProvider entrega ao PDF esse arquivo latin, que os imprime como caixas vazias. Inclua o bloco cjk do kit, chame loadCjkFonts(FONTS, markdown) depois de loadFonts (uma vez por voz, com o texto que ela compõe, quando o livro usa várias fontes CJK) e passe a renderToPdf fontProvider: cjkPdfProvider: os dois pegam os arquivos que contêm os caracteres do texto. Fontes chinesas, japonesas e coreanas →

Erro comum

O chinês não tem itálico

As famílias CJK não trazem itálico, e a tipografia chinesa marca a ênfase com pontos ao lado dos caracteres, não com inclinação. Em um documento marcado como chinês, *…* coloca pontos de ênfase nos caracteres chineses que abrange e deixa o itálico para as palavras latinas (cjk.emphasis: 'dots', o padrão para o chinês); :dots[…] os coloca em qualquer lugar. Com cjk.emphasis: 'italic', ou em um documento marcado como en ou es, *…* faz o canvas inclinar os glifos redondos, um oblíquo sintético que a tipografia chinesa nunca usa (o PDF recorre à fonte redonda): mantenha a marcação chinesa ou faça a ênfase em negrito ou em uma fonte Kai (LXGW WenKai) com um estilo de parágrafo ou de chip. Fontes chinesas, japonesas e coreanas →

Aviso de diagramação · indexReadingMissing

Entrada de índice sem leitura

Por quê. Um índice japonês ordena as entradas pela leitura, e nenhum algoritmo lê kanji com segurança: esta entrada tem um kanji e nenhuma das marcas dela indica uma leitura (yomi, rubi em kana sobre o texto marcado ou uma chave sort em kana); por isso, ela é ordenada depois das entradas em kana, por ponto de código.

Correção. Adicione yomi="…" com a leitura em kana a uma das marcas da entrada (:index[東京]{yomi="とうきょう"}) ou marque um texto que tenha rubi ({東京|とう|きょう}). Docs →

  • Um termo com kanji e sem leitura gera indexReadingMissing. Sem o yomi, 明朝体 caiu para o fim do índice, depois de わ行, sem cabeço, e a composição avisou que a entrada “tem um kanji e nenhuma leitura”.
  • :ruby[…] dentro de :index[…] precisa ter os colchetes escapados, porque a marca termina no primeiro ]; escreva a forma compacta, {版面|はん|めん}.
  • Uma leitura em rubi só conta quando cobre todos os kanji do termo: :index[行{取|ど}り] deixa 行 sem leitura e emite um aviso. {行取|ぎょう|ど}り dá ぎょうどり.

Créditos

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