ببليوغرافيا فارغة

#ببليوغرافيا فارغة

##الأعراض

يتم تجميع المستند الخاص بك دون حدوث خطأ فادح، ولكن قسم المراجع مفقود تمامًا، أو يظهر العنوان بدون أي شيء تحته. غالبًا ما يظهر كل “\استشهاد” في النص كعلامة استفهام عريضة في نفس الوقت. لم يتعطل أي شيء، لذلك لا يوجد خطأ واضح يجب ملاحقته، وهو ما يجعل هذا الأمر محبطًا.

لماذا يحدث ذلك

لا يتم إنتاج قائمة المراجع بواسطة LaTeX وحدها. يقوم LaTeX أولاً بكتابة قائمة المفاتيح المذكورة في ملف مساعد. يقوم برنامج خلفي منفصل (bibtex أو biber) بقراءة قاعدة بيانات .bib الخاصة بك ويقوم بتنسيق الإدخالات المطابقة. أخيرًا، يقرأ LaTeX تلك النتيجة المنسقة مرة أخرى في المسار التالي. تعني الببليوغرافيا الفارغة أن خط الأنابيب هذا قد تعطل في مكان ما: لم يتم تشغيل الواجهة الخلفية مطلقًا، أو تم تشغيلها ولكن لم تتمكن من العثور على قاعدة البيانات، أو وجدت قاعدة البيانات ولكن لم يتم طلب أي مفاتيح، أو أن المستند يطلب النتيجة باستخدام أمر خاطئ.

العمل على الأسباب بالترتيب

أولاً، تأكد من وجود ملف قاعدة البيانات في المكان الذي تشير إليه الوثيقة. يبحث كل من \bibliography{refs} و \addbibresource{refs.bib} عن refs.bib بالنسبة للملف الرئيسي، لذلك يجب الإشارة إلى الملف الموجود في مجلد bib/ الفرعي باسم bib/refs أو bib/refs.bib. الطريق الخاطئ يفشل بهدوء.

ثانيًا، تأكد من تشغيل الواجهة الخلفية بالفعل. تجميع واحد لا يكفي أبدا؛ الدورة الكاملة هي LaTeX، ثم bibtex أو biber، ثم LaTeX مرتين أخريين. يقوم Oleafly بتشغيل هذه الدورة تلقائيًا، ولكن يمكن للبناء اليدوي أو سلسلة أدوات التحرير التي تم تكوينها بشكل خاطئ تخطي الخطوة الوسطى، والنتيجة هي قائمة مرجعية فارغة على وجه التحديد.

ثالثًا، تأكد من وجود أمر \cite واحد على الأقل. تقوم الواجهة الخلفية بتنسيق الإدخالات التي يطلبها المستند فقط، لذلك تحصل المسودة التي لا تحتوي على أي اقتباسات على قائمة فارغة حسب التصميم. أثناء الصياغة المبكرة، يمكنك فرض كل شيء باستخدام \nocite{*}، الذي يطلب كل إدخال في قاعدة البيانات دون طباعة أي شيء في النص.

رابعا، مطابقة الأمر للنظام. تنتهي مستندات BibTeX الكلاسيكية بـ \bibliographystyle{...} و \bibliography{refs}. تقوم مستندات biblatex بتحميل قاعدة البيانات في المقدمة باستخدام \addbibresource{refs.bib} وطباعتها باستخدام \printbibliography. إن الخلط بين الاثنين، على سبيل المثال تحميل biblatex مع الاستمرار في استدعاء \bibliography، ينتج عنه هذا الفشل بالضبط. الأمر نفسه ينطبق على تشغيل الواجهة الخلفية الخاطئة: يحتاج biblatex إلى “biber”، ولا تؤدي تغذيته إلى “bibtex” الكلاسيكية إلى أي شيء.

اقرأ السجل الخاص بالواجهة الخلفية

تكتب الواجهة الخلفية شكاواها إلى ملف .blg بجوار مستندك، وهذا هو المكان الذي تظهر فيه الإدخالات المشوهة والمفاتيح المكررة ورسائل “لم أتمكن من فتح ملف قاعدة البيانات”. إذا كانت الخطوات المذكورة أعلاه تبدو صحيحة ولكن القائمة لا تزال فارغة، فسيقوم سجل .blg دائمًا بتسمية الجاني الحقيقي. بالنسبة لعلامات الاستفهام التي تستمر بعد ظهور قائمة المراجع نفسها، راجع مسح علامات الاستشهاد الغامضة.