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

レシピ集 · 第2章 · 文字と本文

かな・漢字・欧文が混じる日本語の技術書

日本語のプログラミング書のA5判の一章。JLReqの禁則処理と約物のアキ、和欧間の四分アキ、コード、図3-1、ページごとの脚注を組みます。

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

かんたんな説明

日本語のプログラミング書の一章です。日本語の文に英単語やコード、数字がたくさん混じります。Postextは約物と改行を日本語の規則で組み、日本語と欧文が接するところに細いアキを入れます。

できあがり

架空の日本語のプログラミング書『実践 日本語テキスト処理』から、Unicode正規化を扱う第3章の5ページです。日本のコンピューター書の体裁で組みます。A5判、1段組みで、9ptのNoto Serif JPを1行36字、29行、見出しはNoto Sans JP、コードはBIZ UDGothicです。この本文は日本語組版にとって難しい題材です。2文に1文は欧文の単語、コードポイント、数字、関数名を含むからです。改行はJLReqのもっとも厳しい禁則処理に従い、約物は全角のアキを保ち、誰もスペースを打たなくても日本語と欧文のあいだには四分アキが入ります。図、表、コードリスト、脚注には日本語のラベルがつきます。図3-1、表3-1、ページごとに数える上つきの注番号です。コードリストとキーキャップは、同じ種類のページを英語で組んでいます。

このレシピが答える質問

  • 和文の約物のアキを調整するには(、。「」が続くときの詰め、?!の後と段落頭の始めかっこのアキ)?
  • 小書きのかな、ー、閉じかっこが行頭に来てはいけないのはなぜですか?規則の厳しさを選ぶには?
  • 日本語のテキストが中国語の規則で組まれる(ラベルが图、小書きのかなが行頭に来る、漢字が中国の字形)のはなぜですか?

手短な答え

script.js · 34〜56行コード全体で見る
// locale 'ja' turns on JLReq composition: kinsoku at its strictest, full-width marks squeezed
// where two meet (」、 takes one em, not two), a closing mark keeps its half em at a line
// end, 、。 may hang past it, and a paragraph opening with 「 sets the bracket in the indent.
// The values below are the ones 'auto' picks for 'ja'; they are spelled out to be seen.
const cjk = {
  lineBreak: 'ja-very-strict', // no line starts with ー, small kana, 々, 」、。?・ or :
  punctuationWidth: 'fullwidth', // 、。「」 keep their em inside the line (JLReq §3.1.2)
  hangingPunctuation: 'allow', // 、。 hang only when the line would otherwise break before them
  paragraphStartBracket: 'half', // 「 at a paragraph start sits in the indent's second half
  latinSpacing: em(0.25), // 四分アキ between kana or kanji and Latin letters or digits
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES }, // whole ems, whole lines
};
// The Latin is the Japanese face's own proportional Latin, at the text's size: never
// full-width A or a second face for the words in parentheses.
const bodyText = {
  fontFamily: MINCHO, fontSize: pt(BODY), lineHeight: pt(PITCH), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  textAlign: 'justify', firstLineIndent: em(1), indentAfterHeading: true, // 1 字下げ
  referenceBold: false, // 図3-1 and 表3-1 in the text weight: the face loads no bold
  hyphenation: { enabled: false }, avoidRunts: true, // no one-character last line
  // The grid cuts a list where the page ends: the four forms stay in one piece.
  shortListSplit: 'avoid', shortListMaxItems: 4,
};

材料

種類
Noto Serif JP, Noto Sans JP, BIZ UDGothic (SIL OFL 1.1)
素材
  • Figure 3-1, the bytes of が, drawn in code in the page’s palette (Postext Cookbook, CC BY 4.0)

作り方

#1 · 日本語の規則は言語タグについてくる

コードは上の手短な答えにあります。locale: 'ja'で、W3Cの『日本語組版処理の要件』(JLReq)の規則が有効になります。cjkの下に書き出した値は、日本語に対して'auto'が選ぶ値です(東アジアの組版)。ja-very-strictでは、ー、小書きのかな、々、閉じ括弧類で始まる行も、始め括弧類で終わる行もできません。約物は行の中で全角のアキを保ち、」、のように2つが続くときは2つで全角1つ分を分け合います。41ページで「実際に変換し、」で終わる行は、その「、」を行長の右端の外に出しています。これがぶら下げで、エンジンはそうしなければ約物を次の行へ送るしかないときにだけ使います。latinSpacingは、Markdownにスペースがなくても、Unicodeと「では」のあいだ、U+304Cと「を」のあいだに四分アキを入れます。このアキは英字か数字の隣にだけ入ります。normalize()とis_normalized()は括弧で終わるので、Markdownでは「関数」とのあいだにスペースを入れてあります。

