設定：ページとレイアウト

#ページ

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'は右綴じになります。こうした本は流れ全体も反転するため、最初の段は右側になり、字下げ、リストの行頭記号、フロート、注は右に置かれます。ヘッダーとフッターのスロットは物理的な位置のままです。アラビア語の組版を参照してください。

右から左に読むコミックの本も右綴じです。設定にcomicsセクションがあり、その読む向きが'rtl'に解決されると、'auto'は右綴じになります。マンガ（comics.artDirection: 'rtl'）と、欧米のコミックの日本語版や繁体字中国語版がこれに当たります。決めるのはこのセクションで、本全体に効きます。ある章の:::pageブロックで決まるのではありません。漫画を参照してください。

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

4つの新聞の判型はpostext 1.18で加わったもので、図には含めていません。ブランケット判の1ページは21 × 28のページのほぼ4倍の面積です。通常は'multiple'レイアウトで組み、ブランケット判では6段、タブロイド判では5段がよく使われます。

#ベースライングリッド

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

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

#トンボ

有効にすると、キャンバスが裁ち落とし領域を含む大きさに広がり、エンジンは印刷工程用のトンボを四隅に描きます。PDFでは各ページにTrimBoxとBleedBoxが設定されます。PDF/Xのファイルは、トンボがなくてもこの2つを持ちます。Sandboxでは書き出し › 印刷の準備で設定します。

用紙は四辺それぞれ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'を組み合わせると、欄はすべてのページの外側の辺に置かれます。教科書の欄外段の形です。

• 'multiple'：3〜8段の同じ幅の段組みで、段数はcolumnCountで指定します（既定は3）。新聞や多くの雑誌のグリッドです（postext 1.18以降）。各段の幅は(内容の幅 − (n − 1) × gutterWidth) / nです。本文は2段組みと同じように段から段へ流れます。段間罫はすべての段間に引かれ、段のそろえは章の最終ページとページ幅の囲みの前ですべての段の高さをそろえ、脚注はどの段でも使え、ページ幅の図、囲み、見出しはページ全体にまたがります。図やフロートする囲みは一部の段だけを使うこともできます。placement.columns（リソースの種類を参照）と囲みスタイルのcolumnsです。columnCountが3〜8の範囲外か整数でない場合は、丸めたうえでいちばん近い有効な段数に収め（数値でない値は3）、文書のconfigWarningsに{ kind: 'columnCountClamped', path: 'layout.columnCount', value, used }が入ります（見出しスタイル自身のlayoutの場合、パスはheadingStyles[1].layout.columnCountのようにスタイルを示します）。ほかの種類のレイアウトはこの値を読みません。layoutが'multiple'の見出しスタイルは、独自に設定しない限り文書のcolumnCountを使うので、5段組みの新聞でオピニオン面だけを4段にすることもできます。

#柱とノンブル

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は配置先で決まる。見出しのデザインと部扉では長い題が複数行に折り返し、柱・ノンブル・目次の部の行では幅に収まらないテキストが…付きの1行に切り詰められます。長くなりうる柱（住所、著者名の行）にはoverflow: 'wrap'を指定し、切り詰められたテキストについてはdesignTextTruncated警告を確認してください。内容中の改行（改行文字、またはテンプレートや属性値に書いた\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へ書き換えられるため、既存の設定は変更なしでそのまま動作します。