आप एक से ज़्यादा बार कंपाइल क्यों करते हैं

Aux फ़ाइलें, ग्रंथसूची पास, और पहली बार में संदर्भ ?? क्यों छपते हैं।

आप एक से ज़्यादा बार कंपाइल क्यों करते हैं

देर-सवेर आप कोई दस्तावेज़ कंपाइल करेंगे, PDF खोलेंगे, और जहाँ चित्र का क्रमांक या उद्धरण होना चाहिए वहाँ ?? पाएँगे। कुछ टूटा नहीं है। एक कंपाइल आपकी फ़ाइल पर एक पास होता है, और कुछ जानकारी सचमुच एक पास में पता नहीं चल सकती।

समस्या का छोटा रूप यह है। पृष्ठ 2 पर आप लिखते हैं “चित्र \ref{fig:results} देखें”, लेकिन वह चित्र पृष्ठ 7 पर आता है। जब इंजन पृष्ठ 2 टाइपसेट करता है, तब वह पृष्ठ 7 तक पहुँचा नहीं होता, इसलिए उसे अंदाज़ा नहीं होता कि चित्र को कौन-सा क्रमांक मिलेगा। यही बात विषय-सूची पर भी लागू होती है, जिसे पहला पृष्ठ पूरा होने से पहले ही हर अनुभाग का पृष्ठ क्रमांक चाहिए।

इंजन इसे कैसे हल करता है

LaTeX इंजन आपकी .tex फ़ाइल पढ़ता है, हर मैक्रो को हल करता है, और PDF लिखता है। PDF के साथ वह छोटी सहायक फ़ाइलें भी लिखता है: लेबल और उद्धरणों के लिए .aux, विषय-सूची के लिए .toc, फ़ॉर्मेट की गई ग्रंथसूची के लिए .bbl। ये फ़ाइलें इंजन के अपने भविष्य के लिए छोड़े गए नोट्स हैं।

  1. पहले पास में इंजन आपका पाठ टाइपसेट करता है और जो भी \label और \cite उसे मिलता है, उसे .aux फ़ाइल में लिख देता है। जहाँ उसे ऐसा क्रमांक चाहिए जो वह अभी नहीं जानता, वहाँ वह ?? छापता है।
  2. अगर आप कुछ भी उद्धृत करते हैं, तो ग्रंथसूची उपकरण (bibtex या biber) .aux फ़ाइल पढ़ता है, आपके .bib डेटाबेस में हर उद्धरण खोजता है, और फ़ॉर्मेट की गई संदर्भ सूची .bbl फ़ाइल में लिख देता है।
  3. दूसरे और कभी-कभी तीसरे पास में इंजन उन सहायक फ़ाइलों को वापस पढ़ता है, इसलिए क्रॉस-रेफ़रेंस, विषय-सूची की प्रविष्टियाँ और उद्धरण लेबल आखिरकार असली क्रमांकों में बदल जाते हैं।

आधुनिक सेटअप ये पास आपके लिए अपने-आप चला देते हैं, इसलिए व्यवहार में आप कमांड खुद कम ही टाइप करते हैं। पर इस चक्र को जानने से लक्षण समझ आता है: कोई लेबल या उद्धरण जोड़ने के बाद नया ?? दिखे, तो इसका मतलब बस इतना है कि सहायक फ़ाइलें अभी पीछे हैं, और एक और कंपाइल इसे ठीक कर देता है।

इंजन, एक-एक पंक्ति में

कई प्रोग्राम “इंजन” की भूमिका निभा सकते हैं। pdfLaTeX क्लासिक चुनाव है और इसे सबसे व्यापक जर्नल समर्थन मिलता है। XeLaTeX पूरा Unicode जोड़ता है और आपको अपने सिस्टम में इंस्टॉल फ़ॉन्ट इस्तेमाल करने देता है। LuaLaTeX भी Unicode समझता है और उन्नत पैकेजों के लिए एक स्क्रिप्टिंग भाषा समाहित करता है। Tectonic एक आधुनिक इंजन है जो पैकेज पहली बार ज़रूरत पड़ने पर माँग के अनुसार डाउनलोड करता है। Oleafly इसे साथ में बंडल करता है, ताकि पहले TeX डिस्ट्रीब्यूशन इंस्टॉल किए बिना नया प्रोजेक्ट कंपाइल हो जाए।

ज़्यादातर दस्तावेज़ों के लिए अंतर मुश्किल से मायने रखते हैं। जिसकी आपका टेम्पलेट या प्रकाशन मंच अपेक्षा करता है, वही चुनें और आगे बढ़ें। जब आपको सोच-समझकर चुनना हो, तब इंजनों की तुलना देखें।

जब सचमुच कुछ विफल हो

विफल कंपाइल एक लंबा लॉग उगल देता है, और स्वाभाविक झुकाव उसे नीचे से ऊपर पढ़ने का होता है। इससे बचें। लॉग की पहली त्रुटि पढ़ें और केवल उसी को ठीक करें। बाद की त्रुटियाँ बहुत बार पहली के कारण पैदा हुआ सिलसिलेवार शोर होती हैं। अगर लगातार दो सफल कंपाइल के बाद भी संदर्भ ?? छपते रहें, तो आमतौर पर दोषी \label या \ref के नाम में टाइपो होता है, किसी पास का छूटना नहीं।

लूप खोलें पर वापस जाएँ