ビルドとコンパイル
ビルドシステムの概要
TeX64はlatexmkエンジンを使用してLaTeX文書をコンパイルします。latexmkは自動的に必要な中間パスを管理し、参考文献やインデックスなど複雑な構成を処理します。
すべてのビルドはあなたのマシン上でローカルに実行されるため、インターネット接続を必要としません。TeX64はオフラインモードで完全に動作し、セキュリティとプライバシーを守ります。コンパイルプロセスは高速で透過的です。
ビルド方法
ビルドの開始は非常にシンプルです。以下のいずれかの方法を使用できます：
- ツールバーボタン — ウィンドウ上部のビルドボタン（再生アイコン）をクリックします。Cmd+B はエディタで \textbf{} を入力するために予約されています。
- クリーンビルド — Settings > Build Profile を開き、Clean をクリックします。生成物も削除したい場合は Clean -C を使用します。
ビルドが完了すると、PDFプレビューが自動的に更新されます。
ビルドプロセス
ビルドプロセス中は、latexmkが以下を自動的に管理します：
- 複数パスのコンパイル — LaTeX は通常 2～3 回実行されて相互参照を解決します
- BibTeX/Biber — bibliography エントリを自動的に処理します
- インデックス生成 — makeindex または xindy を実行してインデックスを構築します
- 相互参照 — \ref, \cite, \pageref などのコマンドが正しく解決されます
- 変更検出 — ファイルが変更されていない場合はビルドをスキップして時間を節約します
コンパイルの進行状況とビルド出力は、専用のログパネルにリアルタイムで表示されます。ビルドのどの段階にいるかを常に確認できます。
ルートファイル選択
マルチファイルプロジェクトでは、どの.texファイルをメインファイル（ルートファイル）として使用するかが重要です。TeX64は\documentclassコマンドを検査することで、自動的にルートファイルを検出します。
ほとんどの場合、自動検出は正しく機能します。ただし、複雑なプロジェクト構造では、プロジェクト設定からルートファイルを手動で指定することもできます。
ビルドは常にルートファイルから開始されます。その他のすべてのファイルは \input または \include コマンドを使用してルートファイルから参照される必要があります。
ビルドプロファイル
TeX64では複数のビルドプロファイルを設定でき、異なるLaTeXエンジン間で簡単に切り替えることができます。各プロファイルは異なるエンジンやカスタムオプションを使用できます。
プロファイルはプロジェクト設定で作成・管理できます。各プロファイルには、プロファイル名、使用するエンジン、カスタムフラグを設定します。
プロファイルは以下のような場合に便利です：
- 異なるエンジンで同じ文書をテストする（例：pdflatex vs xelatex）
- 本番用と草稿用の異なるビルド設定を保持する
- プリセンテーション用にカスタムエンジンオプションを使用する
サポートされているエンジン
TeX64は以下の主要なLaTeXエンジンをサポートしています：
pdflatex
pdflatexは最も一般的で確立されたエンジンです。ほぼすべてのLaTeXパッケージとテンプレートが対応しており、最高の互換性を提供します。PDFを直接生成し、高速です。
使用対象：一般的なアカデミック論文、技術文書、本など。ほとんどのプロジェクトはpdflatexで問題なく動作します。
xelatex
xelatexはUnicodeとシステムフォントをネイティブサポートします。非ラテン文字（中国語、日本語、アラビア語など）を扱う場合に最適です。システムにインストールされているフォントを直接使用できます。
使用対象：多言語文書、複雑な文字体系を含むドキュメント。pdflatexで文字エンコーディングの問題が発生する場合。
lualatex
lualatexはLua スクリプト機能と優れたフォント処理を備えた最新のエンジンです。OpenType フォントをネイティブサポートし、複雑なタイポグラフィ制御が可能です。
使用対象：最新のテクノロジーとLuaマクロを活用したプロジェクト。高度なフォント処理が必要な場合。多くの場合、xelatexと同様の用途に使用できます。
カスタムlatexmkフラグ
高度なユーザーは、カスタムlatexmkフラグを追加してビルド動作をさらに細かく制御することができます。これらのフラグはプロジェクト設定で指定します。
一般的なフラグには以下が含まれます：
-shell-escape— \write18 コマンドを有効にして、LaTeX 内から外部プログラムを実行できます（Minted などのパッケージに必要）-interaction=nonstopmode— エラーで停止せずに、コンパイルを続行します-output-directory=— PDF や中間ファイルを別のディレクトリに出力します-pdf— pdflatex またはその他の PDF 出力生成エンジンを強制します
コンパイルログ
コンパイルログは、ビルドプロセスの完全な出力を表示します。TeX64はログを解析し、エラーと警告を色分けして強調表示します。これにより、何が問題なのかを一目で確認できます。
- エラー — 赤色で強調表示されます。ビルドが失敗します
- 警告 — 黄色またはオレンジで強調表示されます。ビルドは成功しますが、出力品質に影響する可能性があります
- メッセージ — グレーで表示されます。ビルドプロセスの進行状況に関する情報提供です
ログ内のエラーや警告をクリックすると、ソースコード内の対応する行へ自動的にジャンプします。ファイル名と行番号がハイライトされ、問題を素早く特定して修正できます。
エラー解析
TeX64は LaTeX エラーを自動的に解析して、適切なファイルと行番号を特定します。
一般的なエラーパターンには以下が含まれます：
- Undefined control sequence — コマンドが定義されていないか、タイプミスがあります
- Missing \endcsname inserted — 通常、開き括弧または閉じ括弧の不一致が原因です
- File not found — \input または \include で参照されたファイルが見つかりません
- Package not found — \usepackage で指定されたパッケージがインストールされていません
- Runaway argument — 通常、コマンド引数の括弧が閉じられていません
LaTeX はしばしば後続のエラーを連鎖的に生成するため、最初のエラーを見つけることが重要です。ログの最初の赤いエラーを修正すると、多くの場合、その後のエラーも解決されます。
AI支援デバッグ
TeX64のAI機能はコンパイルログを分析して、エラーの原因と解決方法を提案することができます。複雑なLaTeXエラーメッセージを理解するのに役立ちます。
ビルドが失敗した後、AI デバッグ機能を使用するには：
- コンパイルログパネルの「AI に相談」ボタンをクリックします
- TeX64 は完全なエラーコンテキストを AI に送信します
- AI は可能な原因と修正方法を提案します
AI の提案は常に正しいとは限りませんが、通常は良い出発点を提供します。専門的な TeX 知識がない場合でも、複雑なエラーを理解するのに役立ちます。
環境診断
TeX64は起動時に、ビルドに必要なツールがすべてインストールされているかチェックします。以下のツールを確認します：
- latexmk — LaTeX コンパイル自動化エンジン（必須）
- TeX distribution — TeX Live、MacTeX、MiKTeX などの TeX 実装（必須）
- latexindent — LaTeX コード整形ツール（オプション、推奨）
- synctex — ソースコードと PDF の同期（オプション、推奨）
いずれかのツールが見つからない場合、TeX64は警告を表示し、インストール方法のガイダンスを提供します。
クリーンビルド
クリーンビルドは、中間ファイルをすべて削除してから、ドキュメントを再ビルドします。
クリーンビルドによって削除されるファイルには以下が含まれます：
.aux— 補助ファイル（相互参照などを含む）.log— ビルドログ.toc— 目次ファイル.lof, .lot— 図表一覧ファイル.bbl, .blg— 参考文献ファイル.fdb_latexmk— latexmk のファイル依存データベース
クリーンビルドを使用すべき場合：
- ビルドが奇妙な中間状態にあり、通常のビルドでは修正されない場合
- 大幅な構造変更を行った後（例：章を追加/削除した場合）
- クロスリファレンス番号が古いままのようなキャッシング問題がある場合
- プロジェクト設定やエンジンオプションを変更した後
インクリメンタルコンパイル
デフォルトでは、TeX64は「インクリメンタルコンパイル」を使用します。latexmkは変更されたファイルを追跡し、必要なパスだけを再実行します。
これにより、小さな変更を加えた後のビルド時間が大幅に短縮されます。latexmk は内部的に依存関係を追跡し、本当に必要な場合だけ完全な再ビルドを実行します。
インクリメンタルコンパイルが機能しない場合は、クリーンビルドを試してください。
ビルドのトラブルシューティング
ビルドが失敗する場合、以下のことを確認してください：
「ルートファイルが見つかりません」
- ルートファイルが正しく設定されているか確認してください。マルチファイルプロジェクトでは、\documentclassコマンドを含むファイルをビルドする必要があります。
- ルートファイルが削除されていないか確認してください。
エラーメッセージ
- コンパイルログを見て、最初のエラーメッセージを探してください。ログの最後のエラーではなく、最初のエラーから始めて、一つずつ修正してください。
- AI デバッグ機能を使用して、複雑なエラーメッセージを分析してもらいます。
パッケージが見つかりません
- 必要なパッケージが \usepackage でロードされているか確認してください。
- TeX64 はパッケージが見つからないエラーを表示します。エラーメッセージの指示に従って、パッケージをインストールします。
- macOS では、MacTeX をインストールするだけで、ほとんどのパッケージが自動的に利用可能になります。
メモリエラー
- リソースの問題がないか確認してください。大きな画像を多く含む文書では、メモリが不足してビルドが失敗することがあります。
- 画像を圧縮したり、サイズを小さくしたりして、リソース使用量を削減してください。
- または、複数の小さな PDF に分割してビルドしてから、後で結合してください。
遅いビルド
- インクリメンタルコンパイルが機能していることを確認してください。大きな変更後は、クリーンビルドが必要な場合があります。
- 複雑なグラフィックスやレイアウトは、コンパイル時間を大幅に増加させることがあります。
パフォーマンスのヒント
ビルド時間を短縮するための一般的な戦略は以下の通りです：
- ドラフトモード — \documentclass に draft オプションを追加して、画像を処理せずにテキストレイアウトのみを高速にコンパイルできます
- 選択的コンパイル — \includeonly を使用して、特定の章のみをコンパイルします
- 外部画像の最適化 — 大きなビットマップ画像を PDF に変換したり、サイズを小さくしたりします
- フォント選択 — Computer Modern フォント（デフォルト）の方が、複雑なシステムフォントより高速です
- TikZ/PGFPlots の最適化 — 複雑な図を個別に PDF に事前コンパイルして、\includegraphics で取り込みます
これらのテクニックを組み合わせることで、大規模プロジェクトのビルド時間を大幅に短縮できます。