章 2 · 部 I · 基礎
Postextのアーキテクチャー
Postext組版エンジンの技術的なアーキテクチャー:基本概念、文書ツリー、垂直リズム、バックエンド、パフォーマンス
かんたんな説明
このページでは、Postextが内部でどう動いているかを、プログラマー向けに説明します。Postextはまず、画面に何も描かずにすべての単語の幅を測るので、とても速く動きます。次に、すべての行、図、段をどこに置くかを決め、その計画をメモリーに保存します。最後に、できあがったページをWebページ、canvasの画像、PDFファイルとして描きます。単語を1つ変えると、ページを組み直し、変わっていない段落の計測結果を再利用します。行と図を置いていく手順は、次のページで順を追って説明します。
Reactを使ったことがあれば、中心となる仕掛けはすでにご存じです。Reactはメモリー上に仮想DOMを組み立てて差分を取り、そのあとで初めてブラウザーの実際のDOMに手を触れます。Postextも同じことをします。ただし組み立てるのはUIコンポーネントではなく、ページ、段、テキストブロック、バウンディングボックスからなるツリーです。複数ページ、複数段の文書のジオメトリー全体を、1ピクセルも描画しないうちに計算します。段落、見出し、画像、脚注、プルクオートのひとつひとつが正確な座標に置かれ、CSSでは表現できない、何世紀も受け継がれてきた組版の規則に従います。
これを可能にしているのが@chenglou/pretextです。DOMを使わずにテキストを計測するライブラリーで、ブラウザーのレイアウトのリフローより300〜600倍高速です。プロジェクトの経緯(10年にわたる失敗、そのすべてを阻んだボトルネック、そしてそれを取り除いたライブラリー)ははじめにを参照してください。
#核となる考え方
2段組みで74ページの文書を思い浮かべてください。企業の年次報告書かもしれませんし、図版の多い教科書かもしれません。これをPostextに渡すと、エンジンはレイアウト全体をメモリー上に組み立てます。すべてのページ、すべての段、すべての段落の正確な位置とピクセル単位の寸法です。72ページの2段目に何があるかを知りたければ、答えはもうそこにあります。描画は必要ありません。エンジンはすでに、各段落をどこで改行するか、各画像をどこに置くか、ウィドウとオーファンをどう避けるか、隣り合う段のベースラインをどうそろえるかを決めています。
これがなぜそれほど重要なのかを説明します。
組版の規則は、どうしようもないほど深く互いに依存しています。5ページのウィドウ(段の下端に取り残された段落の最後の1行)を、前の段に引き戻して直したとします。それはよいのですが、この変更で5ページの段が短くなり、内容が後ろへずれ、6ページにオーファンが生じるかもしれません。段落から切り離され、新しい段に押し出された最初の1行です。新しい問題を作ってしまったことを検出するだけでも、文書のレイアウト全体を調べられる状態にしておく必要があります。そして、どこかに別の問題を作らずにそれを直すには、全体を調整し、計測し直し、検査し直せなければなりません。
これが「まずすべてを計算し、描画はあとで」という考え方です。性能を上げるための工夫ではありません。プロの組版者が何世紀にもわたって用いてきた、互いに関連しあう何十もの組版規則を適用するには、これしか方法がないのです。
#基本概念
簡単な用語集です。このドキュメントの残りの部分はこれらの用語を前提にしています。意味があいまいになったときは、ここに戻ってください。
| 用語 | 定義 |
|---|---|
| VDT | 仮想文書ツリー(Virtual Document Tree)。文書全体を表す、その場で書き換える可変のデータ構造です。ページ、段、ブロック、インラインのセグメント、バウンディングボックスからなります。仮想DOMに相当するものを、文書レイアウトのジオメトリーについて作ったものです。 |
| ページ | 決まった大きさの長方形の領域です。エンジンは最初からページを意識して動きます。文書はページの順序付きの並びです。 |
| 段 | ページを縦に分割した区画です。段には決まった幅と最大の高さがあります。テキストはある段から次の段へ、さらに次のページへと流れます。 |
| ブロック | 段の中で縦方向の空間を占める内容の単位です。段落、見出し、画像、表、引用ブロック、プルクオート、脚注領域があります。 |
| 行 | ブロック内の計測済みのテキストの1行で、Pretextが生成します。各行には、バウンディングボックスとベースラインの位置があります。 |
| バウンディングボックス | { x, y, width, height }(単位はピクセル、ページの原点からの相対値)。VDTのすべてのノードが1つずつ持ちます。 |
| リソース | idで本文と結び付けられる、テキスト以外の要素です。ビットマップ、SVG、表、動画のいずれかです(Resource、kind: 'bitmap' | 'svg' | 'table' | 'video')。リソースは最初に参照された時点で種類ごとに番号が付き(図1、表2.1…)、その参照に近いページの天または地の帯にフロートとして配置されます。 |
| 注 | 脚注または章末の注です。Markdownでは[^id]のマーカーと[^id]:の定義で書きます(脚注を参照)。傍注と、コンテンツモデルが受け付けるPostextNoteのリストは実装されていません。エンジンはnotesを読みません。 |
| ベースライングリッド | 本文の行の高さから導かれる縦方向の格子です(たとえば16px/1.5なら24px)。本文のベースラインはすべてその倍数の位置に来るべきもので、これによって段どうし、向かい合うページどうしで行がそろいます。 |
| バッドネス | 両端そろえの行の語間が、本来の幅からどれだけずれているかを表す値です。調整比の2乗で、10000で頭打ちになります。Knuth-Plassの行分割における基本のコストです。 |
| デメリット | Knuth-Plassで、改行位置の候補にかかる総コストです。バッドネスにペナルティ(ハイフネーション、最終行のラント、適合クラスの不一致)を加えたものです。アルゴリズムはデメリットの合計が最も小さい改行位置の組を選びます。段落を2つの段に分ける位置も同じ方法で選び、ウィドウ、オーファン、スラックのコストの合計が最も小さいものを採ります。 |
| 適合クラス | 行がどれだけ詰まっているか、ゆるいかを大まかに分けた区分です。隣り合う行のクラスが大きく異なる場合(詰まった行のすぐ隣にとてもゆるい行がある場合)は追加のデメリットがかかり、段落の組みの見た目がなめらかになります。 |
| スラック | 段落をそこで分割するか、まるごと次へ送ったときに、段の下端に空いたまま残る行です。エンジンが分割位置を選ぶときは、スラックの2乗のコスト(slackWeightで重み付け)を、ウィドウとオーファンのペナルティと比べます。 |
| バックエンド | 完成したVDTを受け取る描画先です。現在は4つあります。canvas(ビットマップのプレビュー)、HTML(DOMによる画面での閲覧)、PDF(postext-pdfによる入稿用の出力)、EPUB(postext-epub、電子書籍としての本)です。4つとも同じ計測(Pretextの上に載るmeasureモジュール)をもとに描画します。3Dビューアーのpostext-folioは、canvasバックエンドで紙面を描きます。 |
| 配置のパス | 内容を最初のブロックから最後のブロックまで1回たどり、VDTをまるごと組み立てる処理です。解析し、キャッシュを通して計測し、テキスト、フロート、囲みを配置し、改行・改段と分割禁止の規則を適用します。 |
| ラウンド | 前のパスから得たヒントを付けて、配置のパスを再実行することです。ヒントには、帯の上限、段末そろえの調整手段、確定したページのラベルや注の番号があります。ラウンドの種類ごとに上限があります(パスのドライバーを参照)。 |
#システム構成
コンテンツがエンジンの中でたどる道筋は次のとおりです。
- パーサーが拡張Markdownを読み、型付きのコンテンツブロックの平らなリストに変えます。あるのは内容と構造だけで、位置はまだありません。
- 配置のパスがそのリストを1回たどり、VDTを組み立てます。各ブロックを、これから入る段の幅でPretextを通して計測し、テキスト、フロート、囲みをページと段に配置し、進みながら改行・改段と分割禁止の規則を適用します。
- ドライバー(
buildDocument)は、レイアウト全体の結果がなければ決められない判断があるときに、パスを再実行します。ページ番号を出力する目次、上にある段を同じ高さで切らなければならないページ幅の囲み、短く終わった段などです。再実行のたびに前のパスからヒントを受け取り、再実行の種類ごとに上限があります。 - 最終的なVDTは、レイアウトの完全なジオメトリーです。どの要素も、自分のページ番号、割り当てられた段、位置、バウンディングボックスを知っています。描画の前に、文書は完全に「組み上がって」います。
- バックエンドが完成したVDTをたどり、目的の形式に描画します。ラスタライズしたcanvasのビットマップ、位置を指定したHTML要素のDOMツリー、フォントを埋め込んだPDF文書、EPUBのいずれかです。4つとも同じVDTから作られます。どのバックエンドを選ぶかは、純粋に出力の選択です。
#入力層
#コンテンツモデル
コンテンツモデルはデータ構造であると同時に、ひとつの考え方でもあります。書き手は何を言うかを記述し、どうレイアウトするかは記述しません。レイアウトの判断はエンジンが行います。
// packages/postext/src/types.ts
interface PostextContent {
markdown: string; // enriched markdown with :ref / ::resource markers
metadata?: DocumentMetadata; // title, subtitle, author, publishDate, …
resources?: Resource[]; // bitmaps, SVGs, tables, videos — referenced by id
notes?: PostextNote[]; // not read: footnotes are written as [^id] in the markdown
continuation?: LayoutContinuation; // counters and page numbers carried from earlier chapters
outline?: OutlineEntry[]; // the book's headings with their page labels, for :::toc / :::index
citations?: CitationContext; // this chapter's share of the book's citations
laterPageIds?: Record<string, number>; // page fences of later chapters a story may continue on
chapters?: { start: number; end: number }[]; // a whole book as one document: where each chapter lies, each set in its own chapter style
}
interface Resource {
id: string; // stable id, referenced by inline :refs
typeId: string; // ResourceType this resource belongs to ('figure', 'table', …)
kind: 'bitmap' | 'svg' | 'table' | 'video';
caption?: string; // the type prefix + number are computed, not written here
altText?: string;
createdAt: number;
updatedAt: number;
// Exactly one kind-specific payload:
bitmap?: { fileId: string; format: string; width: number; height: number };
svg?: { fileId: string; width?: number; height?: number };
table?: { model: TableModel };
video?: ResourceVideo; // where it plays from; drawn on the page as its poster
placement?: ResourcePlacement; // optional per-resource float override
safeArea?: ResourceSafeArea; // bitmap / svg: { x, y, width, height } in fractions, the part always shown
}リソースは視覚的なデータを運びます。キャプション、代替テキスト、そして種類ごとのペイロードです。バイナリーのペイロード(ビットマップ、SVG)は帯域外に置かれます。リソースが保存するのはfileIdだけで、レンダラーが描画時にそれを解決します(Sandboxはバイト列をIndexedDBに保存します)。表のリソースは例外で、そのTableModel(結合とそろえの情報を含むセルの格子)はインラインで運ばれます。バイト列ではなく、構造化されたデータだからです。
注はMarkdownの中に書きます。注を引用する箇所に[^id]のマーカーを置き、定義の[^id]:は独立した段落として章のどこにでも書けます。エンジンは最初に引用された順に注へ番号を付け、それぞれの注を、引用する行を含む段の下端に短い罫線をはさんで組みます。footnotes.placement: 'chapterEnd'を指定すると、章の最後のブロックのあとに組みます(脚注と設定 → 脚注を参照)。コンテンツモデルは今もnotes配列を受け付けますが、パイプラインのどの段階もそれを読みません。
この分離は意図を持った設計上の選択で、見た目以上に大きな意味があります。Markdownが受け持つのは「読む順序」と「意味の構造」です。何が先に来るか、何が見出しか、脚注がどこで引用され、何が書かれているか。リソースの配列が受け持つのは「視覚的なデータ」です。画像の寸法、キャプションの文章、表のセル。両者を分けておくことで、設定を変えるだけで同じMarkdownをまったく異なる方法でレイアウトできます。2段組みの学術論文のレイアウトと1段組みのブログ記事が、同じソースを共有できます。そしてエンジンは、ソースに一切手を触れずに配置を決められます。たとえば、ここに入らない画像を次の段へ送るといった判断です。
// Example: a simple article with a referenced figure
const content: PostextContent = {
markdown: `
# The Art of Typography
The history of typography begins with Gutenberg's
movable type, shown in :ref{id="printing-press"}.
His invention transformed the production of books.
The technique spread rapidly across Europe, reaching
Italy by 1465 and France by 1470.
`,
resources: [
{
id: 'printing-press',
typeId: 'figure',
kind: 'bitmap',
caption: 'A reconstruction of the original press.',
altText: "Reconstruction of Gutenberg's printing press",
createdAt: 1765379100000,
updatedAt: 1765379100000,
bitmap: { fileId: 'press-photo', format: 'jpeg', width: 600, height: 400 },
},
],
};リソースはidで本文と結び付けられ、参照するだけで文書に取り込まれます。インラインの:ref{id="printing-press"}は2つの役割を同時に果たします。本文中にリソースの計算された番号(「図1」)を描画し、さらに読む順序で最初の参照の時点で、そのリソースをページにフロートとして配置します。参照の近くのページの天か地に帯を確保するもので、印刷の組版者がするのとまったく同じです。図をもう一度配置する必要はありません。流れの中の決まった位置に置かなければならない例外的なリソースのために、単独の行に書く::resource{id="…"}という任意のブロック埋め込みがあります。これがインラインで描画されるのは、リソースの解決済みのplacement.positionが'here'(フロートしない指定)のときだけです。フロートするリソースの場合は、ただの参照のひとつとして扱われます。書き手は配置について考える必要がありません。それはエンジンの仕事です。
#設定
レイアウトのパイプラインのあらゆる面はPostextConfigで制御します。セクション(ページ、レイアウト、本文、見出し、リスト、数式、柱とノンブルなど)の全体は設定のページにまとめています。このドキュメントに特に関係するのは次のものです。
| 設定 | 制御する内容 | 使われる場所 |
|---|---|---|
bodyText / headings | フィールドごとのウィドウ・オーファン・ラントのペナルティ、分割禁止の規則、両端そろえの限度、ハイフネーション。設定 → 本文を参照 | 計測、改行・改段と分割禁止の規則、段末そろえ |
tableStyle | kind: 'table'のリソースのセルの文字組み、罫線、角の丸み、見出し行と本体の塗り。さらに、表がtable.styleIdで選ぶtableStylesの名前付きの変種。設定 → 表スタイルを参照 | リソースの配置 |
captionStyle | リソースのキャプションの文字組み。番号付きのラベルと説明文。設定 → キャプションスタイルを参照 | リソースの配置 |
diagramStyle | singleInk + inkColor。SVGのダイアグラムを、1色のインキの濃淡に輝度で対応付けて色を付け直します。これにより、特色1色で印刷しても図が忠実に再現されます。設定 → ダイアグラムスタイルを参照 | バックエンド |
resourceTypes | 種類別のリソースの番号付け。テンプレート、カウンターの書式、リセットの範囲、既定のフロート配置。設定 → リソースの種類を参照 | 内容の構造化、リソースの配置 |
#解析の方針
解析は、パイプラインの中で意図的に最も単純にしてある段階です。Markdownが入力され、型付きのコンテンツブロック(packages/postext/src/parse/のContentBlock)の平らなリストとして出てきます。見出し、インラインのスパンを含む段落、リストの項目、ディレクティブといったものです。結果はメモ化されるので(parseMarkdownMemo)、1回のビルドの中のパスは1度しか解析せず、同じテキストをあとでビルドするときも解析し直しません。リソースの参照は、配置のパスが始まるたびに、IDによってresources[]配列と照合して解決されます。脚注の定義([^id]:で始まる段落)もそこで流れから外され、それを引用するマーカーのためにidごとに保持されます。notes[]配列は読みません。
目録のようなものだと考えてください。「見出しがあり、次に200語の段落、次に図の参照、次にまた段落がある」。計測はありません。位置決めもありません。レイアウトの判断は一切ありません。VDTBlockができるのは、配置のパスがブロックを計測して場所を与えたあとです。
#仮想文書ツリー(VDT)
プロの組版者に本1冊のレイアウトを頼んだところ、印刷したページではなく表計算のシートを渡されたと想像してください。各行が1つの要素です。各セルが正確な寸法です。「見出しは(40, 30)にある。最初の段落は(40, 78)から始まり、高さは144px。画像は3ページの2段目の天に入る……」。このシートがVDTです。
仮想文書ツリーはPostextの中心となるデータ構造です。すべてのページ、段、ブロック、行を表す、その場で書き換える可変のツリーで、各要素が正確なバウンディングボックスを持ちます。buildDocumentが結果を返せば、VDTそのものが答えです。「72ページの2段目に何があるか」を、1ピクセルも描画せずに問い合わせられます。
#なぜ可変なのか
これはゲームエンジンの描画パイプラインと同じ手法です。そこでは、共有された可変のワールドの状態を、いくつものシステムが短い周期のループで順に更新します。理由も同じです。
配置のパスはツリーをその場で埋めていきます。ページを開き、そこに段を追加し、ブロックが入った段のavailableHeightからそのブロックの高さを引き、ページ幅の囲みが帯を切る位置でその帯の段を閉じます。1冊の本には数千のブロックがあり、不変のツリー(Reactの仮想DOMなど)では、こうした手順のひとつひとつで新しいオブジェクトを確保することになります。そこでノードは普通のオブジェクトにしてあり、パスはそこへ直接書き込みます。
終わったパスの結果に手を加えることはありません。buildDocumentがもう一度試す必要があるとき(帯の上限、段末そろえの調整手段)は、内容からパスを再実行して新しいツリーを得ます。前のパスのツリーはそのまま残るので、ドライバーは2つを比べることも、よいほうを残すことも、それぞれからページを取ることもできます。再実行の負荷を抑えているのは計測キャッシュです。テキスト、フォント、幅が変わっていない段落は、計測し直さずにキャッシュから読みます。
#構造
#型定義
以下の形は説明のために簡略化したものです。packages/postext/src/vdt.tsにある実際の定義には、描画のためのフィールド(フォントの文字列、色、リストの記号、数式の描画結果、デザインスロット)がずっと多く含まれています。ここで重要なのは構造です。
// Simplified — see packages/postext/src/vdt.ts for the full definitions
// The root of the Virtual Document Tree
interface VDTDocument {
pages: VDTPage[];
blocks: VDTBlock[]; // flat view of the same block objects
config: ResolvedConfig; // every sub-config resolved to non-optional
baselineGrid: number; // baseline increment in px (e.g. 24 for 16px/1.5)
converged: boolean; // every balancing segment ended flush or out of levers
iterationCount: number; // placement passes behind this layout (see The Pass Driver)
metadata: DocumentMetadata;
}
// A physical page
interface VDTPage {
index: number;
width: number;
height: number;
columns: VDTColumn[];
header?: VDTDesignSlot; // running header (design slot)
footer?: VDTDesignSlot; // running footer / page number
floats?: VDTBlock[]; // resource bands floated to the top/bottom of this page
pageNumberValue: number;
pageLabel: string; // rendered label ('iv', '7', 'A', …)
}
// A column within a page
interface VDTColumn {
index: number;
bbox: BoundingBox; // position within the page
blocks: VDTBlock[];
availableHeight: number; // remaining vertical space
baselineOffset: number; // current baseline y-position
band?: number; // column band (0 unless a span block split the page)
kind?: 'text' | 'span' | 'side'; // 'span' = full-width column holding a page-span block,
// 'side' = the float-only side column of a one-and-a-half layout
}
// A content block (paragraph, heading, resource, etc.)
type VDTBlockType =
| 'paragraph' | 'heading' | 'resource' | 'blockquote'
| 'listItem' | 'footnoteRef' | 'mathDisplay' | 'callout' | 'code';
interface VDTBlock {
id: string;
type: VDTBlockType;
bbox: BoundingBox;
lines: VDTLine[]; // for text blocks: the measured lines
resourceBlock?: ResolvedResourceBlock; // for resource blocks
pageIndex: number;
columnIndex: number;
dirty: boolean; // not used: cleared when the block is placed, read by nothing
snappedToGrid: boolean; // the flow went back to the baseline grid under this block
balancing?: VDTBalancing; // the column-balancing levers applied to this block
}
// A measured line of text
interface VDTLine {
text: string;
bbox: BoundingBox; // natural width: a justified line is painted to its block's right edge
baseline: number; // y-position of the text baseline
hyphenated: boolean; // line ends inside a word, or after a closed dash ("say—" | "that’s")
hardHyphen?: boolean; // …after a hyphen the text carries ("well-" | "known"): nothing added
repeatedHyphen?: boolean; // opens with that hyphen repeated ("vencer-" | "-se"), not in the source
segments?: VDTLineSegment[]; // word/space/math runs for justified rendering
isLastLine?: boolean; // last line of its paragraph
justifiedSpaceRatio?: number; // width every space is painted at ÷ the regular face's space
justifiedSpaceLimitRatio?: number; // the spacing the limits bound, when the line's own spaces are not regular (lineWordSpacing reads both)
sourceStart?: number; // markdown source map (char offsets; a line opening with `\$` starts at the backslash)
sourceEnd?: number;
plainStart?: number; // plain-text source map
plainEnd?: number;
qr?: VDTLineQr; // リンク注のQRコード(links.show)。注の1行目に付く
}
// A measured, placement-ready resource embed (bitmap / svg / table / video)
interface ResolvedResourceBlock {
resource: Resource;
kind: 'bitmap' | 'svg' | 'table' | 'video';
number: string; // computed number, e.g. "1.7"
captionPrefix: string; // e.g. "Figure"
bodyRect: BoundingBox; // the image / table area
bodySource?: ResourceSafeArea; // the part of the picture shown in bodyRect when cropped to its safe area
bodyFlex?: { shrink: number; grow: number; delta: number }; // px the body can still shrink / grow, px applied
fileId?: string; // out-of-band binary (bitmap / svg)
captionLines: VDTLine[]; // measured caption, prefix + number included
table?: VDTResourceTableLayout; // cell geometry for table resources
}
// Bounding box — all values in px, relative to page origin
interface BoundingBox {
x: number;
y: number;
width: number;
height: number;
}いくつかのフィールドには補足が必要です。
isLastLine:両端そろえの描画を左右します。段落が両端そろえでも、最終行は行末不ぞろいで描画されます。ただし行長からはみ出す(overfull)最終行は例外で、語間を詰めて行長に収めます(TeXのグルーの設定と同じ意味論です)。sourceStart/sourceEndとplainStart/plainEnd:各行から元のMarkdownと、ブロックのプレーンテキストへ戻るソースマップです。エディターとの連携で、カーソルと選択範囲の同期に使われます。VDTResourceTableLayout(とそのVDTResourceTableCellの項目):表のリソースのレイアウト済みのジオメトリーをすべて運びます。列のx方向の境界、行のy方向の境界、セルごとの矩形とその計測済みの内容の行です。これにより、どのバックエンドも同じ表を描きます。dirtyとsnappedToGrid:ブロックを配置するときに書き込まれますが、どのステージもどのバックエンドも読みません。dirtyは新しいブロックではtrueで始まり、ブロックが配置されるとfalseになります。エンジンはツリー上の変更を追跡せず、配置のパスを再実行します(パスのドライバーを参照)。snappedToGridがtrueになるのは、流れがそのあとでグリッドに戻るテキストブロックの、最初の部分です(垂直リズムの仕組みを参照)。balancing:段末そろえのどの調整手段がそのブロックを動かしたか、または広げたかを示します。段末そろえが手を付けなかったブロックにはありません(段末そろえを参照)。computePageTextExtent(page):ページ上で実際にテキストが占める縦方向の範囲(フロートのキャプションを含む)を返す、小さな公開ヘルパーです。デバッグ用のオーバーレイがこれを使い、ベースライングリッドの線を空のページ下部ではなく実際のテキストの範囲だけに引きます。
#垂直リズムの仕組み
よく組まれた本を光にかざしてみてください。左ページの行は右ページの行とそろっています。1段目の5行目のベースラインは、2段目の5行目のベースラインとまったく同じ高さにあります。これが垂直リズムで、訓練を積んだ目が組版の品質を評価するときに最初に確かめることの1つです。そしてPostextを特徴づける点の1つでもあります。
両方の段に同じ大きさの本文しかなければ、そろえるのは簡単です。どの行も同じ高さなので、ベースラインは自然にそろいます。難しくなるのは、一方の段に大きな文字サイズの見出し、任意のピクセル数の高さの画像、引用ブロックの周りの追加の間隔が入った瞬間です。こうした要素はグリッドを「崩し」ます。その下の内容がベースラインの増分の倍数ではない量だけずれ、急にその段のベースラインが隣の段とそろわなくなります。視覚的な調和が失われます。
目標はそれを取り戻すことです。見出しや画像など、標準と異なる高さの要素が一方の段にだけ現れても、隣り合う段の本文のベースラインは水平にそろわなければなりません。
#ベースライングリッド
すべては1つの数値を基準にします。文書は、本文の行の高さから導かれるbaselineGridの値を定めます。たとえば、本文を16px、line-heightを1.5で組むと、ベースライングリッドは24pxになります。本文のベースラインはすべて、この値の倍数の位置に来るべきです。これが約束事です。
#グリッドを崩す要素
高さがbaselineGridの倍数でないために、どうしてもグリッドを崩してしまう要素があります。
- 見出し(大きな文字サイズ、異なる行の高さ)
- 画像(任意のピクセル数の高さ)
- 表(高さが変わる)
- 引用ブロック(異なる文字サイズや内側余白を使うことがある)
- 脚注領域(段の下端の注とその罫。段のテキスト領域はその上で終わる)
#流れがグリッドに戻る仕組み
グリッドは、配置のときにブロックごとに保たれます。あとから段をたどってずれを探すパスはありません。本文の行はグリッド1行分の高さなので、グリッドの上から始まった本文の連なりは、グリッドに乗ったままです。グリッドから外れうるブロックを組むと、配置のパスは次のブロックが始まる前に、段で使った高さを次のグリッド線まで切り上げます。こうしてそろえるブロックは次のとおりです。
- 連続する見出しの最後の見出し(続いた見出しどうしの間ではそろえず、最後の見出しが、そのあとのテキストをそろえ直します)
- リストの最後の項目(項目の間隔にかかわらず)
- 別行立ての数式
- 囲み、コードリスト、インラインで埋め込んだ図や表
:::paragraphsコンテナーの最後の段落と、:::verseの詩(どちらも行送りが独自のものです)
ブロックの下のアキ(marginBottom)は切り上げの前に数えるので、marginBottomは最小値で、残りはグリッドが決めます。図では、1段目に、24pxのグリッドの上に高さ36pxの見出しがあり、その下のアキはありません。見出しの下端はグリッド線を12px過ぎた位置に来るので、そろえが12pxを足し、次の本文の行はグリッドの上から、2段目の隣の行と同じ高さで始まります。marginBottomが16pxなら下端は52pxになり、そろえはそれを72pxに切り上げます。
フロートの帯は、ステージ4で説明した独自の方法でグリッドを保ちます。天の帯はグリッドの行の倍数に切り上げられ、地のフロートは、キャプションの最後のベースラインがグリッドに乗るように固定されます。段末そろえはグリッドの行単位でアキを足すので、これもグリッドを保ちます。
段と段を比べる処理はありません。どの段もグリッドの上から始まり、どのそろえもグリッドに戻るので、隣り合う段の行も、向かい合うページの行も、2回目のパスなしで一致します。
そろえを行わない指定。snapToGrid: falseを指定すると、代わりに、ブロックの下のアキが正確に保たれます。headings(すべてのレベル、1つのレベル、または1つの見出しスタイル)、段落スタイル、囲みスタイル、codeStyleに設定できます。そのようなブロックのあとのテキストは、次にそろえるブロックまで、グリッドから外れることがあります。囲みの中のテキストは囲み自身の行送りに従い、グリッドはありません。
#バックエンドインターフェース
テキスト計測の信頼できる情報源(source of truth)はただ1つ、Pretextのcanvasフォントメトリクスに基づくmeasureモジュールだけです。どのバックエンドも、そこから得られた、完成した同じVDTをもとに描画します。
これは意図的な選択で、決定的な理由があります。テキストを計測する方法は、描画する方法と完全に一致していなければなりません。仮に計測にはcanvasのフォントメトリクスを使い、描画バックエンドではカーニングテーブルがわずかに異なるPDFライブラリーを使ったとします。するとレイアウトと出力が一致しません。エンジンが320pxに収まると計測した行が、描画時にはあふれたり足りなくなったりします。1ピクセルのずれでも、それは嘘になります。計測は一度だけ行い、その結果の幾何情報からすべての出力を描画するので、バックエンド同士の食い違いは起こりえません。改行位置、段の高さ、リソースの配置は、どのバックエンドが動くよりも前にVDTの中で確定しています。
たとえばPDFバックエンドがテキストを計測し直さないのはこのためです。PDFバックエンドは完成したVDTを受け取り、そのピクセル座標をPDFのポイントに変換します。正となるのはcanvasのメトリクスであり、PDFは運搬手段にすぎません。(postext-pdfパッケージの)renderToPdfを使う場合も、renderToCanvasやrenderToHtmlに渡すのと同じVDTを渡します。3つの出力が一致することは保証されています。
#APIの概要
バックエンドはクラス階層ではなく、VDTDocumentを受け取る普通の関数です。PostextBackendインターフェースは存在しません。あるのは、出力ごとの描画エントリーポイントと、それに必要なヘルパーだけです。
// Canvas (from 'postext')
renderToCanvas(doc, options?): HTMLCanvasElement[]; // one canvas per page
renderPage(page, doc, options?): HTMLCanvasElement; // a single page
renderPageToCanvas(page, doc, canvas, options?): void; // draw into an existing canvas
// Canvas resource-image registry — decoded images keyed by Resource fileId
registerResourceImage(fileId, image, options?): void; // options: { vector?, singleInk? }
unregisterResourceImage(fileId): void;
clearResourceImages(): void;
// HTML (from 'postext')
renderToHtml(doc, options?): string;
renderToHtmlIndexed(doc, options?): HtmlRenderIndex; // per-page / per-block breakdown
// PDF (from 'postext-pdf')
renderToPdf(doc, options): Promise<Uint8Array>;
// EPUB (from 'postext-epub'), a book's chapters in order
renderToEpub(docs, options): Promise<Uint8Array>;
// SCORM (from 'postext-scorm'), the EPUB writer's content as a package for an LMS
renderToScorm(docs, options): Promise<Uint8Array>;バイナリーのリソースデータは本体とは別に扱われるため、各バックエンドはそれぞれのやり方でfileIdを解決します。canvasバックエンドはデコード済みのCanvasImageSourceのレジストリーを持ちます。ホストアプリがビットマップやSVGをregisterResourceImage(fileId, image)で一度ずつ登録し、レンダラーは描画時にそれを参照します。HTMLバックエンドはオプションでresourceImageUrl(fileId)リゾルバーを受け取り、ホストが返すURL(オブジェクトURL、データURI、CDNのパスなど)を指す<img>タグを出力します。PDFバックエンドはresourceBytesプロバイダーを受け取り、実際のバイト列を埋め込みます。EPUBの書き出し処理もこれを受け取り、各画像を本の中のファイルとして一度だけ格納します。動画リソースはポスター画像として、ほかのビットマップと同じように描画されます。HTMLバックエンドは再生する動画ファイル用にresourceVideoUrl(fileId)リゾルバーも受け取り、EPUBの書き出し処理はそれらのファイルをmedia/の下に格納します。PDFバックエンドは、再生マークとQRコードをポスター画像の上にベクターのパスとして描き、video.linkPosterがオンのときは、video.linkを開くURIリンク注釈をポスター画像の上に置きます。タグ付きPDFでは、このリンクはポスター画像のFigureに加わり、その代替テキストは種類の名前で始まります(Video: …)。表リソースにはこうした仕組みはいりません。表のモデルはインラインで持たれ、どのバックエンドもVDTの表の幾何情報からセルを描画します。
renderToHtmlIndexedについては補足があります。この関数はHTML文字列全体に加えて、ページごと・ブロックごとの内訳(HtmlRenderIndex)を返します。呼び出し側はこれを前回の描画結果と比較し、HTMLが実際に変わったDOMサブツリーだけを差し替えられます。これがSandboxのライブプレビューで使われている経路です。
#バックエンド
| バックエンド | 計測 | 描画 | 状況 |
|---|---|---|---|
| Canvas | Pretext(canvasのフォントメトリクス) | HTMLCanvasElementへのビットマップ描画(renderToCanvas、renderPage、renderPageToCanvas) | 提供中 |
| HTML | Pretext(canvasと同じメトリクス) | 組版用のCSSを当てた絶対配置のDOMノード(renderToHtml、renderToHtmlIndexed) | 提供中 |
| Pretextで計測済みのVDTを受け取る | pdf-libによるPDFページの構築、ウェイトごとのフォント埋め込み(postext-pdfのrenderToPdf) | 提供中 | |
| EPUB | Pretextで計測済みのVDTを受け取る | EPUB 3ファイル。印刷ページごと(固定レイアウト)または章ごと(リフロー型)に1つのXHTML文書を作り、フォントを埋め込む(postext-epubのrenderToEpub) | 提供中 |
| SCORM | Pretextで計測済みのVDTを受け取る | 学習管理システム向けのSCORM 1.2または2004のzip。EPUBの書き出し機能が作るページまたはテキストをHTML5にし、SCOごとにプレーヤーを付ける。練習問題は得点、完了、合否を送る(postext-scormのrenderToScorm) | 提供中 |
| Folio(3Dビューアー) | Pretextで計測済みのVDTを受け取る | 各ページをcanvasバックエンドで描き(renderPageToCanvas)、three.jsの紙葉のテクスチャーとして表示する。描くのは開いている見開きの周辺だけ(postext-folioのcreateFolioFromDocument) | 提供中 |
| コマンドライン | Skia(@napi-rs/canvas)上のPretext。Skiaがブラウザーのcanvasの代わりを務める | PDF、HTML、EPUBの書き出し、ページ画像、Wordを、ブラウザーなしでターミナルから実行する(postext-cli)。PythonとRustからはpip install postextとcargo add postextで使えます | 提供中 |
4つのバックエンドとFolioビューアーは、すべて同じVDTDocumentを受け取ります。canvasとHTMLのバックエンドを公開するpostextと、PDFバックエンドを公開するpostext-pdfに分かれているのは、純粋に依存関係の都合です。PDFの経路はpdf-libと@pdf-lib/fontkitを取り込みますが、Webへの組み込みの多くではこれらは必要ありません。postext-pdfは、実際にPDFのバイト列を出力したいときだけインストールしてください。postext-epubも同じ理由で独立したパッケージになっており、必要になるのは電子書籍を作るときだけです。postext-scormはpostext-epubの上に成り立ち、EPUBの書き出し機能が作る内容を学習プラットフォーム向けのパッケージにまとめます。そのため、独自のバックエンドではありません。コマンドラインは5つ目のバックエンドではありません。postext-cliは、ブラウザーのない環境でこれらと同じ書き出しを実行します。Wordファイルはバックエンドではなく、その横にあります(postext/word)。semanticDocxはMarkdownの章とそのスタイルをレイアウトせずに.docxへ書き出し、formattedDocxはPDFの元になるのと同じVDTDocumentのチェーンのページを書き出し、applyDocxEditsはどちらかに加えた校正をMarkdownに戻します。readDocxとwordToPostextは、それ以外のWordファイルをMarkdownとして読み込みます。
レイアウトを実行する場所:エンジンはテキストをcanvasで計測するので、canvasが与えられる環境ならどこでも動きます。ブラウザーでは、パイプラインはメインスレッド上(buildDocument)でも、専用のWeb Worker内(postext/workerのcreateLayoutWorker)でも実行できます。UIを持つアプリにはワーカーでの実行を推奨します。計測と配置のパスをメインスレッドから外せること、AbortSignalによる後勝ちのキャンセルに対応していること、独自の計測キャッシュと数式ラスターキャッシュを持つため再ビルドが続いても軽いままであることが理由です。組み込み方の全体は設定 → Web Workerでレイアウトを実行するを参照してください。ブラウザーの外では、コマンドラインが、ブラウザーのcanvasの代わりにSkiaを使って同じパイプラインを実行します。そのため、ターミナルでも、スクリプトでも、ビルドサーバーでも、本は同じページに分かれます。
#パフォーマンス戦略
もたつくツールと、待たされる感覚のないツールの差は、およそ10倍です。レイアウトに500msかかれば、単語を1つ変えるたびに目に見えるカクつきが出ます。50msなら一瞬で、文書が最初からそこにあったかのように感じられます。この差は後から修正で埋められるものではなく、最初の日から設計に組み込んでおく必要があります。
エンジンが相手にするものを考えてみてください。数百ページにわたる数千のテキストブロックがあり、編集のたびにレイアウトし直し、レイアウトにラウンドが必要なときは何度もやり直します。これはゲームエンジンが直面するのと同じ種類の問題です。ゲームエンジンは数千のオブジェクト(ジオメトリー、物理、ライティング、AI)を毎秒60回処理し、すでに済ませた処理を繰り返さないことで、これを解決しています。Postextはこの考え方を、最も負荷の大きいもの、つまりテキストの計測に当てはめています。
#原則
-
メモリー内での計算。VDT全体がメモリーに収まります。レイアウト中にDOMを読むことはありません。DOMに触れるのは最後の描画のときだけです。
-
キャッシュした計測の上での完全なパス。配置のパスの再実行は、何が変わったかを探しません。最初のブロックから文書を配置し直します。それで間に合うのは、負荷の大きい計測が段落ごとにキャッシュされているからです(原則5)。段落のテキスト、フォント、幅を何も変えないパスは、その段落の行をキャッシュから読みます。
-
上限のあるラウンド。再実行には、種類ごとに決まった上限があります(パスのドライバーを参照)。段末そろえには、セグメントごとの上限に加えて文書ごとの上限もあるので、章の多い本でも、パスを際限なく費やすことはありません。ビルドの負荷はパスごとに計測できます。
BuildDocumentOptions.onPassが、各パスとその経過時間を報告します。 -
Pretextの速さ。テキストの計測がDOMの300〜600倍の速さなので、エンジンは段幅、ハイフネーション位置、トラッキングの調整などを試しながら、投機的にテキストを計測し直す余裕があり、それでもメインスレッドをブロックしません。
-
多層の計測キャッシュ。measureモジュール(
packages/postext/src/measure/)は、テキスト、フォント、幅、そしてレイアウトに影響するすべてのオプションをキーとする計測キャッシュを明示的に持ちます。これはPretext自身のprepare()キャッシュと、テキスト幅の生のキャッシュの上に重なっています。変更のない段落の再計測は、マップを1回引くだけで済みます。あるファミリーのフェイスが変わると、エンジンはそのファミリーの幅とPretextのキャッシュを捨て、計測キャッシュは次の参照のときにそのファミリーで組んだブロックを捨てます(自分が埋められた世代を持っているためです)。そのため、ホストが何も呼ばなくても、フォントの読み込みが終わったあとのグリフ幅は正しく保たれます。clearMeasurementCache()はすべてのファミリーを捨てます。 -
ホットパスでの改行処理。Knuth-Plassのアクティブノードの扱いは、速度のために書き直されました。ノードが外れるたびにアクティブ集合をその場で詰め、候補は(行、適合クラス)ごとに重複を除いて、キーごとにデメリットが最小のノードだけを残します。アルゴリズムの結果は変わりません。改行位置の集合は同じで、計算が速くなっただけです。同じ行分割はRustでも書かれ(
rust/crates/linebreak)、WebAssemblyにコンパイルしてパッケージに埋め込まれています。同じ演算を同じ順序で行い、2〜3倍速く、モジュールのコンパイルが済んだ環境ではこちらが答えます。ページのメインスレッドではバックグラウンドでコンパイルされ、それまでの間や、WebAssemblyがない、または拒否される環境では、TypeScript版が答えます。initLineBreaker()はコンパイルを前倒しで始め、useWasmLineBreaker(false)はすべての段落をTypeScript版で分割します。 -
メインスレッド外でのビルド。
postext/workerエントリーポイントは、パイプライン全体を専用のWeb Worker内で実行します。メインスレッドは{ content, config }とAbortSignalを送ります。ワーカーはフォントを登録し(ArrayBufferとして転送されます)、配置のパスを実行して、完成したVDTDocumentを送り返します。新しいbuild()呼び出しは、前の呼び出しを協調的にキャンセルします。ワーカーはbuildDocumentAsyncを実行し、これがブロックごとに1回とパスの間でキャンセル用のフックを確認して、BuildCancelledErrorを投げます。そのため、エディターで入力しているユーザーが、もう不要になったレイアウトを待たされることはありません。ワーカーは永続的な計測キャッシュと、内容をキーとする数式ラスターキャッシュも独自に保持します。これにより、構造化複製されたMathRenderオブジェクトが再ビルドをまたいで生き残り、ラスター化し直さずに済みます。 -
2通りにアクセスできるVDT。ツリー(
pages > columns > blocks)は、ページ単位や段単位で進む処理のための階層的なアクセスを提供します(段末そろえは、各段の下端のすき間を測ります)。並行して持つフラットなblocks[]配列は、どこにあるかにかかわらず、すべてのブロックへの直接のアクセスを提供します(注の番号のラウンドは、各注が出力したマーカーをここから読みます)。2つのビューは同じブロックオブジェクトを参照しています(データの複製はなく、同じデータをたどる方法が2つあるだけです)。
#レイアウトのやり直し
内容や設定が変わると(キー入力、別のページサイズ)、ホストはbuildDocumentをもう一度呼び、新しい文書を受け取ります。ビルドからビルドへ引き継がれるものは2つあります。計測と、編集中の文書については前回のレイアウトです。
テープ。createLayoutTapes(options?)はLayoutTapesを返します。これは1つの文書のレイアウトのチェックポイントです。その文書のすべてのビルドでBuildDocumentOptions.tapesとして渡してください。編集のあと、配置の各パスは編集されたブロックより前にある最後のチェックポイントから始まり、レイアウトが前回のものと再び一致したところで止まります。その先のページは、Markdown内の位置をずらしたうえで前回のものを使います。できあがる文書は、テープなしのビルドと同じです。options.restBelowPagesを指定すると、その値よりページ数の少ない文書は、再びその数に達するまでテープを使わずにレイアウトします。短い章では、記録のコストが節約分を上回るためです。tapes.statsは、直前のビルドの各パスがどこから始まったか、そしてなぜそれより前から始められなかったかを示します。1組のテープは1つの文書専用です。ビルドの間に、その文書の内容、設定、リソースをその場で変更してはいけません。レイアウトワーカーは、tapesKeyが編集中の章を指すビルドのために1組を保持し、変わったページだけを送ります。
計測。createMeasurementCache()でMeasurementCacheを1つ作り、すべてのbuildDocument呼び出しの3番目の引数に渡してください。テキスト、フォント、幅、改行のオプションが変わっていない段落はそこから読まれるので、キー入力のたびに文書をレイアウトするエディターでも、計測するのは入力中の段落だけです。キャッシュから読まれた行は、語のセグメントをキャッシュと共有します。レイアウト済みの文書のセグメント(たとえば色)を変更するコードは、見つけたセグメントに書き込まず、行のsegmentsにコピーを入れてください。ページサイズや段数を変えると幅が変わり、その段落は計測し直されます。それでもPretextのprepare()の結果は有効なままです。フォントとテキストに依存し、幅には依存しないからです。実行されるのは軽いlayout()の算術だけです。解析もメモ化されています。テンプレートページも引き継がれます。テンプレート、Markdown、スタイル、フォントが変わっていないテンプレートページは前回のビルドの結果を再利用するので(composed/pageMemo.ts)、テンプレートページでできた章の1ページを編集しても、組み直すのはそのページだけです。脚注、相互参照、引用、目次や索引の一覧、漫画のストリップを含むページは、毎回組み直されます。
ライブエディターでは、createLayoutWorker(postext/worker)が、これらすべてをメインスレッドの外で行います。ワーカーは自分と同じ寿命の計測キャッシュを持ち、新しいbuild()は実行中のビルドをキャンセルします。設定 → 計測キャッシュとWeb Workerでレイアウトを実行するを参照してください。
#ベンチマーク
packages/postext/src/__bench__/に3つのベンチマークがあります。pnpm testでは実行されず、packages/postextでpnpm benchを実行すると動きます。chapter.bench.test.tsは、教科書の1章ほどの大きさの章(見出し、段落、リストからなる40のセクション)を、空の計測キャッシュで5回、温まったキャッシュで5回レイアウトし、それぞれの中央値とパスの数を報告します。cjkChapter.bench.test.tsは紅樓夢の第1回をレイアウトし、measureTextに送られた文字数を数えて、CJKコンポーザーの負荷が段落の長さに比例する範囲にとどまることを確かめます。composedPage.bench.test.tsは、20のテンプレートページからなる章について、コールドビルド、変更なしの再ビルド、1ページの属性の変更、そのページの枠の中の編集を、それぞれテンプレートページのメモ化ありとなしで計測します。
// From packages/postext/src/__bench__/chapter.bench.test.ts
const cold: number[] = [];
for (let i = 0; i < ROUNDS; i++) cold.push(time(() => buildDocument({ markdown }, config, createMeasurementCache())));
const warmCache = createMeasurementCache();
buildDocument({ markdown }, config, warmCache);
const warm: number[] = [];
for (let i = 0; i < ROUNDS; i++) warm.push(time(() => buildDocument({ markdown }, config, warmCache)));
const passes: BuildPassInfo[] = [];
const doc = buildDocument({ markdown }, config, createMeasurementCache(), { onPass: (p) => passes.push(p) });
// [bench] chapter: … pages, … passes (… ms), iterationCount=…; cold median … ms, warm median … ms (5 rounds)正直に補足しておくと、Nodeにはcanvasがないので、どのベンチマークもテキストの計測をスタブに置き換えており、絶対的な時間はブラウザーのものとは違います。キャッシュが空のときと温まったときの比と、パスの数は実際のものです。どちらかが悪化すれば、Sandboxで表面化する前にここに現れます。章とテンプレートページのベンチマークは数値を報告するだけで、ビルドを失敗させることはありません。中国語のベンチマークは、計測した文字数が、最も長い段落の長さの3倍未満に収まることを検査します。どれもCIでは実行しません。性能の劣化は、ホットパスを変更したときに実行ごとの数値を比べることで見つけます(Knuth-Plassのアクティブノードを書き直したときもそうしました)。今のところ、時間が延びたことでビルドが失敗することはありません。遅くなったことは、計測とレビューで見つけます。
4つ目のベンチマークは、実際のテキスト計測(CLIと同じSkia)で本全体の時間を計ります。packages/postext-cliでbun scripts/bench-layout.ts --runs 3 --stages <book>を実行すると、本を章ごとにコールドでレイアウトし、各実行の時間、メモリ、ページのハッシュ、各段階(計測、行分割、配置、パス後の処理)の割合を出力します。Layout timingワークフローは、リリースのたびにGitHubのランナーで5冊のショーケースの本に対してこれを実行し、表を実行のサマリーに書き出します。報告するだけで、何も失敗させません。各実行では、プッシュ前のコミットも同じランナーで新しいコミットと交互にレイアウトします。ランナーどうしの差は、たいていの変更で縮まる時間より大きいため、見るべき差は1回の実行の中の差です。以下は1.88.1の数値です(2026年11月16日、3回の実行の中央値、1スレッド)。右の3列は実行に占める割合です。
| 本 | ページ | 時間 | 1ページあたり | 計測 | 行分割 | 配置 | | --- | ---: | ---: | ---: | ---: | ---: | ---: | | Don Quijote | 142 | 0.58 s | 4.1 ms | 22 % | 20 % | 18 % | | Paradise Lost | 402 | 2.12 s | 5.3 ms | 29 % | 8 % | 25 % | | Física universitaria (OpenStax) | 122 | 0.91 s | 7.5 ms | 25 % | 12 % | 35 % | | ألف ليلة وليلة | 2,700 | 26.6 s | 9.8 ms | 49 % | 5 % | 23 % | | 紅樓夢 | 2,030 | 3.55 s | 1.8 ms | 48 % | 0 % | 12 % |
#データフロー
#対象外とするもの
以下の制限はどれも意図的な選択です。エンジンはそれだけで十分に複雑であり、ほかが担うべき責任まで引き受けることは、いつまでも完成しない一番の近道になります。
- WYSIWYG編集。Postextは組版エンジンであり、エディターではありません。コンテンツを受け取り、幾何情報を返します。カーソル管理、選択、取り消し・やり直し、入力処理といった対話的な編集画面を作ることは、まったく別の問題です。Postextはエディターの描画バックエンドにはなれますが、編集機能そのものは提供しません。
- CSSのcolumn-countのラッパー。PostextはCSSの段組みレイアウトを置き換えるものであり、それを包むものではありません。配置済みの正確な幾何情報をゼロから計算します。ブラウザーの段組みアルゴリズムでは、リソースの配置、ウィドウ・オーファンの防止、段をまたぐ組版規則を制御できないからです。それこそがPostextの存在理由です。
- レスポンシブなブレークポイントの管理。Postextは指定されたページサイズでレイアウトを計算します。いつレイアウトし直すか(ビューポートのリサイズ時、画面の向きの変更時など)は利用する側が決めます。Postextはブレークポイント、メディアクエリー、レスポンシブデザインの判断を管理しません。それは利用する側の仕事です。
- リアルタイムの共同編集。Postextはステートレスなレイアウト計算(コンテンツを受け取り、幾何情報を返す)であり、競合解決、操作変換(operational transform)、複数ユーザーの状態把握を備えた共同編集用の文書システムではありません。
- フォントファイル。
postextパッケージはフォントを読み込みますが、フォントそのものは含みません。prepareFontsは最初のビルドの前に、設定とそのテキストが求めるすべてのフェイスを読み込み、フォントセットが用意できなかったフェイスは文書の警告にfontFallbackとして挙がります。ファイルはエンジンを組み込む側が用意します。ページの@font-face規則か、各フェイスの場所を答えるresolve関数です。設定 → レイアウトの前にフォントを読み込むを参照してください。
#付録:既存の型との対応
packages/postext/src/types.tsで定義されている主な型と、ここまで説明してきたアーキテクチャーとの対応は次のとおりです。
| 型 | アーキテクチャー上の役割 |
|---|---|
PostextContent | エントリーポイント。エンジンへの入力(内容の構造化) |
PostextConfig | 配置のパスのすべてのステージと、その周りのラウンドを制御する |
Resource | 種類ごとのリソース(ビットマップ、SVG、表、動画)。計測の段階でResolvedResourceBlockになり、種類が'resource'のインラインのVDTBlock(配置が'here'の場合)か、ページの帯に置かれるフロートのどちらかになる(リソースの配置) |
ResourceType | 種類ごとの番号付け、キャプションの接頭辞、参照ラベル、既定のフロート配置を決める(内容の構造化、リソースの配置) |
ResourcePlacement | リソースごとのフロート配置の上書き。position('auto' / 'top' / 'bottom' / 'here')とspan('column' / 'page' / 'side')に加えて、rotate、width、align、columns、captionSide、shrink、minScale、captionMeasure、wrap、wrapGap、citingPageがある。各フィールドは種類のdefaultPlacementにフォールバックし、リソースの配置の段階で値が決まる |
PostextNote | エンジンは読まない。脚注はMarkdownの中に([^id]で)書き、引用した段の下部か章の後に置かれる。傍注は実装されていない |
PostextResource | 非推奨。旧来のコンテンツモデルのリソース。レンダラーに残る最後の参照(VDTBlock.resource)がResourceモデルに移行するまでの間だけ残している |
#VDTの型の置き場所
VDTの型(VDTDocument、VDTPage、VDTColumn、VDTBlock、VDTLine、VDTLineSegment、ResolvedResourceBlock、VDTResourceTableLayout、BoundingBoxなど)は、ファクトリーヘルパー(createVDTDocument、createVDTPage、createVDTBlockなど)やcomputePageTextExtentとともにpackages/postext/src/vdt.tsにあります。バックエンド用のインターフェースモジュールは別にありません。バックエンドインターフェースで説明した描画エントリーポイントは、postext(canvas、HTML)、postext-pdf(PDF)、postext-epub(EPUB)から直接エクスポートされています。
#レシピ集の例
このページの内容を使うレシピを、いちばん近い節ごとにまとめました。どのレシピもページとスクリプト全体を並べて見せます。


