コンパイルできない大学のクラスファイル
切り分けの手順:最初のエラー、エンジン、古いパッケージ、二分探索。
コンパイルできない大学のクラスファイル
大学の学位論文テンプレートは、特殊なレガシーコードです。15 年前に大学院生が、当時の TeX ディストリビューションに合わせてクラスファイルを書き、卒業し、そのまま放置しました。その間に LaTeX の環境は先へ進んでいます。今日 universitythesis.cls をダウンロードして、画面いっぱいのエラーで止まったとしたら、クラスが壊れているというより、時代に取り残されていることがほとんどです。それでも、失敗のパターンは予測でき、決まった順序で切り分ければ大半は解決できます。
最初のエラーだけを見る
LaTeX の失敗は連鎖します。クラスの早い位置にある未定義コマンド 1 つが、意味のない後続のエラーを何十個も生むことがあります。ログを ! で始まる最初の行までスクロールし、それを直して、ほかを読む前に再コンパイルしてください。この手順を繰り返すと、手に負えないほどのエラーの壁が 3 回か 4 回で消えることがよくあります。最初のエラーが未知のコマンドなら、Undefined control sequenceで診断の手順を説明しています。
エンジンを確認する
多くのテンプレートは特定のエンジンを前提にしていて、ほかのエンジンでは奇妙な失敗の仕方をします。fontspec を読み込む、またはフォントを名前で指定するクラスには XeLaTeX か LuaLaTeX が必要です。pdftex 固有のプリミティブを前提に作られたクラスは、その両方で失敗することがあります。クラスファイルの先頭付近のコメントや、大学の指示書にある、想定エンジンを示した行を探して、ほかのデバッグより先にそれに合わせてください。違いはこのプロジェクトに向くエンジンにまとめています。
自分で管理できる部分を最新にする
古いテンプレートは、現在のディストリビューションにすでに後継があるパッケージの古い版を読み込み、そのせいで両者が衝突します。互いに衝突するパッケージに、よくある組み合わせを挙げています。現実的な方針は、クラスファイル自体には手を付けないことです。大学の書式要件はそこに書かれているからです。直すのは自分のプリアンブルだけにします。古い \usepackage 行を削除し、hyperref は最後のほうで読み込み、クラスがすでに読み込んでいるものを再度読み込まないようにします。
プリアンブルを二分探索する
エラーの原因を目で見つけられないときは、自分のプリアンブルの後半をコメントアウトして再コンパイルします。エラーが消えれば、原因はコメントアウトした側にあります。その半分を元に戻し、同じことを繰り返します。数回コンパイルすれば問題の 1 行を特定でき、自分が書いていないプリアンブルを頭で推論するより、ずっと速く済みます。
苦しむ前に検索する
その大学の学生は全員が同じクラスをコンパイルしているので、あなたのエラーはほぼ確実に誰かがすでに踏んでいます。正確なエラーメッセージとクラスファイル名を組み合わせて検索し、大学や後輩の学生が GitHub でパッチ適用済みのフォークを保守していないか確認してください。保守されているフォークがあるなら、既知のバグを自力で直し直すより、そちらを使うほうが得です。