Університетські файли класів, що не компілюються
Діагностика: перша помилка, рушій, застарілі пакети, бінарний пошук.
Університетські файли класів, що не компілюються
Університетські шаблони дисертацій — особливий різновид спадкового коду. Аспірант написав файл класу п’ятнадцять років тому під тодішній дистрибутив TeX, закінчив навчання й залишив його замороженим, поки екосистема LaTeX рухалася далі. Коли ви сьогодні завантажуєте universitythesis.cls, і він падає з екраном помилок, клас здебільшого не зламаний, а скоріше застряг у часі. Проте режими відмов передбачувані, і фіксований порядок діагностики розв’язує більшість із них.
Починайте лише з першої помилки
Помилки в LaTeX каскадують: одна невизначена команда на початку класу може породити десятки наступних помилок, які нічого не означають. Прокрутіть журнал до першого рядка, що починається з !, виправте її й перекомпілюйте, перш ніж читати щось інше. Повторення цього циклу нерідко розчищає лякаючу стіну помилок за три-чотири проходи. Якщо перша помилка — невідома команда, діагностику розбирає урок Undefined control sequence.
Перевірте рушій
Багато шаблонів припускають конкретний рушій і дивно ламаються під будь-яким іншим. Клас, що завантажує fontspec або задає шрифти за назвою, вимагає XeLaTeX чи LuaLaTeX; клас, побудований на примітивах, специфічних для pdftex, може не працювати під обома. Пошукайте коментар у верхній частині файлу класу або рядок в інструкціях університету з назвою передбаченого рушія й підберіть його, перш ніж діагностувати щось інше. Відмінності підсумовано в уроці Який рушій обрати для проєкту.
Модернізуйте те, що контролюєте
Старі шаблони завантажують застарілі пакети, сучасні заміни яких уже є у вашому дистрибутиві, і ця пара тоді конфліктує; класичні комбінації перелічено в уроці Пакети, що конфліктують між собою. Робоча стратегія — не чіпати сам файл класу, бо в ньому живуть вимоги університету до оформлення, а модернізувати лише власну преамбулу: видалити застарілі рядки \usepackage, завантажувати hyperref пізно й не завантажувати вдруге те, що клас уже завантажує.
Бінарний пошук по преамбулі
Коли помилка не піддається огляду, закоментуйте другу половину преамбули й перекомпілюйте. Якщо помилка зникла, причина в закоментованій половині; поверніть половину з неї й повторіть. Кілька компіляцій ізолюють єдиний винний рядок, і це набагато швидше, ніж міркувати про преамбулу, яку ви не писали.
Шукайте, перш ніж страждати
Кожен студент цього університету компілює той самий клас, тож з вашою помилкою майже напевно вже стикалися. Шукайте точний текст помилки разом із назвою файлу класу й перевірте, чи не підтримує університет або студент-наступник виправлений форк на GitHub. Використання підтримуваного форка, коли він існує, краще за повторне виправлення відомих помилок самостійно.