latex-setup

LaTeX 環境のセットアップ

研究者が LaTeX のコンパイル環境をセットアップまたは修正できるよう支援します。パッケージの一覧を固定で指定せず、実際に必要なものを検出してインストールしてください。

ステップ 1：現在の状態を検出する

インストールを始める前に：

1. インストール済みの TeX ディストリビューションを確認する：

   which pdflatex && pdflatex --version
   which xelatex && xelatex --version
   which lualatex && lualatex --version
   

2. 文献処理ツールを確認する：

   which biber && biber --version
   which bibtex && bibtex --version
   

3. パッケージマネージャーを確認する：

   which tlmgr && tlmgr --version
   

ステップ 2：プロジェクトを分析する

メインの .tex ファイルを読み、必要なものを特定します：

1. ドキュメントクラス： \documentclass{article}、\documentclass{IEEEtran} など
2. 文献管理システム：
   • \usepackage{biblatex} → biber が必要です
   • \usepackage{natbib} または \bibliographystyle{...} → bibtex が必要です
3. 必要なパッケージ：すべての \usepackage{...} 宣言から抽出します
4. 特別な要件：TikZ、minted（pygments が必要）、algorithm2e など

ステップ 3：投稿先のテンプレートを検出する

ユーザーが投稿先に言及した場合は、公式テンプレートを検索します：

• 投稿先の公式ウェブサイトからダウンロードします（サードパーティのミラーは使用しません）
• テンプレートで必要な TeX ディストリビューションやクラスが指定されているか確認します
• 投稿先固有のコンパイル手順があれば記録します

一般的な投稿先と要件：

投稿先	クラス	文献管理システム	備考
CVPR/ECCV	カスタムクラスファイル	bibtex	通常はテンプレートに含まれています
NeurIPS	neurips_20XX.sty	natbib + bibtex	スタイルファイルは毎年変更されます
ICLR	iclr20XX_conference.sty	natbib + bibtex	OpenReview 形式
ACL/EMNLP	acl.cls	bibtex	ACL Anthology 形式
IEEE	IEEEtran.cls	bibtex	列の書式設定は固有です
Springer	llncs.cls	bibtex または biblatex	シリーズによって異なります

ステップ 4：不足しているコンポーネントをインストールする

分析結果に基づいて、不足しているものだけをインストールします：

Ubuntu/Debian の場合

# Base installation (if nothing installed)
sudo apt install texlive-base texlive-latex-recommended

# Common extras
sudo apt install texlive-latex-extra  # most \usepackage needs
sudo apt install texlive-fonts-recommended texlive-fonts-extra
sudo apt install texlive-bibtex-extra biber  # if biblatex used
sudo apt install texlive-science  # algorithm2e, etc.

macOS の場合

# Full installation (recommended)
brew install --cask mactex

# Minimal
brew install --cask basictex
sudo tlmgr update --self
sudo tlmgr install <package-name>

tlmgr を使って個別のパッケージをインストールする場合

# If specific packages are missing
sudo tlmgr install <package-name>

ステップ 5：コンパイルを設定する

適切なコンパイル手順を設定します：

bibtex を使うプロジェクトの場合

pdflatex main.tex
bibtex main
pdflatex main.tex
pdflatex main.tex

biblatex/biber を使うプロジェクトの場合

pdflatex main.tex
biber main
pdflatex main.tex
pdflatex main.tex

よくあるコンパイルの問題

• .bib ファイルが見つからない：\bibliography{...} のパスが正しいか確認します
• 引用が未定義：bibtex/biber と pdflatex を 2 回実行します
• パッケージが見つからない：apt ではなく tlmgr からインストールします（apt のパッケージは粒度が粗いためです）
• フォントエラー：texlive-fonts-extra をインストールします
• TikZ の外部化エラー：write18 が有効になっていることを確認します

ステップ 6：セットアップを検証する

設定後：

1. コンパイル手順全体を実行します
2. PDF が正しく開くことを確認します
3. 文献項目が表示されていることを確認します
4. .log ファイルに警告が残っていないか確認します

出力形式

次の内容を提示します：

1. 現在の状態：インストール済みのものと不足しているもの
2. プロジェクトの要件：.tex ファイルから検出した内容
3. インストールコマンド：必要なものだけを、OS に応じて提示
4. コンパイルコマンド：このプロジェクトに適した正確な手順
5. 検証：コンパイルが正常に完了したことの確認