設定：本文と見出し

#本文

bodyTextプロパティは、すべての段落テキストの文字組みを制御します。

#引用ブロック

引用ブロック（>で始まる行）は、本文のフォントファミリー、サイズ、行送り、ウェイト、行そろえ、ハイフネーションを引き継ぎます。それ以外はbodyText.blockquoteで設定します。設定しない場合、引用ブロックはpostext 1.4までと同じ見た目になります。灰色のイタリックで、本文の1行目の字下げを使い、左右のインデントはありません。

bodyText: {
  firstLineIndent: { value: 1.5, unit: 'em' },
  // Upright verse in the body colour, set in by 2 em, no first-line indent.
  blockquote: { color: { hex: '#241f26', model: 'hex' }, italic: false, indent: { value: 2, unit: 'em' }, firstLineIndent: { value: 0, unit: 'em' } },
}

Sandboxでは、これらは本文セクションの引用ブロックグループにあります。

#詩

行に半句の区切りがない:::verseの詩は行ごとに組みます（文書の書式 › :::verseを参照）。bodyText.verseはそうした詩の既定値を決め、詩の開始行に同じ名前の属性を書くと、その詩だけの値になります。

bodyText: {
  // 折り返しは角括弧付きで行末側へ。短歌は分けない。
  verse: { turnover: 'right', keepStanzas: 5 },
}

これらの設定より前に保存された設定（configVersionが8以前）で、区切りのない詩を組んでいるものはlayout: 'bayt'として読まれ、詩はpostext 1.22で組まれたとおり中央に置かれます。postext 1.23で保存された設定（configVersionが9）で、一行ずつ組む詩を含むものはtighten: falseとして読まれ、詩行は1.23で折り返した位置で折り返します。

Sandboxでは、これらは本文セクションの詩グループにあります。

#タブ位置

bodyText.tabStopsは、タブ（:tab、またはタブ位置のある段落の中のタブ文字）の行き先となるタブ位置を並べます（記法と行の組み方は文書形式 › タブとタブ位置を参照）。段落スタイルのtabStopsはそのスタイルの段落について、囲みスタイルのbody.tabStopsは囲みの中で、これを置き換えます。空のリストはタブ位置を1つも設定しません。各タブ位置はTabStopです。

bodyText: {
  tabStops: [
    { position: { value: 30, unit: 'mm' } },
    { position: 'end', align: 'end', leader: '.', leaderGap: { value: 2, unit: 'pt' } },
  ],
  tabInterval: { value: 10, unit: 'mm' },
}

tabIntervalは、リストの最後のタブ位置より先に、行長の始端から一定の間隔でタブ位置を加えます。これがなければ、最後のタブ位置より先のタブは語間スペースになります。本文に入力したタブ文字は、スタイル（そのスタイル自身または本文）にタブ位置か間隔がある段落でだけタブになります。それ以外の場所では従来どおり語間スペースなので、保存済みの文書はこれまでと同じに組まれ、固定の必要はありません。

タブ位置は設定のほかの部分と一緒に検査されます（設定の警告を参照）。タブ位置の不明なキー（leaders）はunknownConfigKeyとして、最も近いキーとともに報告されます。4つのどれでもないalignはunknownConfigValueとして報告され、タブ位置は'start'として組まれます。長さでも'end'でも割合でもないpositionはused: 'none'のunknownConfigValueとして報告され、そのタブ位置は除外されます。

リーダーの色と書体は段落のものです。リーダー専用の設定はまだありません。

#ドロップキャップ

本文の段落は、ドロップキャップで始めることができます。最初の文字を最初の数行の横に大きく組み、それらの行は文字の幅とアキの分だけ短くなって、ほかの行と同じく組まれます（Knuth-Plassで改行し、両端そろえとハイフネーションを行います）。段落スタイルは、そのスタイルの各:::paragraphsグループの最初の段落にドロップキャップを付けます（each: trueならすべての段落に付けるので、項目の並ぶカタログに使えます）。見出しのレベルや見出しスタイルは、見出しの後の最初の本文の段落に付けます（レベルごとの上書き、段落スタイル、見出しスタイルのdropCapフィールドを参照）。見出しの後の段落は、indentAfterHeadingと同じく、コンテナーのフェンス、ディレクティブ、本文の外に置かれた囲み、フロートの図を飛ばして探します。囲み、リスト項目、引用、詩、注の中の段落には付きません。テキストでは、見出しの行や:::paragraphsのフェンスに{dropcap}、{dropcap=false}、{dropcap=N}と書くと、その章やグループについてドロップキャップを有効にし、解除し、またはその行数を指定できます（文書形式 › ドロップキャップを参照）。postext 1.23以降。

headings: {
  levels: [
    { level: 1, dropCap: { lines: 3, fontFamily: 'Libre Bodoni', fontWeight: 700, color: { hex: '#8b2e2a', model: 'hex', paletteId: 'accent' }, leadIn: { words: 3 } } },
  ],
},

文字は次のように組まれます。

• サイズ：テキストと頭文字の2つの大文字の高さは、どちらも書体から計測します（Hのインクの高さ。中国語や日本語のテキストでは頭文字そのもののインクの高さ）。インクの計量値を持たない書体では、大文字をサイズの0.72とみなします。既定のサイズはどの書体の組み合わせにも合うので、書体ごとの補正は要りません。デザインテキストのdropCapは固定の0.72のままです（テキスト要素を参照）。
• 文字とその語：頭文字は書記素クラスターを丸ごと取ります。最初の語の残りはスペースなしでその後に続きます。1文字の語（A、Y）は、1行目の先頭に語間スペースを保ちます。段落自身の1行目の字下げは取り除かれます。コピー、検索、ソースマップ、Sandboxのキャレットは、段落を書かれたとおりに読みます。ブロックのプレーンテキストは頭文字を含み、1行目のplainStartは頭文字の後から数え、VDTBlock.dropCapは1行目を含む断片に頭文字の範囲と配置を持ちます。
• 突き出した頭文字（lines: 1でfontSizeを大きくしたもの、またはsinkをlinesより小さくしたもの）は1行目より上に出ます。段落はその分の空きをグリッドの行単位で上に確保するので、上のテキストに重なりません。
• 分割：段落はsink行目より前では分割されません。代わりに全体が次の段やページへ移ります。ただし、その行数を収められない空の段に単独で置かれた場合は、そのまま分割してdropCapの警告を出します。本文とともに保たれる見出しは、それらの行を自分の下に保ちます。次の段へ続く部分には頭文字がなく、行は全幅になります。幅の異なる段のために再び分割された場合も、最初の数行は字下げを保ちます。段の高さそろえは、ほかの段落と同じくこの段落をゆるく、またはきつく組むことがありますが、短くした行のあいだにアキを加えることはありません。
• 用字：行は始端側で短くなります。ラテン文字のテキストでは左、アラビア文字とヘブライ文字では右です。次の文字と連結する文字（アラビア文字、シリア文字、ンコ文字）は切り離さず、段落はdropCapの警告を出します。横組みの中国語と日本語は1文字の頭文字（首字下沉）を取ります。縦組みのテキストには付きません（警告）。文字や数字で始まらない段落（参照、数式、注の印）にも付きません（警告）。
• 出力：Canvas、HTMLビューアー、固定レイアウトのEPUBは、頭文字を行の横に描きます。HTMLは頭文字を1行目のテキストの直前に、あいだに何も入れずに書くので、スクリーンリーダーは語をひと続きに読みます。タグ付きPDFでは、頭文字は段落のPの一部になり、語の残りとともに、その語を/ActualTextに持つSpanになります。テキストを抽出するとL ong beforeではなくLong beforeと読めます。リフロー型のEPUBではCSSのinitial-letter（行数、沈む行数）で組み、リーディングシステムがこれに対応していない場合はフロートにします。

設定は設定のほかの部分と一緒に検査されます（設定の警告を参照）。ドロップキャップやそのリードインの不明なキーはunknownConfigKeyとして報告されます。どの語にも当たらないpunctuationやshortParagraph、1以上の整数でないlines、sink、charactersはunknownConfigValueとして報告され、既定値が使われます。ドロップキャップは既定で無効なので、保存済みの文書は変わりません。

#fontFamilyには1つのファミリー

fontFamilyは、ここでもほかのフォントファミリーの項目（headings.fontFamily、tableStyle.bodyFontFamily、separatorFontFamily、チップスタイルやデザイン要素のfontFamilyなど）でも、1つのファミリーを指定します。Canvas、HTML出力、PDFは同じ書体で組む必要があり、PDFはフォールバックの連鎖なしにファミリーごとに1つのフォントを埋め込むため、CSSのフォントスタックが代替として使えるものはありません。スタックを指定すると最初のファミリーで組まれ、設定の警告として報告されます。

bodyText: { fontFamily: "'EB Garamond', Georgia, serif" } // set in EB Garamond

レイアウトの前にそのファミリーを読み込んでください（カスタムフォントと、PDFの生成のフォントプロバイダーを参照）。読み込まれていないと、スタックのほかの指定にかかわらず、ブラウザーは既定のフォントで計測します。引用符の中のカンマは名前の一部です（'"Foo, Bar"'は1つのファミリーです）。

#ハイフネーション

行そろえを'justify'にしたとき、ハイフネーションは長い語を音節の境界で分割して、語間が広がりすぎるのを防ぎます。エンジンはTeX/Liangのパターンを使って、音節の境界にある自然な分割位置を見つけます。詳しくはハイフネーションと両端そろえを参照してください。行末不ぞろいのテキストは、指定した場合にだけハイフネーションします。後述の行末不ぞろいのテキストを参照してください。

対応ロケール：'en-us'（英語）、'es'（スペイン語）、'fr'（フランス語）、'de'（ドイツ語）、'it'（イタリア語）、'pt'（ポルトガル語）、'ca'（カタルーニャ語）、'nl'（オランダ語）。

