الحزم التي تقاتل بعضها البعض

#الحزم التي تقاتل بعضها البعض

تتمتع حزم LaTeX بحرية إعادة تعريف أوامر بعضها البعض، والعديد منها تفعل ذلك عمدًا. هذه هي الطريقة التي يقوم بها hyperref بتحويل كل إسناد ترافقي إلى رابط. ويعني هذا أيضًا أن حزمتين يمكن لكل منهما تصحيح نفس الأمر بافتراضات غير متوافقة، وتتراوح النتيجة من خطأ صريح مثل Command \footnote محدد بالفعل أو 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 أن تشير إلى الاستخدام القديم لك في وقت الترجمة.

اشتباكات الخيار

تضارب الخيار للحزمة X يعني أنه تم تحميل الحزمة مرتين بخيارات مختلفة، غالبًا مرة واحدة بواسطة فئة المستند خلف ظهرك. لا يمكنك تحميله مرة أخرى بخيارات جديدة، ولكن يمكنك إدخال خيارات قبل أن يقوم أي شخص بتحميله: ضع \PassOptionsToPackage{table}{xcolor} قبل \documentclass، وسيتم دمج الخيارات في أي تحميل يأتي أولاً.

عزل مع الحد الأدنى من الأمثلة

عندما لا يكون السبب واضحًا، أنشئ مثالًا عمليًا مبسطًا: مستند يحتوي فقط على \documentclass والحزمتين المشتبه فيهما و\begin{document}...\end{document} مع سطر واحد من النص. إذا تكرر الخطأ، قم بتبديل ترتيب التحميل والخيارات حتى لا يحدث. إذا لم يتم إعادة إنتاجها، قم بإضافة الطرود الأخرى الخاصة بك مرة أخرى إلى النصف حتى تعود. يتقارب هذا البحث الثنائي في عدد قليل من التجميعات ويمنحك زوجًا واضحًا للبحث عنه. تنقذ نفس التقنية الديباجة الموروثة، كما هو موضح في ملفات فئة الجامعة التي لن يتم تجميعها.