かんたんな説明
日本の組版で使う言葉を説明する短い章と、巻末の索引です。索引に載る語はそれぞれ読みが付き、Postextはその読みを使って、あ行、か行といった行見出しの下に五十音順で並べます。
できあがり
架空の日本語組版の手引き『組版の言葉』の1章と、その索引です。章はページの各部の名前、文字サイズの名前、約物の規則を説明し、A5判、36字×28行のページに組みます。各用語は、説明している箇所で索引用にマークします。主役は索引です。日本語の漢字にはアルファベット順のような並びがないので、索引は各項目をかなの読みで、五十音表の順に、あ行、か行、さ行といった行見出しの下へ並べます。振り仮名の付いた用語はそれ自体が読みを示し、それ以外の漢字を含む用語はyomi属性で読みを書きます。中国人名の索引では、中国の人名をピンインと画数で並べます。
このレシピが答える質問
- 日本語の索引を、読みに基づいて五十音順に並べるには?
手短な答え
// 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) },
};
材料
- 機能
- 五十音順の索引索引ふりがな:漢字に付ける仮名の読みルビ:ピンインと注音中国語・日本語・韓国語のフォント日本語の改行(禁則処理)日本語の約物のアキ見出しスタイル番号のない章番号付き見出し行取りの見出し1段組みと2段組み文字グリッドデザインした章扉見出しの属性柱とノンブル見開きの余白段落スタイルPDFの書き出し
- 種類
- 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の順どおり先頭に来て、それぞれの文字の見出しの下に並びます。記号と数字はさらにその前に来ます(索引)。

#3 · →と「も見よ」
「見よ」参照はseeを付けたマークで、:index{term="振り仮名" yomi="ふりがな" see="ルビ"}と書き、「振り仮名 →ルビ」と刷ります。「も見よ」参照はseealsoを使い、日本語の索引の書き方どおり、参照先を「も見よ」の前に置いて「級 10 →歯も見よ」と刷ります。日本語の書体にはイタリックがないので、see: { italic: false }でラベルを正体のままにします。各用語のあとの全角スペースと、ページの間の「、」は、separatorとlocatorSeparatorで決まります。
#4 · 2段にわたる索引
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の行送りで組みます。
レシピの全体
// ═══ 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[行{取|ど}り]では行の読みが欠けて警告が出ます。{行取|ぎょう|ど}りならぎょうどりになります。
クレジット
- 本文
- 書き下ろしの文章, CC BY 4.0
- フォント
- Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)


