Postextの設定

Postextのレイアウトに関する判断は、すべて1つの設定オブジェクトで決まります。

PostextConfigは、ページの寸法、段組み、本文の文字組み、見出しのスタイル、文書の言語（locale）などを制御します。プロパティはすべて省略できます。Postextには伝統的な書籍組版にならった無理のない既定値が用意されているので、指定するのは変えたい項目だけで済みます。

import { buildDocument } from 'postext';
 
const document = buildDocument(content, {
  page: { sizePreset: '21x28', dpi: 300 },
  layout: { layoutType: 'double', gutterWidth: { value: 0.5, unit: 'cm' } },
  bodyText: { fontFamily: 'EB Garamond', fontSize: { value: 9, unit: 'pt' } }, // 9 pt overrides the 8 pt default
  headings: { fontFamily: 'Open Sans' },
});

エンジンがこの設定をどう処理するかの概要は、アーキテクチャーのページを参照してください。

#内容一覧

このリファレンスは長いため、主なブロックを挙げておきます。

• ページ：サイズ、余白、ベースライングリッド、トンボ、綴じ。
• レイアウト：段数、段間、段間罫、縦組み。
• 柱とノンブル：ページごとに置くテキスト要素と罫線要素。プレースホルダー、奇偶、そろえ位置を指定できます。
• 本文：文字組み、ハイフネーション、オーファンとウィドウ。
• 文書の言語：最上位のlocale。ハイフネーションのフォールバック、組み込みのリソースタイプ、表と分割された囲みの続きを示す文字列、アクセシブルなPDFにタグ付けされる言語を決めます。そこから導かれる数字（numerals）とテキストの方向（direction）、Postextが組める言語と文字体系もここで説明します。右から左に組む本のガイドはアラビア語の組版です。
• 東アジアの組版：cjk。中国語・日本語・韓国語のテキストの地域ごとの慣習と行分割、両端そろえの行の空け方、約物の幅とぶら下げ、漢字とラテン文字の間のスペース、文字グリッド、縦組みでの数字の正立、そして圏点、ルビ、割注、漢文の訓点。全体のガイドは中国語の組版と日本語の組版です。
• 見出し：共通の既定値と、H1〜H6ごとの上書き。
• 箇条書きリストと番号付きリスト：行頭記号、番号付け、入れ子。
• 数式：LaTeXの描画、倍率、色、余白。
• リソースの種類：図、表、独自の種類に付ける種類別の番号。
• 表スタイル（名前付きの表スタイルを含む）とキャプションスタイル：表リソースとそのキャプションの文字組みと装飾。
• ダイアグラムスタイル：特色印刷のために、埋め込んだSVGのダイアグラムを単色に塗り替えます。
• 段落スタイル：:::paragraphsコンテナー用の名前付きスタイル。参考文献、用語集、注記などに使います。
• 囲みスタイル：:::calloutコンテナー用の、枠で囲んだ注記、ヒント、学習目標。
• 部：:::partコンテナー用の部扉ページ。奇偶、本文領域、扉のデザイン、本文の文字組み。
• 見出しスタイル：{style="…"}を付けた見出し用の名前付きスタイル。番号のない章や、独自の柱、ジオメトリー、パレットを持つ前付けに使います。
• 目次：:::tocが出力する内容。項目の文字組み、リーダー、ページ番号、著者の行、部の行。
• 索引：:::indexが出力する内容。項目の文字組み、字下げ、ページ番号の区切りと範囲、頭文字ごとのグループ、並べ替えの言語。
• 単位と色、カラーパレット：Dimension、ColorValue、名前付きの色。
• カスタムフォント：ユーザーがアップロードしたフォントファミリーを、Google Fontsと並べて宣言します。
• HTMLビューアー：HTMLバックエンドの目標段幅と行分割。
• PDF生成（設定）：PDFバックエンドのしおり、アクセシブルな（タグ付きの）出力、色空間の強制。
• Folioビューアー（設定）：3Dの本のビューアーの用紙、綴じ、表面、光。
• デバッグ：エディター用の視覚的なオーバーレイと、執筆中の警告。
• プログラムからの利用：buildDocumentとそれが報告する警告、リゾルバー、キャッシュ。
• Web Workerでレイアウトを実行する：キャンセルできる、メインスレッド外でのビルド。
• HTMLビューアーの統合とPDFの生成：最初から最後まで通した実例。
• EPUBの本：同じレイアウトから作る固定レイアウトとリフロー型のEPUB 3ファイルと、EPUBCheckによる検査。

#ページ

pageプロパティは、ページの物理的な寸法と外観を制御します。

#見開きの余白

本は見開きで読まれ、のどの余白はふつう小口の余白と異なります。margins.mirrorを使うと、4つの余白が見開きの余白になります。

{
  "page": {
    "margins": {
      "top": { "value": 2, "unit": "cm" },
      "bottom": { "value": 2.5, "unit": "cm" },
      "left": { "value": 2.2, "unit": "cm" },
      "right": { "value": 1.4, "unit": "cm" },
      "mirror": true
    }
  }
}

この設定では、どの奇数ページも左（背の側）の余白が2.2 cm、右（小口）が1.4 cmになり、どの偶数ページも左（小口）が1.4 cm、右（背の側）が2.2 cmになります。組まれた各ページはVDTPageに自分のcontentAreaを持つため、そこから導かれるもの、つまり段、全幅のフロートの帯、ヘッダーとフッターのコンテナー、span: 'page'の章扉の帯は、左右を入れ替えたジオメトリーに自動的に従います。'page'または'bleed'に固定したデザイン要素が使うページ枠と裁ち落とし枠は影響を受けません。これらは余白ではなく、物理的な用紙を表すものです。

#綴じ

「縦組みの中国語文書は右側で綴じ、横組みの文書は左側で綴じる」（clreq §7.1.1.1）。page.binding: 'right'は、本を右綴じとして組みます。

• 1ページ目はこれまでどおり奇数ページ（recto）です。そのためbreakBefore.parity、:::pagebreak{parity}、parityを持つデザイン要素、あらゆるページ数の意味は変わりません。変わるのは奇数ページが置かれる側で、見開きの左ページになります。新しい奇数ページから始まる章は、左ページから始まります（clreq §7.1.3.3）。
• margins.mirrorを使う場合もleftはのどの余白ですが、左右を入れ替えるのは奇数ページのほうになります。1ページ目はのどの余白が右に、2ページ目は左に来ます。'outer'／'inner'に置いたoneAndHalfのサイド段、背に接する回転したフロート、部扉の余白、'outer'／'inner'に置いた囲みの角のアイコンも同じ規則に従います。
• 文書自体がそれを示すため（VDTDocument.binding: 'right'）、ホストが設定を読む必要はありません。Sandbox（ブラウザーで動く編集環境）は見開きを[3 | 2]のように表示し、1ページ目は背の左側に単独で置かれます。SandboxのHTMLビューアーはページを右から左へ並べ、右端から開き、左矢印で次のページに進みます。renderToHtmlのmultiモードは、ページの列を右から左に並べます。
• PDFには、タグ付きかどうかにかかわらず/ViewerPreferences << /Direction /R2L >>と/PageLayout /TwoPageRight（1ページ目は単独、以降は2ページずつ）が入ります。AcrobatとFoxitはこれに従いますが、Chromeの組み込みビューアーはどちらも無視します。

ノンブルと柱はひとりでには移動しません。ページ番号を外側の角に置くテンプレートでは、奇数ページ用と偶数ページ用の要素を右綴じに合わせて設定する必要があります（要素はparityを取ります）。

右から左に書く本（アラビア語、ペルシア語、ヘブライ語など）も右綴じです。文書のdirectionが'rtl'に解決されると、'auto'は右綴じになります。こうした本は流れ全体も反転するため、最初の段は右側になり、字下げ、リストの行頭記号、フロート、注は右に置かれます。ヘッダーとフッターのスロットは物理的な位置のままです。アラビア語の組版を参照してください。

#ページサイズのプリセット

#ベースライングリッド

