आपस में उलझते पैकेज
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 का मतलब है कि पैकेज दो बार अलग-अलग ऑप्शन के साथ लोड हुआ, अक्सर एक बार आपकी डॉक्यूमेंट क्लास ने आपके पीछे से। आप उसे नए ऑप्शन के साथ दोबारा लोड नहीं कर सकते, लेकिन किसी के लोड करने से पहले ऑप्शन डाल सकते हैं: \documentclass से पहले \PassOptionsToPackage{table}{xcolor} रखें, और ऑप्शन उस लोड में मिल जाएँगे जो सबसे पहले आता है।
न्यूनतम उदाहरण से अलग करें
जब कारण साफ़ न हो, तो एक न्यूनतम काम करने वाला उदाहरण बनाएँ: ऐसा दस्तावेज़ जिसमें सिर्फ़ \documentclass, दो संदिग्ध पैकेज, और एक पंक्ति के टेक्स्ट वाला \begin{document}...\end{document} हो। अगर त्रुटि फिर भी आती है, तो लोड करने का क्रम और ऑप्शन तब तक बदलते रहें जब तक त्रुटि न जाए। अगर नहीं आती, तो अपने बाकी पैकेज आधे-आधे करके वापस जोड़ते जाएँ जब तक त्रुटि लौट न आए। यह बाइनरी सर्च कुछ ही कंपाइल में नतीजे पर पहुँच जाती है और आपको खोजने के लिए साफ़ जोड़ी देती है। यही तरीका विरासत में मिले प्रीएम्बल भी बचाता है, जैसा यूनिवर्सिटी क्लास फ़ाइलें जो कंपाइल नहीं होतीं में बताया गया है।