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

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

中国語の人名索引:拼音順と画数順

1組の:indexマークから『紅樓夢』読本の2つの版を組みます。index.groupByがzh-Hansでは拼音の頭文字、zh-Hantでは画数で人名を分類します。

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

6〜7ページ(全16ページ)

  • 英語の見本:日本語版はまだありません
  • 仕上がり140 × 203 mm
  • 1段
  • Noto Serif SC 10.5/18
  • LXGW WenKai TC
  • Ma Shan Zheng
  • Noto Sans SC
  • Noto Sans TC
  • Noto Serif TC
  • 16ページ
  • レベル
  • Postext 1.65.0
  • 組版時間142 ms
  • コード180行

かんたんな説明

中国の古典小説の短い読本で、巻末に登場人物の名前の索引がつきます。同じ印から2つの版ができ、一方は読みの順、もう一方は筆画の数の順に並びます。

できあがり

『紅樓夢』の薄い読本です。第1回から第3回のうち、登場人物が初めて現れるくだりを再録し、巻末に47人の名前の索引を置きます。ほかの呼び名からの参照も4つあります。同じマークから2つの版を組みます。中国本土向けの簡体字版は名前を拼音の頭文字F、H、J…で分類し、台湾向けの繁体字版は最初の字の画数、三畫、四畫…で分類します。どちらも140 × 203 mmの大32开のペーパーバックで、本文はNoto Serifで1行26字、回の題は楷体の書体で、キッカー、ノンブル、索引の見出しはNoto Sansで組みます。カードには簡体字版の索引の最初の組、FからLまでを拡大して載せています。人名索引と事項索引では、英語の研究書で同じ種類の索引を組んでいます。

このレシピが答える質問

  • 中国語の人名索引をピンイン順や画数順でまとめるには?
  • 中国語の文字を、空の四角にせずにPDFへ入れるには?

手短な答え

script.js · 44〜57行コード全体で見る
// Marks in the Markdown, one per passage; main is the page where the character enters:
//   字:index[士隐]{term="甄士隐" main}      :index{term="贾化" see="贾雨村"}
// Printed at the end of each edition: # 人名索引 {style="index"}, then :::index
const index = (e) => ({
  // 'auto' reads the same from the locale: pinyin for zh-Hans, strokes for zh-Hant.
  groupBy: e.locale === 'zh-Hans' ? 'pinyin' : 'stroke', // A B C… or 三畫 四畫…
  fontFamily: e.serif, fontSize: pt(9), lineHeight: pt(14),
  separator: '\u3000', locatorSeparator: ',', // 贾宝玉 4,6: an ideographic space, then ,
  see: { italic: false }, // 见 / 見 upright: Chinese has no italic (gotcha: cjk-no-italic)
  groups: { fontFamily: e.sans, fontSize: pt(9.5), fontWeight: 700, color: col('cinnabar'),
    marginTop: pt(6.25) }, // the three names of 九畫 stay whole at the foot of their column
});
const indexHeading = { id: 'index', numbered: false, breakBefore: { enabled: true, parity: 'any' },
  layout: { layoutType: 'double', gutterWidth: pt(21) } }; // two columns, 2 characters apart

材料

種類
Noto Serif SC, Noto Sans SC, Ma Shan Zheng, Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1)
素材
なし:画像はすべてコードで描画

作り方

#1 · 読者が初めて出会う箇所に名前の印をつける

コードは上の手短な答えにあり、残りはMarkdownの中にあります。マークは、本文が何を印字していても、フルネームで項目を立てます。字:index[士隐]{term="甄士隐" main}は士隐と印字し、そのページを甄士隐の項目に入れます。mainはそのページを太字にします。索引の表題の下の注記は、ここでの太字の意味、つまりその人物が本人として登場するページであることを説明しています。賈宝玉は第2回で名前を出されないまま生まれる(又生了一位公子)ので、印字する文字のないマーク:index{term="贾宝玉"}を置き、項目は4, 6となります。別名やあだ名にはそれぞれ参照項目を立てます。:index[凤辣子]{term="凤辣子" see="王熙凤"}は、Postextが中国語の流儀、つまり句点の後に空白を入れずに、凤辣子。见王熙凤と印字します(索引マーク)。