パターンを選ぶとき、地域・用字・バリアントのサブタグは無視され、大文字・小文字の違いと_の区切りも無視されます。'es-ES'、'es-MX'、'es_419'は'es'で、'pt-BR'は'pt'で、英語のタグはすべて（'en'、'en-GB'）'en-us'でハイフネーションします。同梱している英語のパターンはこれだけなので、イギリス英語のテキストもアメリカ式で分割されます。パターンを同梱していない言語（'sv'、'pl'、'fi'など）は'en-us'のパターンでハイフネーションするため、分割されないのではなく誤った位置で分割されます。エンジンはこれをタグごとに1回console.warnで報告し、Sandboxは検査パネルに表示します。そうした文書ではenabled: falseを設定してください。警告も出なくなります。中国語・日本語・韓国語（zh、ja、ko。地域や用字は問いません）はパターンを必要とせず、警告も出ません。これらの言語の文書はハイフネーションなしで組まれます。文中に引用したラテン文字の語を分割するには、enabled: trueを設定し、localeにその言語を指定します（英語なら'en-us'）。localeなしでenabled: trueにした場合や、中国語・日本語・韓国語のロケールを指定した場合は、ハイフネーションはオフのままで、その旨をコンソールに1回表示します。matchHyphenationLocale(tag)はタグに対応する同梱ロケールを返し（ない場合はundefined）、HYPHENATION_LOCALESは同梱ロケールの一覧です。解決済みの設定（doc.config.bodyText.hyphenation）は、実際に使ったパターンをlocaleに、指定したタグがそれと異なる場合はそのタグをtagに保持します。PDFバックエンドは文書の言語をトップレベルのlocaleから宣言し、localeが未設定の場合にだけこのタグから宣言します（文書の言語を参照）。

import { matchHyphenationLocale } from 'postext';
 
matchHyphenationLocale('es-MX'); // 'es'
matchHyphenationLocale('en-GB'); // 'en-us'
matchHyphenationLocale('sv');    // undefined: hyphenated with 'en-us', with a console warning

5文字未満の語はハイフネーションしません。分割位置の前に2文字以上、後に3文字以上が必要です。

行末不ぞろいのテキスト

既定では、ハイフネーションするのは両端そろえのテキストだけです。textAlign: 'left'の場合や、左そろえ・中央そろえ・右そろえの段落スタイルでは、行末がどれほど不ぞろいになっても語は丸ごと保たれます。例外はテキストに入力したソフトハイフン（U+00AD）です。行末不ぞろいのテキストもハイフネーションするには、hyphenation.ragged: trueを設定します。

行末不ぞろいの行は伸ばさないので、収まらない語をすべて分割すると行末がハイフンだらけになります。これを抑えるのがハイフネーションゾーンで、DTPソフトの単一行コンポーザーと同じ方法です。行末に語が収まらないとき、エンジンは、その語を丸ごと次の行に送った場合に残るアキを調べます。アキがzoneより広ければ、収まる最後の音節で語を分割し、そうでなければ語を丸ごと次の行に送ります。emで指定したゾーンは、そのテキスト自身の文字サイズが基準です。既定値の3emでは、目立って短い行を残す語だけを分割します。ゾーンを広くするとハイフンが減り、行末の不ぞろいが大きくなります。0にすると、収まらない語はすべて分割します。1行ずつ組む場合、音節で終わる行は3行以上続きません。ハードハイフン（enseñanza-aprendizaje）、URLの区切り、テキストに入力したソフトハイフン、行全体より広い語は、これまでどおりに改行します。ゾーンと2行の制限が制御するのは辞書による音節だけです。

この設定は文書全体に効きます。本文テキストと引用ブロックが行末不ぞろいのときに適用され、行末不ぞろいの段落スタイルや囲みの本文のうち、自身のhyphenationがオンのもの（既定値は本文のhyphenation.enabled）にも適用されます。したがって、hyphenation: falseにすると、そのスタイルの語は丸ごと保たれます。見出し、キャプション、注、表のセル、目次はハイフネーションしません。そこでは、ほかと同様に、行長全体より広い語だけを分割します。デザインのテキスト（柱、章扉、部扉）は、各テキスト要素のhyphenateフラグに従います。組み込みの全ページの章扉と部扉はこれを設定しており、文書の辞書も使います。両端そろえのテキストではraggedとzoneは無視されます。

const config: PostextConfig = {
  locale: 'es',
  bodyText: {
    textAlign: 'left',
    // A little more hyphenation than the 3 em default.
    hyphenation: { ragged: true, zone: { value: 2, unit: 'em' } },
  },
};

optimalRagged（既定）を使うと、行末不ぞろいの本文テキストはKnuth-Plassで改行され、ゾーンはそこでも同じ意味を持ちます。語を分割するのは、行の残りに収まらず、丸ごと送るとゾーンを超えるアキが残る場合だけです。音節で終わる行が2行続くことは禁止されませんが、両端そろえのテキストでハイフンが2行続くのと同じコストがかかるため、3行続くことはまれです。optimalRagged: falseまたはoptimalLineBreaking: falseでは、postext 1.4までと同様に、各行を埋めてから次の行に進みます。

