本文へスキップ

章 19 · 部 III · 実践

エージェントスキル:出版物をPostextに移植する

Claude Code、Codexなどのエージェントにpostext-portスキルを入れ、PDF、Word、PowerPoint、EPUB、InDesign、HTMLの原稿を、元のレイアウトに沿ったPostextプロジェクトに変換させる方法

更新日 2026-10-2110分enescadefritptzhjaar

かんたんな説明

このページは、PDF、Word、InDesignなど別の形式の本や文書をすでに持っていて、それをPostextに移したい人のためのものです。エージェントと呼ばれるAIアシスタントに、スキルという小さな追加機能を渡せば、作業の大部分を任せられます。スキルは、元の文章を移し、元のデザインを作り直す方法をエージェントに教えます。このページでは、スキルの入れ方、頼み方、結果の確かめ方を説明します。約5分の動画で、すべての手順を見られます。

コーディングエージェントを使って、既存の出版物をPostextのプロジェクトにします。

Postextを使い始める人の多くは、すでにある本を抱えています。印刷用PDFの教科書、Wordの報告書、PowerPointの講義資料、InDesignのカタログ、EPUBなどです。移植には2つの作業があります。

  • コンテンツ:各章の拡張Markdown。ディレクティブとマイクロフォーマットを含みます。
  • デザイン:元のレイアウトの規則(ページの寸法と配置、ベースライングリッド、書体、章扉、柱、囲み、フロート、表、部)を再現する設定マニフェスト。

この作業の多くはLLMにできますが、それはPostextのしくみを知っている場合に限ります。PostextのMarkdownはCommonMarkではなく、設定には、ページが正しく描画されないときに初めて表に出る落とし穴があります。 postext-portスキルは、その知識を、Sandboxのすべてのプリセットを作るのに使ったツールと一緒にまとめたものです。これを使えば、エージェントが移植をきちんとこなせます。

スキルはオープンなAgent Skills形式に従っているので、Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode、そのほか多くのエージェントで動きます。

#チュートリアルを見る

5分、コードは不要です。フォルダーを用意し、ベクター形式の原稿を持ち込み、参照用のPDFを加え、エージェントに頼み、結果をSandboxで確かめます。

