Yamamoto's Laboratory
 
ファイル
 
表紙
図
 
公開情報
 
 
古い情報
 
 

LaTeXファイル

LaTeX 文書で使うソースファイル,画像ファイル,補助ファイル,生成ファイルについて説明します.長い文書を複数のファイルに分ける方法も示します.

目次


ファイル構成

LaTeX では,一つの文書を作るときにも複数のファイルを使います.自分で作る *.tex や *.bib のほかに,LaTeX が参照番号,目次,文献リストなどの補助ファイルを作ります.最終的な出力は,多くの場合 *.pdf です.

主な拡張子

LaTeX でよく使うファイルの拡張子を以下に示します.コンパイルの方法や使用するパッケージにより,作られるファイルは変わります.

自分で作るファイル
*.tex LaTeX のソースファイルです.本文,プリアンブル,分割した章のファイルなどを記述します.
*.bib 参考文献データベースです.BibTeX や Biber が読み込みます.
*.sty パッケージまたは自作のスタイルファイルです.\usepackage で読み込みます.
*.cls 文書クラスファイルです.\documentclass で指定します.
*.bst BibTeX の文献スタイルファイルです.文献リストの並べ方や表示形式を決めます.
画像ファイル
*.pdf, *.png, *.jpg, *.jpeg 現在よく使う画像ファイルです.pdfLaTeX,LuaLaTeX,XeLaTeX,dvipdfmx で扱えます.
*.eps PostScript 系の画像ファイルです.古いワークフローや EPS 図を多く使う文書で見かけます.
*.xbb 画像の BoundingBox 情報などを書いたファイルです.dvipdfmx で画像サイズを読むために使われることがあります.
LaTeX が作る補助ファイル
*.aux 相互参照,引用,目次などに使う補助ファイルです.複数回コンパイルが必要になる主な理由です.
*.log コンパイル時のログファイルです.エラーや警告を確認できます.
*.toc 目次を作るためのファイルです.
*.lof, *.lot 図目次と表目次を作るためのファイルです.
*.out PDF のしおりやリンク情報などに使われる補助ファイルです.hyperref 使用時によく作られます.
最終出力または中間出力
*.pdf 最終的に配布することが多い PDF ファイルです.
*.dvi TeX の組版結果を保存する中間ファイルです.Device Independent file の略です.dvipdfmx を使う場合に作られます.
*.ps PostScript ファイルです.現在は PDF を直接作ることが多いため,必要な場合だけ使います.
文献処理で作られるファイル
*.bbl 文献リストの内容を書いたファイルです.BibTeX または Biber が作ります.
*.blg BibTeX または Biber のログファイルです.文献処理のエラー確認に使います.
*.bcf biblatex と Biber の処理で使う制御ファイルです.Biber がこのファイルを読みます.
*.run.xml Biber が処理状況を記録する XML ファイルです.
索引・用語集で作られるファイル
*.idx, *.ind, *.ilg 索引を作るときに使います.*.idx は LaTeX が作り,*.ind と *.ilg は索引処理プログラムが作ります.
*.glo, *.gls, *.glg 用語集を作るときに使われます.使用するパッケージにより,作られる拡張子は変わります.
latexmk やエディタが使うファイル
*.fls コンパイル時に読み書きしたファイルの一覧です.latexmk が依存関係の判断に使います.
*.fdb_latexmk latexmk が前回の処理状態を保存するファイルです.通常は直接編集しません.
*.synctex.gz PDF とソースの対応を保存するファイルです.エディタと PDF ビューアの相互ジャンプに使います.

テキストファイルとバイナリーファイル

*.tex,*.bib,*.sty,*.aux,*.log などの多くはテキストファイルです.内容をエディタで確認できます.一方,*.pdf,*.dvi,画像ファイル,圧縮された *.synctex.gz はバイナリーファイルです.

ソースファイルは,文字コードを統一して管理します.現在は UTF-8 で保存するのが一般的です.古い文書を EUC-JP や Shift_JIS で保存している場合は,文書の先頭やエディタ設定で文字コードを明確にします.

生成ファイルの扱い

LaTeX が作る補助ファイルは,原則として再生成できます.配布やバックアップでは,通常は *.tex,*.bib,画像,独自の *.sty,*.cls を残せば十分です.*.aux,*.log,*.toc,*.fls,*.fdb_latexmk などは,作業中に削除しても再コンパイルで作られます.

ただし,投稿先や共同作業のルールで *.bbl の提出が求められることがあります.最終出力の *.pdf も,確認用や提出用として保存します.

ソースファイルの分割

長い文書では,章や節ごとに *.tex を分けると編集しやすくなります.一つの巨大なファイルを編集するより見通しがよく,複数人で分担するときにも便利です.

input による分割

\input は,指定したファイルの内容をその場所に読み込みます.本文の一部,表,長い数式,自作マクロなどを小さなファイルに分けるときに使います.ファイル名の拡張子 .tex は,付けても省略しても構いません.

\documentclass[10pt,a4paper]{jsbook}
% プリアンブル

\begin{document}

\input{chapters/chap_01}
\input{chapters/chap_02}
\input{chapters/chap_03}

\end{document}

このときのディレクトリーツリーを図1に示します.図の赤色のファイルは root.tex に読み込むファイル,青色のファイルはコンパイルで作られるファイルです.

include による分割

\include も別ファイルを読み込みますが,読み込みの前後で改ページします.そのため,章ごとに分ける book や report 系の文書に向いています.各 \include ファイルには個別の *.aux が作られます.

\documentclass[10pt,a4paper]{jsbook}
% プリアンブル

\includeonly{chapters/chap_01,chapters/chap_03}

\begin{document}

\include{chapters/chap_01}
\include{chapters/chap_02}
\include{chapters/chap_03}

\end{document}

\includeonly を使うと,指定したファイルだけをコンパイルできます.長い文書の一部だけを確認したいときに便利です.ただし,章番号や参照番号を正しく保つには,一度は全体をコンパイルして補助ファイルを作っておく必要があります.

図1: ディレクトリー構造.赤色: root.tex に取り込むファイル,青色: コンパイルにより作成されるファイル.

ページ作成情報

参考資料

  1. さんきちさんの「分割した LaTeX ファイルを subfiles を使ってコンパイルする」に分かりやすい説明があります.
  2. LaTeX for authors current version は,現在の LaTeX の基本機能の確認に使いました.
  3. CTAN: latexmk は,latexmk と生成ファイルの確認に使いました.
  4. CTAN: biber は,Biber 関連ファイルの確認に使いました.
  5. CTAN: synctex-parser は,SyncTeX ファイルの説明に使いました.

更新履歴

2018年09月22日 ページの新規作成
2026年05月15日 ファイル拡張子,生成ファイル,ソースファイルの分割方法の説明を追加.


no counter