焦る前に LaTeX で大学院の学位論文の構成を決める
前付け、章ごとのインクルード、略語、大学のクラスファイル、コンパイル速度、そして修士・博士課程の学生のための Git 履歴。
学位論文は、事務手続きが付いてくる長い論文です。長い論文は LaTeX が得意とするところです。事務手続きのほうは、たいてい 2009 年に書かれ、最後に試したのが別の TeX Live だった大学のクラスファイルです。
章がまだ空でも、構成は早めに始めてください。最後の 1 か月にファイル間で内容を移すと、相互参照や図のパスが壊れます。
クラスファイルは受け入れ、それ以外は分ける
大学の .cls (必要なら .bst やロゴのファイルも) をプロジェクトに置きます。クラスは書き換えません。自分のマクロ、パッケージ、各章の内容は、自分で管理するファイルに置きます。
thesis/ main.tex macros.tex chapters/ figures/ university.clsクラスが新しいエンジンで壊れる場合は、コンパイルできない大学のクラスファイルを参考に切り分けてください。fontspec に手間をかける前に、論文の事務窓口がどのエンジン (pdfLaTeX、XeLaTeX、LuaLaTeX) を受け付けるかを文書にしておきます。
審査委員会が求める前付け
要旨、献辞、謝辞、目次、図表の一覧にはローマ数字のページ番号、本文の章にはアラビア数字を使います。book / report クラスには \frontmatter / \mainmatter がありますが、article ベースのテンプレートでは \pagenumbering を手作業で使う必要があります。ガイド: ローマ数字からアラビア数字へ。
表紙の内容は、大学院が示す Word の見本と一致させる必要があることが多くあります。文言を正確に写してください。ここで工夫すると、チェックリストで PDF が差し戻されます。
章をファイルに分ける
ルートは 1 つ、インクルードは複数にします。
\include{chapters/intro}\include{chapters/background}\include{chapters/methods}\include{chapters/results}\include{chapters/conclusion}学位論文のもとになる論文を共著者が手伝ってくれた場合でも、各章は自分の責任で書いてください。図は figures/chapter3/ のようなフォルダに置くと、章を並べ替えてもパスが変わりません。下書き中は \includeonly{chapters/methods} を使えば、数式を 1 つ直すたびに論文全体をコンパイルせずにすみます。参考: 章ファイルの分割。
ラベルはプロジェクト全体で一意にします (どのファイルにも eq:main と書くのではなく、eq:ch3-main のようにします)。200 ページ規模のツリーでは、プロジェクト全体の構成ビューや参照のライブチェックが役に立ちます。
略語と記号
用語集のパッケージは強力ですが、扱いが細かいです。多くの学位論文では、前付けに記号の一覧を手で管理すれば十分です。略語を自動で展開したい場合は、提出の週ではなくその前に、glossaries-extra を学ぶ日を 1 日確保してください。
数式のマクロは macros.tex に定義し、そのファイルを全員が守る共通の決まりとして扱います。第 2 章と第 5 章で記法がずれていると、細かい審査員には格好の材料になります。
参考文献
学位論文全体で .bib を 1 つにするか、小さなファイル群を慎重にまとめます。キーは安定させます。製本の前に検証しましょう。BibTeX バリデータを使えます。学科が求めるスタイル (数値式、著者年方式、脚注中心の人文系スタイル) に合わせます。1 つのプリアンブルに biblatex と従来の BibTeX の構成を混在させないでください。
速度
論文全体のコンパイルは遅くなります。図のドラフトモード、\includeonly、TikZ の externalize を使うと、何時間も取り戻せます。メモ: PDF の待ち時間を短くする。
章をまたぐ失敗を早く見つけられるよう、毎週「全体コンパイル」の習慣を持ってください。
バックアップと履歴は別物
Dropbox のコピーはバックアップです。Git は、論点がどう変わってきたかの物語です。章がコンパイルできたらコミットします。プライベートな GitHub か GitLab のリモートにプッシュします。
Oleafly (新しいタブで開きます) はプロジェクトごとに本物のリポジトリを初期化し、コンパイル成功後やアイドル時の編集後にチェックポイントを作り、ワンクリックで復元できます。章のファイルをまたいで機能するプロジェクト全体の構成ビューや SyncTeX も同じ場所にあります。そのため、この習慣を飛ばしにくくなります。どのエディタでも、慎重に Git を使えば同じ規律は保てます。ただし、学位論文が 18 か月目に git init を思い出せるかどうかに左右されてはいけません。
審査委員会からのフィードバックの流れ
ソースを開かない読者には PDF をエクスポートして渡します。コメントは issue や共有ドキュメントで管理しても、修正は TeX に反映します。審査委員がスキャンした書き込み入りの PDF を返してきたら、ファイル名に日付とバージョンを入れて、どのソースのコミットを指しているかが分かるようにします。
製本前のチェックリスト
印刷または提出の前に確認します。
- クラスファイルとエンジンが、論文の事務窓口の規則と一致している。
- 前付けのページ番号が正しい。必要なら署名ページがある。
- すべての
\ref/\citeが解決され、[?]が残っていない。 - 必要なら図表の一覧がある。キャプションに一貫性がある。
- 余白とフォントサイズがチェックリストの PDF を満たしている (テストページを印刷する)。
- 提出後に、ソース、PDF、コミットハッシュをアーカイブした。
図、表、「一覧」ページ
多くの論文事務窓口が、図と表の一覧を求めます。キャプションは一貫させ、方法のセクション全体を 20 行のキャプションに詰め込まないでください。クラスが短いキャプションに対応しているなら、一覧用には短いタイトルを、本文には長めの説明的なキャプションを使います。
盗用と既発表の論文
章が既発表の論文を再構成したものである場合は、収録と共著者の許可に関する大学の規則に従ってください。もとになった論文の受理済み PDF と学位論文の章をバージョン管理の下に置き、何が変わったか (記法、拡張した実験、統一した序論) をメモしておきます。
書き始める月ではなく、今月から始める
アウトラインを提案する時点で、骨組みを作ります。空でもコンパイルできる章は、進捗に数えられます。終盤の焦りの多くは、構成の負債と手ごわいクラスファイルから来るもので、科学の中身の不足から来るものではありません。その負債は早めに返しましょう。