設定：オーファン、ウィドウ、段末そろえ

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

これらのデメリットの仕組みはハイフネーションと両端そろえを参照してください。この節は、それらを制御する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つの大域的な最適化の中で比較し、総コストが最も小さい改行位置の組み合わせを選びます。より強い保証が必要ならペナルティーを上げ、ペナルティーを緩めたほうが読みやすい文書なら下げてください。

#段末そろえ

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

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

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

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

#どの調整手段が働いたか

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

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

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

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

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