Các gói xung đột với nhau

hyperref ở cuối, cleveref sau nó, các cặp gói lỗi thời, ví dụ tối thiểu.

Các gói xung đột với nhau

Các gói LaTeX được tự do định nghĩa lại lệnh của nhau, và nhiều gói làm vậy một cách có chủ ý. hyperref biến mọi tham chiếu chéo thành liên kết chính là nhờ cách đó. Điều này cũng có nghĩa là hai gói có thể cùng vá một lệnh với những giả định không tương thích, và kết quả dao động từ một lỗi rõ ràng như Command \footnote already defined hoặc Option clash for package xcolor cho đến kết quả sai một cách âm thầm. Xung đột hầu như luôn xuất hiện ngay sau khi bạn thêm một gói vào phần mở đầu vốn đang chạy tốt, và đó cũng là manh mối lớn nhất.

Thứ tự tải quyết định một nửa vấn đề

Nhiều xung đột được giải quyết chỉ nhờ thứ tự, vì gói tải sau sẽ có tiếng nói cuối cùng. Quy tắc quan trọng nhất: tải hyperref gần cuối phần mở đầu. Nó viết lại nhiều phần lớn của bộ máy tham chiếu chéo trong LaTeX, và các gói tải sau nó có thể hoàn tác những bản vá đó. Một danh sách ngắn các ngoại lệ phải được tải còn muộn hơn nữa, và gói bạn thực sự sẽ gặp là cleveref, được thiết kế để nằm trên hyperref và phải được tải sau nó:

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

Khi tài liệu của một gói chỉ định vị trí so với một gói khác, hãy tin vào đó. Những ghi chú ấy tồn tại vì đã có người gặp đúng xung đột mà bạn sắp gặp.

Gói lỗi thời và gói thay thế

Một số xung đột đến từ việc tải một gói đã lỗi thời cùng với gói kế nhiệm của nó. Đừng kết hợp epsfig với graphicx, subfigure với subcaption, hay các gói cũ times và mathptmx với các gói phông hiện đại như newtxtext. Nguồn gốc thường là các mẫu cũ: chúng tải bất cứ gói nào đang thịnh hành lúc mẫu được viết, rồi bạn lại thêm gói hiện đại tương đương lên trên. Hãy bỏ gói lỗi thời và giữ gói thay thế. Gói nag có thể đánh dấu cách dùng lỗi thời cho bạn ngay lúc biên dịch.

Xung đột tùy chọn

Option clash for package X nghĩa là gói đã được tải hai lần với các tùy chọn khác nhau, thường là một lần do lớp tài liệu của bạn tải mà bạn không hay biết. Bạn không thể tải lại nó với tùy chọn mới, nhưng có thể chèn tùy chọn trước khi bất kỳ ai tải nó: đặt \PassOptionsToPackage{table}{xcolor} trước \documentclass, và các tùy chọn sẽ được gộp vào lần tải nào đến trước.

Cô lập bằng một ví dụ tối thiểu

Khi nguyên nhân không rõ ràng, hãy dựng một ví dụ tối thiểu chạy được: một tài liệu chỉ chứa \documentclass, hai gói bị nghi ngờ, và một \begin{document}...\end{document} với một dòng chữ. Nếu lỗi tái hiện, hãy đảo thứ tự tải và các tùy chọn cho đến khi nó biến mất. Nếu không tái hiện, hãy thêm các gói khác của bạn vào lại theo từng nửa cho đến khi lỗi quay lại. Phép tìm kiếm nhị phân này hội tụ chỉ sau vài lần biên dịch và cho bạn một cặp gói rõ ràng để tra cứu. Kỹ thuật tương tự cũng cứu được các phần mở đầu thừa kế, như đã mô tả trong Tệp lớp của trường đại học không biên dịch được.

Quay lại Thời gian chạy