حزم تتعارض فيما بينها

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} مع سطر نصي واحد. فإذا تكرر الخطأ، فبدّل ترتيب التحميل والخيارات حتى يزول. وإذا لم يتكرر، فأعد بقية حزمك إليه على دفعات نصفية حتى يعود. يتقارب هذا البحث الثنائي في بضع مرات تجميع ويعطيك زوجًا واضحًا تبحث عنه. وتنقذ التقنية نفسها الديباجات الموروثة، كما هو موضح في ملفات فئات الجامعات التي لا تُجمَّع.

العودة إلى وقت التشغيل