文字起こし

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

  1. 0:00

    画面縦組みのタイトルカード:Postextのロゴの下に、右から順にキッカー「チュートリアル · 5つのステップ」、タイトル「あなたの出版物を」「Postext に」(金色)、サブタイトル「AIエージェントで。プログラミングは不要。」

  2. 0:03

    画面右端に縦に「あなたの出版物は、すでにある。」日本語のページが3枚降りてきます。右から、縦組みの小説のページにはInDesign(IDML)、横組みの技術書のページにはWord(DOCX)、緑の帯の町内会報「東若葉台だより」にはPDFのラベルが付きます。3枚が一つに集まり、金色の破線の矢印が「AIエージェント」のラベルを通ってmy-book.postextという名前のファイルアイコンを指します。右端の文字は「エージェントで Postext へ。」と「5つのステップ。よく書けた依頼を、いくつか。」に変わります。

    ナレーションあなたの手もとには、もう出版物があります。小説、技術書、町内会のたより。InDesignやWord、PDFの中にあります。この回では、AIエージェントがそれをPostextにします。コードは不要。五つのステップと、よく書けた依頼がいくつかあれば十分です。

  3. 0:28

    画面「計画」:ナレーションがステップを挙げるたびに、番号付きのカードが右から1枚ずつ現れます。01「フォルダーを整理」、02「ベクターの原図をそろえる」、03「見本を加える」、04「エージェントに頼む」、05「Sandbox で確認」。

    ナレーション手順はこうです。フォルダーを整理し、イラストの元データをそろえ、見本を一つ置き、エージェントに頼んで、最後に結果を確かめます。

  4. 0:41

    画面ステップ01、見出しが右端に縦に組まれています。「ステップ 01 · フォルダー」「プロジェクトひとつに、フォルダーひとつ。」大きなフォルダーmy-book/のまわりに、ばらばらのファイルが10個浮かんでいます。NotoSerifJP-Regular.otf、表紙.jpg、図1-1.ai、第一章.docx、NotoSerifJP-Bold.otf、地図.svg、写真-07.jpg、NotoSansJP-Bold.otf、本.idml、グラフ.pdf。フォルダーの中身を示すウィンドウが開き、ナレーションが種類を挙げるたびに、ファイルが対応するサブフォルダーへ飛び込みます。見本.pdf(仕上がりの姿 → ステップ 03)、fonts/(Noto Serif JP、Noto Sans JP…、.otf .ttf .woff2)、images/(写真、.jpg .png)、artwork/(ベクターの原図、.ai .svg .pdf)、text/(Word、InDesign(IDML)…)。

    ナレーションステップ1。すべてをパソコンの一つのフォルダーに。一つのプロジェクトに一つのフォルダー。その中に、素材の種類ごとのサブフォルダーを作ります。フォント、画像、イラスト、そして原稿。

  5. 0:59

    画面fonts/の行が強調され、「フォント」のカードに大きな「永」の字、明朝体・ゴシック体・太字の三つの字様、OTF・TTF・WOFF2の三つの形式、そして注記「埋め込めるものだけを。入れたものしか使われない。」が表示されます。続いて縦に「整ったフォルダーほど、推測は減る。」が現れ、ツリーの各サブフォルダーにチェックマークが付きます。

    ナレーションフォントを忘れずに。和文フォントは大きく、多くはライセンスが必要です。埋め込める、たとえばNoto Serif JPのようなオープンソースのフォントだけを。エージェントは入れたものしか使えません。フォルダーが整っているほど、エージェントの推測は減ります。

  6. 1:20

    画面ステップ02:「ステップ 02 · ベクターの原図」「原図をそろえる。」図解、グラフ、地図がアンカーポイントの見える線画で描かれ、三つのファイルアイコンが現れます。.ai Illustrator、.svg SVG、.pdf PDF。

    ナレーションステップ2。イラストが図解やグラフ、地図のようなベクター画像なら、元のファイルを探しましょう。Illustrator、SVG、またはPDFです。

  7. 1:34

    画面2枚のパネルに同じ図が表示されます。「原稿」と「テンプレート」が「ページ」を指す図解で、キャプションは「図2-1 内容とデザインが出会う」。右の「図の写真 · PDF から切り出し」は、拡大するにつれてぼやけ、ピクセルのかたまりに崩れます。左の「図そのもの · 原図」は拡大してもくっきりしたままです。右のパネルが暗くなり、原図のラベルが英語(Manuscript、Template、Pages)に打ち直され、四隅にトンボが付き、三つのチェックマークが並びます。「どれだけ拡大してもくっきり」「図の文字は本物の文字」「原図 → 入稿」。

    ナレーション完成したPDFから切り抜いた図は、絵の写真のようなもの。元のファイルこそが、絵そのものです。元のファイルがあれば、エージェントは図を一つずつ作り直します。どこまで拡大してもくっきりして、図の文字も本物の文字なので、翻訳できます。そして印刷には、元のデータがそのまま入稿されます。

  8. 2:01

    画面ステップ03:「ステップ 03 · 見本」「仕上がりの姿を見せる。」フォルダーの一覧で見本.pdfが強調され、「★ ルートに置く」のタグが付きます。そこから1ページが飛び出し、例の教科書『山の地形』の縦組み・上下2段のページとして大きく表示されます。柱は「第一章 氷河は山の谷をどう削るか」で、氷河の谷の写真が2点入っています。

    ナレーションステップ3は欠かせません。フォルダーのいちばん上に、完成品の姿がはっきりわかるファイルを置きます。PDFが理想です。

  9. 2:12

    画面ページの上に寸法が現れます。上下2段の縦の行の輪郭、「天 28 mm」「小口 24 mm」「段間 2字」「1行 30字」「1段 26行」「行送り 15 pt」。見出し、本文、キャプションには「見出し · Noto Sans JP 11 pt」「本文 · Noto Serif JP 9/15 pt」「キャプション · Noto Sans JP 7.5 pt」のラベルが付きます。隣の仕様書.mdが1行ずつ埋まっていきます。判型 185 × 260 mm(B5変型)· 縦組み・右綴じ、版面 上下2段 · 1行30字 × 26行、段間 2字(18 pt)、本文 Noto Serif JP 9 pt・行送り15 pt、両端そろえ、字下げ 1字、見出し Noto Sans JP · 第一章 / 一、約物 JIS X 4051 · 禁則処理、キャプション 図1-1 ゴシック体 7.5 pt。最後に「推測」の語に赤い取り消し線が引かれ、金色の「実測。」が光ります。

    ナレーションエージェントは、そのページからデザインを読み取ります。判型、版面、字詰めと行数、文字の大きさ、行送り、約物の扱い。そして、それをレイアウトの規則として書き留めます。見本がなければ、推測するしかありません。見本があれば、測れます。

  10. 2:37

    画面ステップ04:「ステップ 04 · エージェント」「ふだんの言葉で頼む。」「エージェント · ~/my-book」と題したウィンドウが、Claude Code、Codex、「ほかのエージェントでも」のバッジの横に開きます。日本語の画面は横書きで読むため、ウィンドウの中は横組みです。「あなた」のメッセージが打ち込まれます。「Postext のスキルをインストールしてください:`npx skills add drnachio/postext --skill postext-port`」。エージェントが「✓ スキルをインストールしました:postext-port」と答えます。「スキル · postext-port」のカードには「実績のある手順」「Postext のすべての知識」「自分の仕事を確かめる道具」が並びます。

    ナレーションステップ4。そのフォルダーでエージェントを開きます。Claude CodeでもCodexでも、ふだんのもので。そして、Postextのスキルを入れるよう頼みます。スキルとは、専門的なノウハウのパッケージです。これは、出版物をPostextに移す方法をエージェントに教え、自分の仕事を確かめる道具も渡します。

  11. 3:03

    画面次の依頼が打ち込まれます。「postext-port スキルで、この本を Postext に変換してください。デザインは `見本.pdf` のとおり、フォントは `fonts/`、元のイラストは `artwork/` にあります。PDF から図を切り抜かずに、元のイラストを使ってください。まず第一章だけを作り、組む前に仕様書を見せてください。」隣のフォルダーの一覧では、依頼が名前を挙げるのに合わせて見本.pdf、fonts/、artwork/が順に光り、「見本の章」と大きな「1」のカードが現れます。

    ナレーションそれから、してほしいことをふだんのことばで頼みます。見本とフォントと元データの場所を伝え、まず一つの章だけで始めるよう頼みましょう。

  12. 3:16

    画面依頼のウィンドウの横に、暗くした縦組みの教科書のページが12枚、格子状に並び、最初の1枚が金色の枠で囲まれます。円を描く矢印がそのページで磨いた回数を「1回目」から「3回目」まで数え、チェックマークが付くと、残りの11ページが明るくなります。下には「見本の章 → 磨く → 広げる」。

    ナレーション内容が長いときは、まずサンプルの章を一つ作ります。完璧になるまで磨き上げ、それから残りに広げます。

  13. 3:26

    画面エージェントが四つの質問をします。「原本どおり? それとも作り直す?」「どの言語で?」「印刷、画面、それとも両方?」「縦組み? 横組み?」チェックリストが、素材を洗い出す、デザインを測る、文章を取り出す、フォントと画像、ページごとに比べる、ファイルにまとめる、と一つずつ完了し、ファイルmy-book.postextが現れます。3つ目の依頼が打ち込まれます。「第一章はこれで承認です。残りの章も同じデザインで変換し、一章ずつ `見本.pdf` と比べて、すべてを一つの .postext ファイルにまとめてください。」エージェントは「✓ 12章 · 警告0件 · my-book.postext」と返します。

    ナレーションエージェントはいくつか質問をします。元のとおりに再現するか、デザインし直すか、どの言語か、紙か画面か、横組みか縦組みか。そのあと、測り、取り出し、組み立て、確かめて、Postextのファイルを渡してくれます。サンプルがうまくいけば、本全体に広げるのはもう一度頼むだけです。

  14. 3:57

    画面ステップ05:「ステップ 05 · Sandbox」「ページごとに、確かめる。」ブラウザーのウィンドウのアドレス欄にpostext.dev/ja/sandboxが打ち込まれます。ポインターがサイドバーの「本」、「新規」、「.postextファイルを開く…」を順にクリックします。ファイルが飛び込み、一覧の先頭に「私の本 · 12章 · 184ページ」が現れ、Canvasのビューに縦組みの見開きが開きます。上部のタブはCanvas、HTML、PDF、Folio、EPUB 3です。

    ナレーションステップ5。postext.devでPostextのサンドボックスを開きます。「本」で「新規」を選び、あなたのファイルを開きます。

  15. 4:09

    画面サイドバーが「デザイン」パネルに替わり、「表記体系」のグループに「日本語の既定設定」と「確認…」のボタンがあります。設定の行に一つずつチェックマークが付きます。文書の言語 ja、本文の書体 Noto Serif JP、見出しの書体 Noto Sans JP、1行目の字下げ 1字、行そろえ 両端そろえ、キャプションのラベル 図1-1 タイトル、章番号 第一章、番号付きリスト 一、(一)1(1)①、ノンブルの数字 漢数字(一〇五)。

    ナレーション一から作る日本語の本なら、デザインの「日本語の既定設定」で、日本の組版のならわしを一度に適用できます。

  16. 4:20

    画面見本のページとPostextで組んだページが、「見本」と「POSTEXT」のラベル付きで並びます。「検査」パネルが開き、三つの問題を挙げます。行長に満たないCJKの行(4ページ)、PDFのフォントにない文字(7ページ)、段からはみ出す囲み(7ページ)。Postextのページの上で、赤い枠がそれぞれの箇所を示します。

    ナレーション見本と並べて、一ページずつ確かめます。「検査」パネルが問題を教えてくれます。行長に満たない行、フォントにない文字、段からはみ出す囲み。

  17. 4:34

    画面ページの略図が2列に並びます。「見本 · PDF」と「POSTEXT · 内容が流れる」。流れるほうの列では、「図」が1ページ目から2ページ目の段の上へ移り、破線が二つの位置を結びます。縦に「規則は同じ、ページは別。」と「内容は流れる。図や改ページが、別の場所に来ることもある。」続いて、ページの各組を等号が結び、「そろえるべきもの」として、判型、版面、字詰め、書体と文字サイズ、図と囲みのスタイル、きれいな紙面:1字だけの行がなく、段がそろう、が並びます。≠の印が付いた赤いパネルには「手作業による職人の判断」と「規則ではないので、変わっていく内容は組めない」。

    ナレーション一つ覚えておいてください。ページがPDFとまったく同じでなくてもいいのです。Postextが学んだのはレイアウトの規則。内容は今、流れているので、図や改ページが別の場所に来ることもあります。そろうべきなのは品質、つまり同じ仕上がりの水準です。手で組むとき、私たちは規則ではない小さな職人の判断をたくさんしています。そして、変わり続ける内容を組めるのは、規則だけです。

  18. 5:09

    画面サンドボックスの上にエージェントのウィンドウが戻り、4つ目の依頼が打ち込まれます。「サンドボックスの第二章、7ページ:「ポイント」の囲みが二つの段に分かれていて、柱も消えています。「検査」には行長に満たない行が3つ出ています。直して、ファイルをまとめ直してください。」スクリーンショット「スクリーンショット-第二章-p7.png」が添付されます。続いて、Sandbox(確かめる)とエージェント(直す)のあいだのループが1回目から3回目まで回り、警告の数が3から0に減り、チェックマークと縦組みの「ぴったり。」で終わります。

    ナレーションそれから、見たことをエージェントに伝えます。できるだけ具体的に。どの章の、どのページで、何がおかしいか。スクリーンショットがあると助かります。新しい版を開いて、もう一度確かめ、これを繰り返します。回を重ねるごとに近づき、やがてぴったりになります。

  19. 5:34

    画面縦組みで「ただの」「Postext 版ではない。」ファイルmy-book.postextが金色の線で二つに割れます。一方は「内容 · 何を言うか」:chapters/01-glaciers.mdに、見出し「# 氷河は山の谷をどう削るか」、:ref{id="valleys"}で図を参照する文「氷河が通った谷は広く、谷底は平らで、横断面はU字形になる」、そして「氷河は、流れる氷である。」と書かれた「ヒント」の囲み。もう一方は「形 · どう見えるか」:「テンプレート · 原本から導いたもの」に、判型 185 × 260 mm(B5変型)、縦組み、版面 2段 × 30字 × 26行、本文 Noto Serif JP 9/15 pt、見出し Noto Sans JP、第一章 / 一、約物 JIS X 4051、禁則処理、図 図1-1、段の上にフロート。

    ナレーションここが肝心です。手にしたのは、内容のPostext版だけではありません。内容と形を、分けたのです。文章は整った章の中に、デザインはテンプレートの中にあり、レイアウトの規則は元の本から導き出されています。

  20. 5:54

    画面縦組みのページの列の上で、「修正」「増補」「翻訳」のチップが順に光ります。1行が強調されてページの上を光が横切り、2ページが滑り込み、続いてページがめくれて、同じテンプレートで組んだ横組みの英語版に変わります。依頼が打ち込まれます。「英語版を追加してください。本文、キャプション、図の中の文字を翻訳し、デザインはそのままにしてください。」キャプションは「同じ規則、新しい内容。ページはひとりでに組まれる。」続いて縦に「ファイル一つに、本一冊。」:.postextのアイコンから4本の枝が伸び、トンボ付きのページ(入稿用 PDF)、電子書籍リーダー(EPUB 電子書籍)、ブラウザーのウィンドウ(ウェブリーダー)、見開きのページ(どのページも組み上がる)につながります。

    ナレーションだから内容が変わっても、直しても、増やしても、翻訳しても、レイアウトを気にする必要はありません。Postextが同じ規則で組み直します。一冊の本に、ファイルは一つ。印刷用のPDF、EPUBの電子書籍、ウェブで読めるリーダー、そしてひとりでに組み上がるページ。

  21. 6:21

    画面エンドカード:Postextのロゴ、キャッチフレーズ「ウェブで動く、プログラムできる組版システム」、postext.dev、「この動画のプロンプトは概要欄にあります ↓」と書かれたピル、フッター「オープンソース · MIT · GITHUB.COM/DRNACHIO/POSTEXT」。

    ナレーションPostext。オープンソースで、postext.devにあります。プロンプトの例は概要欄に。

