قائمة مراجع فارغة
المسار، والواجهة الخلفية، واستشهاد مفقود، وprintbibliography مقابل bibliography.
قائمة مراجع فارغة
العَرَض
يُجمَّع مستندك دون خطأ فادح، لكن قسم المراجع غائب تمامًا، أو يظهر عنوانه وتحته لا شيء. وغالبًا يظهر كل \cite في النص علامة استفهام غامقة في الوقت نفسه. لم ينهَر شيء، فلا يوجد خطأ واضح يمكن تتبعه، وهذا ما يجعل هذه المشكلة مزعجة.
لماذا يحدث ذلك
لا تُنتَج قائمة المراجع بواسطة LaTeX وحده. يكتب LaTeX أولًا قائمة المفاتيح المستشهد بها في ملف مساعد. ثم يقرأ برنامج خلفي منفصل (bibtex أو biber) قاعدة بيانات .bib الخاصة بك وينسق الإدخالات المطابقة. وأخيرًا يقرأ LaTeX هذه النتيجة المنسقة في المرور التالي. وقائمة المراجع الفارغة تعني أن هذا المسار انكسر في موضع ما: لم يعمل البرنامج الخلفي أصلًا، أو عمل لكنه لم يجد قاعدة البيانات، أو وجدها لكن لم يُطلب منه أي مفتاح، أو أن المستند يطلب النتيجة بأمر خاطئ.
افحص الأسباب بالترتيب
أولًا، تأكد من أن ملف قاعدة البيانات موجود في المكان الذي يذكره المستند. يبحث كل من \bibliography{refs} و\addbibresource{refs.bib} عن refs.bib بالنسبة إلى الملف الرئيسي، لذا يجب الإشارة إلى الملف الموجود في مجلد فرعي bib/ بالصيغة bib/refs أو bib/refs.bib. والمسار الخاطئ يفشل بصمت.
ثانيًا، تأكد من أن البرنامج الخلفي عمل فعلًا. لا يكفي تجميع واحد أبدًا، فالدورة الكاملة هي LaTeX، ثم bibtex أو biber، ثم LaTeX مرتين أخريين. يدير Oleafly مرات البناء نيابة عنك؛ اختر TinyTeX أو محرك TeX من النظام لمشروع يستخدم Biber. أما البناء اليدوي أو سلسلة أدوات محرر مضبوطة خطأً فقد تتخطى الخطوة الوسطى، والنتيجة هي بالضبط قائمة مراجع فارغة.
ثالثًا، تحقق من وجود أمر \cite واحد على الأقل. فالبرنامج الخلفي لا ينسق إلا الإدخالات التي يطلبها المستند، لذا فإن المسودة التي لا تحتوي على أي استشهاد بعد تحصل على قائمة فارغة بحكم التصميم. وفي أثناء الكتابة الأولى يمكنك فرض إدراج كل شيء بالأمر \nocite{*}، الذي يطلب كل إدخال في قاعدة البيانات دون أن يطبع أي شيء في النص.
رابعًا، طابق الأمر مع النظام. تنتهي مستندات BibTeX الكلاسيكية بـ \bibliographystyle{...} و\bibliography{refs}. أما مستندات biblatex فتحمّل قاعدة البيانات في المقدمة بالأمر \addbibresource{refs.bib} وتطبعها بالأمر \printbibliography. والخلط بين الأسلوبين، مثل تحميل biblatex مع الاستمرار في استدعاء \bibliography، يسبب هذا الفشل تحديدًا. والأمر نفسه ينطبق على تشغيل البرنامج الخلفي الخطأ: يحتاج biblatex إلى biber، وإطعامه bibtex الكلاسيكي لا ينتج شيئًا.
اقرأ سجل البرنامج الخلفي نفسه
يكتب البرنامج الخلفي شكاواه في ملف .blg بجوار مستندك، وهناك تظهر الإدخالات المشوهة والمفاتيح المكررة ورسائل «I couldn’t open database file». فإذا بدت الخطوات أعلاه سليمة وبقيت القائمة فارغة، فإن سجل .blg يسمّي في الغالب السبب الحقيقي. أما علامات الاستفهام التي تبقى بعد ظهور قائمة المراجع نفسها فراجع التخلص من علامات الاستشهاد الغامضة.