खाली ग्रंथसूची

पथ, बैकएंड, गायब cite, 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 बिल्ड पास आपके लिए सँभालता है; Biber प्रोजेक्ट के लिए TinyTeX या सिस्टम TeX इंजन चुनें, लेकिन हाथ से चलाया गया बिल्ड या गलत कॉन्फ़िगर किया गया एडिटर टूलचेन बीच का चरण छोड़ सकता है, और नतीजा ठीक खाली संदर्भ सूची होता है।

तीसरे, जाँचें कि कम से कम एक \cite कमांड मौजूद है। बैकएंड केवल उन्हीं प्रविष्टियों को फ़ॉर्मैट करता है जिन्हें दस्तावेज़ माँगता है, इसलिए जिस ड्राफ़्ट में अभी कोई उद्धरण नहीं है उसे डिज़ाइन के अनुसार खाली सूची मिलती है। शुरुआती ड्राफ़्टिंग में आप \nocite{*} से सब कुछ जबरन शामिल कर सकते हैं, जो डेटाबेस की हर प्रविष्टि माँगता है पर पाठ में कुछ नहीं छापता।

चौथे, कमांड को सिस्टम से मिलाएँ। क्लासिक BibTeX दस्तावेज़ \bibliographystyle{...} और \bibliography{refs} पर खत्म होते हैं। biblatex दस्तावेज़ प्रीएम्बल में \addbibresource{refs.bib} से डेटाबेस लोड करते हैं और \printbibliography से उसे छापते हैं। दोनों को मिलाना, जैसे biblatex लोड करना पर फिर भी \bibliography बुलाना, ठीक यही विफलता पैदा करता है। गलत बैकएंड चलाने पर भी यही होता है: biblatex को biber चाहिए, और उसे क्लासिक bibtex देने से कुछ नहीं निकलता।

बैकएंड का अपना लॉग पढ़ें

बैकएंड अपनी शिकायतें आपके दस्तावेज़ के बगल की .blg फ़ाइल में लिखता है, और बिगड़ी प्रविष्टियाँ, दोहराई कुंजियाँ और “I couldn’t open database file” जैसे संदेश वहीं दिखते हैं। अगर ऊपर के चरण सही लगते हैं पर सूची फिर भी खाली है, तो .blg लॉग लगभग हमेशा असली दोषी का नाम बता देता है। उन प्रश्नचिह्नों के लिए जो ग्रंथसूची के दिखने के बाद भी बने रहते हैं, रहस्यमय उद्धरण चिह्न हटाना देखें।

लॉग साक्षरता पर वापस जाएँ