本文へスキップ
レシピ番号126

レシピ集 · 第5章 · 本の構成

読みで並べる五十音順の日本語索引

日本語の組版用語を扱う章とその索引。各マークは振り仮名かyomiで読みが付き、項目はJISの順に、あ行、か行、さ行の下へ分類されます。

このページの内容
出力
Canvas · PDF
レベル
中級
Postext
Postext 1.65.0で検証済み
1.28.0以上が必要 · postext-pdf ≥ 1.28.0
ライセンス
2026年10月11日更新
コードMIT · 本文CC BY 4.0

10〜11ページ · 2〜3/3

  • 英語の見本:日本語版はまだありません
  • 仕上がり148 × 210 mm
  • 1段
  • Noto Serif JP 9/16
  • Noto Sans JP
  • 3ページ
  • レベル
  • Postext 1.65.0
  • 組版時間108 ms
  • コード122行

かんたんな説明

日本の組版で使う言葉を説明する短い章と、巻末の索引です。索引に載る語はそれぞれ読みが付き、Postextはその読みを使って、あ行、か行といった行見出しの下に五十音順で並べます。

できあがり

架空の日本語組版の手引き『組版の言葉』の1章と、その索引です。章はページの各部の名前、文字サイズの名前、約物の規則を説明し、A5判、36字×28行のページに組みます。各用語は、説明している箇所で索引用にマークします。主役は索引です。日本語の漢字にはアルファベット順のような並びがないので、索引は各項目をかなの読みで、五十音表の順に、あ行、か行、さ行といった行見出しの下へ並べます。振り仮名の付いた用語はそれ自体が読みを示し、それ以外の漢字を含む用語はyomi属性で読みを書きます。中国人名の索引では、中国の人名をピンインと画数で並べます。

このレシピが答える質問

  • 日本語の索引を、読みに基づいて五十音順に並べるには?

手短な答え

script.js · 30〜42行コード全体で見る
// 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) },
};

材料

種類
Noto Serif JP, Noto Sans JP (SIL OFL 1.1)
素材
なし:画像はすべてコードで描画

作り方

#1 · 漢字を含む用語にはかならず読みを

コードは前の手短な答えにあります。本文の:index[{版面|はん|めん}]{main}は、版面の上にはんめんを付けて刷り、項目をはんめんとして分類します。:index[明朝体]{yomi="みんちょうたい" main}は読みを刷らず、みんちょうたいとして分類します。ノンブルやのどのようなかなの用語と、DTPやJIS X 4051のようなラテン文字の用語には何も要りません(索引マーク)。読みが決めるのは並び順だけで、項目は書いたとおりに刷られます。天はここではてんですが、別の文脈ではあめと読むように、漢字の読みは推測できません。そのためエンジンは推測を試みません。

#2 · JISの順と行見出し

groupBy: 'gojuon'は、locale: 'ja'で'auto'が選ぶ値です。項目はJIS X 4061の順に並びます。カタカナはひらがなとして、小書きのかなは並のかなとして扱い、濁音のかなは清音のすぐあとに置き、ーは直前の母音とみなします。そのため級(きゅう)は行取り(ぎょうどり)の前に、ゴシック体(ごしっくたい)は小口(こぐち)のあとに来ます。ラテン文字の用語はJISの順どおり先頭に来て、それぞれの文字の見出しの下に並びます。記号と数字はさらにその前に来ます(索引)。

11ページ:DとJの下にラテン文字の用語、続いてか行からわ行までのかなの行。どの項目も読みの順に並びます。

#3 · →と「も見よ」

「見よ」参照はseeを付けたマークで、:index{term="振り仮名" yomi="ふりがな" see="ルビ"}と書き、「振り仮名 →ルビ」と刷ります。「も見よ」参照はseealsoを使い、日本語の索引の書き方どおり、参照先を「も見よ」の前に置いて「級 10 →歯も見よ」と刷ります。日本語の書体にはイタリックがないので、see: { italic: false }でラベルを正体のままにします。各用語のあとの全角スペースと、ページの間の「、」は、separatorとlocatorSeparatorで決まります。

#4 · 2段にわたる索引

script.js · 46〜60行コード全体で見る
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) } } },
] } });

索引の見出しは、span: 'page'と2段のlayoutを指定した見出しスタイルです。そのデザイン(題名を載せた淡い帯)はページ幅にまたがり、その下で:::indexが2段に流れます。行見出しは朱色のゴシック、項目は本文の明朝で、8.5 ptの文字を14 ptの行送りで組みます。

レシピの全体

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

組み立てたscript.jsはそのまま動きます。任意のページのモジュールスクリプトに貼り付けるか、レシピをCodePenで開いてください。 GitHub上のレシピのフォルダー ↗ (新しいタブで開きます)

アレンジ

#先頭のかなで見出しを立てる

'kana'は、辞書や長い人名索引のように、各グループの見出しに項目の先頭のかなを使います。か行ひとつの代わりに、か、き、くと見出しを立てます。

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

