असली प्रोजेक्ट की फ़ाइलें
.tex, .bib, .cls, .sty, और जेनरेट हुआ कचरा जिसे आपको कमिट नहीं करना चाहिए।
असली प्रोजेक्ट की फ़ाइलें
किसी भी असली LaTeX प्रोजेक्ट का फ़ोल्डर कंपाइल के बाद खोलें, तो आपको उससे कहीं ज़्यादा फ़ाइलें मिलेंगी जितनी आपने लिखीं। यह ज़्यादातर शुरुआती लोगों को चौंकाता है, और गलत चीज़ मिटा देने का डर फ़ोल्डरों को हमेशा के लिए बेतरतीब रखता है। जो भेद इसे साफ़ कर देता है वह यह है: कुछ फ़ाइलें वह सोर्स हैं जिन्हें आप संपादित करते हैं, कुछ टेम्पलेट या पैकेज से मिली स्टाइलें हैं, और बाकी जेनरेट हुई कामचलाऊ जगह है जिसे कंपाइलर हर बार दोबारा बना देता है।
वे फ़ाइलें जो आप लिखते हैं
आपकी .tex फ़ाइलों में असली दस्तावेज़ होता है: टेक्स्ट, सेक्शन, आकृतियाँ और गणित। .bib फ़ाइल आपका ग्रंथ-सूची डेटाबेस है, हर उस शोध-पत्र या किताब की एक प्रविष्टि जिसे आप उद्धृत कर सकते हैं; आप उसे हाथ से सँभाल सकते हैं या Zotero जैसे रेफ़रेंस मैनेजर से एक्सपोर्ट कर सकते हैं। इन्हीं फ़ाइलों का बैकअप लेना और इन्हें वर्ज़न कंट्रोल में रखना ठीक है, क्योंकि बाकी सब कुछ इनसे दोबारा बनाया जा सकता है।
वे फ़ाइलें जो टेम्पलेट देता है
.cls फ़ाइल एक डॉक्यूमेंट क्लास तय करती है, वही चीज़ जिसका नाम आप \documentclass{...} में लिखते हैं। जर्नल और सम्मेलन अपनी-अपनी क्लास साथ भेजते हैं ताकि हर सबमिशन एक-सा दिखे, और आप उसे लगभग कभी संपादित नहीं करते। .sty फ़ाइल एक पैकेज है: दोबारा इस्तेमाल होने वाले मैक्रो और सेटिंग जो \usepackage से लोड होते हैं। आप खुद एक तभी लिखेंगे जब कई दस्तावेज़ों में अपने कस्टम कमांड साझा करना चाहेंगे। .bst फ़ाइल BibTeX उद्धरण शैली बताती है और इसी तरह आम तौर पर प्रकाशन मंच ही इसे डाल देता है।
वे फ़ाइलें जो कंपाइलर बनाता है
.aux फ़ाइल कंपाइल के चरणों के बीच क्रॉस-रेफ़रेंस और उद्धरण का डेटा रखती है; उसे कभी संपादित न करें, और बेझिझक मिटा दें, क्योंकि अगला कंपाइल उसे दोबारा लिख देता है। .log फ़ाइल कंपाइलर के किए हर काम का रिकॉर्ड रखती है और केवल तब खोलने लायक है जब कुछ गड़बड़ हो। .pdf वह आउटपुट है जो आपको असल में चाहिए था।
| एक्सटेंशन | भूमिका | हाथ से संपादित करें? |
|---|---|---|
.tex | सोर्स दस्तावेज़ और अध्याय | हाँ |
.bib | ग्रंथ-सूची डेटाबेस | हाँ (या Zotero से एक्सपोर्ट करें) |
.cls | डॉक्यूमेंट क्लास | कभी-कभार, बाहरी टेम्पलेट |
.sty | पैकेज / स्टाइल फ़ाइलें | जब अपने मैक्रो लिख रहे हों |
.bst | BibTeX स्टाइल | कभी-कभार |
.aux | क्रॉस-रेफ़रेंस डेटा | नहीं: अपने आप जेनरेट होती है |
.log | कंपाइलर लॉग | डीबग करते समय पढ़ें |
.pdf | आउटपुट | देखें / सबमिट करें |
ऐसा प्रोजेक्ट ढाँचा जो बड़ा होने पर भी चले
paper/ main.tex chapters/ figures/ refs.bibऊपरी स्तर पर एक main.tex प्रवेश-बिंदु का काम करती है, अध्याय अपने फ़ोल्डर में रहते हैं और \input या \include से खींचे जाते हैं, इमेजें figures/ में रहती हैं, और ग्रंथ-सूची एक ही refs.bib में रहती है। यह ढाँचा चार पेज के शोध-पत्र के लिए भी सँभालने लायक रहता है और थीसिस के लिए भी। अध्याय फ़ाइलों को बाँटना दिखाता है कि ये टुकड़े कैसे जुड़ते हैं।
अगर आप Git इस्तेमाल करते हैं, तो *.aux, *.log और जेनरेट हुई बाकी फ़ाइलों को .gitignore में जोड़ दें ताकि आपका इतिहास केवल असली सोर्स को ट्रैक करे। Oleafly के प्रोजेक्ट डिस्क पर साधारण फ़ोल्डर होते हैं, इसलिए यह सलाह वहाँ बिना बदले लागू होती है। सबसे आम गलती इसकी उलटी है: किसी अजीब कंपाइल त्रुटि की तलाश में अक्सर .aux फ़ाइलें हटा देना ही हल निकलता है, क्योंकि किसी बिगड़े रन की पुरानी फ़ाइल उसके बाद के हर कंपाइल को खराब कर सकती है।