YouTubeでも見られます。YouTubeで見るか、Postextの再生リストからどうぞ。

AI エージェントで Postext の本を編集する:章の追加、新版、別の読者向け ― チュートリアル2YouTube で見る (新しいタブで開きます) · 再生を押すと YouTube からプレーヤーを読み込みます。

#スキルの中身

  • 作業の流れ:
    1. 要件を取り決める
    2. 原稿の内容を一覧にする
    3. デザインを測って仕様書にまとめる
    4. プロジェクトのひな形を作る
    5. コンテンツを抽出する
    6. PostextのMarkdownに整える
    7. フォントと画像を用意する
    8. ページごとに確かめる
    9. パッケージにまとめる
  • リファレンス:
    • 文書形式と設定マニフェスト。どちらもエンジンと照合済みです。
    • プロジェクト(バンドル)の形式。
    • 原稿の形式ごとの手順書。
    • デザインを分析する方法。
    • 解決済みのレイアウト事例集:部ごとの色、章扉、韻文、欄外の注、脚注、索引、フロート・分割・入れ子の囲み、 印刷用のベクター原稿、文字をテキストのまま残した図、表のセル内の画像、横向きの表、対訳版など。
    • 横組み、または縦組みで右綴じにした中国語の本:要件で何を尋ねるか(文字、地域、組み方向、綴じ)、 文字グリッドの測り方、縦組みのPDFの読み取り方、InDesignのルビと割注、Wordの東アジア言語のレイアウトと 右から左に進むEPUB、CJKフォントを本に必要な文字だけにサブセット化する方法(中国語の組版を参照)。
    • 右綴じで縦組みの文庫・単行本の小説、または横組みの技術書といった日本語の本:日本語の規則を有効にするロケール (ja。中国語のタグは使いません)、何を尋ねるか(組み方向、グリッド、ルビ、注、その版の表記)、 版面を字数と行数で測る方法、ルビと圏点のマークアップ、aozora.pyで変換する青空文庫のテキスト、 国立国会図書館が公開するパブリックドメインの版のスキャン、かなと縦組み用字形を保ったままサブセット化した 日本語フォント(日本語の組版を参照)。
    • 右から左に組み、右綴じにするアラビア語の本(現代語でも古典語でも、母音記号付きでも):本全体を右から左に組むロケール、 何を尋ねるか(地域と数字、母音記号、韻文、巻末の目次)、左右反転したページの測り方、PDF、Word、Wikisourceからの アラビア語の読み取り方、:::verseで組む詩、ページごとの«(١)»形式の注、連結用のテーブルを保ったまま サブセット化したアラビア語フォント(アラビア語の組版を参照)。
    • 欧米のコミック、日本の漫画、新聞漫画:ページをコマに分ける分割式、話者のアンカーとセーフエリアを付けたコマの絵、 エンジンが写植する言語ごとの台本(吹き出し、ナレーション、描き文字)、右から左に読む漫画とアラビア語版、 文字のない原画と翻訳から、写植済みのスキャンから、台本と生成した絵から移植する方法(漫画を参照)。
    • 特殊インキと抜き加工:PDFやIDMLの特色版と抜き型業者の版やレイヤー、各インキの名前が示す加工(メタリック、箔押し、蛍光、不透明ホワイト、ニス)を印刷所の仕様で確かめる方法、抜き型の線から測る抜き型(特殊インキと抜き加工を参照)。
    • テンプレートページ:教科書、ワークブック、雑誌の固定レイアウトのページを、Markdownから枠を埋めるページテンプレートとして移植する方法、インストール済みのPostextが対応する移植のラウンド、各版が通るべき検査(テンプレートページを参照)。
    • 物としての本:原本の用紙、綴じ、表紙、背を読み取り、Folioビューアーが表示する folio設定として指定する方法。リンターで検査されます。
  • スクリプト(PythonとNode)。次の節で説明します。

