विश्वविद्यालय कक्षा फ़ाइलें जो संकलित नहीं होंगी

विश्वविद्यालय थीसिस टेम्पलेट एक विशेष प्रकार का विरासत कोड है। एक स्नातक छात्र ने पंद्रह साल पहले उस दिन के TeX वितरण के विरुद्ध कक्षा फ़ाइल लिखी, स्नातक की उपाधि प्राप्त की, और इसे स्थिर छोड़ दिया जबकि LaTeX पारिस्थितिकी तंत्र आगे बढ़ गया। जब आप आज universitythesis.cls डाउनलोड करते हैं और यह त्रुटियों की एक स्क्रीन के साथ बंद हो जाता है, तो कक्षा आमतौर पर इतनी टूटी नहीं होती है जितनी कि समय में फंस जाती है। हालाँकि, विफलता मोड पूर्वानुमानित हैं, और एक निश्चित ट्राइएज क्रम उनमें से अधिकांश को हल करता है।

पहली त्रुटि से ही शुरुआत करें

एक LaTeX विफलता कैस्केड होती है: कक्षा की शुरुआत में एक अपरिभाषित कमांड दर्जनों डाउनस्ट्रीम त्रुटियां उत्पन्न कर सकता है जिसका कोई मतलब नहीं है। लॉग को ! से शुरू होने वाली पहली पंक्ति तक स्क्रॉल करें, उसे ठीक करें, और कुछ भी पढ़ने से पहले पुनः संकलित करें। इस लूप को दोहराने से अक्सर तीन या चार बार में एक भयावह त्रुटि दीवार साफ़ हो जाती है। यदि पहली त्रुटि एक अज्ञात कमांड है, तो अपरिभाषित नियंत्रण अनुक्रम निदान के माध्यम से चलता है।

इंजन की जाँच करें

कई टेम्प्लेट एक विशिष्ट इंजन को मानते हैं और किसी अन्य के अंतर्गत विचित्र रूप से विफल हो जाते हैं। एक वर्ग जो fontspec लोड करता है या नाम से फ़ॉन्ट सेट करता है उसे XeLaTeX या LuaLaTeX की आवश्यकता होती है; पीडीएफटेक्स-विशिष्ट प्राइमेटिव्स के आसपास निर्मित एक वर्ग दोनों के अंतर्गत विफल हो सकता है। क्लास फ़ाइल के शीर्ष के पास एक टिप्पणी या विश्वविद्यालय के निर्देशों में इच्छित इंजन का नाम देने वाली एक पंक्ति देखें, और कुछ भी डीबग करने से पहले उसका मिलान करें। अंतरों को संक्षेप में [इस परियोजना के लिए कौन सा इंजन] (/ सीखें/इंजन-तुलना/) में प्रस्तुत किया गया है।

जो आप नियंत्रित करते हैं उसे आधुनिक बनाएं

पुराने टेम्प्लेट अप्रचलित पैकेज लोड करते हैं जिनके आधुनिक प्रतिस्थापन पहले से ही आपके वितरण में हैं, और जोड़ी फिर लड़ती है; पैकेज जो एक-दूसरे से लड़ते हैं क्लासिक संयोजनों को सूचीबद्ध करता है। व्यावहारिक रणनीति यह है कि क्लास फ़ाइल को अकेला छोड़ दिया जाए, क्योंकि विश्वविद्यालय की प्रारूपण आवश्यकताएँ वहाँ रहती हैं, और केवल अपनी स्वयं की प्रस्तावना को आधुनिक बनाएं: अप्रचलित \usepackage लाइनों को हटा दें, hyperref को देर से लोड करें, और क्लास में पहले से लोड की गई किसी भी चीज़ को दोबारा लोड करने से बचें।

बाइनरी-प्रस्तावना खोजें

जब त्रुटि निरीक्षण का विरोध करती है, तो अपनी प्रस्तावना के दूसरे भाग पर टिप्पणी करें और पुनः संकलित करें। यदि त्रुटि गायब हो जाती है, तो ट्रिगर टिप्पणी वाले आधे हिस्से में है; इसका आधा हिस्सा पुनर्स्थापित करें और दोहराएं। मुट्ठी भर संकलन गलती वाली एकल पंक्ति को अलग कर देते हैं, जो आपके द्वारा नहीं लिखी गई प्रस्तावना के बारे में तर्क करने से कहीं अधिक तेज़ है।

कष्ट सहने से पहले खोजें

उस विश्वविद्यालय का प्रत्येक छात्र एक ही कक्षा संकलित करता है, इसलिए आपकी त्रुटि लगभग निश्चित रूप से पहले ही प्रभावित हो चुकी है। क्लास फ़ाइल के नाम के साथ सटीक त्रुटि संदेश खोजें, और जांचें कि क्या विश्वविद्यालय या उत्तराधिकारी छात्र GitHub पर एक पैच फोर्क रखता है। जब कोई मौजूद हो तो उसका उपयोग करना, ज्ञात बगों को अपने आप ठीक करने से बेहतर होता है।