Университетские файлы классов, которые не компилируются
Порядок разбора: первая ошибка, движок, устаревшие пакеты, бинарный поиск.
Университетские файлы классов, которые не компилируются
Университетские шаблоны диссертаций — особый вид унаследованного кода. Аспирант написал файл класса пятнадцать лет назад под тогдашний дистрибутив TeX, защитился и оставил его замороженным, пока экосистема LaTeX двигалась вперёд. Когда вы сегодня скачиваете universitythesis.cls и он падает с экраном ошибок, класс чаще не сломан, а застрял во времени. Типичные сбои, однако, предсказуемы, и фиксированный порядок разбора справляется с большинством из них.
Начните только с первой ошибки
Сбой в LaTeX идёт каскадом: одна неопределённая команда в начале класса может породить десятки ошибок ниже, не значащих ничего. Прокрутите журнал до первой строки, начинающейся с !, исправьте её и перекомпилируйте, прежде чем читать что-либо ещё. Повторение этого цикла нередко расчищает пугающую стену ошибок за три-четыре прохода. Если первая ошибка — неизвестная команда, диагностику разбирает урок Undefined control sequence.
Проверьте движок
Многие шаблоны рассчитаны на конкретный движок и странно ломаются под любым другим. Класс, который подключает fontspec или задаёт шрифты по имени, требует XeLaTeX или LuaLaTeX; класс, построенный на примитивах, специфичных для pdftex, может не работать под обоими. Поищите комментарий в начале файла класса или строку в инструкциях университета с названием нужного движка и сначала подберите его, прежде чем отлаживать что-либо ещё. Различия сведены в уроке Какой движок для этого проекта.
Модернизируйте то, чем управляете
Старые шаблоны подключают устаревшие пакеты, современные замены которых уже есть в вашем дистрибутиве, и тогда эта пара начинает конфликтовать; классические сочетания перечислены в уроке Пакеты, которые конфликтуют друг с другом. Рабочая стратегия такова: не трогать сам файл класса, потому что требования университета к оформлению заложены в нём, а модернизировать только собственную преамбулу: удалить устаревшие строки \usepackage, подключать hyperref позже всех и не загружать повторно то, что класс уже загружает.
Бинарный поиск по преамбуле
Когда ошибка не поддаётся осмотру, закомментируйте вторую половину преамбулы и перекомпилируйте. Если ошибка исчезла, причина в закомментированной половине; верните половину её и повторите. Несколько компиляций выделяют единственную виновную строку, а это гораздо быстрее, чем рассуждать о преамбуле, которую вы не писали.
Ищите, прежде чем мучиться
Каждый студент этого университета компилирует один и тот же класс, поэтому ваша ошибка почти наверняка уже встречалась. Поищите точный текст ошибки вместе с названием файла класса и проверьте, не поддерживает ли университет или студент-преемник исправленный форк на GitHub. Использовать поддерживаемый форк, если он есть, лучше, чем самому заново чинить известные баги.