#2 · 並べ方はロケールに選ばせる

script.js · 30〜37行コード全体で見る
// The mainland edition in Simplified characters and the Taiwan edition in Traditional ones.
// Each takes the Song (serif), Hei (sans) and Kai faces cut for its script. Fontsource has no
// Kai text face with mainland forms: LXGW WenKai TC draws 冷 the Taiwan way, so the mainland
// titles take Ma Shan Zheng, a brush Kai.
const EDITIONS = {
  hans: { locale: 'zh-Hans', serif: 'Noto Serif SC', sans: 'Noto Sans SC', kai: 'Ma Shan Zheng' },
  hant: { locale: 'zh-Hant', serif: 'Noto Serif TC', sans: 'Noto Sans TC', kai: 'LXGW WenKai TC' },
};

2つの版は設定を共有し、索引について切り替えるのはlocaleだけです。groupBy: 'auto'はzh-Hansの索引を拼音で、zh-Hantの索引を画数で分類します。手短な答えでは、見てわかるように2つの値を書き出しています。項目は見出しと同じ基準で並ぶので、同じ名前でも順番が入れ替わります。甄费はZの組で甄士隐の前に来ますが(fèiはshìより前)、十四畫の組では後になります(士は3画、費は12画)。宁国公と荣国公はNとRに分かれますが、寧國公と榮國公は14画の名前の中で並んだままです(索引)。読みと画数はブラウザーの中国語の照合順序によるものです。読みを誤る姓(曾、单、解)には、正しい読みを表す字でsortキーを与えます。

#3 · 書体ごとに、組む字だけを読み込む

script.js · 270〜279行コード全体で見る
const DIGITS = '0123456789';
const HEADS = '第回一二三四五六七八九十画畫ABCDEFGHIJKLMNOPQRSTUVWXYZ'; // 第一回, the index heads
const all = (md, re) => [...md.matchAll(re)].map((m) => m[1]).join('\n');
for (const [key, md] of [['hans', markdown], ['hant', traditional]]) {
  e = EDITIONS[key];
  await loadCjkFonts({ [e.serif]: ['400'] }, md); // the text, the index, the running heads
  await loadCjkFonts({ [e.serif]: ['700'] }, DIGITS); // the bold page numbers
  await loadCjkFonts({ [e.sans]: ['700'] }, all(md, /kicker="([^"]*)"/g) + HEADS + DIGITS);
  await loadCjkFonts({ [e.kai]: ['400'] }, all(md, /^# ([^{\n]*)/gm)); // the titles alone
}

Fontsourceは中国語の各ウェイトを約100のファイルに分けており、loadCjkFontsはテキストが触れるファイルだけを取りに行きます。宋体には本全体を渡すので、柱の文字に追加の負担はありません。宋体の太字には主要ページを示す数字、黒体にはkicker属性のテキスト、索引の見出し、ノンブルの数字、楷体には3つの対句と人名索引を渡します。PDFも同じ道をたどります。cjkPdfProviderはそれらのファイルを、ページで使う字だけに絞って埋め込むので、空の四角になる字はありません。楷体は版によって変わります。Fontsourceにある唯一の本文用の楷体LXGW WenKai TCは旧字形で描き(冷の旁の令の下が古い卩の形)、読点と句点を字面の中央に置きます。そのため簡体字版の題は、本土の字形の筆書きの楷体Ma Shan Zhengで組んでいます(中国語・日本語・韓国語のフォント)。

#4 · 注記は索引の扉に置く

script.js · 61〜81行コード全体で見る
const opener = (e, sink, kicker, note = []) => ({
  enabled: true,
  minHeight: pt(LEAD * sink), // the text starts on the same line after every opener
  slot: { elements: [
    { kind: 'text', id: 'kicker', content: kicker, fontFamily: e.sans, fontSize: pt(9),
      fontWeight: 700, letterSpacing: pt(2.7), color: col('cinnabar'), align: 'center',
      placement: { ...at('container', 'top', 0, 8), size: { width: 'fill', height: 'auto' } } },
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: e.kai, fontSize: pt(16),
      lineHeight: 1.45, color: col('ink'), align: 'center',
      overflow: 'wrap', // design text ends in an ellipsis by default
      placement: { ...at('#kicker', 'below', 0, 3), size: { width: 'fill', height: 'auto' } } },
    { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.5), color: col('rule'),
      placement: { ...at('#title', 'below', (MEASURE - 12) / 2, 4), size: { width: mm(12) } } },
    ...note,
  ] },
});
// The note (note="…" on the heading) sits above the columns: no paragraph for balancing to loosen.
const indexNote = (e) => [{ kind: 'text', id: 'note', content: '{attr.note}',
  fontFamily: e.serif, fontSize: pt(9), lineHeight: 1.6, color: col('muted'), align: 'center',
  overflow: 'wrap', placement: { ...at('#rule', 'below', -(MEASURE - 12) / 2, 4),
    size: { width: 'fill', height: 'auto' } } }];

