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