बंडलडॉक - क्लाउड में ऑनलाइन

कार्यक्रम:

नाम

बंडलडॉक - एक LaTeX दस्तावेज़ के लिए आवश्यक सभी फ़ाइलों को बंडल करें

SYNOPSIS

बंडलडॉक [--संस्करण] [--मदद] [--[नहीं]वाचाल] [--texfile=पट्टिका] [--निर्देशिका=डायरेक्टरी]
[--[नहीं]केवल स्थानीय] [--निकालना=स्ट्रिंग] [--शामिल=फाइलस्पेक] [--घोषणापत्र=पट्टिका]
[--listdeps=[हाँ|नहीं|केवल|rel]...] [--[नहीं]Keepdirs] [--कॉन्फ़िगरेशन=पट्टिका] रवानगी पट्टिका

वर्णन

बंडलडॉक के लिए एक पोस्ट-प्रोसेसर है स्नैपशॉट पैकेज जो सभी को एक साथ जोड़ता है
किसी दिए गए LaTeX दस्तावेज़ को बनाने के लिए आवश्यक कक्षाएं, पैकेज और फ़ाइलें। यह पढ़ता है रवानगी
उसे फ़ाइल करें स्नैपशॉट उसमें उल्लिखित प्रत्येक फाइल को तैयार करता है, ढूंढता है और उन्हें पैकेज करता है
एक एकल संग्रह फ़ाइल में (उदा., a .tar.gz फ़ाइल), सिस्टम में स्थानांतरित करने के लिए उपयुक्त,
किसी सहकर्मी को प्रेषित करना, आदि।

यथासंभव सरलतम उदाहरण के रूप में, एक LaTeX फ़ाइल पर विचार करें जिसे कहा जाता है, हैलो.टेक्स:

\RequirePackage{स्नैपशॉट} % बंडलडॉक द्वारा आवश्यक है
\documentclass[11pt]{लेख}

\शुरू{दस्तावेज़}
नमस्ते दुनिया!
\अंत{दस्तावेज़}

"\RequirePackage{स्नैपशॉट}" का कारण बनता है हैलो.डेप फ़ाइल का उत्पादन किया जाना है. कब बंडलडॉक is
फिर एक तर्क के रूप में "hello.dep" दिया गया, यह निर्भर फ़ाइलों का पता लगाता है - स्नैपशॉट.sty,
आलेख.सीएलएस, तथा आकार11.क्लो -- और उन्हें एक ही संग्रह फ़ाइल में बंडल कर देता है
हैलो.टेक्स और एक MANIFEST फ़ाइल (नीचे "विकल्प" में वर्णित है)।

विकल्प

निम्नलिखित विवरण में, somefile आपके मुख्य LaTeX दस्तावेज़ के नाम को संदर्भित करता है (संख्या)
विस्तार)।

बंडलडॉक द्वारा निर्मित निर्भरता फ़ाइल के नाम की आवश्यकता है स्नैपशॉट (सामान्य रूप से
somefile.dep). निम्नलिखित विकल्प भी दिए जा सकते हैं:

--संस्करण
आउटपुट बंडलडॉक स्क्रिप्ट का संस्करण क्रमांक. यह शेष सभी को ओवरराइड करता है
विकल्प.

--मदद
एक संक्षिप्त उपयोग संदेश दें. यह शेष सभी विकल्पों को ओवरराइड करता है।

--[नहीं]वाचाल (डिफ़ॉल्ट: "नोवरबोज़")
बंडलडॉक आम तौर पर त्रुटि संदेशों के अलावा कुछ भी आउटपुट नहीं होता है। "--verbose" के साथ,
यह प्रचुर स्थिति संदेशों को आउटपुट करता है।

--texfile=मुख्य .टेक्स पट्टिका (चूक जाना: somefile.tex)
स्नैपशॉटकी निर्भरता फ़ाइल में मुख्य LaTeX फ़ाइल (वह जो पास हो जाती है) सूचीबद्ध नहीं है
सेवा मेरे लाटेकस). के क्रम में बंडलडॉक उस फ़ाइल को ढूंढने और बंडल करने के लिए, बंडलडॉक यह मानता है
के समान नाम है स्नैपशॉट निर्भरता फ़ाइल लेकिन एक के साथ .टेक्स विस्तार। यदि यह हो तो
ऐसा नहीं है, तो सही फ़ाइल नाम निर्दिष्ट करने के लिए "--texfile" का उपयोग करें।