行末不ぞろいのハイフネーションでは、インライン書式（太字、イタリック、リンク、数式）を含む段落が常に使う改行処理で段落を組みます。そのため、オンにするとハイフン以外の改行位置もいくつか変わることがあります。行末不ぞろいの行では、この改行処理はスペースと辞書の音節のほかに、2語の間のハードハイフンやダッシュの後（largas—separadas。breakAfterDashesを使うと、語の間に前後を詰めて置いたあらゆるダッシュ、つまりriddles.—Iやriddles—*and*も）、URLの区切り、表意文字の間で改行し、複数の範囲にまたがって組まれた語は分割しません（**Nota**:、(*véase*）。行末不ぞろいのハイフネーションを使わない場合、書式のない行末不ぞろいの段落は、optimalRaggedがオン（既定）ならKnuth-Plassで改行されます。改行位置は、語間、2文字の間のハードハイフンの後（meta- · analyses。もう一方の改行処理と同じ）、breakAfterDashesを使う場合は前後を詰めたダッシュの後です。1行ずつ組む場合はpretextの改行処理を通り、3つの点で異なります。挿入句を閉じるダッシュの前や開くダッシュの後でも改行することがあり（él · — y）、ハイフネーションするときはスラッシュの後でも改行し（km/ · h）、行より広い語を任意の文字の位置でハイフンなしに切ります。もう一方の改行処理は、まず音節で分割します。

Sandboxでは、このスイッチは本文セクションの段落の行そろえの下にある行末不ぞろいのテキストもハイフネーションで、その下にゾーンがあります。本文が両端そろえの場合、同じスイッチは両端そろえの設定と並んでおり、行末不ぞろいの段落スタイルと囲みに適用されます。

#文書の言語

トップレベルのlocaleは文書全体の言語です。hyphenation.localeと同じ値を取り、そのフィールドが未設定のときの代わりになります。スペイン語の本なら、locale: 'es'だけでスペイン語のハイフネーションになります。表と分割された囲みの、組み込みの継続表示の文字列（(cont.)／ContinuedかContinúaか。ページより高い表と分割された囲みの目印を参照）や、言葉で書く見出し番号（Chapter OneかCapítulo unoか。語で綴る番号を参照）の言語もこれで決まり、アクセシブルなPDFにタグ付けする言語にもなります。未設定の場合、エンジンは'en-us'とみなします。Sandboxはインターフェースの言語を使い、このフィールドをデザイン › 表記体系で設定します。

組み込みのリソースタイプもこれで決まります。resourceTypesが未設定の場合、buildDocumentはdefaultResourceTypes(locale)で番号とキャプションを付けるので、locale: 'de'だけでAbbildung 1.1やTabelle 1.1になります。localeが未設定の場合は、リソースタイプでも表の文字列でも、ハイフネーションのロケールが代わりに使われます。明示的に指定したresourceTypesのリストが常に優先されます。以前のバージョンでは、defaultResourceTypes(locale)を自分で渡さない限り、localeにかかわらず英語のタイプを使っていました。localeを設定しつつ英語のラベルを残したい文書は、resourceTypes: defaultResourceTypes('en')を渡します。Sandboxの本とバンドルは自身のリストを持っているので、影響を受けません。

ここでもhyphenation.localeと同様に任意のBCP 47タグが使えます。'de-AT'ならドイツ語の文字列になります。組み込みの文字列があるのは、ハイフネーションが対応する8言語、中国語（簡体字と繁体字）、日本語、アラビア語です。それ以外の言語には英語の文字列が使われます。

中国語では、zh、zh-Hans、zh-Hant、zh-CN、zh-SG、zh-TW、zh-HK、zh-MOと長い形（zh-Hant-TW）を、大文字・小文字を問わず、-でも_でも受け付けます。文字列はIntl.Locale(tag).maximize()で読み取った用字に従います。zh、zh-CN、zh-SGは簡体字、zh-TW、zh-HK、zh-MOは繁体字です。一方、言語に依存する組版の既定値は、clreq §1.2の推奨どおり地域に従います。CN、SG、MYは中国大陸、TWは台湾、HKとMOは香港とみなし、地域のないタグは用字で判断します（zh-Hantは台湾、zhとzh-Hansは中国大陸）。日本語では、ja、ja-JP、ja-Jpan、そのほかのjaタグを受け付けます（isJapaneseLanguage(tag)）。postext 1.16からは日本語独自の文字列と独自の地域japanを持ち、その組版の既定値はJLReqに従います（日本語の組版を参照）。日本語の項目がない文字列の表では、中国語ではなく英語が使われます。localeScript(tag)、cjkRegionOf(tag)、stringsKeyOf(tag)、sameContentLocale(a, b)はこれらの判定結果を返します。DOCUMENT_LANGUAGESは組み込みの文字列がある言語の一覧で、各言語はその言語自身の名前で表記されています（日本語は中国語の項目とالعربيةの間）。Sandboxの文書の言語の選択肢にはこの一覧が表示されます。

キャプションの接頭辞はタイプの名前です（Figure 1.1.）。中国語のタイプは章ごとにハイフンで番号を付け（{h1}-{n}、图 1-1）、キャプションの設定でlabelNumberGap: ''とlabelSeparator: '　'を指定すると、キャプションは图1-1　标题になります（キャプションスタイルを参照）。索引も言語に従います。簡体字では、相互参照の前に见と另见を置き、記号と数字の項目の上に符号と数字の見出しを置きます。繁体字では見、另見、符號、數字を使います。日本語も同じ方法でタイプに番号を付け、この2つの設定なしでキャプションを図1-1　題と組みます。相互参照は第3章、2.3節、12ページと書き、参考文献の見出しを「参考文献」とします。索引は記号と数字の項目の上にそれぞれ「記号」「数字」の見出しを置き、相互参照を矢印で示します。seeは→夏目漱石、see alsoはページ番号の後に→夏目漱石、森鷗外も見よと書き、ラベルは正体です。アラビア語も同じ方法でタイプに番号を付け（{h1}-{n}、شكل 2-3）、相互参照はالفصل 3、القسم 2-1、ص 12と書き、参考文献の見出しをالمراجعとします。索引はانظر／انظر أيضًا、رموز、أرقامを使い、アラビア語のカンマとセミコロン（، ؛）を使います。

中国語・日本語・韓国語の文書は、HTML出力（.pt-docのルートのlang。zh-Hant-TWはそのまま保持）と、描画するCanvas（ctx.lang。Chrome 136以降）で言語を宣言します。これにより、ブラウザーは地域に合った字形で描画します。Unicodeは漢字を統合しているため、同じコードポイントでも台湾のフォントと日本のフォントでは見た目が異なるからです。ほかの文書には、これまでどおりlangを付けません。PDFは、タグ付きかどうかにかかわらず、すべての文書でlocaleから用字と地域を含めて/Langを宣言します。右から左に書く言語（アラビア語、ペルシア語、ウルドゥー語、ヘブライ語など）の文書も言語を宣言し、フォントの言語別字形（locl）とフォールバックフォントはそれに従います。

const config: PostextConfig = {
  locale: 'es',
  bodyText: { textAlign: 'justify', hyphenation: { enabled: true } }, // hyphenates in Spanish
};

文書の数字

トップレベルのnumeralsは、エンジンが書くすべての数の数字を設定します。対象は、ノンブルと、目次・索引・ページ参照のページ表記、番号付きリストと脚注の番号、見出しと章のカウンター、{chapterNumber}、図番号とその参照の{h1}と{n}、{totalPages}、{bookTotalPages}、{numberDecimal}です。'latn'は0–9、'arab'はアラビア・インド数字٠–٩、'arabext'はペルシア数字۰–۹で書きます。変わるのは10進の形式（decimal、リストのarabic、または既定値のままの設定）だけなので、著者が名前で指定した形式はそのとおりに出力されます。lower-romanはi、ii、iiiのままで、ラテン文字の文書でarabic-indicを指定すれば١، ٢، ٣と書きます。文書のテキストが書き換えられることはありません。

既定値の'auto'は、localeの数字を使います（defaultNumeralsFor(tag)）。地域なしのアラビア語とマグリブ以外の地域のアラビア語（ar、ar-EG、ar-SA、ar-AEなど）は'arab'、ar-MA、ar-DZ、ar-TN、ar-LY、ar-MR、ar-EHは'latn'、ペルシア語（fa）、パシュトー語（ps）、インドのウルドゥー語（ur-IN）は'arabext'、パキスタンのウルドゥー語を含むそれ以外はすべて'latn'です。CLDRは地域なしのarとar-AEにlatnを割り当てていますが、マシュリクと湾岸地域のアラビア語の本は٠–٩で印刷され、Postextはそれに従います。数字を指定したタグはその数字を保ちます（ar-MA-u-nu-arab）。文書の数字でノンブルを付けたページは、pageNumberFormatとしてarabic-indicまたはpersianを記録するので、PDFのページラベルにも同じ数字が表示されます。不明な値は言語に従い、unknownNumeralsとして報告されます。

著者が入力した数は、3つの方式のいずれでも読み取ります。リスト項目٣.は3から始まり、{startAt=٥}、:::numbering{startAt=٥}、:::space{lines=٢}、:::part{number="٣"}（{numberDecimal}用）もその値を読み取ります。

const config: PostextConfig = { locale: 'ar' };                     // ١، ٢، ٣
const maghreb: PostextConfig = { locale: 'ar-MA' };                 // 1, 2, 3
const forced: PostextConfig = { locale: 'ar', numerals: 'latn' };   // 1, 2, 3

テキストの方向

トップレベルのdirectionは文書の基本方向を設定します。'ltr'、'rtl'、'auto'（既定）のいずれかです。既定値は、localeの用字が右から左に書かれる場合（アラビア文字、ペルシア語、ウルドゥー語、ヘブライ文字、シリア文字、ターナ文字、ンコ文字、アドラム文字など。directionOf(tag)で判定）に'rtl'、それ以外では'ltr'になります。右から左の文書は鏡像の座標系でレイアウトされます。行は右から始まり、第1段は右の段になり、インデント、リストのマーカー、フロート、脚注、囲みは右側に置かれ、page.binding: 'auto'は右綴じになります。解決済みの設定がdirection: 'rtl'を持つのはそうした文書だけなので、左から右の文書はこれまでどおりに解決されます。不明な値は'auto'として読み取られ、unknownConfigValueとして報告されます。Unicodeの双方向アルゴリズム（UAX #9）は、どちらの方向でも各行のランを並べます。英語の本の中のアラビア語の引用は、その場で右から左に読めます。

文書の中では、見出しや:::コンテナーに{dir=ltr}や{dir=rtl}を付けられ、インラインの:ltr[…]と:rtl[…]はテキストの範囲を分離します（マークアップでの文字方向を参照）。表のリソースにはtable.directionを指定します。文書と逆の方向に組んだブロックは、自身の開始側を保ちます。そのインデント、リストのマーカー、最終行の寄せる側は、テキストが始まる側に移ります。

側を指定する設定は、用紙の側ではなく、テキストまたは本文の流れの側を意味します。そのため、英語の本のために作ったデザインは、本をアラビア語に切り替えてもそのまま機能します。'start'と'end'も明示的な名前として受け付けます。

placement.rotateは鏡像のページでも物理的な意味を保ちます。時計回りに回転した図は、用紙の上でも時計回りに回転します。レイアウトを読み取るホストは、各ページの鏡像の座標系（direction: 'rtl'を持つVDTPage.flow、pageIsMirrored(page)）と、各行のセグメントの表示順（VDTLine.order）を参照できます。flowToPageとpageToFlowは、流れと用紙の間で座標を変換します。アラビア語の組版を参照してください。

const arabic: PostextConfig = { locale: 'ar' };                        // right to left, bound on the right
const english: PostextConfig = { locale: 'en', direction: 'rtl' };     // forced; rarely what you want

#言語と文字体系

Postextは、左から右に書くアルファベット系の文字体系と、横組み・縦組みの中国語と日本語を組めます。中国語の組版と日本語の組版では、それらの組み方と、それを制御する設定を説明しています。設定キーは東アジアの組版、縦組み、綴じにあります。文字体系ごとの扱いは次のとおりです。

• 中国語は、段落のCJK文字が語間より多いときにCJKコンポーザーで組まれます。行はcjk.lineBreakの行頭・行末の規則のもとで文字の間で改行し（。、」やーで始まる行、「や（で終わる行は作りません）、——と……、記号付きの数、ラテン文字の語は分割しません。両端そろえの行は、文字の間を広げて行長にそろえます。約物の幅、ぶら下げ、漢字とラテン文字の間のアキ、文字グリッド、圏点、固有名詞と書名の符号、ルビ、割注は、横組みでも縦組み（layout.writingMode: 'vertical-rl'）でも、localeの地域に従います。いくつかのCJKの語を引用するラテン文字の段落は最適改行を保ち、それらの語の隣で改行することがあります。ラテン文字のテキストに引用したCJKの括弧、中黒、全角の記号（〈h〉、％）は何も変えません。
• 日本語は同じコンポーザーを通りますが、postext 1.16からは独自の規則、つまりW3Cの『日本語組版処理の要件』（JLReq）とJIS X 4051の規則に従います。jaロケールはjapan地域になり、その自動の値によって、JLReqの禁則のレベル（小書きの仮名とーは行頭に置かない）、約物の連続の詰めを伴う全角の約物、？！の後の全角アキ、段落冒頭の始め括弧を字下げの後半に置く処理、本文の上に付けるゴマ圏点、『』による書名、1:2:1の割付けによるルビ、日本語の番号表記、注、読みで並べる索引が設定されます。以前のバージョンでは、日本語を中国大陸の既定値で組んでいました。
• 韓国語も同じコンポーザーを通り、ハイフネーションなしで組まれますが、既定値は中国大陸のものです。韓国語独自の規則（KLREQ）は実装されていません。韓国語のテキストは、スペースのほかに音節の間でも改行します。
• アラビア語とそのほかの右から左の文字体系（ペルシア語、ウルドゥー語、ヘブライ語など）は右から左に組まれます。詳しくはアラビア語の組版で説明しています。文書のdirectionはlocaleの用字から決まり、Unicodeの双方向アルゴリズムが各行の中のラテン文字の語と数を並べ、本は右綴じで第1段が右になり、エンジンが書くすべての数は地域の数字を使います。アラビア文字を含む語は、ハイフネーション、字間の調整、分割の対象にならず、アラビア語の両端そろえの行は語間とカシーダで伸ばします。母音記号、強調、脚注、アラビア語の文字列はアラビア文字のテキストにあります。ペルシア語、ウルドゥー語、ヘブライ語には方向、数字、語を分割しない規則が適用されますが、独自の組み込みの文字列はありません。

ハイフネーションのパターンは8言語分を同梱しています（en-us、es、fr、de、it、pt、ca、nl）。組み込みのリソースタイプと継続表示の文字列は、この8言語と、中国語、日本語、アラビア語にあります。中国語、日本語、韓国語と、右から左に書く言語は、ハイフネーションなしで組まれます。それ以外の言語は、コンソールに警告を出したうえでアメリカ英語のパターンでハイフネーションし、英語の文字列を使います。そうした文書では、hyphenation.enabled: falseを設定し、resourceTypesとtableStyleの継続表示の文字列をその言語で渡してください。

#アラビア文字のテキスト

ここの設定はアラビア文字のテキストのためのもので、ほかの文字体系で書かれた文書には何の影響もありません。アラビア語の組版では、方向、綴じ、数字、韻文、目次、索引といったアラビア語の本のほかの要素とあわせて説明しています。

• 母音記号と行送り。母音記号付きのテキストの母音記号（ファトハ、カスラ、シャッダ、タンウィーン、短剣アリフ、クルアーンの記号）は、文字の上下の行間に積み重なり、行送りはそのために広がることはありません。記号を含む各行は、記号のインクがどこまで届くか（VDTLine.markInk）を記録し、レンダラーの段のクリップは段の最初と最後の行の記号を含めます。語の上の記号が、上の行の語の下にぶら下がる文字や記号とぶつかると、ビルドはその段落を報告します（arabicMarksExceedLeading。Sandboxの検査パネル）。比較するのは上下に重なる語だけです。部分的に母音記号を付けたテキストには約1.7–1.85 emのlineHeight、完全に母音記号を付けた韻文には1.9–2.1 emが適しています。
• 強調。アラビア文字の活字にはイタリックがないため、localeがアラビア文字で書かれる文書では、*…*は既定で太字になります（bodyText.emphasis: 'auto'）。'color'はitalicColorの正体で組み、'overline'は語の上に線を引きます。アラビア語の本で使われるkhaṭṭ fawqīです。この設定は、本文の書体で組むすべてのテキスト、つまり段落、リスト、引用ブロック、段落スタイル、囲みの本文、注、見出しに及びます。キャプション、表のセル、目次、索引は、自身のイタリックの設定を保ちます。どれを選んでも、エンジンがアラビア文字をイタリックにすることはありません。イタリックで組んだ範囲のうち、アラビア語の語は正体のままで、ラテン文字の語はイタリックを保ちます。そうした文書では、引用ブロックは既定で正体です。
• タシュキール（tashkīl）。bodyText.tashkil: 'strip'は、レイアウトで組むテキストから母音記号とクルアーンの記号を取り除きます。母音記号付きの原稿から母音記号なしの版を作るためのものです。対象は、ファトハ、ダンマ、カスラとそのタンウィーン、スクーン、シャッダ、短剣アリフ（هٰذاはهذاになります）、U+0656–U+065FとU+06D6–U+06EDの記号です。'strip-vowels'は、現代の多くの本と同じようにシャッダを残します。ハムザとマッダは残ります（أ إ آは文字であり、結合記号で入力した場合も同じです）。原稿は記号を保ち、行、見出し、目次は記号なしで組まれますが、組まれた文字はすべて原稿の中の位置に対応づけられたままです。
• 脚注。footnotes.markerTemplate: '({n})'は合印を文書の数字で«(١)»と書き、numbering: 'page'はページごとに番号を振り直し、noteNumberPosition: 'inline'は注自身の番号を行の中に組みます。区切り線と注の番号は段の始まり側に置かれ、右から左の本では右側になります。
• 語を分割しない。アラビア文字を含む語は、アラビア語の本の中でも、ほかの言語の本に引用した場合でも、ハイフネーション、分割、字間の調整の対象になりません。アラビア文字のテキストにletterSpacingを設定したスタイルは報告され（joiningScriptLetterSpacing）、行より広い語は行からはみ出して報告されます（unbreakableWordOverflow）。アラビア語の組版を参照してください。
• カシーダと韻文。アラビア語の両端そろえの行は、語間に加えてカシーダでも伸ばします（bodyText.kashida。アラビア文字のカシーダを参照）。古典詩は、:::verseを使うと、同じ幅の2つの半句からなるベイト（bayt）を1行に1つずつ組みます（:::verseを参照）。
• 索引。アラビア語の索引はアルファベット順に並べ、冠詞ال（index.ignoreArticle）、母音記号、ハムザの座を無視します。索引を参照してください。

#オーファン、ウィドウ、ラント、分割禁止の規則

これらのデメリットの仕組みはハイフネーションと両端そろえを参照してください。この節は、それらを制御するbodyTextのキーのリファレンスです。

本文の設定には、ハイフネーションと語間の上限・下限のほかに、構造的に不格好な段落の分割を防ぐ緩やかな規則があります。これらはすべてデメリットとしてKnuth-Plassの改行アルゴリズムに渡されます。厳格な規則を強制することはなく、レイアウトをすっきりした分割の方向に寄せるだけです。どれかを実質的に無効にするには、その*Penaltyの値を0にします。

ラントについて。ラントとは、最終行が短すぎてまともな1行に見えない段落のことで、典型的には段落の末尾に短い語が1つか2つ取り残されたものです。判定は通常のスペース幅に対する行のピクセル長に基づくため、runtMinCharactersは現在の文字サイズに自動的に適応します。runtMinCharacters × spaceWidthより見た目が広い短い語は問題なく、それより狭い語（または本当に1語だけの行）にはラントのペナルティーがかかります。しきい値は語間で数え、語間の幅は文字の約半分なので、既定値の20はおよそ8–12文字の最終行にあたります。どのラントもペナルティー全体のコストになるので、しきい値未満の2つの終わり方のうち、改行処理は上の行を詰めたほうを選びます。gradedRuntPenaltyを使うと、それぞれを不足分に応じて評価し、長いほうの終わり方が選ばれます。数学的な補足として、既定のruntPenaltyである1000では、ラントの回避は、語間の伸びがおよそr≈2.15までの改行位置の組み合わせのどれよりも優先されます。

厳格ではなく緩やかな規則。これらの規則はどれも分割を禁止できません。エンジンは常にレイアウトを生成します。これらはデメリットであり、アルゴリズムはバッドネス、ハイフネーションのコスト、適合クラス（fitness class）の滑らかさ、これらの構造上のペナルティーを1つの大域的な最適化の中で比較し、総コストが最も小さい改行位置の組み合わせを選びます。より強い保証が必要ならペナルティーを上げ、ペナルティーを緩めたほうが読みやすい文書なら下げてください。

#見出し

headingsプロパティは、すべての見出しレベル（H1〜H6）の文字組みを制御します。全レベルに適用される共通の既定値を設定し、そのうえで特定のプロパティをレベルごとに上書きできます。

#共通の既定値

デザインスロットを使わずに、詩や戯曲の各幕の見出しを中央にそろえる例です：

headings: {
  textAlign: 'center',
  levels: [{ level: 2, textTransform: 'uppercase' }],
}

headingsオブジェクトを渡しても、改めて指定しなかったレベルの既定値はすべて保たれます。H1の改ページも同じです（レベルごとの上書きを参照）。

#段末そろえ

出版社は、どの段もページの上端から始まり、下端にそろって終わることを求めます。改行・改段の規則（オーファンとウィドウの防止、見出しと本文の結び付き、分割できない図）は、どうしても短い段を生みます。段の下にベースライングリッドの空き行が1行以上残るのです。段末そろえを有効にすると、エンジンは組版者と同じことを行い、編集上の優先順位に従って調整手段を適用します。

1. 段を閉じる囲み：短い段の末尾にある囲みを、その下の空きちょうどの分だけ下げ、下端をページの最後のグリッド位置、つまり隣の段の最終行と同じ高さにそろえます。その空きが1行に満たなくても、何も別の段へ移らない限りはすべて使います。既定ではほかのどの調整手段よりも先に働いて空きをすべて使うため、直前の段落に注釈を付ける囲みがその段落から数行離れることがあります。closingBox: 'last'にすると、見出し、リストの終わり、そのほかの空きの調整手段が先に行単位で空きを取り、囲みはその残りだけを取ります。closingBox: 'off'では囲みを動かしません。
2. セーフエリアのある画像：セーフエリア（Resource.safeArea、文書形式 › セーフエリアを参照）を持つ画像が、短い段にインラインで置かれているか、その段だけにかかるフロートとして段の頭または末尾にある場合、段が埋まるか切り抜きがセーフエリアに達するまで、セーフエリアの範囲内で切り抜きながらグリッドの行単位で大きくなります。画像が高くなってもページに穴は開かないので、空きを足すどの手段よりも先に働きます。段の頭がそろったままになるページや帯（後述）で段の頭に置かれたフロートは大きくなりません。flexFigureとして記録されます。専用の設定はなく、リソースにセーフエリアが指定された画像だけが大きくなれます。
3. 見出し：短い段の中にある見出しの上の空きに、グリッドの行単位で行を足します。複数行が必要で、段に見出しが複数ある場合は行を分配し、常に最も重要な見出しに最も多く割り当てます（h2はh3より多く受け取ります）。段の一番上にある見出しは空きを受け取らないので、段はページの上端から始まったままです。例外は、続きのあるページで段の頭に置かれた図や表の直下にある見出しで、その見出しの上、つまり図の下に空きが入ります。
4. リストの終わり：見出しだけで空きを吸収しきれないとき、リストや番号付きリストの終わりにグリッドの行を足します（リストの後の空きは自然に読めます）。リストの終わりごとに上限があります。
5. ゆるい段落：最後の手段として、段の中の段落1つを1行長く組み直します（TeXの\looseness=+1）。語間の広がりが目立たないよう、最も長い段落を選びます。ゆるくした組み方は、すべての行が上限のbodyText.maxWordSpacing未満にとどまる場合にだけ採用します。すでに設定した上限を文字の濃度（タイプカラー）が超えることはありません。bodyText.optimalLineBreakingが必要です。

文字グリッド（cjk.grid、中国語の組版 › 文字グリッドを参照）では、どの文字も幅1 emのマスに収まり、どの行もグリッドの行送りに乗ります。この行送りはベースライングリッドでもあります。縦組みと同じく、そこでは段末そろえは既定でオフです。GB/T 9704が28字22行と数えるように、グリッドに沿って1行ずつ組んだページでは、短い段は短いまま残ります。enabled: trueを指定した設定では、グリッドを崩さない調整手段が使われます。見出し、リストの終わり、別行立て、図はグリッド行単位で空きを取るので、その下の本文は行単位で下がります。差し出せる空き行のない規格には、gridLines: 'off'でこれらを除外します。中国語や日本語の段落を1行長く組むのは、どの2文字の間もmaxTrackingを超えて広がらない場合だけで、文字にトラッキングを別に加えることもありません。1字分短い行は字間全体で1 emを広げることになり、既定の0.01 emをはるかに超えるので、マス単位のグリッドでは、ゆるい段落の調整手段はたいてい使える段落を見つけられません。段を閉じる囲みとセーフエリアのある画像は、もともとグリッドに縛られず、ほかの場所と同じように働きます。

ページの最後の段をそろえるのは、そのページが自然に次のページへ続く場合だけです。章の最後のページは短く終わってよいからです。そのようなページと、trailingで高さをそろえて切った最後の帯では、段の頭もそろったままです。段の頭に置かれた図や表の下に行を足すこと（フロート後の調整手段）はせず、そのような図の下で段を始める見出しや囲みも、stretchAfterFloatsの値にかかわらず段の頭にとどまります。末尾をそろえるためだけに、隣の段より低い位置から段を始めることはありません。

どの調整手段が働いたか

レイアウトは、適用した調整手段をすべて、適用先のブロックに記録します。buildDocumentが返すVDTのblock.balancingです。これを使えば、校正刷り、テスト、レポートで、段がなぜ下端にそろっているか、またどの段はどの調整手段でも閉じられなかったかを示せます。段末そろえが手を付けなかったブロックにはbalancingがなく、enabled: falseで組んだ文書には一切ありません。

文字グリッドでは、段が短く終わりうる理由を文書が示します。ページがグリッド上にあり、設定が段末そろえを有効にしていないためにオフになっているときはdoc.gridBalancingが{ off: true }、行単位の調整手段なしで働いているときは{ gridLines: 'off' }になります。それでも短い段にはcolumn.gridRefusedが付き、グリッドのために使えなかった調整手段を示します（文字をマスからずらして広げなければ段落が1行を稼げなかった場合は'looseParagraph'、gridLines: 'off'のもとでは行単位の調整手段）。グリッドの外ではどちらもありません。

interface VDTBalancing {
  levers: BalanceLever[]; // usually one: a paragraph after a list can take the list-end line and run a line long too
  spaceAbove: number;     // px the spacing levers added above the block (0 when only looseParagraph or flexFigure fired)
  bodyGrowth?: number;    // flexFigure: px the picture grew, cropped within its safe area
  extraLines?: number;    // looseParagraph: lines the paragraph gained
  tracking?: number;      // looseParagraph: the tracking that gained them, in thousandths of an em (0 = word spacing alone)
}
type BalanceLever = 'trailingCallout' | 'flexFigure' | 'heading' | 'listEnd' | 'afterDisplay' | 'afterFloat' | 'looseParagraph';

高さをそろえる切断は、切った段に記録します。column.bandCappedは高さをそろえて切ったすべての段（ページ幅の囲みが残す帯、最後の帯）でtrueになり、column.trailingCapはさらに章や文書の最後の帯（trailing）であることを示します。

import { buildDocument } from 'postext';
 
const doc = buildDocument(content, config);
for (const page of doc.pages) {
  page.columns.forEach((column, i) => {
    const levers: string[] = column.blocks.flatMap((block) => block.balancing?.levers ?? []);
    if (column.trailingCap) levers.push('closing band cut level');
    else if (column.bandCapped) levers.push('band cut level');
    if (levers.length > 0) console.log(`page ${page.index + 1}, column ${i + 1}: ${levers.join(', ')}`);
  });
}
// page 3, column 1: heading, heading
// page 3, column 2: listEnd, looseParagraph

#レベルごとの上書き

各見出しレベルは、levels配列で共通の既定値を上書きできます。既定で異なるのはfontSize（と、後述するH1のbreakBefore）だけで、ほかのプロパティはすべて見出しの共通設定を継承します。

H1の既定値は書籍の章立てを模したものです。最上位の見出しはすべて新しい右ページ（奇数ページ）から始まり、前の章との間に必ず白ページを1ページはさみます。書籍ほど階層のない文書では、levels[0].breakBeforeで上書きしてください。

レベルのbreakBeforeはこの既定値にフィールド単位でマージされ、それに触れないheadingsオブジェクトは既定値を保ちます。H1に{ parity: 'odd' }を指定すると改ページを保ったまま奇偶だけが変わり、{ enabled: false }にすると章が続けて組まれます：

headings: {
  fontFamily: 'Merriweather',                               // H1 still breaks to a fresh recto (always-odd)
  levels: [{ level: 1, breakBefore: { parity: 'odd' } }],    // …or: a recto, with no mandatory blank
}
 
headings: { levels: [{ level: 1, breakBefore: { enabled: false } }] } // chapters run on

postext 1.5での変更。postext 1.4までは、headingsオブジェクトを渡すとlevels[0].breakBeforeを改めて指定しない限りH1の改ページが無効になり、一部だけ指定したbreakBeforeは欠けたフィールドを改ページなしの既定値で補っていました。そのため、headingsオブジェクトを持ちH1の改ページを指定していない、1.4向けにコードで書いた設定では、いまはどの章も新しい奇数ページから始まり、必要に応じて白の偶数ページが入ります。章を続けて組むには、levelsのH1の項目にフィールドを1つ与えます：

headings: { fontFamily: 'Merriweather', levels: [{ level: 1, breakBefore: { enabled: false } }] } // as 1.4 laid it out

設定が保存されたものであれば、エンジンがそれを見分けて代わりに処理します。Sandboxは当時保存した本と設定について（Sandbox → 作業内容の保存を参照）、openBundle / readBundleはpostext 1.4以前で書き出された.postextバンドルについて（postext 1.4以前で書き出したバンドルを参照）処理します。自分で保存した設定は、postext/bundleのmigrateConfig(config)に通せます。これは1.4が組んだ改ページを明示的に書き出します（pinLegacyHeadingBreaks）。改ページのなかったH1にはenabled: falseを、H1と見出しスタイルで奇偶を指定していないenabled: trueにはparity: 'any'を添えます。さらに次の項目も1.4の設定どおりに固定します：数式のサイズ、インライン図の周りの空き（囲みの中も）、見出しの文字書式、ドロップキャップのサイズ、リストを導くコロンの行の下の余地、囲みの切断が段落やリスト項目に残す行数、ダッシュでの改行、不ぞろい組みの本文の1行ずつの改行、見出しの下の段落の分割、複合語のハイフンでの改行、:::paragraphsコンテナーの下の空き。第3引数として本のMarkdownを{ content }で渡すと、不要な固定を省きます。本文に$がなければ数式の固定を、リソースを埋め込む行がなければ空きの固定を（囲みの中になければ囲み内の空きの固定を）、記号を含む見出しがなければ見出しの文字書式の固定を、コロンで終わる行の後にリストが続かなければコロン行の固定を、本文が:::calloutを開かなければ囲みの切断の固定を、語の間に詰めて置かれたダッシュがなければダッシュの固定を、本文に見出しがなければ見出し下の分割の固定を、本文が:::paragraphsコンテナーを開かなければコンテナーの固定を、2つの文字の間にハイフンがなければ複合語の固定を省きます。不ぞろい組みの改行の固定は本文の一部を不ぞろいに組む設定にだけ、コンテナーの固定は段落スタイルを宣言する設定にだけ加えます（postext 1.4以前で書き出したバンドルを参照）。改ページだけを固定するにはpinLegacyHeadingBreaks(config)を呼び出します。

レベルごとの上書きには、共通の既定値と同じプロパティ（fontSize、lineHeight、fontFamily、color、fontWeight、marginTop、marginBottom、snapToGrid）に加え、次のレベル専用のフィールドを使えます（見出しスタイルでも使えます）：

headings: {
  fontFamily: 'Merriweather',
  levels: [
    // Canonical book preset: chapters on a right-hand (odd) page.
    { level: 1, fontSize: { value: 24, unit: 'pt' }, breakBefore: { enabled: true, parity: 'odd' } },
    { level: 2, fontSize: { value: 18, unit: 'pt' }, italic: true },
  ]
}

snapToGridはレベルごとにも働きます。指定しなければレベルはheadings.snapToGridに従い、指定すればそれを上書きします。そのため1つの文書の中で、H2では本文との間に1行半を空けて次の吸着点までグリッドから外し、H3では下の空きをグリッドの行単位に切り上げる、といった組み方ができます。見出しスタイルでも、そのスタイルを使う見出しに対して設定できます。

headings: {
  marginBottom: { value: 1.5, unit: 'em' },
  levels: [
    { level: 2, snapToGrid: false }, // exactly 1.5 em under every H2
    { level: 3 },                    // inherits headings.snapToGrid: true
  ],
}

#前で改ページ

breakBeforeは番号付けの制御とは独立しています。有効にすると改ページを強制しますが、番号のカウンターがリセットされるのは:::numberingディレクティブを明示的に挿入したときだけです。奇偶合わせの白ページも実際のページとして数え、通常の奇数・偶数の規則に従ってヘッダーとフッターが付きます。

このような見出しの直前に:::pagebreakを置いても、見出しの改ページの代わりにはなりません。見出しはディレクティブが始めたページの後でも奇偶を適用するため、白ページが加わることがあります。手動の改ページの直後から始めたい見出しについては、見出しスタイルを参照してください。

奇偶の値

白ページの帰属

breakBeforeが挿入した白ページには、挿入された理由に応じて、章タイトルの柱が付きます：

• 奇偶の制約（'odd'、'even'、または'always-*'の奇偶合わせの部分）を満たすために挿入したページは、これから始まる章に属します。柱の{chapterTitle}プレースホルダーは新しい章のタイトルになります。その白ページは、新しい章を正しい奇偶のページへ送るためだけにあるからです。
• 'always-odd' / 'always-even'が先頭に挿入する必須の区切りは、前の章に属します。章の終わりに意図して置く間なので、柱の{chapterTitle}プレースホルダーには前の章のタイトルが出たままです。

スタイルを持つセクション（見出しスタイルを参照）の柱とパレットも、白ページでは同じ2つの規則に従います。

文書冒頭の例外

文書の最初のブロックがbreakBeforeを有効にした見出しである場合、またはソースが:::pagebreakで始まる場合、1ページ目がまだ空のあいだは奇偶の強制を行いません。設定した奇偶にかかわらず見出しは書いたとおり1ページ目に置かれるので、parity: 'odd'を設定した# Chapter 1で始まる文書の先頭に、余計な白ページが入ることはありません。何か内容が置かれた後は、奇偶の強制は通常どおり働きます。

#幅と詳細デザイン

各見出しレベルには、見出しをページ幅いっぱいの章扉として描画する方法を制御するフィールドが、さらに2つあります。

ページと同じ高さの章扉。確保する高さが段の末尾を越える場合（minHeightがページの高さに等しい表紙や、ページまたは裁ち落としに固定されて仕上がり線まで伸びる画像や囲み）、章扉はページの残りを占めます。その後の本文は、2段組みでも1段半レイアウトでも、どの段でも次のページから始まります。したがって表紙の後に:::pagebreakは不要です（置いても害はなく、白ページは加わりません）。段内の見出し（span: 'column'）のデザインが段より高い場合はその段を占め、本文は次の段の頭から始まります。見出しのブロックは占めた段の末尾まで伸び、デザインはその帯に対してレイアウトされます。上端に固定した要素は固定位置にとどまり、帯に従う要素（帯の中央や下端に固定したもの、または高さが'fill'のもの）は、高さが収まるときに確保した高さに収まるのと同じように、見出しが占める範囲に収まります（postext 1.4までは、ブロックは本文の高さのままだったので、それらの要素はタイトル1つ分の高さの帯に対してレイアウトされ、その後の本文はデザインの下へ続いていました）。ページを占めるべきでないページの装飾（ページ全体にわたる小口側の帯、ページ下端の飾り）は、ヘッダーかフッターのデザインに入れてください。'page'または'bleed'に固定し、pages: 'opener'で表示すれば、章扉のページに描かれ、本文の場所は確保しません。

例：タイトルの上に「Chapter N」を表示する簡素な章扉です。

{
  "headings": {
    "levels": [
      {
        "level": 1,
        "span": "page",
        "breakBefore": { "enabled": true, "parity": "always-odd" },
        "advancedDesign": {
          "enabled": true,
          "slot": {
            "elements": [
              {
                "kind": "text",
                "id": "chapterLabel",
                "placement": {
                  "anchor": { "to": "container", "edge": "top" },
                  "offset": { "y": { "value": 48, "unit": "pt" } },
                  "size": { "width": "fill" }
                },
                "content": "Chapter {numberRoman}",
                "fontSize": { "value": 10, "unit": "pt" },
                "align": "center",
                "overflow": "ellipsis-end"
              },
              {
                "kind": "text",
                "id": "chapterTitle",
                "placement": {
                  "anchor": { "to": "#chapterLabel", "edge": "below" },
                  "offset": { "y": { "value": 12, "unit": "pt" } },
                  "size": { "width": "fill" }
                },
                "content": "{titleText}",
                "fontSize": { "value": 24, "unit": "pt" },
                "fontWeight": 700,
                "align": "center",
                "overflow": "wrap",
                "hyphenate": true
              }
            ]
          }
        }
      }
    ]
  }
}

レベルのデザインスロットで使える見出しのプレースホルダー：

• {titleText}：見出しのプレーンテキスト（番号の接頭辞を除く）。タイトル中の強制改行（\\）は、章扉の帯でも段内のデザインでも、ここでは改行になります（postext 1.4までは、段内のデザインではスペースを出力し、高さは改行込みで測っていました）。非表示の見出しが段の中で折り返した行は、書いたとおりのタイトルに戻してつなぎます。語自身のハイフンの後で折り返した語はハイフンを残して後にスペースを入れず、段が分割した語は改行で加わったハイフンを除いて元の1語に戻します。段より広く、ノーブレークスペースの位置で分けられたまとまりはノーブレークスペースを取り戻し（CapítuloXVIIIではなくCapítulo XVIII）、それ以外の改行はスペース1つに戻します。postext 1.4までは改行がすべてスペースになったので、ハイフンで折り返したタイトルはWord- Bookと出力され、そのようなタイトルの強制改行は失われていました。
• {number}：レベルのnumberingTemplateに従って書式化した番号。
• {numberDecimal}、{numberRoman}、{numberRomanLower}、{numberAlpha}、{numberAlphaLower}：見出しのカウンター（テンプレートが何を出力するかにかかわらず、そのレベルの通し番号）を、ほかの数字の書式で表したもの。3番目の章なら3、III、iii、C、cとなり、numberingTemplateの有無は問いません。番号を付けない見出し（numbered: falseのスタイル）では空になります。
• {numberWords}、{numberWordsLower}、{numberOrdinalWords}、{numberOrdinalWordsLower}：同じカウンターを語で綴ったもの。先頭を大文字にするか、すべて小文字にするかを選べます：Three / three、Third / third（語で綴る番号を参照）。
• {numberHan}：同じカウンターを、文書のlocaleの字体の漢数字で表したもの。第{numberHan}回と設定した章扉は12番目の章で第十二回と出力し、目次には12と載ります。
• {chapterNumber}、{chapterTitle}、{pageNumber}、{totalPages}、{bookTotalPages}、{title}、{subtitle}、{author}、{publishDate}：共通のメタデータのプレースホルダー。
• {attr.<key>}：見出しの行そのものに書いた属性（# Title {author="I. Zango Martín"}）。なければ現在の章のH1の属性を使います。存在しない属性は、警告なしで空文字列になります。

{chapterNumber}は、柱がその章について出力するものと同じ値を出力します。H1のレベル（またはスタイル）にnumberingTemplateがあればH1の番号、なければ章の序数（1、2…で、この章より前に組んだ章から続きます）で、番号を付けない章や、テンプレートが''のスタイルでは何も出力しません。見出しのデザインは、その見出しが属する章を読みます。レベル1の見出しは自身の章を、下位の見出しはその前にある最後のレベル1見出しの章を読みます。2つの章が1ページで接する場合も同じで、そのページの柱は後の章を出力します。章扉が確保する高さも、同じ値で測ります。postext 1.4までは見出しの番号の接頭辞（テンプレートがなければ空）で測っていたため、高さが{chapterNumber}に依存するデザインは確保した場所より高く描かれることがありました。また、デザインはページの章を出力していたので、1ページを共有する2つの章のうち最初の章に、2番目の章の番号が出ていました。

カウンターのプレースホルダーは、1章ずつ組んだ章をまたいで本全体に従います（continuationAfter()が引き継ぐカウンター）。見出しのstartAt属性でリセットされます（文書形式 → 見出しの属性を参照）。流れと目次では3.と番号が付いたタイトルの上に、Chapter IIIと表示する章扉の例です：

{
  level: 1,
  span: 'page',
  numberingTemplate: '{1}.',
  advancedDesign: {
    enabled: true,
    slot: { elements: [
      { kind: 'text', id: 'label', content: 'Chapter {numberRoman}', fontSize: { value: 10, unit: 'pt' }, overflow: 'ellipsis-end',
        placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: 'fill', height: 'auto' } } },
      { kind: 'text', id: 'title', content: '{titleText}', fontSize: { value: 24, unit: 'pt' }, overflow: 'wrap',
        placement: { anchor: { to: '#label', edge: 'below' }, size: { width: 'fill', height: 'auto' } } },
    ] },
  },
}

