latex-build

LaTeX ビルドの自動化

自己進化型スキル：このスキルは使用するたびに改善されます。手順が間違っている、パラメーターにずれがある、または回避策が必要だった場合は、先送りせず、すぐにこのファイルを修正してください。実際に再現できる問題がある場合のみ更新してください。

このスキルを使用する場面

次のような場合にこのスキルを使用します。

• LaTeX ドキュメントをコンパイルする
• 自動再ビルドを行うライブプレビューを設定する
• 複数ファイルのプロジェクトを管理する
• ビルドの失敗をトラブルシューティングする
• ビルド成果物を削除する
• コンパイルのワークフローを自動化する

クイックリファレンス

latexmk を使う理由

業界標準のビルドツールです。

• 依存関係（参考文献、索引など）を自動検出します
• 適切な回数だけ実行します（相互参照を処理します）
• ライブプレビューモードでは、ファイルの変更を監視します
• SyncTeX の自動再読み込みで Skim と連携します
• MacTeX に同梱されているため、別途インストールする必要はありません

---

基本的な使い方

1 回限りのビルド

latexmk -pdf document.tex
# Result: document.pdf created

ライブプレビュー（監視モード）

latexmk -pvc -pdf document.tex

# What happens:
# - Compiles document initially
# - Watches for file changes
# - Auto-recompiles when files change
# - Auto-reloads PDF in Skim viewer

監視の停止： Ctrl+C を押します

---

クイックリファレンスカード

# Build once
latexmk -pdf document.tex

# Live preview (watch mode)
latexmk -pvc -pdf document.tex

# Build with SyncTeX
latexmk -pdf -synctex=1 document.tex

# Clean artifacts
latexmk -c              # Keep PDF
latexmk -C              # Remove PDF too

# Force rebuild
latexmk -gg -pdf document.tex

# Non-interactive (for CI)
latexmk -pdf -interaction=nonstopmode document.tex

---

ビルドのチェックリスト

• latexmk がインストールされていることを確認します：which latexmk
• 基本的なビルドをテストします：latexmk -pdf document.tex
• SyncTeX を有効にします：-synctex=1 フラグを追加します
• ライブプレビューをテストします：latexmk -pvc -pdf document.tex
• Skim の自動再読み込みを設定します
• よく使うタスク用の Makefile を作成します（任意）
• プロジェクト固有の設定用に .latexmkrc を作成します（任意）
• クリーン処理をテストします：latexmk -c で成果物を削除します

---

リファレンスドキュメント

詳しくは、次のドキュメントを参照してください。

• よく使うコマンド - ビルドオプションと出力形式
• 複数ファイルのプロジェクト - 複雑なドキュメントの依存関係を自動追跡
• 設定 - .latexmkrc と Makefile の連携
• トラブルシューティング - よくあるビルドの問題と解決策
• 高度なパターン - 並列ビルドと CI/CD との連携

公式ドキュメント：完全なリファレンスは man latexmk または latexmk -help を実行してください

関連項目：

• LaTeX のインストールと環境設定には latex/setup スキルを使用します
• tabularray を使った表の作成には latex/tables スキルを使用します

---

トラブルシューティング

問題	原因	解決策
latexmk が見つからない	PATH に含まれていない	/Library/TeX/texbin を PATH に追加します
未定義の制御綴り	パッケージが不足している	必要なパッケージを \usepackage 文で確認します
参照が ?? と表示される	複数回の実行が必要	latexmk が自動的に処理します。エラーがないことを確認してください
ライブプレビューが更新されない	Skim の自動再読み込みが無効	Skim Preferences → Sync → Check for file changes を確認します
ビルドが停止しない	nonstop モードで入力を求められている	-interaction=nonstopmode フラグを使用します
PDF が更新されない	ビルドエラーで出力が妨げられている	.log ファイルで具体的なエラーを確認します
SyncTeX が動作しない	-synctex=1 フラグがない	ビルドコマンドに -synctex=1 を追加します
aux ファイルが多すぎる	通常のビルド成果物	latexmk -c を実行してクリーンアップします（PDF は保持されます）

実行後の振り返り

このスキルの実行が完了したら、終了する前に次の点を確認してください。

1. コマンドは成功しましたか？ — 成功しなかった場合は、失敗の原因となった手順またはエラー表を修正してください。
2. パラメーターや出力に変更はありましたか？ — 基盤となるツールのインターフェースに変更があった場合は、使用例とパラメーター表を更新して合わせてください。
3. 回避策が必要でしたか？ — 即興の対応（異なるフラグや追加手順など）が必要だった場合は、次回同じ回避策が不要になるよう、この SKILL.md を更新してください。

問題が実際に再現できる場合のみ更新してください。推測に基づく更新はしないでください。