再利用できるドキュメントの骨組み

クラス、プリアンブル、maketitle、セクション、参考文献。ほとんどの論文に共通する構造です。

再利用できるドキュメントの骨組み

内容を取り除くと、ほぼすべての LaTeX ドキュメントに同じ骨組みが残ります。クラスの宣言、設定のためのプリアンブル、そして \begin{document} と \end{document} に挟まれた本文です。この形を覚えれば、新しいプロジェクトでは骨組みを貼り付け、タイトルを変えて、書き始めるだけです。

\documentclass[11pt]{article}
% preamble: packages, macros, metadata
\title{...}
\author{...}
\begin{document}
\maketitle
% body: sections, figures, bibliography
\end{document}

上から順に読んでいきます。\documentclass[11pt]{article} はドキュメントの種類を選び、オプションで基本のフォントサイズを指定します。デザインのそれ以外の部分は、すべてこの選択から決まります。クラスの行から \begin{document} までの領域がプリアンブルで、ここでパッケージを読み込み、\title や \author などのメタデータを保存します。\begin{document} は表示される内容の開始位置を示し、\maketitle は保存されたタイトルブロックを組版します。その後に、セクション、図、最後に参考文献という形で本文が続きます。\end{document} でドキュメントを閉じます。その後ろにあるものは黙って無視されるため、誰かが貼り付ける場所を間違えたテキストの塊が、ときどきそこに隠れてしまいます。

クラスの選び方

クラス用途
article論文、宿題、ノート
report章のある長めのレポート
book書籍や多くの学位論文
beamerスライド

クラスは見た目だけの問題ではありません。使えるコマンドそのものが変わります。article には \chapter がないため、学位論文の章を貼り付けるとすぐに失敗します。report は章を追加し、タイトルを独立したページに置きます。book は両面印刷を前提とし、章を右ページから始めます。beamer はスライド用のフレームを中心に、すべてを組み替えます。ジャーナルや学会は独自のクラスを配布しており、投稿先に合わせて書くときは、そのクラスがこの選択を完全に置き換えます。

壊れた骨組みの大半は、次の 2 つの間違いが原因です。\begin{document} の前にテキストを置くと、プリアンブルは設定するだけで出力してはいけないため、“Missing \begin{document}” というエラーになります。また、\end{document} がないと、コンパイラはファイルの終端で待ち続け、入力の終わりについて分かりにくいメッセージを出します。どちらかが出たら、内容を疑う前にドキュメントの枠組みを確認してください。

骨組みは規模に合わせて拡張できます。4 ページのメモなら本文をそのまま書き、学位論文なら各章を別ファイルに移して、章ファイルの分割で示すようにルートファイルから読み込みます。それでも、周りの枠組みは変わりません。

ドキュメントの骨組みチェック任意の練習クイズ5 問

このレッスンの内容を短く確認します。間違えると正解が表示されます。選択肢は挑戦するたびに並び替わります。何度でもやり直せます。

ループを開く に戻る