#スクリプト

スクリプト役割
inventory.pyどんな原稿にも最初にかける下調べ:寸法と配置、フォント、使われているスタイル、メディア、OCRが必要なページ。PDF/Xで刷られたPDFでは、出力条件と塗り足しを、それを再現するprintの設定とともに示します。PDFやIDMLの特色版も、各名前が示す加工とともに挙げ、抜き型業者の版やレイヤーも示します。
measure_layout.pyPDFの余白、段、段間、行送り(ベースライングリッド)
pdf_extract.pyPDF → 書体の役割(フォント、サイズ、色)ごとの章の下書き:読む順序、段落、ハイフネーションの解除、太字とイタリック、上付きと下付き、リスト、キャプション
pdf_figures.pyPDFから図を切り出す:元の解像度の写真、SVGのプレビュー、印刷用のベクターPDF原稿
pdf_regions.py, template_dedupe.py, anchors.pyPDFの固定ページ(教科書、ワークブック、雑誌)をテンプレートページに変換します。作られるのは、ミリ単位の枠からなるページテンプレート、囲み・タブ・ハイライトのスタイル、文字のないページの地、文字を除いて切り出した画像、そしてページごとに1つのページブロック(::::page)と囲みごとに1つのスロットを読む順に並べたMarkdownです。ほかの描画の下に隠れた文字は取り込みません。template_dedupe.pyは、同じ種類のページのテンプレートとスタイルを1つのライブラリにまとめ、枠に種類と順番ではなく役割による名前(box-light-blue、caption-of-picture)を付け、それに合わせてページブロックも書き換えます。anchors.pyは、地図の文字をリソースのアンカーと、版ごとの::labelの行に変えます。1ページだけの実行では統合するものがないため、pdf_regions.py extract自身が枠に役割で名前を付けます(--name-frames、postext 1.43以降)。postext 1.48以降は、ページの線・カード・図形をページごとの画像ではなくベクターで描きます(枠どうしをつなぐコネクター、画像の一点を指す線、パス要素)。template_dedupe.pyは、行と列に並んだカードを繰り返しのグリッドに、ページの帯の一つひとつをモジュールにまとめます。1.50以降は、横に並んだブロックをモジュールの行として配置し、色だけが違うカードはそれぞれに名前付きの見た目を付けて一つのグリッドにまとめ、前付けと本文のページには共通の土台テンプレートを一つだけ使います。ノンブルやページの色は、::::pageブロックの指定がある場合に描かれます。postext 1.51以降は、下書きに手を入れる箇所が減りました。画像は画像だけを切り出し(隠れた文字、隣の塗り、白い余白は入りません)、ページが写真の上に描いた札はその上に残り、囲みの文章は囲みの端まで届き、柱の横の飾りは柱と一緒に動き、画像の下に段組みで置かれたキャプションはそれぞれ一つの枠になり、本がすでに名前を付けている色はそれを使う外観にその名を与え、下書きが上下につないだブロックも横に並んでいればモジュールの行になります。手で直した点はcuration.jsonに書きます。extractが空のファイルを作り、manifestがビルドのたびに適用するので、作り直しても失われません。枠の修正・削除・追加、装飾の削除、重なりの許可、スタイルの変更、リソースの追加をそれぞれ理由とともに記し、存在しないテンプレート・枠・スタイルを指す修正があればビルドを止めます。
extract_tables.pyPDFの表 → PostextのTableModel。セルは揃え・太字・塗りを、結合セルはその広がりを保ちます。表題の行は表のキャプションとラベルに、全列にまたがる行は中央揃えのグループ帯になり、見出し行は太字か塗りで数え、1行として読まれた2行は分け直します。pdf_extract.pyも罫線のある表を表のリソースにします。
pandoc_to_postext.pyDOCX、PPTX、ODT、EPUB、HTML、LaTeX、Markdown、JATS、DocBook → 章の下書き。Wordのスタイルは囲みと段落スタイルに対応づけます
idml_extract.pyInDesignのIDML → 段落スタイルごとの章の下書き、表、アンカー付きの画像。ルビ、縦中横、圏点、割注は:ruby、:tcy、:dots、:warichuになり、縦組みのストーリーと右から左の綴じは報告されます
aozora.py青空文庫のテキスト(CP932のzipまたは.txt)→ PostextのMarkdown:ルビ、傍点と傍線、字下げ付きの見出し、段落スタイルとしての字下げと地付きのブロック、改ページ、JIS X 0213で解決する外字、漢文の訓点。クレジットのブロックと、表現できなかった箇所の報告も返します
index_marks.py印刷された索引を:indexのマークとして作り直す:PDFの索引ページを読み、各語をそのページで見つけ、章の中の同じ語に印を付けます
comic_panels.py漫画のページを測ります:コマの間に見える紙の部分からコマを見つけ、splitの式(左から右、右から左、斜めの間白を含む)、間白と枠を書き出し、コマごとに絵を切り出して:::pageのひな形を出力します。絵に格子を重ねて話者のアンカーとセーフエリアを読み取り、描き戻して確認します
fonts.py、images.py、convert_assets.pyフォントのインスタンス化、サブセット化、拡大縮小、分割(本の文字だけに絞った中国語や日本語の書体は縦組み用字形とメトリクスを、アラビア語の書体は連結形とタトウィールを保ちます)。画像をsRGBに変換し、余白を切り詰め、つなぎ合わせます。.ai/.pdfのアートワークをSVGにします
preset_kit.pyプロジェクトとその生成スクリプトのひな形を作り、preset.jsonを組み立て、.postextファイルにまとめます。設定も点検し、デザイン要素に書き込まれた本文(設定に置くのはデザインだけです)と、Sandboxに収まらない大きさの設定を見つけます
lint_project.pyパーサーとローダーがエラーを出さずに誤って処理してしまうものを、すべて検出します。中国語、日本語、韓国語のテキストでは、同梱フォントで組めない文字。日本語のテキストでは、中国語ロケールの下のかな、中国語の書体や設定、章に残った青空文庫の注記、読みのない漢字の索引項目。アラビア語のテキストでは、アラビア語ロケールの欠落、ラテン文字専用または連結しない書体、字間、強制的なハイフネーション、イタリックによる強調。漫画では、解析できないsplitの式、分割のセルと合わないコマ、見つからない画像や吹き出し・コマのスタイル、不正な話者のアンカー、同梱されていない写植用フォント、版ごとに異なるページ。エージェントが残しがちな誤りも指摘します。inlineMarksなしのデザインテキストにあるインラインの記号、固定幅のスペースの隣に打った通常のスペース、1.52より古いエンジンでの見出し内のチップ、:smallcaps[…]を使わずに小さなチップで組んだ大文字、:::tocのような1行の指示の後の:::です。設定項目の一覧はエンジン自身の型から作ります
render.mjsプロジェクト(フォルダーまたは.postextファイル)を、本物のエンジンでヘッドレスにレイアウトします。設定はSandboxと同じように読み込み、警告を出力します。--jpegを付けると、指定したページ(--pages 12-15)をエンジン自身のcanvasレンダラーでJPEGファイルに描画します。1、2秒で済むので、エージェントはPDFを作らずに自分のページを見られます。--outはPDFを書き出します。印刷用に設定した本ではPREFLIGHT行(解像度不足の画像、細すぎる罫、複数インキの小さな文字、上限を超えるインキ量、仕上がり線に近い文字)を出力し、PDFはICC出力プロファイルで分版します。抜き加工のあるページでは、手に取ったときのように穴の下のページが見えます。
compare_pages.py原本のページとPostextのページを並べて表示します。描画結果のPDFからでも、JPEGのフォルダーからでも使えます。--scoreで似ている度合いを測り、--checkを付けると、チェックが枠の重なりを報告しているあいだは評価が失敗します。--watch DIRを付けてpostext build … --images DIR --watchと並べて動かすと、ページが変わるたびにそのページの対と点数を書き直します
port_audit.py元のPDFと移植したPDFを属性ごとに比べます。語は内容で突き合わせ、特殊なスペース、イタリック(正体を斜めにしたものを含む)、太字、スモールキャップ、箇条記号の大きさと太さ、表のセルの揃えと太さ、ノンブル・柱・本文の色を見ます。属性とページごとの件数をJSONとMarkdownで書き出します。納品の前に実行してください
composed_check.pyテンプレートページ:roundはインストール済みエンジンのバージョンを読み、どの移植ラウンドに対応し、どのテンプレートページ機能が欠けているかを示します。checkは各版でpostext checkとpostext htmlを実行し、枠のあふれ、未知のテンプレートやスロット、アンカーに収まらないラベル、設定に書かれたテキスト、Markdownが埋める順序とは異なる順序でHTMLが読む枠があれば失敗します。postext 1.48以降は、枠が別の枠の下に隠れたり自分の箱からはみ出したりした場合(frameCovered、frameOutsideArea)にも失敗し、最後に重なりの数を示します。原本が意図して重ねている箇所は、理由を添えてプロジェクトのcomposed-check.jsonに記録します。綴りを誤った設定やエンジンが受け付けない値(unknownConfigKey、unknownConfigValue)も不合格にし、ほかの警告もすべて表示します。--json-out FILEは結果を保存しつつ報告と終了コードを残し、保存した検査が不合格のあいだはpreset_kit.py packがパックを拒みます
postext_md.pyほかのスクリプトが読み込む補助モジュールで、PostextのMarkdownの方言でテキストを書き出します。インラインの記号は平たい区間に分け、意味を持つ文字はエスケープし、リスト、見出し、ブロックとして読まれてしまう段落はテキストのまま保ちます