確保する高さ

詳細デザインを持つ見出しは、ほかのブロックと同じように段の中で場所を取り、その後の本文はその下から始まります。その場所は次の3つの高さのうち最も高いもので、いずれも見出しの上端（ページの最初に来る章扉では版面の上端）から下へ測ります：

1. レベルの文字組みで組んだ見出し自身の本文（デザインの下に隠れますが、行は保ちます）。
2. デザインの内容の下端：数に入る要素（後述）のうち、最も低い下辺。
3. advancedDesign.minHeight。

その後に見出しのmarginBottom（見出しスタイル、レベル、またはheadings.marginBottomから。既定は0.5 em）を加え、見出しが吸着する場合はベースライングリッドに切り上げます。章扉（span: 'page'）では、同じ帯をページのすべての段で空けておきます。段に収まる段内の見出しでは、デザインはちょうどその高さの見出しのボックスの中にレイアウトされます。

数に入る要素。デザインの要素は、テキスト、罫線、ボックス、画像のいずれもすべて数に入ります（postext 1.4まではimage要素は数に入らなかったので、minHeightで押さえない限り、本文が帯の画像に重なって始まることがありました）。ただし、次のものは除きます：

• reserve: falseの要素：本文の下に敷いてよい装飾。
• 帯そのものに従う要素：コンテナーの中段（left、center、right）または下段（bottom-left、bottom、bottom-right）に固定した要素、高さをコンテナーに対する'fill'とした要素（高さのないボックスや縦罫線は既定でコンテナーを満たします）、およびそれらに固定した要素。コンテナーは確保した帯なので、これらは帯の下端に置かれるか、帯全体にわたります。帯の下の罫線や、タイトルの背後の色付きのパネルなどです。高さに従うだけで、高さを決めることはありません。ただし、そのうち自身の高さを保つテキストには、それでも場所が必要です。帯の下端に固定したタイトルは帯を少なくともタイトルの高さにするので、タイトルが見出しの上端より上から始まることはありません。minHeight: 36mmでタイトルをbottom-leftに固定すると、見出しのボックスは36 mmにmarginBottomを加え、グリッドに切り上げた高さになり、タイトルはそのボックスの下端、つまり続く本文のすぐ上に置かれます。minHeightがなければ、見出し自身の本文より多くの行を使うタイトルは、帯をタイトルの深さまで広げます。postext 1.4までは、このようなタイトルは見出しの上にある本文に重ねて上方向に描かれていました。帯に従うボックス、罫線、画像にはこのような下限はないので、下端に固定したパネルが見出しより上まで届くことがあります。