注記は見出しの属性# 人名索引 {style="index" kicker="按汉语拼音排列" note="…"}で、2段組みの上に行長いっぱいで組みます。段の中の段落にしていたときは、段末そろえの調整に使われてしまいました。繁体字版の最終ページの段をそろえるために、14字の段で1行12字までゆるめられたのです。注記は本索引收录前三回选文中的人物,粗体页码为人物出场之页;别名与原名另立参见条目。という1つの文で、デザインが行を折り返します。中国語の本のデザインテキストは本文と同じ禁則処理と約物の幅に従うので、,;は簡体字版では半角、繁体字版では全角になり、本文とそろいます。注記の行が約物で始まることもありません。回の扉も同じデザインを使い、キッカーは第{numberHan}回です。これは文書の文字体系で第一回と印字します。

#5 · 2つの版の索引ページを並べて見せる

script.js · 304〜320行コード全体で見る
const indexPage = (doc) => doc.pages[doc.blocks.find((b) => b.headingStyleId === 'index')
  ?.pageIndex ?? doc.pages.length - 1];
const labels = { hans: t({ en: 'Simplified · by pinyin', es: 'Simplificado · por pinyin' }),
  hant: t({ en: 'Traditional · by strokes', es: 'Tradicional · por trazos' }) };
document.getElementById('pages').insertAdjacentHTML('beforebegin', `<section id="indexes" style="
  display:flex;flex-wrap:wrap;justify-content:center;gap:24px;padding:28px 16px;background:#e9e4da">
  ${Object.keys(docs).map((key) => `<figure style="margin:0;width:min(340px,44vw)">
  <canvas id="index-${key}" role="img" style="display:block;width:100%;background:#fff;
  box-shadow:0 18px 36px -18px rgb(0 0 0 / .45)"></canvas><figcaption style="margin-top:10px;
  font:600 11px/1 system-ui,sans-serif;letter-spacing:.14em;text-transform:uppercase;color:#5b534a">
  ${labels[key]}</figcaption></figure>`).join('')}</section>`);
for (const [key, doc] of Object.entries(docs)) {
  const canvas = document.getElementById(`index-${key}`);
  const page = indexPage(doc);
  canvas.setAttribute('aria-label', `${labels[key]}, ${page.pageLabel}`);
  renderPageToCanvas(page, doc, canvas, { scale: (2 * canvas.clientWidth) / page.width });
}

