minimax-pdf

3つのタスク。1つのスキル。

CREATE または REFORMAT の作業を行う前に design/design.md を読んでください。

---

ルートテーブル

ユーザーの意図	ルート	使用スクリプト
新規 PDF をゼロから生成	CREATE	palette.py → cover.py → render_cover.js → render_body.py → merge.py
既存 PDF のフォームフィールドを入力・完成させる	FILL	fill_inspect.py → fill_write.py
既存ドキュメントを再フォーマット・再スタイル	REFORMAT	reformat_parse.py → 全 CREATE パイプライン

ルール： CREATE と REFORMAT の間で判断に迷ったら、ユーザーが開始する既存ドキュメントを持っているかどうかを確認してください。はい → REFORMAT。いいえ → CREATE。

---

ルート A: CREATE

完全なパイプライン — コンテンツ → デザイントークン → カバー → 本文 → 結合 PDF。

bash scripts/make.sh run \
  --title "Q3 Strategy Review" --type proposal \
  --author "Strategy Team" --date "October 2025" \
  --accent "#2D5F8A" \
  --content content.json --out report.pdf

ドキュメントタイプ： report · proposal · resume · portfolio · academic · general · minimal · stripe · diagonal · frame · editorial · magazine · darkroom · terminal · poster

タイプ	カバーパターン	ビジュアルアイデンティティ
report	fullbleed	暗い背景、ドットグリッド、Playfair Display
proposal	split	左パネル + 右幾何学模様、Syne
resume	typographic	超大型の最初の単語、DM Serif Display
portfolio	atmospheric	ほぼ黒、放射状の光、Fraunces
academic	typographic	明るい背景、古典的なセリフ、EB Garamond
general	fullbleed	暗いスレート、Outfit
minimal	minimal	白 + 単一の 8px アクセントバー、Cormorant Garamond
stripe	stripe	3 つの大胆な水平カラーバンド、Barlow Condensed
diagonal	diagonal	SVG 傾斜カット、暗/明の半分、Montserrat
frame	frame	インセットボーダー、コーナー装飾、Cormorant
editorial	editorial	ゴーストレター、全大文字タイトル、Bebas Neue
magazine	magazine	温かいクリーム色背景、センター積み重ね、ヒーロー画像、Playfair Display
darkroom	darkroom	紺背景、センター積み重ね、グレースケール画像、Playfair Display
terminal	terminal	ほぼ黒、グリッドライン、モノスペース、ネオングリーン
poster	poster	白背景、太いサイドバー、超大型タイトル、Barlow Condensed

カバーエクストラ（--abstract、--cover-image でトークンに挿入）：

• --abstract "text" — カバー上のアブストラクトテキストブロック（magazine/darkroom）
• --cover-image "url" — ヒーロー画像の URL/パス（magazine、darkroom、poster）

カラーオーバーライド — ドキュメントコンテンツに基づいて常にこれらを選択してください：

• --accent "#HEX" — アクセントカラーをオーバーライド；accent_lt は白方向への軽量化により自動導出
• --cover-bg "#HEX" — カバー背景色をオーバーライド

アクセントカラー選択ガイダンス：

アクセントカラーについて、あなたは創造的な権限を持っています。ドキュメントのセマンティックコンテキスト — タイトル、業界、目的、対象者 — から選択してください。汎用的な「安全な」選択からではなく。アクセントはセクションルール、コールアウトバー、テーブルヘッダー、およびカバーに表示されます。これはドキュメントのビジュアルアイデンティティを担います。

コンテキスト	推奨アクセント範囲
法務 / コンプライアンス / 金融	深紺 #1C3A5E、チャコール #2E3440、スレート #3D4C5E
ヘルスケア / 医療	ティール緑 #2A6B5A、クール緑 #3A7D6A
テクノロジー / エンジニアリング	スチールブルー #2D5F8A、インディゴ #3D4F8A
環境 / サステナビリティ	フォレスト #2E5E3A、オリーブ #4A5E2A
クリエイティブ / アート / カルチャー	バーガンディ #6B2A35、プラム #5A2A6B、テラコッタ #8A3A2A
アカデミック / リサーチ	深いティール #2A5A6B、ライブラリブルー #2A4A6B
コーポレート / ニュートラル	スレート #3D4A5A、グラファイト #444C56
ラグジュアリー / プレミアム	ウォームブラック #1A1208、深いブロンズ #4A3820