ベースライングリッドは本文のリズムで、版面の上端から数えて本文の行の高さ1つ分ずつ離れた線です。描くかどうかにかかわらず、レイアウトはこれを使います。見出し、リストの終わり、囲み、図、別行立ての数式のあとでは、テキストがグリッドに戻ります（それぞれのsnapToGridがオフでない限り）。そのため隣り合う段の行はそろったままです。enabledはCanvas、PDF、Sandboxのビューにこの線を描いてリズムを確かめるためだけのもので、オンにしてもオフにしても何も動きません。線はページ上の実際のテキスト、つまり最初のテキスト行から最後の行までの範囲にだけ引かれます。フロートの帯、奇偶合わせの白ページ、使われていない末尾の空きにはグリッドは表示されません。

page: {
  baselineGrid: { enabled: true, color: { hex: '#e0e0e0', model: 'hex' } }
}

#トンボ

有効にすると、キャンバスが裁ち落とし領域を含む大きさに広がり、エンジンは印刷工程用のトンボを四隅に描きます。

用紙は四辺それぞれbleed + markOffset + markLengthだけ大きくなり、仕上がりのページはその中央に置かれます。仕上がりの各角には長さmarkLengthのトンボが2本付き、それぞれそこで交わる辺の一方の延長線上に置かれます。トンボは仕上がりからmarkOffsetだけ外側で始まり、bleedのほうが広い場合は裁ち落としの端から始まるため、裁ち落としまで伸びた絵柄にトンボが重なることはありません。既定値（裁ち落とし3 mm、間隔3 mm）では、トンボは仕上がりの外側3 mmから8 mmの範囲に引かれ、その外側を幅3 mmの空白の帯が用紙を一周します。cropMarkSegments(page, doc.config.page, doc.trimOffset)は、1ページ分の8本のトンボ、つまりCanvasとPDFのバックエンドが描くものを、ページのピクセル単位で返します。第3引数は用紙の中で仕上がりが置かれる位置で、PDFのTrimBoxを書き出すもとになる値です。省略すると、cutLinesから同じ方法で算出されます。

裁ち落としの外側には、トンボ以外何も印刷されません。ページが描くものはすべて、'page'や'bleed'に固定したデザイン要素も含めて、Canvas、PDF、HTML出力のいずれでも、DTPソフトの書き出しと同じように裁ち落としの枠で切り取られます。意図して裁ち落としの外まで置いた帯や画像は裁ち落としの端で切られますが、そこは断裁でいずれ失われる部分です。postext 1.4までは、そうした要素はトンボの上を越えて用紙の端まで描かれていました。

PDF（postext-pdf）では、各ページのMediaBoxは用紙全体です。ページにはさらに、仕上がりのページを表すTrimBoxと、仕上がりに裁ち落としを加えたBleedBoxも入り、面付けやプリフライトのツールがこれを読みます。トンボはレジストレーションカラー、つまり/Allの分版で描かれるため、すべての版に印刷されます。これはPDFを書き出す色空間（RGB、グレースケール、CMYK）にかかわらず同じです。ただの黒では、リッチブラックとして、あるいは墨版だけとして印刷所に届いてしまいます。colorはキャンバスにだけ適用されます。

#ノンブル

page.pageNumberingブロックは、ページラベルの書式とカウンターの開始値を制御します。定義するのは文書全体の既定値だけです。文書の途中で番号を振り直す（たとえば、ローマ数字の前付けから、1から始まる算用数字の章に切り替える）には、:::numberingディレクティブを使います（文書形式 → ディレクティブを参照）。

計算されたラベルはすべてのVDTPageにpageLabelとして格納され、ヘッダー・フッターのプレースホルダー{pageNumber}はこの値に解決されます。PDFには/PageLabelsの数値ツリーが出力されるため、プレビューやAcrobatのページ表示と「ページへ移動」が、印刷されたラベルとぴったり一致します。PDFにコードのない書式（漢数字、丸数字、全角数字）はページごとに書き出されるため、ビューアーにも一, 二, 三と表示されます。

番号書式の表記

番号書式を選ぶ設定は3つあり、それぞれが独自の表記を持つようになりました。ページラベル（page.pageNumbering.formatと:::numbering{format=…}）はlower-roman、番号付きリスト（orderedLists.numberFormat）は10進数をarabic、リソースタイプ（counterFormat）はroman-lowerと書きます。どの設定も下の表記をすべて受け付けるため、ある設定からコピーした書式はほかの設定でも使えます。名前の大文字と小文字は区別しませんが、1文字の形式は区別します（iとIは別のものです）。

東アジアの書式は、3つの設定のどれでもCSS Counter Stylesの名前を使います。中国語の漢数字（informal）は、10から19では十の前に一を付けず（十二。ただし一百一十）、数の中で続くゼロには零を1つだけ書き（一百零一、一千零五十）、1万には万または萬、1億には亿または億を使います（一万零一十）。〇を1桁ずつ使うのはcjk-decimalだけで、年を書くときの形です（二〇二六、GB/T 15835—2011）。十干は10、十二支は12、丸数字は50までで、それを超えると算用数字で出力されます。一と壹は文書のlocaleの字体に従い、zh-Hant、zh-TW、zh-HKなら繁体字、それ以外は簡体字になります。古い版には101を零なしで一百一と書くものもありますが、Postextはこの形を出力しません。

日本語の書式（postext 1.16以降）もCSS Counter Stylesに従います。japanese-informalは十の前に一を付けず、空の位に零を書きません（百一、千十）。japanese-formalは大字の壱 弐 参 拾 百 阡を使い、各単位の前に壱を残します（壱拾、壱百）。CSSではどちらも9 999までですが、Postextはその先も4桁ごとに万 億 兆（大字では萬 億 兆）で続け、各グループで単位の前の一を残します。一万一は10 001、一億一万は100 010 000です。日本語の文書（ja、ja-JPなど）では一はjapanese-informalを意味するため、第{1:一}章は日本語の文書では第百一章、中国語の文書では第一百零一章と出力されます。壹は中国語の大字のままです。仮名の系列はCSSのリストと同じで、五十音順の48字（ゐとゑを含む）と、いろは歌の順の47字です。最後の字を過ぎると2字で続き（ああ、いい）、ゼロはないため、0番の項目は0と出力されます。位取りの漢数字（二〇二六）は年やノンブルに使う形で、cjk-decimalにあたります。

アラビア語の書式は、CSSに名前があるものはその名前を使います（arabic-indic、persian。W3Cの『Ready-made Counter Styles』にあるurduとmaghrebi-abjadは、それぞれpersianとarabic-abjad-maghrebiとして読みます）。arabicは従来どおりの意味、つまりヨーロッパ式の数字です。arabic-abjadは、古典アラビア語や写本の丁付けに使われる加算式のアブジャド数字を、大きい値から順に書きます。11はيا、1446はغتموで、千の位の数はغの前に置きます（2000 بغ, 1002 غب）。999 999を超えると算用数字で出力されます。W3Cのノートはこの名前を、11がكになる28文字の系列に使っています。Postextではその系列をabjadと呼び、アブジャド順でリスト項目に文字を振るときに使います（أ، ب، ج، د، هـ）。アルファベット順はhijaiです（أ، ب، ت، ث）。どちらも最初の文字をハムザ付きのأで書き、単独で立つことになるハーはタトウィールを付けてهـと書くため、数字の١や٥と読まれることはありません。28を超えると、lower-alphaと同じように2文字になります（أأ, أب）。マグリブ式の数価は覚え歌صعفض قرست ثخذ ظغشに従います（ص 60, ض 90）。W3Cのリストではصとضが入れ替わっています。أ1字では2つの文字の系列を区別できないため、それぞれのトークンは最初の4文字にしています（{1:أبجد}、{1:أبتث}）。文書自体の数字はnumeralsで設定します。

