latex-scaffold

LaTeX スキャフォールド

トリガーとルーティング

• トリガー: latex scaffold、md→tex、LaTeX 项目骨架、生成 main.tex.
• 使用する場面: LaTeX/PDF での納品が必要（例：arxiv-survey-latex パイプライン）で、ドラフトが生成済み、または執筆段階に入っている場合です。

承認済みの Markdown ドラフトを、最小限のビルド可能な LaTeX プロジェクトに変換します。

これは決定論的な変換ステップです。文章の品質は、あらかじめ output/DRAFT.md で整えておいてください。

入力

• output/DRAFT.md または output/TUTORIAL.md
• 任意：citations/ref.bib

出力

• latex/main.tex（および必要な LaTeX サポートファイル）

レイアウトポリシー

機械可読なレイアウト契約は assets/layout_profiles.json にあります。 デフォルトプロファイルでは、A4 用紙に 1in の余白を設定し、目次を含め、大きな表は分割する場合があります。制約付きの course_paper プロファイルでは、文書化された A4 用紙の 0.9in の余白を設定し、目次を省略し、可能な場合はコンパクトな表を分割せずに保ち、参考文献のみに \small を設定します。本文は 11pt のままです。 このプロファイルは、明示されたページ範囲を守ることを目的としており、論文を縮小して実質的な内容を補うものではありません。

ワークフロー

1. latex/ ディレクトリが存在しない場合は作成します。
2. アウトラインに対応するセクションを含む latex/main.tex を作成します。
3. citations/ref.bib が存在する場合は、参考文献を接続します。

品質チェックリスト

• latex/main.tex が存在する。
• citations/ref.bib が存在する場合、latex/main.tex から参照されている。

スクリプト

クイックスタート

• uv run python .codex/skills/latex-scaffold/scripts/run.py --help
• uv run python .codex/skills/latex-scaffold/scripts/run.py --workspace <workspace>

すべてのオプション

• --help を参照してください（パイプライン経由で使用する場合、入出力はユニットランナーから取得されます）

例

• output/DRAFT.md または output/TUTORIAL.md から latex/main.tex をビルドします：
  • uv run python .codex/skills/latex-scaffold/scripts/run.py --workspace <workspace>

注記

• 生成される latex/main.tex には、読みやすさのために目次（tocdepth=2）が含まれます。
• course_paper プロファイルでは、assets/layout_profiles.json の設定に従って目次が省略されます。それ以外のプロファイルでは、デフォルトで目次が含まれます。
• 言語のデフォルト：スキャフォールドでは article を使用します（英語形式の表紙部分）。ドラフトに CJK 文字が含まれている場合は、PDF が正しくレンダリングされるよう ctexart に切り替えます。
• 変換ルール（概要）：
  • 見出し ##/###/#### → \section/\subsection/\subsubsection（1.2 のような先頭の番号プレフィックスを削除します）。
  • Appendix / 附录 で始まる見出しは、一度だけ \appendix を呼び出した後、付録のセクションとして出力します。
  • Markdown の表の直前にある **Table 1. ...** / **Appendix Table A1. ...** のような太字のキャプション行は、\caption{...} と安定した \label{tab:...} を持つ LaTeX の table フロートになります。
  • ## Abstract → abstract 環境。
  • [@Key] または [@Key1; @Key2] → \citep{Key} / \citep{Key1,Key2}。
  • インライン Markdown の **bold** / *italic* / `code` → \textbf{} / \emph{} / \texttt{}。

トラブルシューティング

問題：生成された latex/main.tex に Markdown の記号が残っている

対処方法:

• latex-scaffold を再実行し、入力の output/DRAFT.md が整っていることを確認してください（##、**、および未対応の [@...] 構文がない状態にします）。

問題：LaTeX で引用が欠落している

対処方法:

• citations/ref.bib が存在し、スキャフォールドでそのファイルが参考文献として指定されていることを確認してください。その後、latex-compile-qa でコンパイルします。