#インストール

#どのエージェントでも(skills.sh)

skills CLIが使っているエージェントを検出し、それぞれにスキルをインストールします。

npx skills add drnachio/postext --skill postext-port

エージェントを明示するには-aを、グローバル(すべてのプロジェクト)にインストールするには-gを使います。

npx skills add drnachio/postext --skill postext-port -a codex -a claude-code -g

同じスキルはWebサイトからも公開されているので、次の方法でも入れられます。

npx skills add https://postext.dev

#Claude Codeプラグイン

PostextのリポジトリはClaude Codeのプラグインマーケットプレイスでもあります。Claude Codeの中で次のように入力します。

/plugin marketplace add drnachio/postext
/plugin install postext@postext

シェルからなら次のとおりです。

claude plugin marketplace add drnachio/postext
claude plugin install postext@postext

#エージェントにインストールさせる

エージェントに頼むこともできます。たとえば「Postextの移植スキル(npx skills add drnachio/postext --skill postext-port)をインストールして、このPDFの移植に使って」と伝えます。https://postext.dev/llms.txtを読むエージェントは、そこからこのページとインストールコマンドを見つけます。

#スクリプトが使うツール

python3 -m pip install pymupdf pillow fonttools brotli numpy
brew install pandoc poppler
mkdir -p ~/.cache/postext-tools && cd ~/.cache/postext-tools && npm init -y && npm i postext postext-pdf postext-citeproc react @pdf-lib/fontkit @napi-rs/canvas