ほかの表記は、型チェックを受けない設定、つまりJSONのプリセットと素のJavaScriptのためのものです。TypeScriptの型には、各設定に固有の表記、つまりSandboxが書き込みresolveAllConfigが返す表記（東アジアの名前を含む）しか挙げていません。そのため型付きのPostextConfigではその表記を使い、別の表記を使うにはキャストが必要です。

// JavaScript or a JSON preset (in TypeScript, each setting's own spelling)
orderedLists: { numberFormat: 'decimal' },          // same as 'arabic'
page: { pageNumbering: { format: 'roman-lower' } }, // same as 'lower-roman'
resourceTypes: [{ id: 'plate', counterFormat: 'upper-roman', … }], // same as 'roman-upper'

resolveAllConfigは、リストとページの書式をそれぞれの設定に固有の表記に変換します。orderedListsでは'decimal'が'arabic'に、page.pageNumberingでは'roman-lower'が'lower-roman'に解決されます。stripConfigDefaultsは、既定値を別の表記で書いたものも取り除きます。Sandboxのパネルは、設定がどの表記を使っていても、3つの設定をそれぞれ固有の表記で表示します。それ以外の値（roman、01、タイプミスなど）は、undefinedと出力される代わりに10進数で番号付けされ、設定の警告として報告されます。見出しの番号テンプレートもコロンのあとに同じ名前を取り（{1:roman-upper}は{1:I}と同じ）、独自のゼロ埋め{1:01}も使えます。

#レイアウト

layoutプロパティは、版面の中での段の配置を制御します。

#縦組み

writingMode: 'vertical-rl'では、ページは横組みのページを時計回りに90度回したものとして組まれます。流れは用紙の高さと同じ幅の枠の中で組まれ、その行が縦組みテキストの列になって、右から読まれます。行に関してエンジンが行う処理（行分割、両端そろえ、フロート、脚注、分割禁止の規則）はすべてこの枠の中で働きます。そのため用紙の上では次のようになります。

• レイアウトの段は、縦組みでは上下に重なる段（tier、栏）になります。layoutType: 'double'では上下に積まれた2つの段ができ、右上から埋まります。gutterWidthは段と段の間の空き、段間罫は段の間に引く水平の罫線になります。章の終わりで段の長さはそろえません（clreq §7.1.3.4）。縦組みの文書では、headings.balancing.enabledを設定しない限り段末そろえはオフです。
• 流れで「上」と呼ぶのは、読み始める側である用紙の右端です。上のフロートはページの右に、下のフロートは左に置かれ、ページ幅の章扉は右端に沿った帯になり、脚注は各段の左端に入ります。ページの上に固定したデザイン要素（見出しのデザイン、固定の囲み）は右端に固定されます。sideColumnSideの'left'は上の段、'right'は下の段で、'outer'と'inner'はそれぞれ'right'と'left'として読みます。
• 流れの余白は、用紙の余白を回したものです。右の余白が流れの上、上の余白が流れの左になります。page.marginsは用紙上での名前のままです。
• 柱、ノンブル、トンボ、ページの背景は、clreqが縦組みの本について述べているとおり、用紙の上に横組みで置かれます。
• 図と表は正立します。図はキャプションが許す範囲で段の高さいっぱいに広がり、幅は最大でページの幅までです。図が取る幅が、流れの中で使う分量になります。キャプションは図の下に横組みで置かれ、表のセルも同様で、どちらも横組みのテキストとして計測されます。表はページの上に正立して置かれ、段より高い場合は行が段に合わせて分割されます。placement.alignは図を段の上端（'left'）、中央、下端に置きます。図が縦組みのテキストで最初に参照される位置ではplacement.rotateは適用されず、ビルドはrotateIgnoredVerticalのコンテンツ警告を報告します。本の中の横組みの部分（layoutで'horizontal-tb'を設定した見出しスタイル）では、図は指定どおりに回転します。
• デザインの画像（章扉のイラストや部扉のイラスト）も正立します。流れの中でのその枠は画像の幅と高さを入れ替えた大きさになるため、size.widthは画像が段に沿って下へ伸びる長さを表し、用紙上での幅は縦横比から決まります。
• 文字：漢字、仮名、全角文字は正立し、それぞれ1em分を占めます。ラテン文字の単語と数字は横倒しになり、横組みでの幅を使います。約物はフォントの縦組み用字形を使います。句読点は回転させません。中国大陸のフォントは、、。，．をセルの右上隅に、！？：；をセルの右半分に置き、台湾や香港のフォントはこれらを中央に置きます（cjk.region）。括弧は縦組み用の字形を使い、大陸のテキストの“ ” ‘ ’は『』「」として読みます。ダッシュ、三点リーダー、波ダッシュは、フォントに縦組み用の字形があればそれを使い（Noto CJKでは—の縦組み字形がfwidとともにvertに割り当てられていて、セルの中央を縦に通る罫になります）、なければ横倒しにして、インクを段の軸の中央に合わせます。中国語のテキストの破折号（——）は、段を縦に通る1本の罫です。縦組み用の字形では各セルの両端に空きが残るため、各ダッシュを行とともに回転させ、横組みと同じように引き伸ばします（約物の幅を参照）。2桁までの数は1つの正立したセルに収めますが、ラテン文字の文の中にある場合はその単語に従います（縦組みの数字を参照）。中黒（·）は大陸のテキストでは半セル、台湾と香港のテキストでは1セルを占めます。Unicodeが正立とする記号（× © ± § ℃ ①など）は、数の中にあっても独立したセルに正立します。3×4は、横倒しの3と4の間に×が正立して入ります。ラテン文字の単語の2文字の間にあるアポストロフィーや中黒（don’t、l·l）は単語の中に残り、横倒しになります。縦組みの流れの中にあるラテン文字の段落も同じ規則に従います。インラインの数式、チップ、色見本は行とともに横倒しになります。
• すべての文字は描かれるとおりに計測されます。正立のセルは行に沿ってセル1つ分進み、横倒しの文字列は横組みでの幅だけ進みます。用紙上で横組みのままのテキスト（柱、ノンブル、キャプション、表のセル）は横方向に計測されます。
• 約物の幅、ぶら下げ、和欧間のアキは、横組みで行に沿って適用されるのと同じように、縦組みでも行に沿って適用されます。字形の前の空きはその上に、後の空きはその下に来ます。開明式（Kaiming）の、は半セルを取り、」「は1.5セルに詰められ、行頭で詰めた始め括弧は半セル上から始まり、ぶら下げた。は行の下端の下に置かれ、漢字とラテン文字の間のスペースは横倒しの単語の上下にその段の4分の1 em分入ります。：；？！は縦組みではどの地域でも1セル全体を取ります。
• 文字グリッドは、行に沿って文字を数え、ページを横切って行を数えます。charsPerLineは段の長さを、linesPerPageはページに入る行数を決め、layoutType: 'double'では文字数が整数の2つの段と、整数のemからなる段間ができます。