--निर्देशिका=संग्रह डायरेक्टरी (चूक जाना: somefile)
. बंडलडॉक एक संग्रह बनाता है (उदा., a ।टार or . ज़िप फ़ाइल) जिसमें शामिल है
दस्तावेज़ की फ़ाइलें, यह वर्तमान को अव्यवस्थित करने से बचने के लिए उन सभी को एक निर्देशिका में रखती है
फ़ाइलों के साथ निर्देशिका. यदि दी गई निर्भरता फ़ाइल को कॉल किया जाता है somefile.dep फिर
परिणामी संग्रह, डिफ़ॉल्ट रूप से, सभी आश्रित फ़ाइलों को संग्रहीत करेगा somefile
निर्देशिका। निर्देशिका का नाम बदलने के लिए "--निर्देशिका" विकल्प का उपयोग करें।

--[नहीं]केवल स्थानीय (डिफ़ॉल्ट: "नोलोकालोनली")
हालांकि बंडलडॉक आम तौर पर इसमें नामित सभी फाइलों को संग्रहित किया जाता है रवानगी फ़ाइल,
"--localonly" विकल्प बताता है बंडलडॉक किसी अन्य निर्देशिका में स्थित सभी फ़ाइलों को बाहर करने के लिए
से .टेक्स फ़ाइल की निर्देशिका या उसकी उपनिर्देशिकाओं में से एक।

--निकालना=स्ट्रिंग (चूक जाना: कोई नहीं)
जबकि "--localonly" फ़ाइलों को इसके बाहर उत्पन्न करता है .टेक्स फ़ाइल का निर्देशिका वृक्ष होना चाहिए
संग्रह से हटा दिया गया, "--बहिष्कृत" फ़ाइलों पर बेहतर नियंत्रण प्रदान करता है
संग्रह से हटा दें. "--बहिष्कृत" विकल्प, जिसे बार-बार निर्दिष्ट किया जा सकता है
कमांड लाइन, उन सभी फ़ाइलों का कारण बनती है जिनके नाम में शामिल है स्ट्रिंग से हटाया जाना है
पुरालेख।

--शामिल=फाइलस्पेक (चूक जाना: कोई नहीं)
"--शामिल" विकल्प, जिसे कमांड लाइन पर बार-बार निर्दिष्ट किया जा सकता है,
का निर्देश बंडलडॉक मेल खाने वाली सभी फाइलों को संग्रह में शामिल करना फाइलस्पेक, भी
यदि वे इसमें संदर्भित नहीं हैं रवानगी फ़ाइल.

--घोषणापत्र=प्रकट पट्टिका (चूक जाना: MANIFEST)
आश्रित फ़ाइलों के अलावा, बंडलडॉक संग्रह फ़ाइल में एक अतिरिक्त शामिल है
फ़ाइल को डिफ़ॉल्ट रूप से `` कहा जाता हैMANIFEST''। MANIFEST एक टेक्स्ट फ़ाइल है जो सूचीबद्ध करती है
सभी निर्भरताओं के मूल फ़ाइल नाम। फ़ाइल नाम को `` से बदलने के लिएMANIFEST''
किसी और चीज़ के लिए, "--मैनिफ़ेस्ट" विकल्प का उपयोग करें। एक विशेष मामले के रूप में, "--प्रकट = """
बताता है बंडलडॉक मेनिफेस्ट फ़ाइल को बिल्कुल भी शामिल न करें।

--listdeps=[हाँ|नहीं|केवल|rel]...] (डिफ़ॉल्ट: "नहीं")
"--listdeps" "हां", "नहीं", "केवल", या "rel" में से एक या अधिक को अल्पविराम से अलग किए गए के रूप में स्वीकार करता है
सूची। जब तक इस सूची में "नहीं" नहीं आता, बंडलडॉक सभी मुख्य को आउटपुट करता है
LaTeX फ़ाइल की निर्भरताएँ। यदि सूची में "rel" शामिल है, तो बंडलडॉक आउटपुट देता है
सापेक्ष पथनामों के साथ निर्भरताओं की सूची। यदि सूची में "केवल" शामिल है
बंडलडॉक सूची प्रदर्शित करने के बाद बिना कोई संग्रह तैयार किए बाहर निकल जाता है।