ルール： このドキュメント特有に思慮深いデザイナーが選ぶようなカラーを選んでください — タイプのデフォルトではなく。ミュート、くすんだトーンが最適です；鮮やかなプライマリカラーは避けてください。判断に迷ったら、より暗く、より中立的に選んでください。

content.json ブロックタイプ：

ブロック	用途	キーフィールド
h1	セクション見出し + アクセントルール	text
h2	サブセクション見出し	text
h3	サブサブセクション（太字）	text
body	均等配置段落；<b> <i> マークアップをサポート	text
bullet	順序なしリストアイテム（• プレフィックス）	text
numbered	順序付きリストアイテム — カウンター自動リセット（非番号付きブロック時）	text
callout	アクセント左バー付きのハイライト表示インサイトボックス	text
table	データテーブル — アクセントヘッダー、交互行ティント	headers、rows、col_widths?、caption?
image	埋め込み画像（列幅にスケーリング）	path/src、caption?
figure	自動番号付き「Figure N:」キャプション付き画像	path/src、caption?
code	アクセント左ボーダー付きモノスペースコードブロック	text、language?
math	表示数学 — LaTeX 構文（matplotlib mathtext）	text、label?、caption?
chart	matplotlib でレンダリングされたバー / 折れ線 / 円グラフ	chart_type、labels、datasets、title?、x_label?、y_label?、caption?、figure?
flowchart	ノード + エッジ付きプロセス図（matplotlib）	nodes、edges、caption?、figure?
bibliography	ハンギングインデント付き番号付き参考文献リスト	items [{id, text}]、title?
divider	アクセント色フルサイズルール	—
caption	小さいミュートレーベル	text
pagebreak	新しいページを強制	—
spacer	垂直空白	pt (デフォルト 12)

chart / flowchart スキーマ：

{"type":"chart","chart_type":"bar","labels":["Q1","Q2","Q3","Q4"],
 "datasets":[{"label":"Revenue","values":[120,145,132,178]}],"caption":"Q results"}

{"type":"flowchart",
 "nodes":[{"id":"s","label":"Start","shape":"oval"},
          {"id":"p","label":"Process","shape":"rect"},
          {"id":"d","label":"Valid?","shape":"diamond"},
          {"id":"e","label":"End","shape":"oval"}],
 "edges":[{"from":"s","to":"p"},{"from":"p","to":"d"},
          {"from":"d","to":"e","label":"Yes"},{"from":"d","to":"p","label":"No"}]}

{"type":"bibliography","items":[
  {"id":"1","text":"Author (Year). Title. Publisher."}]}

---

ルート B: FILL

レイアウトやデザインを変更せずに、既存 PDF のフォームフィールドに入力します。

# ステップ 1: インスペクト
python3 scripts/fill_inspect.py --input form.pdf

# ステップ 2: 入力
python3 scripts/fill_write.py --input form.pdf --out filled.pdf \
  --values '{"FirstName": "Jane", "Agree": "true", "Country": "US"}'

フィールドタイプ	値の形式
text	任意の文字列
checkbox	"true" または "false"
dropdown	インスペクト出力の選択肢の値と一致する必要があります
radio	ラジオ値と一致する必要があります（多くの場合 / で始まります）

正確なフィールド名を取得するために、常に最初に fill_inspect.py を実行してください。

---

ルート C: REFORMAT

既存ドキュメントをパース → content.json → CREATE パイプライン。

bash scripts/make.sh reformat \
  --input source.md --title "My Report" --type report --out output.pdf

サポートされている入力形式： .md .txt .pdf .json

---

環境

bash scripts/make.sh check   # すべての依存関係を確認
bash scripts/make.sh fix     # 不足している依存関係を自動インストール
bash scripts/make.sh demo    # サンプル PDF をビルド

ツール	使用者	インストール
Python 3.9+	すべての .py スクリプト	システム
reportlab	render_body.py	pip install reportlab
pypdf	fill、merge、reformat	pip install pypdf
Node.js 18+	render_cover.js	システム
playwright + Chromium	render_cover.js	npm install -g playwright && npx playwright install chromium