レイアウトを読むホスト向けの情報です。縦組みのページはVDTPage.flowを持ちます。そのcontentArea、段、ブロック、行、フロート、脚注領域、章扉の帯、ブロックのデザインのオーバーレイは流れの座標系で表され、width、height、header、footerは用紙上の値です。flowToPage、pageToFlow、flowRectToPage、pageRectToFlowは両者の間を変換し、verticalOrientation(char, region)は文字の向きを返します。flow.centralBaselinesは、フォントファミリーごとに、レイアウトが正立した文字を中央合わせした軸を返します。これは中のインクの中心です。中の長い画はemボックスの高さいっぱいに伸びており（Noto SerifとNoto Sansでは、SCでもTCでもベースラインの0.38 em上）、中国語・日本語・韓国語のどの書体にもこの字があります。各行はこの軸で中央合わせされます。縦組みの行のベースラインは、行ボックスの上端から、行の高さの半分にファミリーの中央ベースラインを足した分だけ下にあります（横組みの行では行の高さの0.8倍下）。そのため文字の列は行送りの中央に立ち、行送りの整数倍の位置で2つの列の間に引いた罫は、両者のちょうど中間に来ます。縦組みのデザインテキストも、それ自身の行の中で同じように組まれます。縦組みのページはキャンバスが自分で描きます。約物をフォント自身の縦組み字形で描くために、ブラウザーのホストはファミリーごとに1回、その機能を有効にした双子のフェースをloadVerticalAlternates(family, faces)で読み込みます。facesはファミリーのソース（URLまたはバイト列）とディスクリプターです。双子が残されるのは、ブラウザーがその機能をキャンバスのテキストに適用する場合（Chrome 140以降）だけです。与えたフェースのウェイトとスタイルで「（《を、双子と、機能なしで読み込んだ同じフェースのコピーとで描き、インクが異なれば双子を残します。双子を使用中のファミリーについて、別のフェース（標準のあとの太字など）で後から呼び出すと、そのフェースが双子に追加されます。Sandboxは縦組みの文書のすべてのファミリーでこれを行います。双子がない場合、括弧はemボックスを中心に回転させ、大陸の句読点はフォントの縦組み字形が置く位置にセルの中で移動させます。、。，．は右上隅へ（Noto Serif SCの縦組み字形との差は0.07 em以内）、！？：；は右へ半em、少し上へ移します（差は0.02 em以内）。PDFとHTMLも同じページを組みます。PDFの縦組みと、HTML出力とcanvas、PDFとの違いの表を参照してください。Noto Serif TCとSCで、HarfBuzz（vertを使った縦組みレイアウト）とセルごとに照合すると、「賈雨村」云云，宜乎？故曰！；：、。“引”‘單’……のどの文字も、CanvasとPDFでは0.02 em以内、HTMLでは0.05 em以内に収まります（Chromeは回転した字形をフォントのアセントとディセントの中央に合わせますが、Notoではそれがemボックスの中心より0.05 em上にあります）。flow.dashAdvancesは、ファミリーごとに、ページがセルを埋めるために引き伸ばす各ダッシュ（— – ― ⸺ ⸻ －）の横方向の送り幅をem単位で返します。これはフォントメトリクスを自前で持たないレンダラーのためのもので、HTMLはこの値でダッシュを引き伸ばし、CanvasとPDFは自前の値で同じことをします。柱とノンブルも縦に組めます。縦組みのテキスト要素を参照してください。

#段間罫

段間に細い縦の罫線を引いて、段を視覚的に区切ります。

ページ幅の見出し（span: 'page'）の下では、罫は見出しの帯の下、段のテキストが始まる位置から始まります。帯を描くのが標準の章扉でも、独自のデザインでも同じです。postext 1.4までは、版面の上端から帯を貫いて引かれていました。

見出しスタイルはlayoutで独自の罫を設定でき（見出しスタイルを参照）、そのセクションのページはその罫を描きます。スタイルで設定していない項目は文書の値を取るため、段組みだけを変えたセクションでは文書の罫がそのまま使われます。postext 1.4までは、スタイルの罫は描かれず、どのページも文書の罫を描いていました。

#レイアウトの種類

• 'single'：版面の幅いっぱいの1段。幅の狭いページや、長い段落の多い文章中心の内容に向いています。

• 'double'：同じ幅の2段。古典的な編集レイアウトで、1行の長さを読みやすい40〜50文字の範囲に保ちます。

• 'oneAndHalf'：メインの段と、それより狭いサイド段からなる非対称のレイアウト。サイド段（sideColumnPercentで制御）は、傍注、小さな図、補足的な内容に適しています。25〜40%の値が使いやすく、行番号や欄外の記号のための細い欄なら10〜15%程度です。サイド段は版面の幅のsideColumnPercent%で、メインの段は段間を引いた残りです。そのため50%では、サイド段のほうがメインの段より段間1つ分広くなります。両方の段が版面の幅の1%以上を保つ限り、どの値も書いたとおりにレイアウトされます。どちらかがそれより狭くなる値（0以下、あるいはメインの段が段間に隠れて消えるほど大きな値）は、両方を保てる最も近い値に制限され、数値でない値は既定値の33になります。そのとき文書のconfigWarningsには{ kind: 'sideColumnPercentClamped', path: 'layout.sideColumnPercent', value, used }が入ります。見出しスタイル自身のlayoutの場合、パスはheadingStyles[2].layout.sideColumnPercentのようにそのスタイルを指し、値はそのスタイルの余白で計測されます。Sandboxはこれを検査パネルに表示し、collectConfigWarnings(config)は何もレイアウトせずに同じリストを返します。'oneAndHalf'以外のレイアウトはこの値を読まず、報告もしません。sideColumnRole: 'floats'では本文がサイド段に入ることはなく、サイド段はspan: 'side'で配置した図、表、囲みのための欄になります。サイドの図や表は、最初に参照されたページで欄の先頭から積まれます。教科書の欄外の図は、本文での参照がページの下のほうであっても、ページの上端に置かれます。欄の残りに収まらないものは次のページの欄に回ります。サイドの囲みは、中断したテキストの横に積まれます。欄の残りに収まらない場合は、収まる範囲で最も低い位置（囲みの下端が欄の下端に接する位置）まで上にずれるか、次のページに回ります。囲みのフェンスのあとのテキストが次のページに続く場合（段がいっぱいのときや、分割の規則がそのテキストを送るとき）、囲みはフェンスの位置、つまりその前のテキストの横に残ります。sideAtColumnEnd: 'after'を指定したスタイルでは、代わりにフェンスのあとのテキストの最初の行と同じ高さ、つまり次のページの欄に置かれます。行の前に書く行番号や欄外見出しには、この動作が必要です。欄の中に立つ見出しデザインの要素（外側の余白に固定した章番号など）も、積み重ねと重ならないように避けられます（確保する高さを参照）。span: 'page'のフロートと囲みは引き続き両方の段にまたがり、placement.captionSideを指定した段のフロートは、キャプションを欄の中、図と同じ高さに置きます。見開きの余白とsideColumnSide: 'outer'を組み合わせると、欄はすべてのページの外側の辺に置かれます。教科書の欄外段の形です。

#柱とノンブル

headerとfooterプロパティは、ページごとのヘッダーとフッターのスロットを制御します。ヘッダーとフッターは既存のページ余白の内側に描画されます。追加のスペースを確保することはなく、本文領域を狭めることもありません。

コンテナーの枠。'container'にアンカーした要素は、本文と仕上がり線のあいだの余白の帯に置かれ、本文領域の幅に広がります。ヘッダーのコンテナーは仕上がりの天から本文の上端まで、フッターのコンテナーは本文の下端から仕上がりの地までです。そのため、ヘッダーのtop-*アンカーとフッターのbottom-*アンカーは仕上がり線から測り、ヘッダーのbottom-*アンカーとフッターのtop-*アンカーは本文の端から測ります。コンテナーに裁ち落としやトンボの帯が含まれることはないため、page.cutLinesのオン・オフにかかわらず、ヘッダーやフッターは断裁後のページの同じ位置に来ます。本文領域の幅を超えて、または裁ち落としまで要素を広げるには、'page'（トリムボックス）か'bleed'にアンカーします。

スロットは統一されたデザインスロットモデルを使います。どの要素もplacementを持ち、そこにanchor（コンテナー、または#idで指定する別の要素へのアンカー）、省略可能なoffset、省略可能なsizeを指定します。従来のフラットなフィールドalign、marginFromBody、marginFromEdge、width: 'full'も入力としては引き続き受け付け、新しい形へ自動的に移行します。新しい形での同等の記述は以下で説明します。

各スロットはテキスト、罫線、ボックスの要素のリストを持ちます。配列の順序が描画順です（最初の要素が最初に描かれ、最後の要素がいちばん上に描かれます）。これはアンカーの指定にかかわらず変わりません。要素はリストで後に来る要素にもアンカーできる（anchor.to: '#ttl'）ため、背景のボックスを先頭に置いたまま、その前面に来るテキストを基準に位置を決められます。

組み込みの既定値。headerまたはfooterがundefinedのとき、postextは空のスロットではなく、適切な組み込みの既定値を適用します。