--[नहीं]Keepdirs (डिफ़ॉल्ट: "nokeepdirs")
आम तौर पर, संग्रह फ़ाइल वह है बंडलडॉक प्रोड्यूस में एक ही निर्देशिका होती है - और
उपनिर्देशिकाएँ, यदि दस्तावेज़ स्पष्ट रूप से उन्हें संदर्भित करता है - जिसमें सभी
आश्रित फ़ाइलें झूठ बोलती हैं। यदि "--keepdirs" निर्दिष्ट है, तो सभी आश्रित फ़ाइलें संग्रहीत की जाती हैं
उनके मूल पथनामों के साथ। उदाहरण के लिए, यदि somefile.tex पर निर्भर करता है
आंकड़े/somefigure.eps, आलेख.सीएलएस, तथा स्नैपशॉट.sty, फिर somefile पुरालेख होगा
आम तौर पर निम्नलिखित फ़ाइलें होती हैं:

· somefile/somefile.tex

· somefile/आंकड़े/somefigure.eps

· somefile/article.cls

· somefile/snapshot.sty

· कुछफ़ाइल/प्रकटीकरण

हालाँकि, "--keepdirs" इसका कारण बनेगा somefile निम्नलिखित प्रकारों को शामिल करने के लिए संग्रह करें
इसके बजाय फ़ाइल नाम:

· होम/मुझे/mydocs/somefile.tex

· होम/मुझे/mydocs/figures/somefigure.eps

· यूएसआर/शेयर/टेक्सएमएफ/टेक्स/लेटेक्स/बेस/आर्टिकल.सीएलएस

· usr/share/texmf/tex/latex/snapshot/snapshot.sty

जब "--keepdirs" प्रभावी हो तो "--directory" का उपयोग नहीं किया जाता है। इसके अलावा, कोई प्रकटीकरण नहीं
फ़ाइल को संग्रह फ़ाइल में लिखा जाता है क्योंकि इसमें अनावश्यक जानकारी होती है।

--कॉन्फ़िगरेशन=विन्यास पट्टिका (डिफ़ॉल्ट: )
"--config" विकल्प का उपयोग पॉइंट करने के लिए किया जाता है बंडलडॉक उचित विन्यास के लिए
(.cfg) आपके TeX वितरण और ऑपरेटिंग सिस्टम के लिए फ़ाइल। बंडलडॉक एक के साथ आता है
कुछ कॉन्फ़िगरेशन फ़ाइलें और अधिक लिखना आसान है। "कॉन्फ़िगरेशन फ़ाइलें" देखें
(नीचे) कॉन्फ़िगरेशन फ़ाइल स्वरूप के विवरण के लिए।

विन्यास फ़ाइलें

प्रारूप
कॉन्फ़िगरेशन फ़ाइलें काफी सरल प्रारूप का पालन करती हैं। "#" से शुरू होने वाली पंक्तियाँ टिप्पणियाँ हैं।
ख़ाली रेखाओं को नज़रअंदाज कर दिया जाता है. अन्य सभी पंक्तियाँ इस प्रकार हैं:

परिवर्तनशील: मान

के वर्तमान संस्करण बंडलडॉक निम्नलिखित चर को पहचानता है:

बंडल
फ़ाइलों के एक सेट को एकल संग्रह फ़ाइल में बंडल करने के लिए उपयोग करने का आदेश

सिंक
किसी कमांड के आउटपुट को त्यागने के लिए उसका प्रत्यय

खोज
TeX ट्री के भीतर फ़ाइल ढूंढने का आदेश।

जो मान एक पंक्ति के लिए बहुत लंबे हैं उन्हें "\" का उपयोग करके कई पंक्तियों में विभाजित किया जा सकता है
पंक्ति-निरंतरता प्रतीक.

दो पर्यावरण चर हैं बंडलडॉक द्वारा उपयोग हेतु उपलब्ध कराता है
कॉन्फ़िगरेशन-फ़ाइल आदेश: "बीडीबीएएसई", जो पर सेट है somefile (जैसा कि "विकल्प" में है), और
"BDINPUTS", जो उन फ़ाइलों की एक स्थान-पृथक सूची पर सेट है जिन्हें एक कमांड को संचालित करना है
ऊपर। यानी, जब "बंडल" से जुड़ा कमांड चल रहा होता है, तो "BDINPUTS" शामिल होता है
संग्रहीत की जाने वाली सभी फ़ाइलों की सूची। इसके विपरीत, जब आदेश
"खोज" से संबद्ध चल रहा है, "BDINPUTS" में खोजने के लिए फ़ाइल का नाम शामिल है।