ページと裁ち落としに固定した要素は、見出しの上端より下へどれだけ届くかで数えます。見出しより上で終わるページ上部の帯は何も数えず、見出しを越えて伸びる裁ち落としいっぱいの画像は、本文をその下辺まで押し下げます。ページの低い位置にあるものも同じです。ページの下端から25 mm上にある印章、ページ全高にわたる側面の帯、枠などはページをその下辺まで確保するので、本文はたいてい次のページから始まります。このような装飾にはreserve: falseを付け（描画はされ、ほかの要素はそれに固定できます）、見出しに必要な場所はテキスト要素かminHeightで与えてください：

{
  "kind": "image", "id": "seal", "resourceId": "seal", "reserve": false,
  "placement": {
    "anchor": { "to": "page", "edge": "bottom-right" },
    "offset": { "x": { "value": -25, "unit": "mm" }, "y": { "value": -25, "unit": "mm" } },
    "size": { "width": { "value": 30, "unit": "mm" } }
  }
}

確保しない要素に固定した要素は、それ自身にも印を付けない限り数に入ります（印章に付けたキャプションには、それ自身のreserve: falseが必要です）。

描画される位置。章扉のデザイン（span: 'page'）は本文より先に描画されるので、何も確保しない装飾は本文の下に敷かれます。段内の見出しのデザインは見出しのブロックとともに描画され、段の中で先行するブロックより手前、後続のブロックより奥に描かれます。段の末尾より上であれば、左右の余白、天の余白、裁ち落とし、隣の段のどこに置いてもかまいません。流れはそこで終わるので、CanvasでもPDFでも段の末尾で切れます（後述の段より高い場合を参照）。postext 1.4までは、CanvasとPDFは段の上端でも切っていたため、ページや裁ち落としの上端に固定した帯は左右の余白には伸びても、天の余白で止まっていました。ページの下端に固定する装飾は、章扉か、pages: 'opener'を指定したフッターのデザインに入れてください。