• 既定のヘッダー：奇数ページでは{title}を右そろえ、偶数ページでは{chapterTitle}を左そろえにし、全幅の罫線を引きます。いずれもパレットのメインカラー、Open Sans 8pt/600で、marginFromBodyは16pt（テキスト）／13pt（罫線）です。
• 既定のフッター：すべてのページで{pageNumber}を中央に置きます。パレットのメインカラー、Open Sans 8pt/600で、marginFromBodyは16ptです。

組み込みの既定値を使わないようにするには、header: { elements: [] }（またはfooter: { elements: [] }）と指定します。明示的な空のelements配列は「要素なし」としてそのまま保持され、既定値が適用されるのはundefinedのときだけです。

#テキスト要素

テキスト要素は、プレースホルダーを置き換えたテンプレート文字列を描画します。プレースホルダーは{name}の構文で書き、{{と}}は波かっこそのものを出力します。

以下の表の既定値は、自分で追加したテキスト要素のものです。上の組み込みの既定値で説明した組み込みのヘッダーとフッターは、独自の値（パレットのメインカラーのOpen Sans 8pt/600）を持つ既製の要素であり、要素の既定値ではありません。

使えるプレースホルダー：

• {pageNumber} — 現在のページの、1から始まるページ番号。
• {totalPages} — 文書の総ページ数。章ごとにレイアウトする本（Sandbox、buildBundle）では各章が1つの文書になるため、これはその章自身のページ数です。
• {bookTotalPages} — 本全体の総ページ数。すべての章と白ページを含みます。単独でレイアウトする文書では{totalPages}と同じです。下の本全体のページ数を参照してください。
• {title}、{subtitle}、{author}、{publishDate} — content.metadataから読む値。不明または空のメタデータは空文字列になります（Sandboxでは警告も出ます）。
• {chapterTitle} — 現在のページまで（そのページを含む）で最後に現れたH1のテキスト。見出しスタイルでrunningChapter: falseを指定したH1（図版、地図）は飛ばします。
• {chapterTitleAtTop}、{chapterNumberAtTop} — ページ上端の時点で有効な章のタイトルと番号。ほかのテキストの下で新しい章が始まるページでは、{chapterTitle}や{chapterNumber}と異なります。下のページ上端の章を参照してください。
• {partTitle}、{partNumber} — 現在の部のタイトルと番号（現在のページまでで最後の:::partページ。部扉の直前にある奇偶合わせの白ページは、すでにその部に属します）。最初の部より前では空です。
• {firstMark.<key>}、{lastMark.<key>} — ページの最初と最後の柱の見出し語。あるレベル（h1〜h6）の見出し、または段落スタイルの項目です。下の柱の見出し語：最初と最後のマークを参照してください。

本全体のページ数

{bookTotalPages}は本全体のページ数、つまり「12ページ／全348ページ」のように読者が目にする数を出力します。{totalPages}と同じく白ページを含めて物理的なページを数えますが、すべての章にわたって数えます。

• 単独でレイアウトする文書（continuationなしのbuildDocument）は、それ自体が本全体です。{bookTotalPages}は{totalPages}と等しくなります。
• buildBundleの場合、本をレイアウトして全章のページ数を合計し、その合計を使ってもう一度レイアウトするため、どの章も同じ数を出力します。この数が改ページの位置を動かすことはないので、1回の追加ラウンドで確定します。{bookTotalPages}を出力しない設定には追加のコストはかかりません。
• Sandboxは、すべての章のページ数がわかった時点で各章に合計を渡します。それまでは、各章はその章の終わりまでのページ数を出力します。PDFタブの本全体の書き出しは、自身がレイアウトしたページを数えます。ページ数がまだわかっていなかったために別の数を出力した章があれば、各章から得た数でもう一度本をレイアウトします。
• 章を自分でレイアウトするホストは、合計をcontinuation.bookPageCountとして渡します（最初の章にも渡します）。渡さない場合、{bookTotalPages}は文書の終わりまでのページ（continuation.pageIndexOffsetと自身のページ数の和）を数えます。これが正しいのは最後の章だけです。

footer: {
  elements: [{
    kind: 'text', id: 'folio', content: '{pageNumber} / {bookTotalPages}',
    fontSize: { value: 8, unit: 'pt' },
    placement: { anchor: { to: 'container', edge: 'top' }, size: { width: 'auto', height: 'auto' } },
  }],
}

configUsesPlaceholder(config, 'bookTotalPages')を使うと、ホストはこの数を計算する価値があるかどうかを判断できます。

柱の見出し語：最初と最後のマーク

辞書は各ページの柱に、そのページの最初と最後の見出し語を掲げます（「Aback – Anchor」）。参考図書なら最初と最後の節を掲げます。{firstMark.<key>}と{lastMark.<key>}はこれを出力します。キーは、何がページのマークになるかを指定します。

• h1〜h6：そのレベルの見出し。マークは番号を除いた見出しのテキストです。
• 段落スタイルのID（entry）：:::paragraphs{style="entry"}コンテナーの段落。マークは段落冒頭の太字の部分、つまり見出し語で、末尾の約物は除きます。**Aback.** Said of…はAbackをマークにします。太字で始まらない段落はマークを設定しません。

{firstMark.<key>}はページ内で始まる最初のマーク、{lastMark.<key>}は最後のマークです。マークが始まらないページ（長い項目が続いているページ）では、どちらもその時点で有効なマーク、つまりそれより前の最後のマークを出力します。最初のマークより前のページには何も出力されません。章ごとにレイアウトする本では、マークは次の章へ引き継がれないため、これはその章の最初のマークより前のページを指します。ページをまたいで分割された見出しや段落は、始まるページだけをマークします。キーはドットの後に英字、数字、_、-で書き、英字か_で始めます。不明なキーは何も出力しません。

:::paragraphs{style="entry"}
**Aback.** Said of the sails when pressed back against the mast.
 
**Abaft.** Towards the stern, or behind a given point.
:::

header: {
  elements: [{
    kind: 'text', id: 'guide', content: '{firstMark.entry} – {lastMark.entry}',
    fontSize: { value: 8, unit: 'pt' },
    placement: { anchor: { to: 'container', edge: 'bottom' }, size: { width: 'auto', height: 'auto' } },
  }],
}

柱の見出し語は柱として扱われます。ヘッダーとフッターのスロット（見出しスタイルのheaderとfooterを含む）で解決され、見出し、部、目次のデザインでは何も出力しません。見出しと部のデザインでは、検査パネルが不明なプレースホルダーとして警告します。偶数ページに最初の見出し語、奇数ページに最後の見出し語を出すには、2つの要素にparity: 'even'とparity: 'odd'を指定します。見出しスタイルでrunningChapter: falseを指定したH1は、h1のマークを設定しません。

ページ上端の章

{chapterTitle}と{chapterNumber}は、そのページまでに始まった最後の章を指します。章のあいだで改ページせずに続けて組む本では、ある章を終えてページの下のほうで次の章を始めるページに、まだ前の章に属するテキストの上に新しい章のタイトルが載ってしまいます。{chapterTitleAtTop}と{chapterNumberAtTop}は、代わりにページ上端の時点で有効な章を指します。章を続けて組む小説や、多くの参考図書がこの方式です。

• 最初のブロックが章のH1であるページは、その章を指します。
• それ以外のページは、新しい章がページの下のほうで始まる場合でも、前から続いている章を指します。
• 奇偶合わせのために追加された白ページは次のページに、always-*モードの区切りページは前のページに従います（白ページの帰属を参照）。奇偶合わせの白ページの次のページが章のH1ではなく章の終わりで始まる場合、その白ページもその章のままです。
• runningChapter: falseのH1は飛ばします。

header: {
  elements: [{
    kind: 'text', id: 'chapter', content: '{chapterTitleAtTop}', parity: 'odd', pages: 'body',
    fontSize: { value: 8, unit: 'pt' },
    placement: { anchor: { to: 'container', edge: 'bottom-right' }, size: { width: 'auto', height: 'auto' } },
  }],
}