CodePenのサンプルは両方の版をビルドし、デスクには簡体字版を表示します。简体版と繁體版のボタンでデスクを切り替えると、そのたびに表示中の版のPDF、chinese-name-index-hans.pdfかchinese-name-index-hant.pdfが提供されます。キャプチャーは両方のビルドを記録します(capture.doc: ['first', 'last'])。上の最初の8ページが簡体字版、その後の4ページが繁体字版で、最初のページと画数順の索引です。デスクの上の帯には、それぞれの版の索引の最初のページを並べています。レシピに添えたPDFは簡体字版のものです。

レシピの全体

Sandbox
// ═══ Postext Cookbook · Nº 079 · An index of Chinese names, by pinyin and by strokes ═══
// https://postext.dev/en/cookbook/chinese-name-index
// Code: MIT · Text: 紅樓夢 (1792), zh.wikisource revision 9685985 (CC BY-SA 4.0) · Pictures: none
// Fonts: Noto Serif/Sans SC/TC, Ma Shan Zheng, LXGW WenKai TC (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 sample document ('en' | 'es')
const RECIPE = 'chinese-name-index';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink on a warm paper, one cinnabar for the heads and the index letters
const palette = {
  ink: '#1f1b18', // text
  cinnabar: '#a3301f', // the one accent: 回 numbers, index heads
  muted: '#6b635a', // running heads, folios, colophon
  rule: '#d6cdbf', // the short rule under each title
  paper: '#fbf8f1',
};
// Each colour carries its hex and the palette entry it follows.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  // The engine's defaults link to main-color: point it at the accent, never the default blue.
  { id: 'main-color', name: 'accent (defaults)', value: { hex: palette.cinnabar, model: 'hex' } },
];
// #endregion

// #region editions: one book, two scripts; the locale decides the index order
// The mainland edition in Simplified characters and the Taiwan edition in Traditional ones.
// Each takes the Song (serif), Hei (sans) and Kai faces cut for its script. Fontsource has no
// Kai text face with mainland forms: LXGW WenKai TC draws 冷 the Taiwan way, so the mainland
// titles take Ma Shan Zheng, a brush Kai.
const EDITIONS = {
  hans: { locale: 'zh-Hans', serif: 'Noto Serif SC', sans: 'Noto Sans SC', kai: 'Ma Shan Zheng' },
  hant: { locale: 'zh-Hant', serif: 'Noto Serif TC', sans: 'Noto Sans TC', kai: 'LXGW WenKai TC' },
};
// #endregion
const LEAD = 18; // body leading in pt: 1.7 × the 10.5 pt text (五号)
const MEASURE = (26 * 10.5 * 25.4) / 72; // the grid's 26 characters of 10.5 pt, in mm
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });

