यूनिवर्सिटी की क्लास फ़ाइलें जो कंपाइल नहीं होतीं
प्राथमिक जाँच: पहली त्रुटि, इंजन, अप्रचलित पैकेज, बाइनरी सर्च।
यूनिवर्सिटी की क्लास फ़ाइलें जो कंपाइल नहीं होतीं
यूनिवर्सिटी के थीसिस टेम्पलेट एक ख़ास तरह का लेगेसी कोड हैं। किसी ग्रेजुएट छात्र ने पंद्रह साल पहले उस समय की TeX डिस्ट्रीब्यूशन के हिसाब से क्लास फ़ाइल लिखी, पढ़ाई पूरी करके चला गया, और उसे जमी हुई छोड़ गया जबकि LaTeX का परिवेश आगे बढ़ गया। आज जब आप universitythesis.cls डाउनलोड करते हैं और वह त्रुटियों से भरी स्क्रीन के साथ मर जाती है, तो क्लास आमतौर पर टूटी हुई कम होती है, समय में अटकी हुई ज़्यादा। फिर भी इन गड़बड़ियों के रूप अनुमान-योग्य हैं, और जाँच का एक तय क्रम इनमें से ज़्यादातर को सुलझा देता है।
सिर्फ़ पहली त्रुटि से शुरू करें
LaTeX की विफलता एक के बाद एक गिरती जाती है: क्लास में शुरू का एक अपरिभाषित कमांड आगे दर्जनों ऐसी त्रुटियाँ पैदा कर सकता है जिनका कोई मतलब नहीं। लॉग में ! से शुरू होने वाली पहली पंक्ति तक स्क्रॉल करें, उसे ठीक करें, और कुछ और पढ़ने से पहले दोबारा कंपाइल करें। इस चक्र को दोहराने से अक्सर डरावनी त्रुटियों की दीवार तीन-चार पास में साफ़ हो जाती है। अगर पहली त्रुटि किसी अनजान कमांड की है, तो Undefined control sequence निदान क्रम से समझाता है।
इंजन जाँचें
कई टेम्पलेट किसी ख़ास इंजन को मानकर चलते हैं और किसी और के नीचे अजीब ढंग से फ़ेल होते हैं। जो क्लास fontspec लोड करती है या फ़ॉन्ट को नाम से सेट करती है, उसे XeLaTeX या LuaLaTeX चाहिए; जो क्लास pdftex-विशिष्ट प्रिमिटिव के इर्द-गिर्द बनी है, वह दोनों पर फ़ेल हो सकती है। क्लास फ़ाइल के ऊपर के पास कोई टिप्पणी, या यूनिवर्सिटी के निर्देशों में कोई पंक्ति ढूँढें जो मनचाहे इंजन का नाम बताती हो, और कुछ और डीबग करने से पहले उसी से मेल बिठाएँ। फ़र्क़ इस प्रोजेक्ट के लिए कौन-सा इंजन में समेटे गए हैं।
जो आपके हाथ में है उसे आधुनिक बनाएँ
पुराने टेम्पलेट ऐसे अप्रचलित पैकेज लोड करते हैं जिनके आधुनिक विकल्प आपकी डिस्ट्रीब्यूशन में पहले से मौजूद हैं, और फिर दोनों में टकराव होता है; आपस में टकराने वाले पैकेज में पुराने जाने-पहचाने जोड़े गिनाए गए हैं। काम करने लायक रणनीति यह है कि क्लास फ़ाइल को ख़ुद न छुएँ, क्योंकि यूनिवर्सिटी की फ़ॉर्मेटिंग की शर्तें वहीं रहती हैं, और सिर्फ़ अपना प्रीएम्बल आधुनिक करें: अप्रचलित \usepackage पंक्तियाँ हटाएँ, hyperref को देर से लोड करें, और जो कुछ क्लास पहले ही लोड करती है उसे दोबारा लोड करने से बचें।
प्रीएम्बल में बाइनरी सर्च करें
जब त्रुटि जाँच-पड़ताल में हाथ न आए, तो अपने प्रीएम्बल का दूसरा आधा हिस्सा कमेंट कर दें और दोबारा कंपाइल करें। अगर त्रुटि ग़ायब हो जाए, तो कारण कमेंट किए गए आधे हिस्से में है; उसका आधा वापस लगाएँ और दोहराएँ। मुट्ठी भर कंपाइल उस अकेली दोषी पंक्ति को अलग कर देते हैं, जो उस प्रीएम्बल के बारे में तर्क करने से कहीं तेज़ है जिसे आपने लिखा ही नहीं।
तकलीफ़ झेलने से पहले खोजें
उस यूनिवर्सिटी का हर छात्र वही क्लास कंपाइल करता है, इसलिए आपकी त्रुटि से पहले भी कोई टकरा चुका होगा। ठीक-ठीक त्रुटि संदेश को क्लास फ़ाइल के नाम के साथ खोजें, और देखें कि यूनिवर्सिटी या कोई बाद का छात्र GitHub पर पैच किया हुआ फ़ॉर्क संभाल रहा है या नहीं। जब कोई देखरेख वाला फ़ॉर्क मौजूद हो, तो उसे इस्तेमाल करना जाने-पहचाने बग को अकेले दोबारा ठीक करने से बेहतर है।