Pandocは、Word、PowerPoint、EPUB、HTMLの原稿に必要です。popplerは原稿のページ画像に、numpyはcomic_panels.pyに使います。Nodeのパッケージはヘッドレスレンダラーを動かします(Node 22.15以降)。@napi-rs/canvasはビルド済みのcanvasで、これがあれば本のページを直接JPEGに描画できます。任意で使うツールは、スキャン原稿用のocrmypdf、ImageMagick、PDF/UAの検査用のveraPDFです。

mkdir -p ~/.local/bin && curl -fL -o ~/.local/bin/postext https://github.com/drnachio/postext/releases/latest/download/postext-macos-arm64 && chmod +x ~/.local/bin/postext

お使いのシステムのファイルを選んでください(postext-macos-arm64, postext-macos-x64, postext-linux-x64, postext-linux-arm64, postext-linux-x64-musl, postext-windows-x64.exe)。Nodeがあればnpx postext-cliでも動きます。

作業のループはコマンドラインで回します。インストール不要の単体の実行ファイルです。エージェントはプロジェクトを展開したまま、作業中のページを対象にpostext build --watchを動かし続けるので、変更は長い本でもおよそ1秒後にJPEGとして現れます。Nodeのパッケージは任意で、Sandboxの追加の検査を行うrender.mjsを動かします。どちらも、設定の内容にかかわらずbodyText.shapingLanguage: 'host'で本をレイアウトするので、行の切れる位置がSandboxと違うことがあります(Sandboxとの違いを参照)。