41ページ:スペースを打たずに入力したUnicodeとPythonの前後に四分アキが入り、2行目末の「、」が行長の外にぶら下がっています。

中国語との違いは約物にあります。中国本土の本は、既定で、と,を半角、。を全角で組みます(開明式)。日本語の本はすべての約物を全角で保ち、2つが続くところだけを詰めます。中国語の改行規則には、行頭に来てはいけない小書きのかなやーがないので、ja-very-strictは独立したレベルになっています。

#2 · かなを持つ等幅書体でコードを組む

script.js · 60〜71行コード全体で見る
// A ``` fence is set line by line as written, in codeStyle's face: the monospaced face,
// which has kana and kanji too, so a full-width character takes two half-width cells.
// The rest of the fence line (normalize.py) is the listing's title. Inline `code` is set
// in the same face, in the accent.
const codeStyle = {
  fontFamily: CODE, fontSize: pt(8), lineHeight: pt(12), color: col('ink'),
  background: col('tint'), snapToGrid: false, highlight: 'none', // one ink, as in print
  padding: { top: mm(2.5), right: mm(4), bottom: mm(3), left: mm(4) },
  marginTop: mm(2), marginBottom: mm(2),
  titleStyle: { fontFamily: CODE, fontSize: pt(7), fontWeight: 400, color: col('teal') },
  inline: { fontSize: pt(8.5), color: col('teal') },
};

このフェンスはコードブロックです。Postextはその行を書いたとおりに、codeStyleが指定する書体で色をつけた囲みの中に組み、開始行にあるnormalize.pyを囲みのタイトルにします(コードリスト)。highlight: 'none'でコードリストはページのほかの部分と同じく1色になり、codeStyle.inlineで`name`もそれぞれ同じ書体、ティールの色で組まれます。書体の選択が効いてきます。例に出てくる文字列ガイド ABC ①には、半角カタカナ、全角の英字、丸数字が要り、欧文のコード用書体にはこれらがありません。BIZ UDGothicは半角の欧文と全角のかなを固定ピッチで組み、コードリストは全角文字を2桁と数えるので、桁がそろいます。

#3 · 図3-1と表3-1

script.js · 252〜268行コード全体で見る
const FORMS = `入力\tNFC\tNFD\tNFKC
が(U+304C)\tU+304C\tU+304B U+3099\tU+304C
ガ(U+FF76 U+FF9E)\tそのまま\tそのまま\tガ(U+30AC)
ABC(全角)\tそのまま\tそのまま\tABC
①\tそのまま\tそのまま\t1
㍻\tそのまま\tそのまま\t平成`;
const resources = [
  { id: 'tbl:forms', typeId: 'table', kind: 'table', createdAt: 0, updatedAt: 0,
    placement: { position: 'here' }, // at its ::resource line, under the paragraph citing it
    caption: '日本語の文字と四つの正規化形式(NFKDは、NFKCで合成された文字を分解した形になる)',
    table: { model: { ...parseTSV(FORMS), headerRowCount: 1, columnWidths: [34, 18, 26, 22] } } },
  { id: 'fig:bytes', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
    caption: '「が」の二つの表し方。上段が符号位置、下段がUTF-8のバイト列',
    altText: 'が as one code point U+304C, three UTF-8 bytes E3 81 8C; and as U+304B and the '
      + 'combining voiced mark U+3099, six bytes E3 81 8B E3 82 99.',
    svg: { fileId: 'bytes.svg', width: 1175, height: 400 } },
];

defaultResourceTypes('ja')は種類を図と表と名づけ、章ごとにハイフンでつないで番号を振ります。continuation.headingsでこの章は第3章になるので、最初の図は図3-1です。jaの文書はラベルと番号をベタで組み、番号の後に全角スペースを入れます。日本の本が「図3-1 「が」の二つの表し方」と印字するのと同じ形です。そのため、キャプションのスタイルで選ぶのは書体と色だけです。表は'here'に置き、それを引く段落の下に入ります。図の中のラベルはU+304CとE3 81 8Cという欧文だけです。SVGのスタイルにコード用書体の名前を書いておくと、loadSvgが描画の前にフォントファイルを埋め込みます。

