अपरिभाषित कंट्रोल सीक्वेंस

अज्ञात कमांड नाम: टाइपो, गायब पैकेज, गलत इंजन।

अपरिभाषित कंट्रोल सीक्वेंस

लक्षण

कंपाइल ! Undefined control sequence. के साथ रुक जाता है। फिर लॉग वह पंक्ति दिखाता है जहाँ यह हुआ, दो हिस्सों में टूटी हुई: ऊपर की पंक्ति में वह सब जो TeX ने आपत्तिजनक कमांड तक, उसे मिलाकर, पढ़ा था, और उसके नीचे स्रोत पंक्ति का बाकी हिस्सा। उस ऊपरी पंक्ति का आख़िरी टोकन वही कमांड है जिसे TeX पहचान नहीं पाया, इसलिए यह उन त्रुटियों में से है जिनकी सटीक जगह ढूँढना सबसे आसान है।

यह क्यों होता है

कंट्रोल सीक्वेंस हर वह चीज़ है जो बैकस्लैश से शुरू होती है। TeX के पास कोई तय शब्दावली नहीं है: कमांड तभी मौजूद होते हैं जब कर्नेल, डॉक्यूमेंट क्लास, कोई पैकेज या आपका अपना \newcommand उन्हें परिभाषित करे। जब TeX बैकस्लैश के बाद ऐसा नाम पढ़ता है जिसे किसी ने परिभाषित नहीं किया, तो वह अंदाज़ा नहीं लगा सकता कि आपका मतलब क्या था, और रुक जाता है। त्रुटि कभी इस बारे में नहीं होती कि कमांड आम तौर पर “गलत” है। वह इस बारे में होती है कि यह नाम इस दस्तावेज़ में, इस जगह पर, इस इंजन के तहत अज्ञात है।

तीन जाँचों में ठीक करें

पहले वर्तनी जाँचें। \textbf की जगह \texbf, \label की जगह \lable, या नाम को दो हिस्सों में तोड़ने वाली भटकी हुई स्पेस, ज़्यादातर मामले इन्हीं से बनते हैं। लॉग की पंक्ति संख्या आपको सीधे टाइपो तक ले जाती है।

अगर वर्तनी सही है, तो उसे परिभाषित करने वाला पैकेज शायद गायब है। \includegraphics \usepackage{graphicx} के बिना कुछ नहीं करता, \toprule को booktabs चाहिए, और \SI को siunitx। यह सबसे ज़्यादा तब चुभता है जब आप किसी दूसरे दस्तावेज़ से या किसी मॉडल के जवाब से स्निपेट कॉपी करते हैं: मुख्य पाठ साथ आ गया, प्रीएम्बल की पंक्ति नहीं आई। कौन-सा पैकेज किस कमांड को परिभाषित करता है, यह हर कमांड की व्याख्या में खोजें, \usepackage पंक्ति जोड़ें और फिर से कंपाइल करें। अगर पैकेज ही इंस्टॉल नहीं है, तो गायब पैकेज इंस्टॉल करना देखें।

अगर पैकेज लोड है और त्रुटि फिर भी बनी रहती है, तो इंजन पर शक करें। कुछ कमांड सिर्फ़ किसी खास इंजन के तहत मौजूद होते हैं: \fontspec और उसके साथी कमांडों के लिए XeLaTeX या LuaLaTeX चाहिए, और वे pdfLaTeX के तहत ठीक इसी त्रुटि के साथ रुक जाएँगे। जिन टेम्पलेट के दस्तावेज़ीकरण में इंजन बताया गया होता है, वे आम तौर पर इसी वजह से बताते हैं। फ़र्क इस प्रोजेक्ट के लिए कौन-सा इंजन में समझाए गए हैं।

जानने लायक दो खासियतें

क्रम मायने रखता है: जो कमांड उसे परिभाषित करने वाली \usepackage पंक्ति से पहले इस्तेमाल हुआ, वह उस जगह पर अब भी अपरिभाषित है, इसलिए पैकेज लोड करना प्रीएम्बल में, \begin{document} के ऊपर रखें। और एक त्रुटि अक्सर दूसरी को छिपा लेती है, क्योंकि TeX के सँभलने के बाद वह आगे का सब कुछ गलत पढ़ सकता है। लॉग की पहली अपरिभाषित कंट्रोल सीक्वेंस ठीक करें, फिर से कंपाइल करें, और उसके बाद ही देखें कि क्या बचा है।

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