柱の見出し語と同じく、どちらも柱として扱われます。ヘッダーとフッターのスロットで解決され、見出し、部、目次のデザインでは何も出力しません。{attr.<key>}は常に最後に始まった章を読みます。

基準辺から決まるそろえ

テキスト要素のplacement.anchor.toが#idで別の要素を参照するとき、アンカーの基準辺によって、折り返した行の既定のそろえが決まります。

• right-ofとalign-leftはテキストのalign: 'left'を意味します。折り返した行はアンカーから右へ流れます。
• left-ofとalign-rightはalign: 'right'を意味します。折り返した行はアンカー先に最も近い側に寄ります。

Sandboxの見出しエディターは、アンカーの基準辺や対象を変更すると、これらのそろえを自動的に適用します。これにより、複数行に折り返したテキストが、関連する要素に視覚的に結び付いたままになります（たとえば、折り返した「Postext」の「P」が「Introduction」の「I」の真下にそろいます）。

インラインの書式記号と輪郭線

テキスト要素は既定では1つの書体でテキストを組み、**、^などのMarkdownの記号は書かれたとおりに出力されます。inlineMarks: trueを指定すると、解決後のテキストをインラインのMarkdownとして読み、本文と同じ書式記号が使えます（文書形式 → インライン書式を参照）。

• **bold**はウェイトを700にします（要素自身のfontWeightのほうが太ければそれを使います）。*italic*は要素の傾きを反転するため、イタリックの要素の中の強調は立体になります。***both***は両方を適用します。アンダースコアの形（__bold__、_italic_）も使えます。
• ^superscript^と~subscript~はサイズの58%で組み、上付きはサイズの3分の1だけ上げ、下付きは0.15だけ下げます。接する下付きと上付き（T~0~^2^）は、本文と同じく上下に重ねて組みます。
• バックスラッシュを付けると記号の文字そのものを組みます（\*、\_、\^、\~）。リンクはテキストを残し、コードのバッククォートは取り除きます。

書式記号はプレースホルダーを埋めた後で読むため、値に書式記号を含めることができます。たとえば見出しの属性に書いた著者の行で、所属の番号を上付きにできます。折り返し、両端そろえ、省略記号のモード、dropCap、paragraphIndentは、いずれも書式付きのテキストで動作します。どのランも要素の色を保ちます。

{ "kind": "text", "id": "authors", "content": "{attr.authors}", "inlineMarks": true, "overflow": "wrap",
  "fontSize": { "value": 11, "unit": "pt" },
  "placement": { "anchor": { "to": "#title", "edge": "below" }, "offset": { "y": { "value": 6, "unit": "pt" } } } }

# Snow cover and river flow {authors="Ana Ruiz^1^, Luis Gil^2^ and Marta Sanz^1,3^"}

strokeは文字の周りに輪郭線を描きます。widthは線幅で、字形の縁を中心に描きます（半分が文字の内側、半分が外側に入り、測定されるテキストの幅は変わりません）。colorの既定はテキストの色です。hollow: trueは文字を塗らずに輪郭線だけを見せます。袋文字のディスプレイ数字や、写真の上で浮き立たせたいタイトルに使います。輪郭線は塗りの上に描かれ、canvas、HTML（-webkit-text-stroke）、PDF（テキスト描画モード2、hollowのときは1）で同じように描画されます。

{ "kind": "text", "id": "year", "content": "1863", "fontFamily": "Bitter", "fontSize": { "value": 120, "unit": "pt" }, "fontWeight": 700,
  "color": { "hex": "#1d3557", "model": "hex" },
  "stroke": { "width": { "value": 1.5, "unit": "pt" }, "hollow": true },
  "placement": { "anchor": { "to": "page", "edge": "bottom-right" }, "offset": { "x": { "value": -15, "unit": "mm" }, "y": { "value": -20, "unit": "mm" } } } }

PDFでは、太字とイタリックのランに要素のファミリーの対応する書体を埋め込むため、フォントプロバイダーがそれらを提供する必要があります。

テキストの既定値とアンカーの落とし穴

自分で書いたテキスト要素は次の値から始まります。意外に思えるものもあります。

• overflowは'ellipsis-end'。幅に収まらないテキストは…付きの1行に切り詰められます。住所、著者名の行、長くなりうるタイトルにはoverflow: 'wrap'を指定してください。内容中の改行（改行文字、またはテンプレートや属性値に書いた\n）はどのモードでも新しい行を始め、省略記号のモードは各行を個別に切り詰めます。
• alignは'center'、verticalAlignは'middle'。自動幅の要素は最も長い行に合わせて縮むため、各行は互いに中央そろえになります。左そろえのブロックにするにはalign: 'left'を指定します（別の要素にアンカーした自動幅の要素は、アンカー側に自動的に行をそろえます。前述）。
• 書体はEB Garamond 8 pt、黒、lineHeightは1.2。本文が何を使っていても変わりません。設定内のほかの行送りと異なり、デザインのテキストのlineHeightは通常は単純な倍数（1.2）で書きます。Dimensionも使えます（前述）。

placement.size.widthを指定しない（または'auto'の）要素はテキストに合わせて自身のサイズを決めますが、その範囲は、アンカー点から、要素が伸びていく方向のコンテナーの端までの領域に限られます。topまたはbottomのアンカーでは、近いほうの端までの距離の2倍です。offsetも計算に入ります。その端から離れる方向のオフセットは領域を減らしません。top-leftにアンカーし、負のxで左の余白にはみ出させた柱は右へ伸びるため、領域は減りません。その端に向かうオフセットは、同じだけ領域を減らします（topまたはbottomのアンカーでは2倍）。アンカー点を端の外へ押し出すオフセットでは、領域がなくなります。xがコンテナー幅のマイナス値より小さいtop-rightのアンカーや、幅の半分を超えて横にずらしたtopのアンカーがこれに当たります。領域がなくなると、省略記号のモードは何も出力せず、'wrap'は1行に1文字ずつ積み重ねます。回避策は3つあります。

• 要素に固定のsize.widthを指定する。固定幅は切り詰められません。
• 'page'または'bleed'にアンカーし、ページ（または裁ち落とし）の枠を領域にする。
• コンテナーの反対側の端にアンカーする。

ヘッダーのコンテナーは仕上がりの天から本文まで、フッターのコンテナーは本文から仕上がりの地までです。ヘッダーではtop-*アンカーは仕上がり線から、bottom-*アンカーは本文から測り、フッターではその逆です（上のコンテナーの枠を参照）。ヘッダーとフッターは本文のテキストを動かさず、その上に描画されるため、本文領域に押し出された要素はテキストを覆い隠します。一方、章扉の帯は本文のテキストの下に描画されます。それが流れの中でどれだけの領域を占めるかは確保する高さで説明しています。

#縦組みのテキスト要素

writingMode: 'vertical-rl'を指定したテキスト要素は、テキストが横組みのスロットの中で縦に組まれます。対象は、どの本でも紙面上の向きが変わらない柱とノンブル、そして横組みのページのあらゆるデザインです。要素は、時計回りに90度回した独自の枠の中で横組みのテキストとしてレイアウトされ、ページの向きに戻されます。

• ボックスは配置で指定した位置にとどまります。高さは1行の長さで、size.heightで指定します（'auto'ならテキストの長さ、'fill'ならコンテナーの端まで）。size.widthは横方向に何行収まるかを決め、size.maxWidthは1行の長さの上限を決めます。
• alignはボックスに沿った行の位置（'left'は上端）、verticalAlignはボックスを横切る方向の位置（'top'は最初の行が立つ右端）を決めます。ボックスのパディングは、指定した辺に残ります。
• 文字は縦組みのページと同じく測定・描画されます。漢字は1字ずつ全角で正立し、約物は縦組み用の字形になり、欧文の単語は横倒しになり、短い数字は1字分に収まります（cjk.uprightDigits）。canvas、PDF、HTMLは同じ矩形の位置に配置します。
• inlineMarks: trueを指定すると、本文と同じく向きの記号でランを区別できます。第:tcy[3.0]回は3.0を1字分に組み、:upright[GDP]は文字を正立させて縦に並べ、:sideways[…]はランを横倒しにします。これらの内部で行が分割されることはありません。横組みの要素はこれらを無視します。
• 縦組みの要素にはドロップキャップを組みません。
• 縦組みのページの流れの中（章扉、部扉、囲みのタイトル）では、テキストはもともと縦に組まれるため、writingModeは何も変えません。