#本文で振り仮名を付けずに読みを与える

用語の初出には読みを付けず、それでも読みを与えるには、読みをyomiに移します。

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

よくあるつまずき

つまずき

日本語のテキストのタグは'ja'。zh-HansやLANGにしない

レシピの版はenとesですが、日本語のサンプルはどちらの版でも日本語です。`locale: LANG`では英語やスペイン語とタグ付けされ、中国語のタグでは中国語の規則で組まれます(開明式の約物、小書きの仮名が行頭に来てもよい、図の代わりに图、PDFでは中国の字形)。postext 1.30以降、このタグはテキストを組む言語(計測、描画、埋め込みに使う言語)でもあるので、'ja'以外のタグでは日本語の字形ではなく別の字形(中国語のタグでは中国の字形)になり、改行の位置も変わります。'ja'と書いてください。日本の地域(JLReqの改行と約物、ゴマの圏点、ルビの間隔、図と表の表示名)が選ばれ、ハイフネーションが切られます。リントは、zhやkoのタグで仮名を含むテキストをエラーにします。 日本語の改行(禁則処理) →

つまずき

日本語は日本語の書体で組む

Noto Serif SCとTCは仮名を持っていますが、漢字は中国の字形(直、骨、角が異なります)で、仮名も中国のデザインで描きます。本文はNoto Serif JPかShippori Mincho B1、見出しはNoto Sans JPで組み、loadCjkFontsで読み込んでください。Fontsourceの日本語ファイルには変体仮名などの古い仮名(U+1B000–1B16F)がないため、loadCjkFontsはそこで失敗し、PDFには四角が印字されます。現代の仮名で書くか、それを持つ書体をレシピのassetsに同梱してください。Shippori Minchoにはマクロン付きの母音ōとūもないので、ローマ字はラテン文字の書体で組んでください。 仮名、漢字、ローマ字 →

つまずき

中国語の書体はcjkブロックを通じてスライス単位で読み込む

Fontsourceは中国語、日本語、韓国語のファミリーを、ウェイトごとに約100個のファイルとして配信し、各ファイルが文字の範囲を受け持ちます。loadFontsが取得するのはlatinファイルだけなので、画面では漢字がシステムの書体で出て計測が狂い、fontsourceProviderはPDFにそのlatinファイルを渡すため、漢字が空の四角で印字されます。キットのcjkブロックを挙げ、loadFontsのあとにloadCjkFonts(FONTS, markdown)を呼び(本で複数のCJK書体を使うときは、それぞれの書体で組むテキストを渡して書体ごとに1回)、renderToPdfにfontProvider: cjkPdfProviderを渡してください。どちらもテキストの文字を含むファイルを取得します。 中国語・日本語・韓国語のフォント →

つまずき

中国語にはイタリックがない

CJKのファミリーにはイタリックがなく、中国語の組版では強調を傾きではなく、文字の横の圏点で示します。中国語とタグ付けした文書では、*…*は中に含む漢字に圏点を付け、ラテン文字の語にはイタリックを使います(cjk.emphasis: 'dots'、中国語の既定)。:dots[…]はどこでも圏点を付けます。cjk.emphasis: 'italic'の場合や、enやesとタグ付けした文書では、*…*によってCanvasが立体のグリフを傾けます。中国語の組版では使わない擬似斜体です(PDFでは立体にフォールバックします)。中国語のタグを保つか、段落スタイルやチップスタイルで強調を太字や楷書体(LXGW WenKai)にしてください。 中国語・日本語・韓国語のフォント →

レイアウト警告 · indexReadingMissing

読みのない索引項目

原因. 日本語の索引は項目を読みで並べますが、漢字を確実に読めるアルゴリズムはありません。この項目には漢字が含まれ、どのマークも読み(yomi、マークしたテキストのかなのルビ、またはかなのソートキー)を与えていないため、かなの項目の後にコードポイント順で並びます。

対処. 項目のマークのどれかに、かなの読みを書いたyomi="…"を加える(:index[東京]{yomi="とうきょう"})か、ルビ付きのテキスト({東京|とう|きょう})をマークしてください。 ドキュメント →

  • 漢字を含み、読みのない用語はindexReadingMissingを出します。yomiがないと、明朝体は見出しのないまま索引の末尾、わ行のあとに落ち、組版時に、その項目は「has a kanji and no reading」という警告が出ました。
  • :index[…]の中の:ruby[…]は角括弧をエスケープする必要があります。マークは最初の]で終わるからです。簡潔な形、{版面|はん|めん}で書いてください。
  • ルビの読みが使われるのは、用語のすべての漢字を覆っているときだけです。:index[行{取|ど}り]では行の読みが欠けて警告が出ます。{行取|ぎょう|ど}りならぎょうどりになります。

クレジット

レシピ
Ignacio Ferro
本文
書き下ろしの文章, CC BY 4.0
フォント
Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
SandboxPDF