Postextドキュメント
目次
3部構成です。Postextとは何か、どのように作られているか。Postextが自動化する組版の技法。そしてPostextを使うための道具です。
部 I · 基礎
部 II · 技法
- 3設定読了時間: 5分Postextの設定のしくみと、20ページに分かれたリファレンスのどこで各設定を説明しているかの案内
- 3.1ページとレイアウト読了時間: 33分ページサイズ、余白、ベースライングリッド、ノンブル、段組みと段間
- 3.2柱とノンブル読了時間: 31分各ページの上下に印刷するものの設定。プレースホルダーを含むテキスト、罫線、ボックス、画像、ベクターのパス、奇偶ページごとの指定、そして各要素の配置
- 3.3本文読了時間: 28分本文の文字組み:フォント、サイズと行送り、色、インデント、引用ブロック、詩、タブ位置、ドロップキャップ
- 3.4ハイフネーションと言語読了時間: 23分ハイフネーションのパターンと例外、行末不ぞろいのテキスト、文書の言語とその数字と方向、Postextが組める文字体系
- 3.5見出し読了時間: 32分見出しの共通の既定値、レベルごとの上書き、見出しの前の改ページ、ページ幅いっぱいの章の書き出し、語で綴る番号
- 3.6オーファン、ウィドウ、段末そろえ読了時間: 22分段の区切りをまたいで行やブロックを離さない規則と、すべての段の終わりをそろえる調整手段
- 3.7リストと数式読了時間: 18分箇条書きリストと番号付きリスト、その行頭記号、字下げ、入れ子、タスクリスト、数式の大きさ、色、間隔
- 3.8注と参照読了時間: 27分脚注、行番号、相互参照と引用、目次、巻末の索引
- 3.9東アジアの組版読了時間: 32分cjkの設定:中国語、日本語、韓国語の行分割、約物の幅、アキ、文字グリッド、ルビ、各種の記号
- 3.10リソースと表読了時間: 45分リソースの種類とその番号付け、表とキャプションのスタイル、単色のダイアグラム、紙面上の動画
- 3.11スタイルと部読了時間: 45分段落、チップ、ハイライト、コードリスト、見出しの名前付きスタイルと、各部の扉ページ
- 3.12囲み読了時間: 27分:::calloutの囲みに付ける名前付きスタイル:枠線、背景、帯、タイトル、アイコン、外側のマーカー、ラベルのタブ、角ごとの半径・辺ごとの枠線・つながったタブによる囲みの形、番号付きの定理、囲みの中の文字組み、ページをまたいで分割された囲み、囲みの中に描くデザイン
- 3.13練習問題の設定読了時間: 12分練習問題スタイル(exerciseStyles)と本全体の練習問題の設定(exercises):番号のバッジ、指示文の書式、選択肢の記号と印、空欄、正誤の答え、線で結ぶ問題、語群、書き込み欄、マス目、わり算の筆算、難易度の印、アイコン、答えの色、解答を印刷する場所、教師用の版、画面の版
- 3.14漫画の設定読了時間: 8分comicsの設定:漫画のページの枠と間白、コマのスタイル、写植、吹き出しのスタイル、登場人物
- 3.15テンプレートページの設定読了時間: 10分テンプレートページのためのページテンプレート:枠、グループ、枠のセットを繰り返すグリッド、モジュール、装飾とコネクター、継承と左右ページのバリアント、画像のアンカーに付けるラベルスタイル、テンプレートが出す警告
- 3.16フォント、色、出力読了時間: 41分単位、色とカラーパレット、カスタムフォント、HTMLビューアー、PDFと入稿データ、Folioビューアー、そしてデバッグ用の表示
- 3.17プログラムからの利用読了時間: 32分コードからPostextを呼び出す方法。buildDocumentとその警告、既定値、フォント、キャッシュ、そしてWeb Worker
- 3.18PDFファイル読了時間: 34分コードから使うpostext-pdf:インストール、API、ブラウザーとNodeのフォントプロバイダー、CJKフォント、リソースのバイト列、縦組み、ワーカー、印刷入稿用のファイル
- 3.19HTML、Folio、EPUB、SCORM読了時間: 18分組み上がった本をWebページに入れる方法、postext-folioで3Dの本にする方法、postext-epubで固定レイアウトまたはリフロー型のEPUB 3にする方法、postext-scormでLMS向けのSCORMパッケージにする方法
- 3.20.postextバンドル読了時間: 29分コードから.postextファイルを開き、組み、描画し、作成する方法。多言語のバンドル、古いバージョンが書き出したファイル、低レベルのAPI
- 4ハイフネーションと両端そろえ読了時間: 43分PostextがKnuth-Plassアルゴリズムを使って行を分割し、テキストを両端そろえで組み、語間を制御するしくみ
- 5文書形式読了時間: 16分Postextが解析するMarkdownのサブセット。フロントマター、見出し、リスト、コードブロック、無視される記法、そしてソースを書くときの決まり
- 5.1ディレクティブ読了時間: 35分:::で始まるディレクティブの一覧。コンテナー、段組み、用紙、改ページ、番号付け、アキ、詩、目次と索引、段落内の改行、そして漫画のページの記法
- 5.2インライン書式と数式読了時間: 30分行の中の記号:強調、リンク、チップ、スモールキャピタル、タブ、縦組み、中国語と日本語の記号、文字方向、LaTeXの数式
- 5.3注と参照読了時間: 14分脚注、相互参照とアンカー、引用と参考文献、巻末の索引のマーク
- 5.4画像と表読了時間: 42分本文の中のリソース:参照と埋め込み、番号付け、配置とフロートが置かれる場所、回り込み、ビットマップのサイズ、セーフエリア、漫画のアンカー、キャプション中の記号
- 5.5動画読了時間: 10分動画リソース:YouTube、Vimeo、自前のファイルとHLSストリーム、出力ごとの表示、動画のフィールド、ポスター画像とアドレス、プレイヤー、VDTとバンドル、Folioのページで再生する動画
- 6中国語の組版読了時間: 32分Postextが中国語を横組みと縦組みで組む方法。地域、禁則処理、約物の幅、字間による両端そろえ、文字グリッド、右綴じの本、縦中横、符号、ルビ、割注、漢数字、フォント
- 7アラビア語の組版読了時間: 29分Postextがアラビア語を組むしくみ。書字方向と双方向アルゴリズム、右綴じの本、切ることも字間を空けることもない連結した語、カシーダによる両端そろえ、母音記号と強調、数字・番号の書式・序数の語、脚注と古典詩、目次・索引・引用、フォント
- 8日本語の組版読了時間: 34分Postextが日本語を縦組みと横組みで組む方法。日本の地域設定、禁則処理、約物のアキ、段落先頭の括弧、縦組み用の字形、ルビ、圏点と傍線、漢文訓読、番号付け、行取りの見出し、注、五十音順の索引、引用、フォント、青空文庫のテキスト
- 9漫画読了時間: 37分PostextでMarkdownから漫画とコミックを組むしくみ。割り方の木によるコマ割り、セーフエリアを残すコマの絵のトリミング、台本から作る写植(セリフ、思考、ささやき、叫び、無線、ナレーション、描き文字)と吹き出しのスタイル、絵に置く話者のアンカー、本文中の帯漫画と見開き、右から左に読むページと縦組みの写植、翻訳、そしてCanvas・PDF・HTML・EPUBへの出力
- 10楽譜読了時間: 12分Postext が本の中に楽譜を組む方法:ABC、MusicXML、MEI、Humdrum のテキストで書いた記譜を段の幅で浄書し、段や頁をまたいで続く段(システム)に分けること、番号付き譜例をリソースとして扱うこと、楽譜スタイル、各出力、音楽出版社が楽譜を持ち込む手順
- 11練習問題読了時間: 16分Postext が教科書やドリルの練習問題を組む方法::::exercise ブロック、選択問題から筆算までの12種類、Markdown に書く答え、番号、問題の直後・逆さま・章末・巻末に置く解答、教師用の赤刷り版、検査、HTML と EPUB の画面で解ける練習問題、テスト用の制限、SCORM パッケージで LMS に送る結果
- 12テンプレートページ読了時間: 41分テンプレートページをMarkdownで書く方法:コロン4つで始めて使うテンプレートを指定するページブロック、内容をテンプレートの各枠に振り分ける枠とslot属性、繰り返すスロットとモジュール、そして内容がテンプレートに合わないときやほかの枠を覆うときに出る警告
- 12.1ラベル付きの図読了時間: 8分画像の上に文字を置く図:リソースのアンカーに置くラベル、図ごとの代替テキスト・キャプション・注記、ラベルの組み方、引き出し線で結ぶ離れたラベル、凡例とインラインの記号、ラベルの警告
- 13特殊インキと抜き加工読了時間: 14分5色目のインキ、加工を指定した特色としてのメタリックインキ、蛍光インキ、箔押し、不透明ホワイト、ニス。抜き加工:1丁または複数の丁を貫く穴、角丸、型抜きの本、PDFでの抜き型の線、プリフライト、各ビューアーでの表示
部 III · 実践
- 14貢献読了時間: 7分Postextのコミュニティに参加し、プロジェクトに貢献する方法
- 15Sandbox読了時間: 34分Sandboxの画面構成。アクティビティバー、本文・本・章・リソース・フォントの各パネル、そしてスマートフォンでの表示
- 15.1デザインパネルと検査パネル読了時間: 39分デザインパネルのグループ、ページ、検索、概要と、検査パネルが種類ごとにまとめて示すその場の警告
- 15.2テンプレートページ読了時間: 21分ページ上でのページテンプレートと枠の編集、コネクターと図形、引き出し線・指示線・凡例、グリッド、モジュールとそのライブラリー、枠の組み替え、重なりの検査とタブのグリフ、枠のスタイルのライブラリー、すべての版でのテンプレートページの検査、本のテキストのMarkdownへの移行、そしてワンクリックでの枠の修正
- 15.3プレビュー読了時間: 15分メインビューポートのCanvas、PDF、Folio、HTML、EPUB 3、SCORMタブ:それぞれが表示するものと、できること
- 15.4本、Wordファイル、保存読了時間: 41分本と章、漫画のページの編集、Word文書の読み込みと書き出し、Sandboxが作業を保存し、書き出し、読み込むしくみ
- 15.5エージェント、埋め込み、プリセット読了時間: 13分AIエージェント向けのWebMCPツール、自分のアプリに組み込むPostextSandboxコンポーネント(propsとCSS)、そしてプリセットバンドルの形式
- 16テンプレートページで作る本読了時間: 22分テンプレートページでできた小学校の教科書を、Sandboxで作る手順。ページテンプレートの作成、Markdownからの流し込み、地図のラベル、ページの翻訳、収まらない文章の直し方、ページと本文の行き来、さらにコネクターで結ぶ木、指示線と凡例を付けた地図の注記、写真カードのグリッド、シリーズで使うモジュールライブラリー
- 17テンプレートページへの移行読了時間: 13分見出しスタイルにページのテキストを入れている本をページテンプレートとMarkdownへ移す方法、Sandboxのアシスタント「テキストをMarkdownへ移す」と手作業の2つのやり方、移したあとに確かめること、そして画像に描き込まれた線をコネクターに、1つずつ描いた枠をグリッドとモジュールに置き換える方法
- 18InDesign読了時間: 10分InDesignの本をPostextに移す2つの方法、つまり文書の中身をそのまま写すIDMLインポーターと、レイアウトの規則を割り出すエージェントスキルの違いと使い分け、そしてIDMLエクスポーターで本をInDesignに戻す方法
- 19スキル読了時間: 10分Claude Code、Codexなどのエージェントにpostext-portスキルを入れ、PDF、Word、PowerPoint、EPUB、InDesign、HTMLの原稿を、元のレイアウトに沿ったPostextプロジェクトに変換させる方法
- 20コマンドライン読了時間: 14分macOS、Linux、Windowsで動く、自己完結した1つの実行ファイル。.postextの本、本のフォルダー、ばらのMarkdownからのPDF、HTML、EPUB、ページ画像、Word文書の作成、バンドルの作成、本の検査、そしてスクリプトやエージェント向けのJSON出力、PythonとRustのパッケージからの利用
- 21WebMCP読了時間: 13分ブラウザーで動くAIエージェントが64のWebMCPツールでSandboxに対してできること(ページを見る、どの設定でも変える、本文を編集する、画像・表・フォントを加える、検査する、書き出す)と、実際の引数と応答で示す各ツールの呼び出し方