縦組みの中国語の本では、柱とノンブルを次の3か所のいずれかに置きます（clreq §7.2。日本語についてはJLREQ §2.6）。

Sandboxが追加する小口の柱（ヘッダー › 小口の柱（縦組み））を、本文が10 ptの場合で示します（Sandboxは本文サイズの80%で組みます）。

{
  "page": { "pageNumbering": { "format": "trad-chinese-informal" } },
  "header": { "elements": [
    { "kind": "text", "id": "head", "content": "{chapterTitle}", "writingMode": "vertical-rl",
      "fontSize": { "value": 8, "unit": "pt" }, "overflow": "clip", "align": "left",
      "placement": { "anchor": { "to": "outer", "edge": "top" }, "offset": { "y": { "value": 4, "unit": "em" } } } },
    { "kind": "text", "id": "folio", "content": "{pageNumber}", "writingMode": "vertical-rl",
      "fontSize": { "value": 8, "unit": "pt" }, "overflow": "clip", "align": "left",
      "placement": { "anchor": { "to": "outer", "edge": "bottom" }, "offset": { "y": { "value": -5, "unit": "em" } } } }
  ] }
}

anchor.to: 'outer'（要素の配置を参照）は各ページの外側の余白を指すため、右綴じの本（page.binding）では、2つの要素は奇数ページの左端と偶数ページの右端に沿って縦に並びます。{pageNumber}はノンブルの書式で出力されます。103ページは、trad-chinese-informalでは一百零三、cjk-decimalでは一〇三になります。スロットごとの規則はここでも有効で、pages: 'body'を指定すると章扉には柱を出しません。柱とノンブルのあいだに置く短い飾り（魚尾︻、罫線）は、同じ枠にアンカーした通常の要素です。

VDTでは、縦組みのブロックはverticalを持ちます（VDTDesignTextBlock.vertical：領域、正立させる数字、各ファミリーの中心軸）。行はブロック自身の回転した枠の中にあり、xOffsetはボックスの上端から下向き、baselineYは右端から左向きに測ります。書式記号付きの行のランは、本文のセグメントと同じくtcyまたはorientationを持ちます。

#罫線要素

罫線要素は線を描画します。スロットを横切る水平線、またはスロットを縦に走る垂直線です。

#ボックス要素

ボックス要素はスロットの中に角丸の矩形を描きます。章扉、サイドバー、フッターでテキストの背景にするのに便利です。ボックス要素の位置はplacementフィールドだけで決まり、従来のフラットな省略形はありません。塗り、線、角の半径は、「要素の配置」のJSONの例のように、入れ子のstyleオブジェクト（ElementBoxStyle）に指定します。

#画像要素

image要素は、文書のビットマップまたはSVGのリソースを描きます。扉ページの出版社のロゴや、柱に添えるマークなどです。サイズはplacement.sizeで決まります。width／heightの一方を'auto'（既定）のままにすると、もう一方は画像の縦横比に従います。両方を指定すると、画像はボックスに収まるように合わせて中央に置かれます。存在しないリソースや画像でないリソースは何も描きません。

{
  kind: 'image', id: 'logo', resourceId: 'logo-publisher',
  placement: { anchor: { to: 'page', edge: 'top-left' }, offset: { x: { value: 64, unit: 'mm' }, y: { value: 233, unit: 'mm' } }, size: { width: { value: 83, unit: 'mm' }, height: 'auto' } },
}

resourceIdには、テキスト要素のcontentと同じプレースホルダーが使えるため、1つのデザインで見出しごとに異なる画像を描けます。見出しスタイルにresourceId: '{attr.vignette}'を指定すると、# Chapter I {style="opener" vignette="log"}はリソースlogを、# Chapter II {style="opener" vignette="wig"}はwigを描きます。画像ごとにスタイルを複製しなくても、各章で同じスタイルを共有できます。ヘッダーとフッターは、柱の{attr.<key>}と同じくページの章の属性を読み、ほかのプレースホルダーも使えます（'map-{chapterNumber}'）。見出しに属性がない場合など、空になったIDは何も描きません。postext 1.8から使えます。

PDFバックエンドはリソースを図と同じように埋め込み（印刷用マスターを持つSVGはそれを使います）、HTMLビューアーはresourceImageUrlで解決します。

リソースが画像を説明している場合、デザインが描く画像はコンテンツになります。リソースのaltText、なければプレーンテキストにしたキャプション（チップはラベルで、:refはtextがあればそれで読みます）がVDTに入り（VDTDesignImageBlock.altText）、HTMLでは<img>のalt、タグ付きPDFでは/Altを持つFigureになり、そのデザインのテキストの直後に読まれます（章の図版は章の見出しの後）。リソースにどちらもない画像と、decorativeを指定した画像は装飾になり、HTMLではrole="presentation"付きのalt=""、PDFではアーティファクトになります。柱やフッターの画像はすべてのページで繰り返されるため、リソースの内容にかかわらず紙面の付属物として扱われます。VDTにはaltTextがなく、HTMLではrole="presentation"付きのalt=""、PDFではページのアーティファクトになります。

#要素の配置

ElementPlacementは、あらゆるデザインスロット（ページのヘッダー、ページのフッター、見出しレベルの詳細デザインのスロット）の中で、すべての種類の要素（テキスト、罫線、ボックス）が使う統一された配置モデルです。配置は3つの状態で記述します。

interface ElementPlacement {
  /** What this element anchors to and which edge of that target. */
  anchor: {
    to: 'container' | 'page' | 'bleed' | 'outer' | `#${string}`; // container = the slot; page = trim box; bleed = trim box + bleed; outer = the outer margin (header, footer); #id = another element
    edge: AnchorEdge;
  };
  /** Distance from the anchor point. */
  offset?: { x?: Dimension; y?: Dimension };
  /** Optional fixed width / height. Width also accepts 'fill' (span the slot).
   *  `maxWidth` caps an 'auto' width (text): the element still shrink-wraps its
   *  content, so elements anchored to it stay attached, but a long text wraps or
   *  ellipsizes there — a running head can reserve room for the label hanging
   *  off it instead of squeezing that label out. */
  size?: { width?: Dimension | 'fill' | 'auto'; height?: Dimension | 'fill' | 'auto'; maxWidth?: Dimension };
}

AnchorEdgeには次の値を指定できます。

• コンテナーの辺（anchor.toが'container'、'page'、'bleed'のとき）：top、top-left、top-right、bottom、bottom-left、bottom-right、left、right。
• 要素基準の辺（anchor.to === '#someId'のとき）：right-of、left-of、below、above、align-top、align-bottom、align-left、align-right。

要素基準の各辺は、要素の角の1つをアンカー先の要素の角に合わせ、offsetでそこから移動します。

• right-of：要素の左上の角を対象の右上の角に合わせます（横に並び、上端がそろいます）。left-of：要素の右上の角を対象の左上の角に合わせます。
• below：要素の左上の角を対象の左下の角に合わせます（下に置き、左端がそろいます）。above：要素の左下の角を対象の左上の角に合わせます。
• align-topとalign-left：要素の左上の角を対象の左上の角に合わせます。2つの名前は同じ配置になり、上端と左端の両方がそろいます。
• align-bottom：要素の左下の角を対象の左下の角に合わせます。
• align-right：要素の右上の角を対象の右上の角に合わせます。

'container'、'page'、'bleed'とともに使った要素基準の辺、および'#id'とともに使ったコンテナーの辺は、左上の角として扱われます。

