एक रूट फ़ाइल, कई अध्याय

include बनाम input, includeonly, और एक बार में एक अध्याय का ड्राफ़्ट।

एक रूट फ़ाइल, कई अध्याय

एक ही .tex फ़ाइल में लिखी थीसिस पर काम करना दूसरे अध्याय तक पहुँचते-पहुँचते कठिन हो जाता है: सोचने की जगह स्क्रॉल करना पड़ता है, और हर कंपाइल पूरी फ़ाइल को प्रोसेस करता है। मानक उपाय यह है कि एक रूट फ़ाइल में क्लास और प्रीएम्बल रखें और हर अध्याय अपनी अलग फ़ाइल में लिखें। रूट फ़ाइल इन सबको आपस में जोड़ देती है।

रूट फ़ाइल

% main.tex
\documentclass{report}
\begin{document}
\include{chapters/intro}
\include{chapters/methods}
\include{chapters/results}
\end{document}

main.tex ही वह एकमात्र फ़ाइल है जिसे आप कंपाइल करते हैं। हर \include किसी दूसरी फ़ाइल का नाम उसके .tex एक्सटेंशन के बिना देता है, सभी प्लेटफ़ॉर्म पर फ़ॉरवर्ड स्लैश के साथ, और उसी जगह उस फ़ाइल की सामग्री खींच लाता है। अध्याय फ़ाइलों में केवल सामग्री होती है, जो आम तौर पर \chapter{...} से शुरू होती है। उनमें अपना \documentclass या document एनवायरनमेंट नहीं होता, क्योंकि वे इस दस्तावेज़ के हिस्से हैं, अलग दस्तावेज़ नहीं।

include बनाम input

शामिल करने वाले ये दोनों कमांड अलग तरह से काम करते हैं, और यही अंतर तय करता है कि कहाँ कौन-सा इस्तेमाल करें। \include सामग्री से पहले नया पेज शुरू करता है, जो अध्यायों के लिए ठीक रहता है, और हर शामिल की गई फ़ाइल के लिए अलग .aux फ़ाइल लिखता है, जिससे चुनिंदा कंपाइल संभव होता है। \input सीधा टेक्स्ट चिपकाता है: न पेज बदलता है, न अलग .aux बनती है, और इसे किसी दूसरे input के अंदर भी रखा जा सकता है। इसलिए अध्याय से छोटे हिस्सों के लिए \input सही औज़ार है, जैसे अपनी फ़ाइल में रखी कोई बड़ी तालिका या साझा मैक्रो फ़ाइल। एक संरचनात्मक नियम याद रखें: \include को किसी शामिल की गई फ़ाइल के अंदर नहीं रखा जा सकता, जबकि \input कहीं भी इस्तेमाल हो सकता है।

एक बार में एक अध्याय का ड्राफ़्ट

\includeonly{chapters/methods}

प्रीएम्बल में रखने पर \includeonly LaTeX से कहता है कि वह केवल सूची में दी गई फ़ाइलों को प्रोसेस करे, जबकि बाकी सभी फ़ाइलों का सहेजा हुआ .aux डेटा पढ़ता रहे। कंपाइल बहुत तेज़ हो जाता है, और बाकी अध्यायों के लेबल और पेज की गिनती उनकी .aux फ़ाइलों से दोबारा लागू हो जाती है, इसलिए जिस अध्याय का आप ड्राफ़्ट लिख रहे हैं उसमें क्रॉस-रेफ़रेंस और क्रमांक सही बने रहते हैं। यही दूसरा हिस्सा \include पंक्तियों को कमेंट करने के बजाय इसे चुनने का कारण है, क्योंकि कमेंट करने पर LaTeX बाकी अध्यायों को पूरी तरह भूल जाता है और उनकी ओर जाने वाला हर \ref ?? में बदल जाता है।

पूरा बिल्ड बनाते समय \includeonly वाली पंक्ति को कमेंट कर दें, और PDF साझा करने से पहले हमेशा पूरा कंपाइल चलाएँ, क्योंकि बाहर रखे गए अध्यायों में किए गए बदलावों से पुराना .aux डेटा पीछे रह सकता है। नतीजे वाले फ़ोल्डर में कौन-सी फ़ाइलें आपकी हैं और कौन-सी अपने आप बनी हैं, यह जानने के लिए असली प्रोजेक्ट की फ़ाइलें देखें।

लंबे दस्तावेज़ पर वापस जाएँ