#4 · 日本語の流儀で、ページごとの脚注

script.js · 129〜133行コード全体で見る
  footnotes: { fontSize: pt(7.5), lineHeight: pt(12), color: col('ink'),
    separator: { color: col('rule') } }, // at the column foot, 1 on each page, superscript
  // A link in a note prints its address after the text, in parentheses: the reader of the
  // printed book can type it. 'short' drops https:// and www.; the PDF keeps the full link.
  links: { print: 'inline', urlDisplay: 'short' },

脚注に必要な設定は大きさだけです。横組みの日本語文書では、既定値がJLReqの横組みの本の記述どおりになっています。注は引用した段の地に置き、ページごとに1から番号を振り、合印は上つきで、罫は行長の3分の1の長さです(脚注)。合印は保存していた[^hfs]。のように句点の前に置くので、「。」が合印から離れて次の行頭に来ることはありません。

注2は四つの正規化形式を定めるUnicodeの報告書を引いていて、その引用がリンクになっています:[Unicode Standard Annex #15「…」](https://www.unicode.org/reports/tr15/)。注にはさらに注を付けられないので、注の中のリンクは本文のあとに括弧でアドレスを印刷します。links.urlDisplay: 'short'はhttps://とwww.を省き、PDFには完全なリンクが残ります。本文中のリンクにも同じことをするのがlinks.print: 'inline'です(印刷物でのリンク)。注の書き出しを日本語にしてあるので、長い欧文の題の前で1行目が詰まります。

#5 · 3行取りの節見出し

script.js · 75〜90行コード全体で見る
const BAND = 74; // mm from the trim's top
const opener = { enabled: true, minHeight: pt(PITCH * 10), slot: { elements: [ // text: line 11
  { kind: 'box', id: 'band', reserve: false, style: { backgroundColor: col('tint') },
    placement: { anchor: { to: 'page', edge: 'top-left' },
      size: { width: 'fill', height: mm(BAND) } } },
  { kind: 'text', id: 'kicker', content: 'CHAPTER', fontFamily: GOTHIC, fontSize: pt(8),
    fontWeight: 700, letterSpacing: pt(1.6), color: col('teal'), align: 'left',
    placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(0) } } },
  { kind: 'text', id: 'number', content: '{numberDecimal}', fontFamily: GOTHIC, fontSize: pt(64),
    lineHeight: 1, fontWeight: 700, color: col('teal'), align: 'left',
    placement: { anchor: { to: '#kicker', edge: 'below' }, offset: { y: mm(1) } } },
  { kind: 'text', id: 'title', content: '{titleText}', fontFamily: GOTHIC,
    fontSize: pt(20), fontWeight: 700, color: col('ink'), align: 'left', overflow: 'wrap',
    placement: { anchor: { to: '#number', edge: 'below' }, offset: { y: mm(5) },
      size: { width: mm(MEASURE) } } },
] } };

章扉はH1に設定したデザインで、ティールの帯、{numberDecimal}による64ptの章番号、表題からなります。節見出しはlineSpan: 3、つまり行取りです。各見出しは本文のちょうど3行分を占め、文字はその中央に置かれるので、続く本文はグリッドからずれません。headings.balancing.enabled: falseは、ページをそろえるためにエンジンが見出しの上に行を足すのを止めます。

レシピの全体

Sandbox
// ═══ Postext Cookbook · Nº 123 · A Japanese technical manual: kana, kanji and Latin ═══
// https://postext.dev/en/cookbook/japanese-technical-manual
// Code: MIT · Text: original (CC BY 4.0) · Pictures: drawn in code
// Fonts: Noto Serif JP, Noto Sans JP, BIZ UDGothic (SIL OFL 1.1) · Needs postext ≥ 1.65.0
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, defaultResourceTypes, parseTSV,
  registerResourceImage, inlineSvgFonts,
} 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 = 'japanese-technical-manual';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, one deep teal for numbers, rules and labels, a pale tint for code
const palette = {
  ink: '#1d2327', // text: a cool near-black
  teal: '#0e5a6e', // the one accent: chapter number, heads' numbers, labels, the point box
  tint: '#e7f0f2', // the opener band, the listing's ground
  rule: '#b9c6cc', // hairlines: table rules, the note rule
  muted: '#5b666d', // running heads, folios, colophon
  paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.teal })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [MINCHO, GOTHIC, CODE] = ['Noto Serif JP', 'Noto Sans JP', 'BIZ UDGothic'];