段より高い場合。確保する高さが段の末尾を越える場合（ページと同じ高さのminHeight、仕上がり線まで伸びる画像や枠）、見出しはページ（章扉ではすべての段）または段（段内の見出し）の残りを占め、その後の本文は次のページまたは段から始まります。見出しのブロックは段の末尾まで伸び、本文の高さに切り詰められることはないので、デザインがレイアウトされる帯は占めた範囲そのものです（minHeightも含め、末尾まで）。ページそのものより高いデザイン（小さな画面用ページの長いリードなど）は、それでもページの末尾で切れます（段内のデザインは段の末尾で切れます）。Sandboxはこれを検査パネルで見出しのデザインの欠けとして示します。レイアウト自体は警告を出しません。ページを占める表紙はよくある使い方で、失うものもないからです。ただし、どのホストでも組み上がったレイアウトに同じ検査を行えます。collectHeadingDesignCuts(doc)は、デザインのテキストがページの仕上がりの末尾（where: 'page'、章扉）または段の末尾（where: 'column'）を越えている見出しごとに{ kind: 'headingDesignCut', pageIndex, level, where, overflowPx, sourceStart, sourceEnd }を1つ返し、formatWarningがそれぞれを説明します。幅と詳細デザインのページと同じ高さの章扉を参照してください。

