Пакеты, которые конфликтуют друг с другом

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} с одной строкой текста. Если ошибка воспроизводится, меняйте порядок загрузки и параметры, пока она не исчезнет. Если не воспроизводится, возвращайте остальные пакеты половинами, пока ошибка не появится вновь. Такой двоичный поиск сходится за несколько компиляций и даёт вам чёткую пару для поиска. Тот же приём выручает с унаследованными преамбулами, как описано в уроке файлы классов университетов, которые не компилируются.

Вернуться к Среда выполнения