const [BODY, PITCH] = [9, 16]; // pt: 9 pt text on a 16 pt line, 1.78 × the size
const [CHARS, LINES] = [36, 29]; // the type area in characters: 36 to a line, 29 lines
const MEASURE = CHARS * BODY * 25.4 / 72; // mm: 114.3

// #region answer: Japanese rules from the tag, written out; the quarter-em Latin space
// locale 'ja' turns on JLReq composition: kinsoku at its strictest, full-width marks squeezed
// where two meet (」、 takes one em, not two), a closing mark keeps its half em at a line
// end, 、。 may hang past it, and a paragraph opening with 「 sets the bracket in the indent.
// The values below are the ones 'auto' picks for 'ja'; they are spelled out to be seen.
const cjk = {
  lineBreak: 'ja-very-strict', // no line starts with ー, small kana, 々, 」、。?・ or :
  punctuationWidth: 'fullwidth', // 、。「」 keep their em inside the line (JLReq §3.1.2)
  hangingPunctuation: 'allow', // 、。 hang only when the line would otherwise break before them
  paragraphStartBracket: 'half', // 「 at a paragraph start sits in the indent's second half
  latinSpacing: em(0.25), // 四分アキ between kana or kanji and Latin letters or digits
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES }, // whole ems, whole lines
};
// The Latin is the Japanese face's own proportional Latin, at the text's size: never
// full-width A or a second face for the words in parentheses.
const bodyText = {

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

アレンジ

#小書きのかなとーの行頭を許す

ja-strictはJLReqの一般書向けの規則です。っ、ゃ、ーが行頭に来てもよいので、改行できる位置が増え、字間の開いた行が減ります。

-  lineBreak: 'ja-very-strict', // no line starts with ー, small kana, 々, 」、。?・ or :
+  lineBreak: 'ja-strict', // small kana, ー and 々 may open a line

#和欧間にアキを入れない

出版社によっては、四分アキを入れずに欧文の単語をかなにベタでつけて組みます。

-  latinSpacing: em(0.25), // 四分アキ between kana or kanji and Latin letters or digits
+  latinSpacing: em(0), // Unicodeでは, set solid

よくあるつまずき

つまずき

日本語のテキストのタグは'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を渡してください。どちらもテキストの文字を含むファイルを取得します。 中国語・日本語・韓国語のフォント →

  • 日本語の行の中で欧文の単語は分割できないので、長い単語が行末に来ると、その手前の行は字間が開きます。この章の最初の稿では用語に英語を添えていて(正準等価(canonical equivalence))、2行がゆるくなりました。読者の助けにならない箇所の英語は削っています。
  • コード用書体は、コードに含まれる文字で選んでください。ここで最初に試したM PLUS 1 Codeには半角カタカナがありません。画面ではガイドにシステムの書体が代わりに使われ、PDFにはそのグリフが入りませんでした。
  • コードリストはページをまたぐとき行と行の間で分かれ、前後それぞれに少なくとも2行が残ります(codeStyle.splitMinLines)。43ページでは3.3節の下に残る高さにタイトルと2行が入らないので、コードリストは丸ごと44ページから始まります。keepTogether: trueにすると、どのコードリストも分割されません。
  • 文字グリッドのページは、段落や箇条書きがページの変わり目でどう分かれても29行を埋めます。そのままでは、4つの正規化形式の箇条書きは最初の項目NFCだけを42ページの末尾に残します。shortListSplit: 'avoid'とshortListMaxItems: 4を指定すると箇条書きは丸ごと43ページへ移り、42ページは脚注の上で1行短く終わります。

クレジット

レシピ
Ignacio Ferro
本文
書き下ろしの文章, CC BY 4.0
画像
  • Figure 3-1, the bytes of が, drawn in code in the page’s palette · Postext Cookbook · CC BY 4.0
フォント
Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1) · BIZ UDGothic (SIL OFL 1.1)
SandboxPDF