उदाहरण
निम्नलिखित कॉन्फ़िगरेशन फ़ाइल समानताएं हैं बंडलडॉकविभिन्न के डिफ़ॉल्ट मान
कॉन्फ़िगरेशन-फ़ाइल चर, जो एक kpathsea-आधारित TeX वितरण को चलाने का प्रतिनिधित्व करता है
एक सामान्य यूनिक्स प्रणाली पर, जिसमें आवश्यक रूप से कोई GNU उपकरण नहीं है, जैसे
gzip या जीएनयू टार:

# "डिफ़ॉल्ट" कॉन्फ़िगरेशन फ़ाइल
# स्कॉट पाकिन <स्कॉट+ द्वारा[ईमेल संरक्षित]>

बंडल: (tar -cvf - $BDINPUTS | कंप्रेस > $BDBASE.tar.Z)
सिंक: > /dev/null 2>&1
खोजें: kpsewho -progname=latex $BDINPUTS

"बंडल:" पंक्ति में कोष्ठक यूनिक्स शेल को कमांड को चलाने के लिए कहते हैं
उपकोश. यह "सिंक:" प्रत्यय को ठीक से काम करने के लिए है (यानी, ताकि दो न हों)।
">" एक ही कमांड में है)।

ध्यान दें कि कमांड "BDBASE" और "BDINPUTS" को किसी अन्य पर्यावरण चर की तरह कैसे व्यवहार करते हैं
यूनिक्स शेल में, उनका मान लेने के लिए "$" का उपयोग करें। अन्य ऑपरेटिंग सिस्टम अलग-अलग उपयोग करते हैं
पर्यावरण चरों को संदर्भित करने के लिए परंपराएँ। उदाहरण के लिए, एक कॉन्फ़िगरेशन फ़ाइल
विंडोज़-आधारित TeX वितरण के लिए इसके बजाय "%BDBASE%" और "%BDINPUTS%" का उपयोग किया जाएगा।

"सिंक:" का मान किसी ऑपरेटिंग सिस्टम के लिए विशिष्ट है। "खोजें:" का मान है
TeX वितरण के लिए विशिष्ट। "बंडल:" वह जगह है जहां अनुकूलन के लिए सबसे अधिक अवसर हैं
झूठ। आप अपना पसंदीदा संग्रह प्रारूप निर्दिष्ट करने के लिए "बंडल:" का उपयोग कर सकते हैं। उदाहरण के लिए, आप
यूनिक्स पर कुछ इस तरह से एक शार फ़ाइल तैयार कर सकते हैं:

बंडल: (shar --archive-name='$BDBASE' $BDINPUTS > $BDBASE.sh)

या Microsoft Windows पर CAB फ़ाइल कुछ इस प्रकार है:

बंडल: कैबार्क -आर -पी एन %बीडीबीएएसई%.कैब %बीडीआईएनपुट्स%

उदाहरण

मान लो की myfile.dep से उत्पादित किया गया था myfile.tex में दिए गए निर्देशों का पालन करके
विवरण अनुभाग. निम्न आदेश एक उत्पन्न करता है . ज़िप MikTeX TeX के साथ फ़ाइल करें
Microsoft Windows पर वितरण चल रहा है:

बंडलडॉक --config=miktex.cfg myfile.dep

(व्यवहार में, "--config" को पूरा पथ निर्दिष्ट करना संभवतः आवश्यक है
बंडलडॉक's miktex.cfg विन्यास फाइल।)

निम्नलिखित बनाता है a .tar.gz यूनिक्स पर चल रहे TeX लाइव वितरण के साथ संग्रह करें-
ऑपरेटिंग सिस्टम की तरह. बंडलडॉक अपने परिचालनों का वर्णन करते हुए वर्बोज़ आउटपुट उत्पन्न करेगा।
सभी फ़ाइलें समान निर्देशिका ट्री में नहीं हैं myfile.tex और ".fd" या वाली सभी फ़ाइलें
उनके नाम से ".sty" हटा दिया गया है। हालाँकि, सभी .बिब वर्तमान निर्देशिका में फ़ाइलें होंगी
संग्रह में शामिल किया जाए, भले ही उनमें से किसी का भी संदर्भ न दिया गया हो myfile.dep.
अंत में, नहीं MANIFEST फाइल तैयार की जाएगी।

बंडलडॉक --config=texlive-unix.cfg --verbose --localonly \
--exclude=.fd --exclude=.cfg --include='*.bib' --manifest='' \
myfile.dep

onworks.net सेवाओं का उपयोग करके ऑनलाइन बंडलडॉक का उपयोग करें