LaTeX プロジェクトを複数のファイルに分ける

1 つのメイン文書を中心に、長い原稿のセクション、図、参考文献データを複数のファイルへ整理します。

1 つのメインファイルで文書全体を設定し、小さなファイルで個々のセクションやリソースを管理すると、長い原稿でも移動しやすくなります。このレッスンでは、1 つのメイン文書から 1 本の論文を構成します。別々の論文をまとめて置き、プレビューを切り替える方法は、1 つのプロジェクトで複数の論文を書くを参照してください。

プロジェクトツリーを設計する#

一般的な研究論文では、次のような構成を使用できます。

main.tex
sections/
  introduction.tex
  methods.tex
  results.tex
figures/
  calibration.pdf
references.bib
macros.tex

\documentclass、パッケージ、文書全体の設定、document 環境は main.tex に置きます。再利用する定義は macros.tex、文献レコードは references.bib に置き、各セクションファイルには論文のまとまりのある部分を1つずつ収めます。セクションファイルで文書クラスを繰り返したり、別の文書を開始したりしないでください。

セクションファイルを取り込む#

CorTeX のファイルツリーでフォルダーとファイルを作成し、読む順序に従って main.tex から取り込みます。

\documentclass{article}
\input{macros}
\begin{document}
\input{sections/introduction}
\input{sections/methods}
\input{sections/results}
\bibliographystyle{plain}
\bibliography{references}
\end{document}

\input は改ページを強制せず、その位置にファイルを挿入します。.tex 拡張子は省略できます。\include は章単位のまとまりを想定しており、通常は新しいページを開始します。また、大きな書籍で一部の章だけをコンパイルする場合は \includeonly と組み合わせられます。

次のコンパイル可能な例では、ドキュメント用のサンプルを自己完結させるためだけに filecontents* を使っています。実際のプロジェクトでは、代わりに introduction.tex を別ファイルとして作成してください。

\begin{filecontents*}{introduction.tex}
\section{Introduction}
This section is stored in its own file.
\end{filecontents*}
\documentclass{article}
\begin{document}
\input{introduction}
\section{Results}
The main file controls the document order.
\end{document}

CorTeX で開く →

メイン文書からの相対パスを解決する#

プロジェクトのパスには / を使い、大文字と小文字は区別されます。LaTeX の相対パスは、コマンドを含むセクションのフォルダーではなく、メイン文書のフォルダーを基準に解決されます。main.tex がプロジェクトのルートにある場合、sections/results.tex 内で使う図も figures/calibration.pdf と記述します。

プレビューする論文を選ぶには main.tex を開きます。プロジェクトを開いたときの既定の文書にもする場合は、行メニューで メイン文書に設定 を選びます。セクションファイルをエディターで開いたままでも、CorTeX はそのセクションが属する論文をコンパイルできます。共同執筆者は文書全体の順序やプリアンブルを変更せず、担当する部分のファイルで作業できます。

CorTeX でファイルの名前を変更したり移動したりすると、認識された LaTeX の参照が更新され、プロジェクトの変更として表示されます。独自マクロ、計算で生成するパス、通常の文章に書かれたパス名は、安全に書き換えられない場合があるため確認してください。

プロジェクトの再現性を保つ#

各事項を管理する場所は1つにします。セクションファイル間でパッケージの読み込みを重複させたり、競合する2つのマクロファイルを管理したりしないでください。選択中の TeX Live スナップショットに含まれているものを除き、論文に必要な .bib、クラス、スタイル、フォント、図の各ファイルをプロジェクト内に保管します。大規模な再編成の前には、名前付きバージョンを保存します。

ファイルを追加または移動した後は、main.tex からコンパイルします。論文全体が意図した順序で表示され、相互参照と引用が解決され、別の共同執筆者も手元だけにあるファイルなしでコンパイルできれば成功です。依存ファイルがない場合は、ファイル未検出の解決方法を参照してください。