#使い方

原稿のファイルを作業フォルダーに置き、移植を頼みます。たとえば次のように頼みます。

  • 「manual.pdfの1〜3章をPostextに移植して。2段組みのレイアウト、章扉、囲みを再現してほしい」
  • 「course.docxをPostextの本に変換して。スタイル'Nota'と'Actividad'は囲み」
  • 「deck.pptxをPostextの配布資料にして。スライドは節に、スピーカーノートは本文にする」
  • 「この教科書のInDesignパッケージ(IDMLと印刷用PDF)がある。第1章のPostextプリセットをスペイン語と英語で作って」

InDesignの本では、InDesignのファイル › パッケージが作るフォルダー(.idml、印刷用PDF、フォント、リンクされたアートワーク)をエージェントに渡してください。スキルはそれらからレイアウトの規則を割り出します。IDMLインポーターはそれをしません。2つの方法の比較はInDesign:読み込み、書き出し、移植にあります。

エージェントは次の流れで作業します。

  1. 要件。推測できないことを尋ねます。忠実な再現か作り直しか、見本の1章か本全体か、言語、印刷用か画面用か、そして本文、画像、フォントの権利です。
  2. 一覧と測定。原稿を読み、測った事実を仕様書にまとめます。仕上がりサイズ、余白、段、行送り、書体の役割、配色、章扉、柱、囲みの種類、配置の傾向です。あわせて各ページを、本文が流れるページと、囲みやラベルや地図を決まった位置に置くテンプレートページとに分けます。Postext 1.35以降では、テンプレートページを種類ごとにまとめ、種類ごとに1つのページテンプレートで組みます。そのため、レイアウトは原本どおりのまま、テキストは編集も翻訳もできます。それより前のバージョンでは、テンプレートページが全体の3分の1を超えるとき、原本どおりのレイアウトにするか、編集や翻訳ができるテキストにするかをたずねます。
  3. プロジェクト。my-book/のひな形を作ります。その中のbuild_preset.pyという生成スクリプトが仕様を定数として持ち、preset.jsonを作ります。
  4. コンテンツ。適切な抽出スクリプトで章の下書きを取り出し、PostextのMarkdownに整えます。囲み、段落スタイル、部、章扉のための見出し属性、:refによる参照、表と図のリソースです。
  5. 確認。プロジェクトをリンターにかけ、展開したプロジェクトでpostext build --watchを動かし続けます。章や設定を変え、およそ1秒後に描き直されたページのJPEGを見て、改ページ、図、囲みが原稿とページごとに一致するまで変更を繰り返します。節目ごとに、すべての検査(postext checkとリンター)を実行します。PDFは印刷向けの検査のために作るもので、見るたびに作るわけではありません。
  6. 納品。Folioビューアー用に本の用紙、綴じ、表紙を設定し、my-book.postextにまとめます。