// #region answer: the same marks, grouped by pinyin in zh-Hans and by strokes in zh-Hant
// Marks in the Markdown, one per passage; main is the page where the character enters:
//   字:index[士隐]{term="甄士隐" main}      :index{term="贾化" see="贾雨村"}
// Printed at the end of each edition: # 人名索引 {style="index"}, then :::index
const index = (e) => ({
  // 'auto' reads the same from the locale: pinyin for zh-Hans, strokes for zh-Hant.

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

アレンジ

#繁体字の索引を拼音で分類する

名前を読みで引く読者向けの繁体字版なら、拼音で分類できます。両方の版でgroupBy: 'pinyin'にすると、見出しはA–Zになり、項目は繁体字の字形のままです。キッカーは索引の並べ方を示しているので、繁体字のMarkdownでもkicker="依漢語拼音排列"に変えてください。

-  groupBy: e.locale === 'zh-Hans' ? 'pinyin' : 'stroke', // A B C… or 三畫 四畫…
+  groupBy: 'pinyin', // A B C… in both scripts

#見出しなしで名前を並べる

短い名前の一覧なら、組のあいだを1行空け、見出しを置かなくても読みやすく組めます。分類はそのままにして、見出しだけを消します。groupBy: 'none'ではうまくいきません。これは記号、数字、単語だけを分けるもので、ここでは名前がすべて漢字で始まるため、47人が一塊になってしまいます。

-  groups: { fontFamily: e.sans, fontSize: pt(9.5), fontWeight: 700, color: col('cinnabar'),
-    marginTop: pt(6.25) }, // the three names of 九畫 stay whole at the foot of their column
+  groups: { enabled: false, marginTop: pt(14) }, // no heads; a blank line between groups

よくあるつまずき

つまずき

中国語の書体は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)にしてください。 中国語・日本語・韓国語のフォント →

つまずき

文書のタグはLANGではなくzh-Hansかzh-Hantにする

レシピの版はenとesですが、中国語のサンプルはどちらの版でも中国語です。`locale: LANG`では英語やスペイン語とタグ付けされ、ラテン文字の語がハイフネーションされ、図にFigureやFiguraの表示名が付き、PDFの言語も誤ります。postext 1.30以降、このタグはテキストを組む言語(計測、描画、埋め込みに使う言語)でもあるので、英語やスペイン語のタグでは、中国語のフォントの数字と、ラテン文字のテキストと共通の約物が別の字形になり、改行の位置も変わります。タグは自分で書いてください。'zh-Hans'(中国本土の慣習:GBの改行規則、開明式の約物)または'zh-Hant'(台湾:全角で中央に置く約物)、香港なら'zh-HK'です。単なる'zh'は簡体字、本土として読まれます。日本語のサンプルには'ja'を使います(つまずき「ja-locale-tag」)。 中国語の改行 →

つまずき

各地域の約物はその地域の書体で組む

約物の幅の処理は、各記号の横の空きを、フォントが描く側ではなく、文書の地域が置く側に移します。zh-Hansでは開明式の読点は箱の左半分を残し(簡体字の書体はそこにグリフを描きます)、右半分を手放します。繁体字の書体は,。を箱の中央に描くため、手放す半分にグリフの一部があり、読点が次の文字に食い込みます。Fontsourceで唯一の楷書の本文書体であるLXGW WenKai TCは、簡体字のテキストでこうなります。本土のテキスト、注、引用はNoto Serif SCかNoto Sans SCで組み、TCの書体はzh-Hantに取っておき、簡体字の毛筆書体(Ma Shan Zheng)は表示用の行だけに使ってください。デザインのテキストには約物の幅の処理がかからないためです。LXGW WenKai TCは、本土の規格も台湾の規格も使わない伝承字形も描きます。爲の爫の頭を持つ為や、卩の足を持つ令(冷、領の中も)です。この書体で組むページの文字を確認してください。 中国語の約物の幅 →

  • indexの設定は文書に属するので、1つの文書で印字できる並べ方は1つです。拼音順の索引と画数順の検字表の両方がほしい本は、このCodePenのサンプルと同じように2回ビルドします。
  • 文字グリッドでは段末そろえが既定でオフなので、そのままでは各索引の最終ページで第1段が地まで埋まります。簡体字版の奥付はZの下で始まり、第2段の頭で終わります。headings.balancing: { enabled: true }にすると、このページの第1段が早めに切られ、名前は第2段に続き、奥付はその下にまとまって入ります(段末そろえ)。切れ目は項目と項目の間に入り、グループの名前を1つだけ段の末尾や頭に残すことはありません(index.groups.splitMinEntries、既定は2)。そのため、2つの段がそろうのは長さが合うときだけです。ここでは各版の奥付に索引の配列についての1文を入れてあり、どちらの最終ページでも2つの段の差は3分の1行以内です。

クレジット

レシピ
Ignacio Ferro
本文
フォント
Noto Serif SC (SIL OFL 1.1) · Noto Sans SC (SIL OFL 1.1) · Ma Shan Zheng (SIL OFL 1.1) · Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1)
SandboxPDF