サイド段。サイド段がフロートを受け持つ（sideColumnRole: 'floats'）1段半レイアウトでは、段内の見出しのデザインのうちサイド段に立つ要素（教科書の章扉で、小口側の余白の段にページ基準で固定した章番号など）が、サイド段に積まれるフロートを遠ざけます。見出しの後にそのページが置くspan: 'side'の図、表、囲みは、そのような要素からフロートの間隔1つ分を空けます。積み重ねで決まる位置で要素より上に収まればそこにとどまり、収まらなければ要素の下へ回り、サイド段の残りにそこで収まらなければ次のページを待ちます。そのため、サイド段の頭にある章番号は積み重ね全体をその下に置き、ページの下のほうにある見出しの脇の余白に掛けた節番号は、サイド段の頭をそのページが引用する図に譲ります（余白の図は引き続きページの上端に置かれます）。見出しを置く時点でサイド段がすでに持っているものは動かしません。ページの前のほうで積まれ、見出しの要素まで届く図はそのまま要素の下に残るので、ページの途中でサイド段に要素が立つデザインでは、図を見出しの後で引用してください。reserve: falseの要素は、本文に対してと同じくサイド段も空けたままにします。章扉（span: 'page'）ではこのような配慮は不要です。その帯はサイド段を含むすべての段で確保されるからです。postext 1.4までは、このような章扉で引用したサイドの図は、サイド段の頭、章番号の上に置かれていました。

表紙。ページを埋める表紙の見出し（ページと同じ高さのminHeight、またはデザイン内のページ全面の画像）は、こうして1段組みでも多段組みでも、それだけで後の本文を次のページへ送ります。直後の:::pagebreakは任意で、害もありません。まだ空のページでの改ページは何もしないので、白ページが加わることはありません。必要になるのは、表紙のデザインがページの末尾まで届かず、それでも本文を新しいページから始めたい場合だけです。

# Annual report 2026 {style="cover"}
 
:::pagebreak
 
# Letter from the chair

#語で綴る番号

番号付けテンプレートの2つの接尾辞は、カウンターを文書の言語（最上位のlocale、なければハイフネーションのロケール。文書の言語を参照）の語で書きます。基数にはwords、序数にはordinalを使います。文字のA / aと同じく、接尾辞の大文字・小文字が語の大文字・小文字を決めます：

英語、スペイン語、中国語、アラビア語は語で綴ります。ほかの言語は、組み込みの表の続き文字列と同じく英語の語を使います。中国語はlocaleの字体に従い、simp-chinese-informalまたはtrad-chinese-informalの通常の漢数字（一万 / 一萬）で書き、序数の前に第を付けます。漢字には大文字・小文字がないので、接尾辞の3つの書き方は同じ結果になります。英語はアメリカ式です（one hundred five、andなし）。スペイン語は、capítuloやlibroに番号を付けるときと同じく男性形を使い（capítulo primero、tercero、veintiuno）、13から29の序数はRAEが推奨するとおり1語で書きます（decimotercero、vigesimoprimero）。基数は999 999まで、スペイン語の序数は999まで語で綴り、それより大きい数は数字で出力します。

アラビア語の数は数える名詞と性が一致するので、接尾辞に修飾子を付けます。女性名詞には-feminine（または-f）、男性名詞には-masculine（-m、既定）を使います。-classicalは、ブーラーク版や多くのエジプトの刊本と同じく、百を現代のمئةではなくمائةと綴ります。{1:ordinal}は、見出しで使う限定・主格の序数を書きます。الفصل {1:ordinal}はالفصل الأول、الفصل الحادي عشر、الفصل الحادي والعشرونとなり、الليلة {1:ordinal-feminine}はالليلة الأولى、الليلة الحادية عشرة、الليلة الحادية والعشرون、الليلة المئتانとなります。100を超えると、古典的な「〜の後の」の定型になります：الليلة الخامسة والأربعون بعد الثلاثمئة、الليلة الحادية بعد الألف。{1:words}は基数を書きます（واحد وعشرون。女性形はإحدى عشرة、واحدة وعشرون）。序数は9 999まで、基数は99 999まで語で綴ります。修飾子は組み合わせられ（{1:ordinal-f-classical}）、ほかの言語では無視されます。アラビア語には大文字がないので、接尾辞の大文字・小文字は何も変えません。デザインのプレースホルダー{numberWords}と{numberOrdinalWords}は男性形を書きます。女性形の章扉では、レベルのテンプレートに序数を入れて{number}で出力してください。

見出しのデザインでは、{numberWords} / {numberWordsLower}と{numberOrdinalWords} / {numberOrdinalWordsLower}が見出しのカウンターを同じように綴るので、目次には1と載せたまま、章扉にはChapter Oneと表示できます。大文字にするには、テキスト要素のtextTransform: 'uppercase'を使います：

// Spanish novel: "CAPÍTULO PRIMERO" above the title, "1." in the contents.
{ level: 1, numberingTemplate: '{1}.', span: 'page',
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'text', id: 'n', content: 'Capítulo {numberOrdinalWordsLower}', textTransform: 'uppercase', /* … */ },
    { kind: 'text', id: 't', content: '{titleText}', /* … */ },
  ] } } }

#箇条書きリスト

unorderedListsプロパティは、箇条書きリスト（-、*、+）とGFMのタスクリスト（- [ ]、- [x]）の描画方法を制御します。入れ子は5階層までサポートしています。

#箇条書きリストの既定値

#タスクリストの拡張

GFMのタスク項目（- [ ] …、- [x] …）は、行頭記号の代わりにチェックボックスのグリフを置いた箇条書きの項目として描画されます。次のフィールドはタスク項目にだけ適用されます。

#箇条書きリストのレベル別上書き

levelsの各エントリーは1つの深さ（1–5）を対象とし、次のどの項目でも上書きできます。

インデントの連鎖。レベル1は常に全体のindentの値から始まります（既定は0 emで、行頭記号は段の端に固定されます）。レベル2–5では、indentを未定義のままにすると、エンジンは行頭記号を1つ上のレベルの文字の開始位置（親のインデント＋行頭記号の幅＋gap）に置きます。あるレベルにindentを明示すると連鎖が切れ、その深さを好きな位置に固定できます。

unorderedLists: {
  bulletChar: '—',
  gap: { value: 0.4, unit: 'em' },
  hangingIndent: true,
  levels: [
    { level: 2, bulletChar: '·' },
    { level: 3, bulletChar: '◦', color: { hex: '#666666', model: 'hex' } },
  ],
}

#番号付きリスト

orderedListsプロパティは番号付きリスト（1.、2)など）を制御します。入れ子は5階層までサポートしており、深さごとに異なる番号の書式を使えます。

#番号付きリストの既定値

#番号付きリストのレベル別上書き

levelsの各エントリーでは、numberFormat、prefix、separator、fontFamily、fontSize、color、fontWeight、italic、indent、verticalOffsetと区切りのスタイル（separatorFontFamily、separatorFontWeight、separatorItalic、separatorColor、separatorGap）を上書きできます。箇条書きリストと同じインデントの連鎖が適用されます。あるレベルの区切りのスタイルは、リスト全体の区切りの設定が指定されていない限り、そのレベル自身の番号のスタイルを継承します。

右そろえ。パイプラインは連続部分の中でもっとも幅の広い書式付きの番号を測り、その連続部分のすべての項目をインデントして、番号の右端をそろえます。1.–10.と描画される10項目のリストでは、1桁の番号に余白を補い、区切りが同じ位置にそろうようにします。

orderedLists: {
  numberFormat: 'arabic',
  separator: '.',
  levels: [
    { level: 2, numberFormat: 'lower-alpha' },
    { level: 3, numberFormat: 'lower-roman', separator: ')' },
  ],
}

これで、定番の入れ子の組み合わせになります。

1. First item
   a. Sub-item
      i) Deep note
   b. Sub-item
2. Second item

中国語の公文書の階層（GB/T 15834—2011、付録B.3）は5レベルで、一、→（一）→1.→（1）→①の順になります。

orderedLists: {
  levels: [
    { level: 1, numberFormat: 'simp-chinese-informal', separator: '、' },
    { level: 2, numberFormat: 'simp-chinese-informal', prefix: '（', separator: '）' },
    { level: 3, numberFormat: 'arabic', separator: '.' },
    { level: 4, numberFormat: 'arabic', prefix: '（', separator: '）' },
    { level: 5, numberFormat: 'circled-decimal', separator: '' },
  ],
}

#数式

mathプロパティは、$...$（インライン）と$$...$$（別行立て）で囲んだLaTeXの数式の解析と描画の方法を制御します。基盤のエンジンはSVG出力モードのMathJax（mathjax-fullパッケージ）で、キャンバスにはラスタライズして描画し、PDFには拡大縮小可能なグリフとして埋め込みます。

interface MathConfig {
  enabled?: boolean;        // Render LaTeX. When false, spans pass through as literal TeX.
  fontSizeScale?: number;   // × the surrounding text's size (the body size for display maths).
  color?: ColorValue;       // Formula colour; inherits body colour if omitted.
  marginTop?: Dimension;    // Space above display math blocks.
  marginBottom?: Dimension; // Minimum space below; baseline grid snap may enlarge it.
  indentAfterDisplay?: boolean; // Indent a paragraph that follows a display formula.
  keepWithLeadIn?: boolean; // Keep a display formula with the line that leads into it.
  equationNumbering?: {      // Number the display formulas that carry a \label.
    enabled?: boolean;           // default true
    numberingTemplate?: string;  // '{n}'; '{h1}.{n}' numbers by chapter
    resetOn?: ResourceCounterReset; // 'never' | 'h1' … 'h6'
    counterFormat?: ResourceCounterFormat; // 'decimal'
    format?: string;             // '({n})': what the formula and \eqref print
  };
}

math: {
  enabled: true,
  fontSizeScale: 1.0,
  color: { hex: '#295AA3', model: 'hex' },
  marginTop: { value: 1, unit: 'em' },
  marginBottom: { value: 1, unit: 'em' },
}

