オープンソースの組版エンジン · v1.91.1

ウェブで動く、プログラムできる組版システム

Postextは、意味構造のあるMarkdownに、何世紀も受け継がれてきた組版の規則を当てはめます。Knuth-Plassの両端そろえ、高さのそろった段組み、収まるべき場所を心得たフロート。そうして、HTML、Canvas、入稿できるPDFで出版品質のページを生成します。

すべてのページは、あなたのブラウザーの中で計算されます

Postext

かんたんな説明

Postextは、本や雑誌、報告書のページをレイアウトする、無料のオープンソースソフトウェアです。いくつかの簡単な記号を付けて文章を書くと、Postextがそれを、印刷された本のような完成したページにします。印刷の世界で何世紀も使われてきた規則に従うので、文章が読みやすくなります。ページはウェブサイトやアプリに載せることも、そのまま印刷できるPDFにすることもできます。書き手、出版社、デザイナー、開発者のためのソフトウェアです。

文字起こし

ナレーションの全文と、画面に映るものの説明。

  1. 0:00

    画面全編が縦組みで、文字は上から下へ、行は右から左へ読みます。暗い画面の右寄りに、金色の細い罫の下で「畢昇 · 1045年ごろ」が縦に組まれています。活字が一つずつ上から字の枠に落ち、右から「畢昇の活字から千年、」「印刷は紙面の組み方を」「学んできた。」の3行に並びます。最後の行は金色です。背後では巨大な袋文字の年号が1045から2026まで数え上がり、まわりに組版の用語が降りてきます。禁則処理、約物の詰め、版面、ルビ、段間、天地、字詰め、和欧間、ぶら下げ、縦組み、柱、行長。カメラが最後の句点に寄り、画面は金色に満たされます。

    ナレーション畢昇の活字から千年、印刷は紙面の組み方を学んできました。

  2. 0:08

    画面右端に縦組みの見出しが2行、「ウェブは画面の配置を覚えた。」「だが、紙面は組めないままだ。」と並び、2行目は赤です。アドレスがexample.com/longform/articleのブラウザーのウィンドウに、横組み3段の日本語の記事「ウェブはなぜ紙面を組めないのか」が、ブラウザーのやり方で1行ずつ詰めて表示されています。ナレーションに合わせて、赤い印が問題の箇所に一つずつ付きます。ラベルは「行頭の句読点」「段落末の1字」「詰まらない約物」(「版面」のかぎ括弧と句点がそれぞれ全角を取る)、「和欧間のアキなし」(PostextとHTMLの前後にすき間がない)、「ふぞろいな段」(3段目は2行だけ)です。左にはコードのチップ「column-count: 3;」、その下に「……それだけ。」と、同じ五つの問題に×を付けたリスト。ウィンドウが乱れ、崩れ落ちます。

    ナレーションウェブが覚えたのは画面の配置。紙面は組めないままです。だから、ウェブの日本語の長文は今も粗いまま。句読点が行頭に来て、最後の行に一文字が残り、約物は詰まらず、和文と欧文がぶつかります。

  3. 0:29

    画面白い閃光のあと、青・金・赤の縞が横切り、Postextのロゴとワードマークがせり上がります。その下にキャッチフレーズ「ウェブで動く、プログラムできる組版システム」があり、「組版」が金色です。さらに下の行は「オープンソース · MIT ライセンス · v1.16.2 · ブラウザーで動く」。

    ナレーションこれがPostext、ウェブのためのプログラムできる組版エンジンです。

  4. 0:36

    画面ここからは、各セクションの見出しが画面の右端に縦に組まれ、内容はその左に並びます。セクション01「01 · 内容を入れる」:「Markdown が示すのは、それが何か、だけ。」Markdownのファイル03-why-postext.mdが1文字ずつ打ち出されます。partディレクティブ{number="I" title="基礎"}、リード文付きの見出し「# なぜPostextか」、:refで図fig-flowを参照する段落、::resourceの行、そして「一語を変えれば、ページが組み直される。」と書かれた:::calloutのブロック。隣のconfig.tsはbuildDocumentを呼び、2段組み、両端そろえ、locale "ja" のハイフネーションを指定しています。その下に「見た目は、設定が決める。」と「組版の判断は、本文には一切書かない。」

    ナレーション書くのは、意味を表すMarkdown。それが何なのかだけを示します。見た目は、設定が決めます。

  5. 0:46

    画面セクション02「02 · PRETEXT が測る」:「文字を測る、DOM に触れずに。」見出し「なぜPostextか」、本文の段落、囲みが順にスキャンされ、寸法線がそれぞれの高さをptで示します。コードパネルでは、prepare(text, '25px Lora')とlayout(prepared, width, 38)が高さと行数を返します。2本のバーが1万段落の処理を競い、「ブラウザーのリフロー · DOM」はほとんど進まず、「PRETEXT · CANVAS の計測 + 算術」は一瞬で満ちます。カウンターが600×まで上がり、「DOM より速い文字の計測で、本一冊が、入力に合わせて組み直される。」と「@chenglou/pretext を使用」の文字が添えられます。

    ナレーションどの段落も、DOMに触れずに測られます。速さは最大で六百倍。それを可能にしたのが、ライブラリのPretextです。

  6. 0:57

    画面セクション03「03 · POSTEXT が決める」:「ピクセルを描く前に、すべての行が決まる。」七つに区切られた輪が順に点灯します。構造、計測、配置、フロート、仕上げ、段末そろえ、リズム。それぞれに「図を段の上か下へ」「Knuth–Plass。ウィドウもオーファンも出さない」「ベースライングリッドに合わせる」のような1行の説明が付きます。隣では、Postextガイド日本語縦組み版の第二章「エンジンのしくみ」の1ページが組み上がっていきます。ラベル付きのブロックが段に飛び込み、注記「:ref{id="fig-flow"} → 段の下」とともに図2-1が所定の位置に移り、縦の行が現れ、段がそろいます。輪は反復1から3まで回り、「3回の反復で安定」と「収束」がチェックマークとともに表示されます。囲みには1行の位置が「行 · ページ · 段」で示されます。

    ナレーションそして、Postextが決めます。七つのパスで、すべての行を置き、すべての図を配置し、すべての段をそろえ、何も動かなくなるまで繰り返します。

  7. 1:12

    画面セクション04「04 · 仮想ドキュメント」:「一語を変える。変わった所だけ組み直す。」注記は「React の仮想 DOM の、ページ版。VDT、仮想ドキュメントツリーです。」日本語縦組みのガイドのp. 4からp. 10までの7ページが、右から左へ並びます。p. 8の「編集」の位置にキャレットが立ち、その段の続きが「ダーティ」として金色に変わり、p. 9に「安定」とチェックマークが付きます。それより前のページには「スキップ」、後のp. 10には「変更なし」。3つの箇条書きが規則を説明し、renderToHtmlIndexed()と題したパネル(「変わった DOM だけを差し替える」)が、文書ツリーの変わったノードに「差し替え済み」の印を付けます。

    ナレーションすべては仮想ドキュメントの中にあります、Reactの仮想DOMのように。一文字を変えれば、変わったところだけが組み直されます。

  8. 1:25

    画面「長い文書でも? 描くのは、画面に見える部分だけ。」縦組みのページの列が、VIEWPORTと記された金色の枠の中をスクロールしていきます。枠の上下には200ピクセルの余白があり、枠内のページは描かれ、枠外のページは破線の輪郭だけです。大きなカウンターが70ページのうちいま描かれている数を示し、その下に「いま描かれているページ数」と「IntersectionObserver · +200 px」。隣には「幾何情報:全ページ。」「ピクセル:見えるところだけ。」と「ページは画面に入ると描かれ、出ると解放される。」

    ナレーションそして長い本でも、描かれるのは画面に映ったページだけです。

  9. 1:32

    画面セクション05「05 · 日本語組版の規則」:「どの行も、日本語の作法で。」同じ日本語の段落「紙面を組むには決まりが多い。句読点を行頭に置かない。「括弧」。と続く約物は詰める。和文とPostextのような欧文の間にはアキを入れる。段落の最後の行を一字にしない。」が、まず「ブラウザー · 詰めこんで改行」として組まれ、ナレーションに合わせて問題が赤く示されます。句点が行頭に来て、「括弧」と句点がそれぞれ全角を取り、Postextと和文の間にすき間がなく、最後の行は「い。」だけです。続いて「POSTEXT · 日本語組版の規則」が同じ段落を組み直し、下のチップ「禁則処理」「約物の詰め」「和欧間のアキ」「末尾1字の回避」が順に点灯し、それぞれの規則が直した箇所が金色になります。最後に、ブラウザーの段落が同じ文の縦組みに置き換わり、「縦組みでも、同じ規則」と添えられます。

    ナレーションブラウザは行を詰めるだけ。句読点の位置には、お構いなしです。Postextは日本語組版の規則に従います。禁則処理、約物の詰め、和文と欧文の間隔。一文字だけの行も残しません。縦組みでも、同じ規則です。

  10. 1:54

    画面セクション06「06 · 一度の組版、五つの出力」:「見たままが、印刷される。」コードの行const vdt = buildDocument(content, config);の下で、日本語縦組みのガイドの章扉「なぜPostextか」のページが五つに分かれます。Canvas(renderToCanvas()、ピクセル単位で正確なビットマップ)にはピクセルの格子を見せるルーペ。HTML(renderToHtml()、選択できて、サイズに追従)では、ブロックが枠で囲まれ、<h1>、<h2>、<p>などのタグが付きます。PDF(renderToPdf()、入稿用 · PDF/UA · CMYK)では4色の版が重なって見当が合い、トンボとカラーバーが現れます。EPUB 3(renderToEpub()、電子書籍 · 固定レイアウトかリフロー型)では、ページを持つ電子書籍リーダーがスマートフォンの幅に縮み、文字が流し直されて「固定レイアウト」が「リフロー型」に変わります。Folio(postext-folio、ページをめくれる3Dの本)では、本が見開きに開き、1枚がのどを越えてめくれます。

    ナレーション一度組めば、出力は五つ。canvas、HTML、印刷用のPDF、固定レイアウトかリフロー型のEPUB 3、そして3Dの本。見たままが、そのまま印刷されます。

  11. 2:14

    画面セクション07、見出しの2行が右端に縦に組まれています。「07 · なぜオープンな標準か」「LaTeX は印刷の水準を決めた。」「いま、出版はあらゆる画面に。」カードが2枚並びます。1984年のLaTeXには×印の行が並びます。印刷されたページのための設計、ビルドが手元のフォントとパッケージ次第、コンパイルして、待って、また繰り返す、レスポンシブなウェブには書籍の組版がない。2026年のPostextにはチェックマークの行。一度の組版から、ウェブ、入稿用 PDF、EPUB 3、持ち運べる .postext ファイル一つにすべてが入る、入力しながら、その場で組み直す、どのブラウザーでも動く · サーバー不要 · MIT。Postextのカードが明るくなります。

    ナレーション印刷の基準を作ったのはLaTeX。でも今、出版はあらゆる画面にあります。

  12. 2:22

    画面「07 · ファイル一つに、本一冊」:「出版のためのオープンな標準。LaTeX が届かないところまで。」.postextファイルのアイコンが五つの部分に分かれます。preset.json(設定とデザイン)、chapters/*.md(章ごとに Markdown ファイル一つ)、fonts/*.woff2(フォントファイルそのもの)、images/ · SVG(すべての画像を埋め込み)、resources(表、図、キャプション)。下に「ふつうの ZIP。オープンで、仕様が公開され、MIT ライセンス。どんなツールでも読み書きできる。」

    ナレーションPostextは、オープンな標準です。持ち運べるファイルで、仕様は公開、MITライセンス。どのツールでも読み書きできます。

  13. 2:36

    画面「作例 · 本物のエンジンで組版」:日本語縦組みのガイドのページが壁のように並んで奥へ遠ざかり、カウンターが70ページまで上がります。文字は「全11章・3部、縦組み。組むのに1秒足らず。」と「Postext ガイド日本語縦組み版の全ページを、ブラウザーの中で計算。postext 1.16.2 がこの映像のために組みました。手で置いたものは一つもありません。」続いてタグが並びます。教科書、雑誌、文芸書、展覧会図録。

    ナレーションだから、数百ページの本も一秒足らずで組み上がります。

  14. 2:43

    画面エンドカード:Postextのロゴ、キャッチフレーズ「ウェブで動く、プログラムできる組版システム」、アドレスpostext.dev、「$ pnpm add postext」と打ち込まれるターミナルの行、フッター「オープンソース · MIT · GITHUB.COM/DRNACHIO/POSTEXT」。

    ナレーションPostext。オープンソースで、postext.devにあります。

章 1 · なぜPostextか

書籍の組版を、 ウェブのために計算する

印刷の組版は500年をかけてページの組み方を身につけ、ブラウザーは画面のレイアウトの仕方を身につけました。Postextは前者を後者に持ち込みます。

CSSには、flexbox、grid、columnsといったレスポンシブなレイアウトの仕組みがあります。しかし、段の高さをそろえること、見出しを後続の段落と離さないこと、ウィドウとオーファンを防ぐこと、図を次の段の頭へフロートさせることはできません。これらは、何世紀もの印刷で磨かれてきた編集上の判断です。

Postextはこの溝を埋めます。意味構造のあるMarkdownと設定オブジェクトを渡すと、@chenglou/pretext (新しいタブで開きます)を使ってDOMより300〜600倍速くテキストを計測し、すべての行、フロート、キャプションを含むページの幾何情報を残らず計算して、HTML、Canvas、入稿できるPDFのバックエンドで描画します。

入力:Markdown

:::part{number="I" title="基礎"
  palette="band=#2b4acb"}
:::

# なぜPostextか {lead="印刷の組版は
五百年をかけて……"}

Postextは**オープンソースの
組版エンジン**です。
:ref{id="fig-flow"}のように、
印刷組版の技をウェブに
もたらします。

:::callout{type="try"}
一語を変えれば、ページが
組み直されます。
:::

出力:ページ

図 1.1 エンジンを通す前と後の同じMarkdown。章扉、高さのそろった2つの段、段の頭へフロートした図。

数字で見るPostext

DOMと比べたテキスト計測の速さ。入力するそばから本全体が組み直されます
300–600×DOMと比べたテキスト計測の速さ。入力するそばから本全体が組み直されます
1つのレイアウトから得られる出力。HTML、Canvas、入稿できるPDF、EPUB 3
41つのレイアウトから得られる出力。HTML、Canvas、入稿できるPDF、EPUB 3
しおりとCMYKカラーを備えた、タグ付きのアクセシブルなPDF出力
PDF/UAしおりとCMYKカラーを備えた、タグ付きのアクセシブルなPDF出力
必要なサーバーの数。エンジンはすべてブラウザーの中で動き、MITライセンスで公開されています
0必要なサーバーの数。エンジンはすべてブラウザーの中で動き、MITライセンスで公開されています

章 2 · 機能

印刷の組版者が昔から知っていたこと

ページに必要でありながら、CSSが決めるようには設計されていない6つのこと。エンジンがそれを計算し、毎回同じ結果を出します。

  1. 2.1

    Knuth-Plassの両端そろえ

    TeXと同じ最適な行分割アルゴリズムを、TeXのパターンによるハイフネーションとオーファン制御とともに使います。白い川(リバー)のない均一な版面を、CSSでは表現できない水準で組みます。

    ドキュメントで読む
  2. 2.2

    リソースと相互参照

    図、SVGの図表、表を、印刷のフロートと同じように段やページの天または地へフロートとして配置します。番号は種類ごとに振られ、:refによる相互参照は常に番号と一致します。

    ドキュメントで読む
  3. 2.3

    表とキャプション

    本文と見出し行に別々の文字組みを設定できる表。ページをまたいで分割し、見出し行を繰り返します。キャプションは設定に従って番号が振られ、説明する対象のリソースのそばに置かれます。

    ドキュメントで読む
  4. 2.4

    単色インキの図

    SVGの図を輝度に応じて1色のインキの濃淡に置き換え、すべての図版をデザインに合わせます。特色印刷にもそのまま使えます。

    ドキュメントで読む
  5. 2.5

    LaTeXの数式

    LaTeXで書いたインライン数式と別行立て数式を、エンジンが計測して組み、本文とともにベースライングリッドに乗せます。

    ドキュメントで読む
  6. 2.6

    ウェブ、入稿用PDF、EPUB

    1つの組版エンジンから4つの出力。計算した同じページを、HTML、Canvas、入稿できるPDF(しおり、CMYKカラー、タグ付きのアクセシブルなPDF/UA出力に対応)に描画し、ページそのままの形またはリフロー型のEPUB 3電子書籍としても書き出せます。

    ドキュメントで読む
Postextガイドは、表紙も目次も部扉も含めて全ページを、読んでいるそのときに、あなたのブラウザーの中でPostextが組んでいます。
— 付属ガイドの奥付

作例

本物の本を、ブラウザーで組む

教科書、雑誌、注釈付きの叙事詩、展覧会の図録、全120回の中国古典小説、アラビア語の『千夜一夜物語』、縦組みの日本の小説、10言語のコミック。どれでもSandboxで開いて規則を一つ変えると、すべてのページが組み直されます。

章 3 · ワークフロー

出版品質のレイアウトまで3ステップ

内容はMarkdownで、デザインは設定オブジェクトで書き、ページは1回の関数呼び出しで得られます。

  1. 3.1

    意味構造のあるMarkdownを書く

    見出し、リスト、表、数式、囲み、図への:ref相互参照を使い、拡張Markdownで内容を書きます。レイアウトを気にする必要はなく、書くのは内容だけです。

  2. 3.2

    レイアウトの規則を設定する

    ページサイズ、段組み、文字組み、見出しのデザイン、柱、フロートの配置をPostextConfigオブジェクトで定義します。Sandboxで目で見ながらデザインすることもできます。

  3. 3.3

    HTML、Canvas、PDFに描画する

    buildDocumentを呼び出すと、レイアウトの幾何情報がすべて返ります。それをHTML、Canvas、入稿できるPDFのバックエンドで描画します。

API

1つの関数で、すべてを制御

コンテンツと設定オブジェクトを渡してbuildDocumentを呼び出すと、ページの幾何情報がすべて返ります。renderPageで任意のページを画像として描くことも、renderToPdfで本全体を入稿できるPDFとして組むこともできます。

book.ts
import { buildDocument, renderPage } from "postext";
import { renderToPdf } from "postext-pdf";

const doc = buildDocument(
  { markdown },
  {
    page: { sizePreset: "21x28" },
    layout: { layoutType: "double" },
    bodyText: {
      fontSize: { value: 12, unit: "pt" },
      textAlign: "justify",
      hyphenation: { enabled: true, locale: "en-us" },
    },
  }
);

// すべてのページを画像に…
const cover = renderPage(doc.pages[0], doc);
cover.toBlob((png) => save(png, "cover.png"));

// …または本全体を入稿できるPDFに
// fontProvider:ファミリーとウェイトごとのTTFバイト列(ドキュメントを参照)
const pdf = await renderToPdf(doc, { fontProvider });

章 4 · オープンな形式

1つのファイルに、本1冊

1つの.postextファイルに、どのマシンでも文書を組み直すために必要なものがすべて入っています。誰でも採用できる、オープンで編集可能な形式です。

多くの出版用の形式では、プロジェクトがばらばらに散らばります。LaTeXのビルドは特定のマシンにインストールされたフォントとパッケージに依存し、主要なレイアウトソフトのネイティブファイルは、外部に置かれた画像や書体にリンクしています。プロジェクトを移すと、何かが欠けます。私たち自身、LaTeXでこの限界に突き当たりました。

.postextは、誰でも開いて読み、編集できる通常のZIPアーカイブです。中身はJSONのマニフェスト、章ごとに1つのMarkdownファイル、そしてフォントファイルと画像そのものです。Sandboxが書き出し、postext-portエージェントスキルが書き、postext/bundleがどのプログラムからでも開いて同じページを組み直します。形式は文書化され、MITライセンスで公開されており、どんなツールからも読み書きできます。

postext-guide.postextの中身
  1. 4.1preset.json

    設定. ページ、グリッド、書体、見出しと段落のスタイル、色、柱を、読みやすいJSONで。

  2. 4.2chapters/<lang>/*.md

    章. 章ごとに1つのMarkdownファイル。ここでは2言語で22章。

  3. 4.3fonts/*.woff2

    書体. 名前だけでなく、フォントファイルそのもの。Lora、Fraunces、Geist、Bricolage Grotesque、Geist Monoの23ファイル。

  4. 4.4preset.json › resources

    リソース. 本文が参照する31点の図と表の、キャプション、番号、配置、表の内容。

  5. 4.5resources/*.svg

    画像. 図版そのもの(SVGまたはビットマップ)と、言語ごとの版。43ファイル。

図 4.1 ガイド自身の.postext(1387 KB)。本に必要なものはすべて入っていて、外から取ってくるものはありません。

試してみる

ガイドを開いて、ページを得る

Sandboxの最初の見本であるPostextガイドは、1つの.postextファイルです。ブラウザーで開いて、すべてのページを画像にします。書体も図も表も、ファイル自体から読み込まれます。

ガイドをダウンロードpostext-guide.postext · 1387 KB
open-guide.js
import { openBundle, loadBundleFonts, registerBundleImages,
  buildBundle, renderPageToCanvas } from "postext";

// Sandboxのガイド:設定、章、フォント、画像
const file = await fetch("postext-guide.postext").then((r) => r.blob());
const book = await openBundle(file, { locale: "en" });

await loadBundleFonts(book);      // ガイド自身の書体
await registerBundleImages(book); // ガイド自身の図

// すべての章の全ページを画像に
for (const doc of buildBundle(book))
  for (const page of doc.pages) {
    const canvas = document.createElement("canvas");
    renderPageToCanvas(page, doc, canvas, { scale: 0.5 });
    document.body.append(canvas);
  }

インストール

1分以内に始める

パッケージは1つだけ。サーバーもネイティブの依存関係も要りません。印刷が必要になったらpostext-pdfを追加します。

quick-start.ts
// クイックスタート
import { buildDocument, renderPage } from "postext";
import { renderToPdf } from "postext-pdf";

const doc = buildDocument({
  markdown: "# Hello World\n\nYour content here.",
});

// 最初のページをcanvasに描く
document.body.append(renderPage(doc.pages[0], doc));

// 文書全体をPDFに
const pdf = await renderToPdf(doc, { fontProvider });