anchor.to: 'page'は要素をトリムボックス（断裁後の物理的なページ）に、'bleed'は各辺をcutLines.bleedだけ広げたトリムボックスにアンカーします（トンボが無効な間はトリムボックスと同じです）。どちらの枠もsize: 'fill'と自動幅の制限の基準にもなるため、ページの余白にかかわらず、色の帯を端から端まで伸ばせます。

{ "kind": "box", "id": "band", "placement": { "anchor": { "to": "bleed", "edge": "top-left" }, "size": { "width": "fill", "height": { "value": 6, "unit": "cm" } } }, "style": { "backgroundColor": { "hex": "#1d3557", "model": "hex" } } }

トンボを有効にすると、要素が裁ち落としの枠の外に描いた部分は切り取られます（トンボを参照）。

anchor.to: 'outer'（ヘッダーとフッターのスロット）は、要素をページの外側の余白にアンカーします。これは、背と反対側で版面の端から仕上がり線までの範囲、かつ版面の天から地までの範囲です。左綴じの本では奇数ページの右側と偶数ページの左側、右綴じの本ではその逆になる（page.binding）ため、1つの要素で見開きの両ページに対応できます。小口に沿って縦に置く柱がその例です（縦組みのテキスト要素を参照）。ほかのスロットでは'container'として扱われます。テキスト要素のoffsetは、要素自身のfontSizeを単位とするemで書けます。版面の天から4字下は{ "y": { "value": 4, "unit": "em" } }です。

見出しの詳細デザインのスロットの中では、ページや裁ち落としにアンカーした要素は、見出しの上端より下に伸びない限り、見出しのために確保する高さを増やしません（ページ上部を横切る帯は章扉の背後に置かれ、見出しより下まで伸びる帯は本文のテキストを押し下げます）。章扉の高さをどんな場合でも固定で確保するにはadvancedDesign.minHeightを使い、テキストをまったく押し下げてはいけない要素にはreserve: falseを指定します。詳しい規則は確保する高さにあります。

各要素は固定のidを持ちます（Sandboxが自動で割り当てますが、手で設定することもできます）。ほかの要素にアンカーした要素は小さな依存グラフを作り、エンジンは測定の前にそれを解決します。そのため、手作業で座標を指定しなくても、要素を別の要素に連ねて配置できます。

従来のalign + marginFromBody + marginFromEdgeの形は入力時に解析され、設定の解決時にplacementへ書き換えられるため、既存の設定は変更なしでそのまま動作します。

#本文

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では、これらは本文セクションの引用ブロックグループにあります。

#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が必要です。

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

どの調整手段が働いたか

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

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.
}

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

番号付きの数式。\tag{…}を含む別行立て数式は、その組幅（段、または囲みの内側の幅）いっぱいに広がります。数式は中央に置かれ、その番号は数式の行の右端にそろえて組まれます。alignでは、タグの付いたすべての行でそうなります。\tag*{…}はラベルを括弧なしで、書かれたとおりに印字します。番号が付くのは明示的なタグだけで、equationなどの環境はそれだけでは番号が付きません。組幅より広い番号付きの数式は、ほかの別行立て数式と同じく右へはみ出します。（postext 1.4までは、\tagを含む数式はまったく描画されませんでした。）

解決関数（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つのページで共有されるグローバルな状態を参照）。

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

#脚注

footnotesプロパティは、[^id]で引用した注をどこに置き、どのように番号を付け、どのような見た目にするかを設定します。記法は文書形式で説明しています。

interface FootnotesConfig {
  placement?: 'column' | 'chapterEnd' | 'spread'; // Foot of the citing column, after the chapter, or beside the text of a spread.
  numbering?: 'chapter' | 'document' | 'page' | 'column' | 'spread'; // Start again at each chapter, run on, or start again on each page / column / spread.
  numberFormat?: string;      // decimal, lower-roman, circled-decimal (①)…
  markerPosition?: 'auto' | 'superscript' | 'inline' | 'side' | 'right'; // Raised, on the baseline, beside the word, or right of a vertical line.
  markerSize?: Dimension;     // Inline, side or right marker size; em is the text around it.
  numberGap?: 'en' | 'em';    // Space after the note's own number.
  chapterEndAlign?: 'foot' | 'text';   // chapterEnd: notes at the column foot, or under the text.
  fontSize?: Dimension;       // Note size; em is the body size.
  lineHeight?: Dimension;     // Note leading; em is the note size.
  color?: ColorValue;         // Note colour; the body colour when unset.
  textAlign?: TextAlign;      // The body alignment when unset.
  hangingIndent?: Dimension;  // Indent of a note's turnover lines.
  spaceBetween?: Dimension;   // Space between two notes.
  spaceAbove?: Dimension;     // Space between the text and the rule; em is the body size.
  spaceBelowRule?: Dimension; // Space between the rule and the first note.
  separator?: {
    enabled?: boolean;        // Draw the rule.
    width?: number;           // Rule length, a fraction of the column width.
    lineWidth?: Dimension;    // Rule thickness.
    color?: ColorValue;       // The note colour when unset.
  };
}

footnotes: {
  fontSize: { value: 7.5, unit: 'pt' },
  lineHeight: { value: 9.5, unit: 'pt' },
  hangingIndent: { value: 0.8, unit: 'em' },
  separator: { width: 0.25, lineWidth: { value: 0.4, unit: 'pt' } },
}

日本語の本。日本語の文書（locale: 'ja'、postext 1.16以降）では、未設定のフィールドにJLReq §4.2の値が使われます。縦組みの本は注を章の後に組み（placement: 'chapterEnd'、後注）、章ごとに番号を付け、合印（{n}）を行の右に置きます（markerPosition: 'right'、数字はcjk.uprightDigitsにより正立）。横組みの本は注をページの下端に組み、ページごとに番号を付け、合印を上付きにします。どちらも罫線を組幅の3分の1の長さで引き（separator.width: 1/3）、章の後に置く注にはnumberGap: 'em'と2字分のぶら下げインデントを使います。明示した値が優先され、保存時にも保持されます（stripFootnotesDefaultsは文書自身の既定値と比較します）。中国語、アラビア語、ラテン文字の文書の解決結果は従来どおりです。footnoteDocumentDefaults(locale, writingMode, placement?)はこれらの値を返します。合印は文末の。の前に書いてください（先生[^1]。）。合印は直前の文字から離れず、。が行頭に来ることはありません。日本語の組版 › 注を参照してください。

段の下端での注の組み方は次のとおりです。

• 注と引用箇所は同じ段に置かれます。行を置く前に、レイアウトはその行が初めて引用する注の高さ（その段の最初の注の場合は罫線も）を加えます。その下に注が収まらない行は、オーファンとウィドウの規則に従い、段落の残りとともに次の段へ移ります。段の本文領域は注の高さの分だけ縮むため、段末そろえと章の最後の帯では本文だけが数えられます。
• 複数の注が1つの段にある場合は、1本の罫線の下に引用順に積み重なります。あとで再び引用された注は番号を保ち、二度は組まれません。
• 下側のフロート。注を組んだ後に段の下端を占める図は、注の上に入ります。図の後に組まれた注は図の上に入ります。
• 囲み。囲み（インライン、フロート、固定）の中で引用された注は、囲みの後の本文が続く段の下端に置かれます。通常は同じ段です。文書を閉じる囲みは、本文が終わった段の下端に注を残します。
• 制限。注は分割されません。段より高い注は段からはみ出します。キャプション、表のセル、見出しの中の合印は読み取られません（書いたとおりに印字されます）。
• 出力。Canvas、HTML、PDFは注、合印（上付きの番号）、罫線を描画します。PDFでは各合印がその注にリンクし、タグ付きPDFでは各注を一意の/IDを持つNote要素とし、構造ツリーの/IDTreeに列挙します（PDF/UA-1）。注はfootnoteNoteが設定されたVDTBlockとしてpage.floatsに、罫線はpage.footnoteAreasに入ります。
• 警告。undefinedFootnote（定義のない合印。番号は空の注の上に印字されます）とunusedFootnote（どの合印からも引用されない定義。組まれません）があります。

解決関数と除去関数は、ほかのセクションと同じ形です。