数式のサイズ（postext 1.5で変更）。MathJaxは数式のボックスをexで返し、TeXフォントの1exは0.442emです。postext 1.4まではエンジンがこれを0.5emとして扱っていたため、どの数式もbodyText.fontSize × fontSizeScaleより約13%大きく組まれていました。現在は数式がドキュメントに記載したとおりのサイズで組まれ、数式を含む行とページは組み直されます。1.4向けにコードで書いた設定は、書いたままの状態でpostext/bundleのpinLegacyMathSizeに1回通すと、1.4の数式サイズを保てます。

import { pinLegacyMathSize } from 'postext/bundle';
 
config = pinLegacyMathSize(config); // formulas, and the space around display formulas, as 1.4 set them

1.5でのほかの規則の変更でも、ページが動くことがあります。対象は、見出しの改行位置、インラインの図の周囲のアキ（本文中と囲みの中）、見出しのインラインのマーク、ドロップキャップのサイズ、コロンで終わる行の下に、それが導入するリストのために確保する余地、囲みの分割で段落やリスト項目に残る行、ダッシュの後の改行、行末不ぞろいのテキストの改行、見出しの下での段落の分割、複合語のハイフンの後の改行、:::paragraphsコンテナーの下のアキです。その設定で組むMarkdownを渡してmigrateConfigを1回実行すると、そのテキストに必要なものを、数式のサイズも含めて固定します（postext 1.4以前で書き出したバンドルを参照）。

import { migrateConfig } from 'postext/bundle';
 
config = migrateConfig(config, undefined, { content: markdown }); // heading breaks, formulas, inline gaps, heading marks, drop caps, colon lines, box cuts, dash breaks, compound breaks, ragged breaking, splits under a heading and container space as 1.4 set them

これで、こうした規則の変更によって動くものは抑えられますが、1.4のページがすべて保たれるわけではありません。バージョン1.5ではレイアウトのバグも修正しており、修正は固定できません。古い設定にも新しい設定と同じく修正が適用されるため、修正の影響を受けるページは動くことがあります。主なものは次のとおりです。独自のデザインを持たないページ幅の見出しは、ページ全体の幅で測られ、そのレベルの行送りで組まれます。見出しデザインの中のドロップキャップのベースラインの下には、何も確保されません。ドロップキャップはセクションのパレットの色を取り、overflowが'wrap'でないデザインテキストにも組まれ、そのテキストは回り込むようになります。囲みの中の段落は、測ったときのトラッキングで描画されます。分割された囲みは、すべての断片でアイコンの列を保ちます。語間を3倍を超えて広げることになる囲みの行は、本文と同じく行末不ぞろいで組まれます。ゆるい段落を調整する仕組みは、両端そろえの行をmaxWordSpacingが許す以上に広げません。フロートとして配置した囲みは、フロートのアキより広いmarginBottom（上の帯の場合）またはmarginTop（下の帯の場合）を保ちます。トラッキングを指定した中央そろえまたは右そろえのデザインテキスト（柱、章扉のタイトル）は、最後の文字の後のトラッキングを含めず、文字そのもので位置が決まります。ページ幅の章扉の下では、2段目を始めるテキストが、章扉の直下のテキストと同じ位置から始まります。章扉の後に見出しが続く場合も同様です。連続するドットをカーニングで離す書体でも、目次のリーダーはページ番号の手前で止まります。柱は見出しを書かれたとおりに読み、ハイフンやダッシュの後、または幅のために分割された語の途中で行が終わる箇所に空白を入れません（MEDIOAMBIENTALE SではなくMEDIOAMBIENTALES）。見出しデザインの{titleText}も同じように読みます（thousand- colourではなくthousand-colour）。見出しデザインの帯の下端または中央に固定したテキストは、それが収まる高さに帯を保つため、見出しの上のテキストに重なることがなくなりました。行より幅の広い語が、その語に含まれるハイフンの隣で分割される場合は、そのハイフンの後で分割され、2つ目のハイフンは付きません。別のリストに入れ子にしたリストの後の項目は、入れ子のリストではなく自分のリストのitemSpacingを使います。最後に、行より幅が広いために分割された語の残りは、その語自身の分割位置を保ちます。そのため、Webアドレスは区切りの位置で、複合語はハイフンの位置で改行され続け、辞書の音節で改行されることはありません。

pinLegacyMathSizeは倍率に1.1312（0.5 ÷ 0.442）を掛け、emで指定した別行立て数式のアキを同じ係数で割ります。別行立て数式を含む本では、倍率だけでは足りません。そのアキは数式自身のサイズに対する長さなので、同じく13%大きくなり、下のテキストを押し下げてしまいます。既定のアキについて書き出すと、3つの値は次のとおりです。

math: {
  fontSizeScale: 1.131,
  marginTop: { value: 0.7072, unit: 'em' },
  marginBottom: { value: 0.7072, unit: 'em' },
} // formulas as large as 1.4 set them, with the space 1.4 left around them

設定が保存されていた場合は、エンジンがそれを判別して自動的に処理します。1.5より前に書かれた.postextバンドルではopenBundle / readBundleが（postext 1.4以前で書き出したバンドルを参照）、その時期に保存された本、作業コピー、postext-config.jsonファイルではSandboxが処理します（Sandbox → 作業内容の保存を参照）。これらはmigrateConfigを通して読み込まれ、サイズが固定されます（pinLegacyMathSize）。fontSizeScaleは保存されていた倍率（未設定なら1）×1.1312になり、emまたはremで指定した別行立て数式のアキ（数式自身のサイズに対する長さ）は同じ係数で割られるため、別行立て数式の周囲のアキは1.4のときのまま保たれます（既定の0.8emは0.7072emになります）。ページの単位（pt、mm…）で指定したアキはそのままで、enabled: falseの設定や、本に$がない設定も変更されません。こうして古い本は1.4と同じように組まれ、そのmathセクションには実際に組まれるサイズが表示されます。そのような本を現在のサイズで組みたい場合は、これらの値をリセットします。Sandboxでは数式 → サイズの倍率、別行立て数式の上のアキ、別行立て数式の下のアキで、コードでは次のようにします。

math: { ...config.math, fontSizeScale: 1, marginTop: undefined, marginBottom: undefined } // today's size and margins

番号付きの数式。番号の付いた別行立て数式は、その組幅（段、または囲みの内側の幅）いっぱいに広がります。数式は中央に置かれ、その番号は数式の行の右端にそろえて組まれます。alignでは、番号の付いたすべての行でそうなります。番号は\label{eq:x}から付きます（postext 1.19以降）。ラベルを付けた数式と、align、gather、alignat、flalign、eqnarrayのラベルを付けた行には、\nonumberや\notagを書いた行を除き、equationNumberingに従って読む順に番号が振られます。equationなどの環境はそれだけでは番号が付かず、ラベルのない数式には番号がありません。\tag{…}は指定したラベルを括弧に入れて、\tag*{…}は書かれたとおりに印字します。どちらも数えられず、その横の\labelはそれに名前を付けます。組幅より広い番号付きの数式は、ほかの別行立て数式と同じく右へはみ出します。（postext 1.4までは、\tagを含む数式はまったく描画されず、1.18までは\tagだけが番号を付けていました。）

本文の\eqref{eq:x}は番号をそのformatで（(3)）、\ref{eq:x}は番号だけを印字します。:ref{id="eq:x"}と@eq:xも同じです（相互参照を参照）。数式の中では、\eqrefは番号をテキストとして印字します。章ごとに組む本では、カウンターは前の章から続きます。continuationAfterがそれをLayoutContinuation.statementCounters（equation）で引き継ぎ、本のアウトラインがすべてのラベルに番号を与える（OutlineEntry.numberLabel）ので、別の章の数式への参照もその番号を印字します。

math: {
  equationNumbering: { numberingTemplate: '{h1}.{n}', resetOn: 'h1' }, // (1.1), (1.2)… (2.1)
}

解決関数（resolver）と既定値の除去関数（stripper）は、ほかのセクションと同じ形です。

import {
  DEFAULT_MATH_CONFIG,
  resolveMathConfig,
  stripMathDefaults,
} from 'postext';
 
const resolved = resolveMathConfig(config.math);
const minimal  = stripMathDefaults(config.math);

#数式エンジンの起動

MathJaxはエンジンのほかの部分と一緒には読み込まれず、必要になったときに読み込まれます。メインスレッドでレイアウトする場合は、数式を含む文書を構築する前に起動してください。

import { buildDocument, initMathEngine, renderPage } from 'postext';
 
await initMathEngine(); // loads MathJax once; later calls resolve at once
const doc = buildDocument({ markdown: 'Euler: $e^{i\\pi}+1=0$.' }, config);
document.body.append(renderPage(doc.pages[0], doc));

• エンジンが動くまで、数式はプレースホルダーです。各数式は推定サイズの灰色のボックスとして配置されます。initMathEngine()を一度も呼ばずに数式を含む文書をレイアウトすると、コンソールにその旨の警告が1回表示されます。
• レイアウトワーカーは自動で起動します。postext/workerでのビルドは、Markdownに$が含まれていれば自らinitMathEngine()を呼びます。
• すぐにレイアウトし、準備ができたらもう一度。isMathReady()はエンジンが動いているかどうかを返します。onMathReady(fn)はエンジンが動き出したときに（すでに動いていればすぐに）fnを1回呼び、その呼び出しを取り消す関数を返します。エディターはすぐにプレースホルダーを表示し、MathJaxが届いたらもう一度レイアウトできます。initMathEngine()の実行中は警告は出ません。
• 失敗。MathJaxを読み込めない場合、initMathEngine()はrejectされます。次の呼び出しで再び読み込みを試みます。
• どのバンドラーでも、Nodeでも、CDNでも。MathJaxは、事前にバンドルした1つのモジュールとしてパッケージに同梱されています（圧縮前で約1.8MB、initMathEngineが呼ばれたときにだけ取得されます）。単純なimport { initMathEngine } from 'https://esm.sh/postext'で動作し、?bundleは不要です。mathjax-fullパッケージはpostextのビルドにだけ必要なため、postextをインストールしてもインストールされません。MathJaxと、それに同梱されたmhchemパーサーはApache-2.0ライセンスです。それらの告知とライセンス文は、モジュールの隣にdist/math/THIRD_PARTY_LICENSES.txtとして同梱されています。
• 1ページにエンジンは1つ。エンジンと、描画済みの数式のキャッシュは、同じJavaScriptレルムでpostextをインポートするすべてのコードで共有されます（1つのページで共有されるグローバルな状態を参照）。

文書側の文法（$...$、$$...$$、ドル記号そのもののエスケープ）については、文書形式を参照してください。