Пакети, які сперечаються між собою

hyperref останнім, cleveref після нього, застарілі пари, мінімальні приклади.

Пакети, які сперечаються між собою

Пакети LaTeX можуть вільно перевизначати команди одне одного, і багато з них роблять це свідомо. Саме так hyperref перетворює кожне перехресне посилання на гіперпосилання. Але це означає й те, що два пакети можуть латати одну й ту саму команду з несумісними припущеннями, а результат буває різним: від відвертої помилки на зразок Command \footnote already defined чи Option clash for package xcolor до мовчки хибного виводу. Конфлікти майже завжди проявляються одразу після того, як ви додали пакет до преамбули, що раніше працювала, і це найбільша підказка.

Порядок підключення — половина справи

Багато конфліктів розв’язує сам порядок, бо останнє слово залишається за пакетом, підключеним пізніше. Найважливіше правило: підключайте hyperref ближче до кінця преамбули. Він переписує великі частини механізму перехресних посилань LaTeX, а пакети, підключені після нього, можуть скасувати ці латки. Кілька винятків мають іти ще пізніше, і той, що вам справді трапиться, — це cleveref, створений, щоб стояти поверх hyperref, тому підключати його треба після нього:

\usepackage{graphicx}
\usepackage{amsmath}
% ... everything else ...
\usepackage{hyperref}
\usepackage{cleveref} % after hyperref, by design

Якщо документація пакета вказує місце щодо іншого пакета, довіряйте їй. Такі примітки існують, бо хтось уже натрапив на конфлікт, який трапиться вам.

Застарілі пакети та їхні заміни

Деякі конфлікти виникають через підключення мертвого пакета поряд з його наступником. Не поєднуйте epsfig з graphicx, subfigure із subcaption, а також старі прокладки times і mathptmx із сучасними шрифтовими пакетами на кшталт newtxtext. Зазвичай причина в старих шаблонах: вони підключають усе, що було актуальним на час їх написання, а ви додаєте зверху сучасний еквівалент. Приберіть застарілий пакет і залиште заміну. Пакет nag може позначати застаріле використання під час компіляції.

Конфлікти параметрів

Option clash for package X означає, що пакет підключили двічі з різними параметрами, часто один раз за вашою спиною через клас документа. Підключити його знову з новими параметрами не вийде, але можна передати параметри, поки його ніхто не підключив: поставте \PassOptionsToPackage{table}{xcolor} перед \documentclass, і параметри об’єднаються з тим підключенням, яке станеться першим.

Ізолюйте проблему мінімальним прикладом

Коли причина неочевидна, зробіть мінімальний робочий приклад: документ, що містить лише \documentclass, два підозрілі пакети та \begin{document}...\end{document} з одним рядком тексту. Якщо помилка відтворюється, змінюйте порядок підключення й параметри, доки вона не зникне. Якщо не відтворюється, повертайте решту пакетів половинами, доки вона не з’явиться знову. Такий бінарний пошук зводиться за кілька компіляцій і дає вам чітку пару для пошуку в мережі. Ту саму методику використовують, щоб урятувати успадковані преамбули, як описано в уроці Файли університетських класів, які не збираються.

Назад до Середовище виконання