結果はSandboxで開きます:本 › 新規 › .postextファイルを開く…。読み込まれるのは、Sandboxの言語に対応する章と文言です。Postextのローカルコピーでプロジェクトのフォルダーを扱うには、POSTEXT_PRIVATE_PRESETS_DIRを設定します(Sandboxを参照)。

#結果をコードから読み込む

納品されたファイルはSandboxに縛られません。postextパッケージはopenBundleでファイルを開き、buildBundleで本をレイアウトし、canvas、HTML、PDFに描画します(バンドルを参照)。つまり移植の結果をそのままプログラムに渡せます。そのプログラムの出力に調整が必要なときは、createBundleで.postextファイルに書き出し、Sandboxで微調整して、直したファイルを読み込み直します。スキルのヘッドレスなrender.mjsも、プロジェクトのフォルダーだけでなく、まとめた.postextファイルを受け付けます。

#期待できること

  • 抽出スクリプトが作るのは下書きで、仕上げるのはエージェントです。章ごとに、元のページと照らし合わせる見直しが1回入ると考えてください。品質はその見直しから生まれます。
  • 本文はMarkdownに置きます。設定が持つのはデザインだけで、本の言葉はすべて各章にあります。そのため、誤字の修正も翻訳もMarkdownの編集で済みます。Postext 1.35以降では、テンプレートページは設定の中のページテンプレートで、その枠に各章のMarkdownが流し込まれます。翻訳が長くなれば囲みが伸びて下の囲みを押し下げ、1.37からは地図上の地名もMarkdownに書くラベルになります。それより前のバージョンでは、位置を固定した囲み、文字を含まないページ画像、ラベルを実際のテキストとして残したSVGの図で組みます。どちらの方法を使ったか、どのバージョンで作業したかは報告に書かれます。設定に文字を書き込まない限りPostextで表現できないものがあれば、エージェントは作業を止め、その不足をissueの下書きにまとめてあなたに確認します。スキルが1冊の本に合わせてエンジンを変えることはありません。
  • すべての言語を1つのファイルに。翻訳版は同じ.postextファイルに入った一組の章で、キャプションや図のラベルもその言語で用意します。確認は言語ごとにpostext checkで行います。
  • 権利の判断はあなたが行います。ライセンスがはっきりしない画像やフォントを複製する前に、エージェントは確認を求めます。ライセンス付きのフォントにはredistributable: falseが付くので、書き出したプロジェクトには含まれません。
  • 大事なところで忠実に。目標は、ほとんどのページで同じグリッド、書体、章扉、囲み、図の配置、改ページを得ることです(ずれは1章につき1ページ以内)。改行位置まで同じにすることではありません。

#スキルの置き場所

スキルはリポジトリのplugins/postext/skills/postext-portにあります。Sandboxのプリセット(公開・非公開の両方)を作るなかで出会ったすべての事例を扱っています。まだ扱っていない事例に移植で出会ったら、スキルを改善するissueかプルリクエストをぜひ出してください。そうすれば、次の移植ではその改善がそのまま生かされます。