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

कार्यक्रम:

नाम

dtplite - लाइटवेट डॉकटूल्स मार्कअप प्रोसेसर

SYNOPSIS

dtplite -o उत्पादन विकल्प? प्रारूप इनपुट फ़ाइल

dtplite मान्य इनपुट फ़ाइल

dtplite -o उत्पादन विकल्प? प्रारूप इनपुटनिर्देशिका

dtplite -मर्ज -o उत्पादन विकल्प? प्रारूप इनपुटनिर्देशिका

_________________________________________________________________________________________________

वर्णन

इस दस्तावेज़ द्वारा वर्णित आवेदन, dtplite, अत्यंत का उत्तराधिकारी है
सरल mpexpand. से इसकी कार्यक्षमता प्रभावित हुई डीटीपी doctools प्रोसेसर यह बहुत है
से अधिक शक्तिशाली mpexpand, फिर भी उपयोग में उतना ही आसान; निश्चित रूप से इससे भी आसान डीटीपी इसके साथ
असंख्य उपआदेश और विकल्प।

dtplite पैकेज पर आधारित है doctools, अन्य दो प्रोसेसर की तरह।

उपयोग मामलों
dtplite निम्नलिखित तीन उपयोग मामलों को ध्यान में रखकर लिखा गया था।

[1] किसी एकल दस्तावेज़ का सत्यापन, यानी यह जांचना कि यह वैध लिखा गया है
डॉक्टरूल्स प्रारूप। इस मोड का उपयोग प्रारंभिक संस्करण प्राप्त करने के लिए भी किया जा सकता है
एकल दस्तावेज़ के लिए स्वरूपित आउटपुट, ब्राउज़र, nroff, आदि में प्रदर्शन के लिए,
फ़ॉर्मेटिंग की प्रूफरीडिंग की अनुमति देना।

[2] एक ही पैकेज, यानी सभी के लिए स्वरूपित दस्तावेज़ का निर्माण
मैनपेज, साथ ही सामग्री की एक तालिका और कीवर्ड की एक अनुक्रमणिका।

[3] ऑपरेशन के पिछले मोड का विस्तार, आसान पीढ़ी के लिए एक विधि
कई पैकेजों के लिए एक दस्तावेज़ीकरण वृक्ष, और विशेष रूप से एक एकीकृत तालिका के लिए
सामग्री और कीवर्ड अनुक्रमणिका.

उपरोक्त के अलावा हम इसके द्वारा प्रदान की गई अनुकूलन सुविधाओं का भी उपयोग करना चाहते हैं
HTML फ़ॉर्मेटर. यह एकमात्र प्रारूप नहीं है जिसे एप्लिकेशन जेनरेट करने में सक्षम होना चाहिए, बल्कि
हम आशा करते हैं कि यह सबसे अधिक उपयोग किया जाएगा, और यह उन कुछ में से एक है जो प्रदान करता है
अनुकूलन हुक.

हम कॉल करने वाले को हेडर स्ट्रिंग, फ़ुटर स्ट्रिंग, स्टाइलशीट और डेटा निर्दिष्ट करने की अनुमति देते हैं
जेनरेट किए गए दस्तावेज़ के शीर्ष पर नेविगेशन लिंक की एक पट्टी। जबकि सभी को इस प्रकार सेट किया जा सकता है
जब तक फ़ॉर्मेटिंग इंजन एक उपयुक्त इंजन पैरामीटर प्रदान करता है (अनुभाग देखें)।
विकल्प) अंतिम दो में आंतरिक प्रसंस्करण है जो उन्हें HTML के लिए विशिष्ट बनाता है।

कमान लाइन
dtplite -o उत्पादन विकल्प? प्रारूप इनपुट फ़ाइल
यह उपयोग के मामले के लिए प्रपत्र है [1]। विकल्पों बाद में समझाया जाएगा, खंड में
विकल्प.

पथ उत्पादन (में)
यह तर्क निर्दिष्ट करता है कि जनरेट किए गए दस्तावेज़ को कहाँ लिखना है। यह हो सकता है
फ़ाइल या निर्देशिका का पथ, या -. अंतिम मान के कारण अनुप्रयोग होता है
जेनरेट किए गए दस्तावेज़ को लिखें stdout.

अगर उत्पादन तब मौजूद नहीं है [फ़ाइल dirname $output] मौजूद होना चाहिए और
एक लिखने योग्य निर्देशिका होनी चाहिए. उत्पन्न दस्तावेज़ को लिखा जाएगा
उस निर्देशिका में फ़ाइल, और उस फ़ाइल का नाम इससे लिया जाएगा
इनपुट फ़ाइल, प्रारूप, और विकल्प को दिया गया मान -ext (अगर मौजूद है)।

(पथ|हैंडल) प्रारूप (में)
यह तर्क प्रसंस्करण करते समय उपयोग किए जाने वाले फ़ॉर्मेटिंग इंजन को निर्दिष्ट करता है
इनपुट, और इस प्रकार उत्पन्न दस्तावेज़ का प्रारूप। खंड देखें प्रारूप
एप्लिकेशन द्वारा पहचानी गई संभावनाओं के लिए।

पथ इनपुट फ़ाइल (में)
यह तर्क फ़ाइल को संसाधित करने के लिए पथ निर्दिष्ट करता है। इसका अस्तित्व होना चाहिए,
पठनीय होना चाहिए, और में लिखा होना चाहिए doctools प्रारूप.

dtplite मान्य इनपुट फ़ाइल
यह उपयोग के मामले में एक सरल रूप है [1]। "मान्य" प्रारूप कोई आउटपुट उत्पन्न नहीं करता है
बिल्कुल, केवल सिंटैक्स जाँच ही की जाती है। जैसे कि किसी आउटपुट की विशिष्टता
फ़ाइल या अन्य विकल्प आवश्यक नहीं है और छोड़ दिया गया है।

dtplite -o उत्पादन विकल्प? प्रारूप इनपुटनिर्देशिका
यह उपयोग के मामले के लिए प्रपत्र है [2]। यह उपयोग के मामले में फॉर्म से भिन्न है [1] द्वारा
इनपुट दस्तावेज़ों को फ़ाइल के बजाय निर्देशिका के माध्यम से निर्दिष्ट करना।
को छोड़कर अन्य तर्क समान हैं उत्पादन, जिसे अब रास्ता बनाना होगा
एक मौजूदा और लिखने योग्य निर्देशिका।

इनपुट दस्तावेज़ सभी फ़ाइलें हैं इनपुटनिर्देशिका या इसकी कोई उपनिर्देशिका
जिसे पहचान लिया गया फ़ाइलउपयोग::फ़ाइलप्रकार जैसे कि इसमें पाठ शामिल है doctools प्रारूप.

dtplite -मर्ज -o उत्पादन विकल्प? प्रारूप इनपुटनिर्देशिका
यह उपयोग के मामले के लिए प्रपत्र है [3]। उपयोग के मामले में फॉर्म में एकमात्र अंतर [2]
अतिरिक्त विकल्प है -मर्ज.

ऐसी प्रत्येक कॉल इनपुट को संसाधित करने से आने वाले उत्पन्न दस्तावेज़ों को मर्ज कर देगी
के अंतर्गत दस्तावेज़ इनपुटनिर्देशिका या इसकी किसी उपनिर्देशिका के अंतर्गत फ़ाइलों में
उत्पादन. इस प्रकार क्रमिक रूप से एकीकृत का निर्माण संभव है
किसी भी संख्या में पैकेज के लिए दस्तावेज़ीकरण। ध्यान दें कि इसके माध्यम से चलना आवश्यक है
पूरी तरह से सही क्रॉस-रेफरेंस (प्रारूपों के लिए) प्राप्त करने के लिए सभी पैकेजों को दो बार
उनका समर्थन करना)।

विकल्प
यह खंड एप्लिकेशन के उपयोगकर्ता के लिए उपलब्ध सभी विकल्पों का वर्णन करता है, जिसमें
विकल्पों का अपवाद -o और -मर्ज. इन दोनों का वर्णन पहले ही अनुभाग में किया जा चुका है
कमान लाइन.

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

-ext स्ट्रिंग
यदि आउटपुट फ़ाइल का नाम इनपुट फ़ाइल के नाम से प्राप्त किया जाना है
के नाम का उपयोग करेगा प्रारूप डिफ़ॉल्ट रूप से एक्सटेंशन के रूप में। यह विकल्प यहाँ होगा
हालाँकि, इसे ओवरराइड करें, इसे उपयोग करने के लिए बाध्य करें स्ट्रिंग फ़ाइल एक्सटेंशन के रूप में. इस विकल्प
यदि आउटपुट फ़ाइल का नाम विकल्प के माध्यम से पूरी तरह निर्दिष्ट है तो इसे अनदेखा कर दिया जाता है -o.

जब कई बार उपयोग किया जाता है तो केवल अंतिम परिभाषा ही प्रासंगिक होती है।

-शीर्षक पट्टिका
इस विकल्प का उपयोग केवल तभी किया जा सकता है जब चयनित हो प्रारूप एक इंजन प्रदान करता है
पैरामीटर जिसका नाम "हेडर" है। यह निर्दिष्ट फ़ाइल की सामग्री लेता है और असाइन करता है
इंजन द्वारा किसी भी उपयोग के लिए उन्हें उस पैरामीटर पर। HTML इंजन सम्मिलित होगा
टैग के ठीक बाद का पाठ . यदि नेविगेशन बटन मौजूद हैं (विकल्प देखें)।
-नव नीचे), फिर उनके लिए जेनरेट किया गया HTML हेडर डेटा में जोड़ा जाता है
पैरामीटर के अंतिम असाइनमेंट से पहले यहां उत्पन्न हो रहा है।

जब कई बार उपयोग किया जाता है तो केवल अंतिम परिभाषा ही प्रासंगिक होती है।

-फुटर पट्टिका
पसंद -शीर्षक, सिवाय इसके कि: किसी भी नेविगेशन बटन को नजरअंदाज कर दिया जाता है
आवश्यक इंजन पैरामीटर को "फ़ुटर" नाम दिया गया है, और डेटा ठीक पहले डाला गया है
टैग .

जब कई बार उपयोग किया जाता है तो केवल अंतिम परिभाषा ही प्रासंगिक होती है।

शैली पट्टिका
इस विकल्प का उपयोग केवल तभी किया जा सकता है जब चयनित हो प्रारूप एक इंजन प्रदान करता है
पैरामीटर जिसका नाम "मेटा" है। निर्दिष्ट होने पर यह HTML कोड का एक टुकड़ा उत्पन्न करेगा
की घोषणा पट्टिका जेनरेट किए गए दस्तावेज़ के लिए स्टाइलशीट के रूप में और उसे असाइन करें
पैरामीटर. HTML इंजन इसे दस्तावेज़ में ठीक इसके बाद सम्मिलित करेगा
टैग .

इनपुट निर्देशिका को संसाधित करते समय स्टाइलशीट फ़ाइल को आउटपुट में कॉपी किया जाता है
परिणाम को और अधिक बेहतर बनाने के लिए निर्देशिका और जेनरेट किया गया HTML कॉपी को संदर्भित करेगा
स्व-निहित. किसी इनपुट फ़ाइल को संसाधित करते समय हमारे पास उसे कॉपी करने के लिए कोई स्थान नहीं होता है
स्टाइलशीट को और इसलिए इसे निर्दिष्ट अनुसार संदर्भित करें।

जब कई बार उपयोग किया जाता है तो केवल अंतिम परिभाषा ही प्रासंगिक होती है।

-तोसी पथ
यह विकल्प सामग्री तालिका के बजाय उपयोग करने के लिए एक डॉक्टरॉक फ़ाइल निर्दिष्ट करता है
अपना स्वयं का निर्माण करना।

जब कई बार उपयोग किया जाता है तो केवल अंतिम परिभाषा ही प्रासंगिक होती है।

-प्री+टोक लेबल पथ|पाठ

-पोस्ट+टोक लेबल पथ|पाठ
यह विकल्प नेविगेशन में उपयोग करने के लिए अतिरिक्त डॉक्टोक फ़ाइलें (या टेक्स्ट) निर्दिष्ट करता है
बार।

एकाधिक उपयोगों की स्थिति निर्धारण और प्रबंधन विकल्पों के समान है -प्रेनव और -पोस्टनेव,
निचे देखो।

-नव यूआरएल लेबल करें

-प्रेनव यूआरएल लेबल करें
नेविगेशन बटन निर्दिष्ट करने के लिए इस विकल्प का उपयोग करें लेबल प्रदर्शित करने के लिए और यूआरएल सेवा मेरे
से लिंक करें। इस विकल्प का उपयोग केवल तभी किया जा सकता है जब चयनित हो प्रारूप एक प्रदान करता है
इंजन पैरामीटर का नाम "हेडर" है। इसके लिए जनरेट किया गया HTML संलग्न है
ऑप्शन से हमें जो भी डेटा मिला है -शीर्षक जेनरेटर में डालने से पहले
दस्तावेजों।

जब कई बार उपयोग किया जाता है तो सभी परिभाषाएँ एकत्र हो जाती हैं और एक नेविगेशन बार होता है
बनाया गया, जिसमें पहली परिभाषा बाएं किनारे पर और अंतिम परिभाषा दिखाई गई है
दांई ओर।

यूआरएल सापेक्ष हो सकता है. उस स्थिति में इसे मुख्य के सापेक्ष माना जाता है
फ़ाइलें (टीओसी और कीवर्ड इंडेक्स), और अन्य सभी को अभी भी लिंक करने के लिए रूपांतरित किया जाएगा
अच्छी तरह।

-पोस्टनेव यूआरएल लेबल करें
नेविगेशन बटन निर्दिष्ट करने के लिए इस विकल्प का उपयोग करें लेबल प्रदर्शित करने के लिए और यूआरएल सेवा मेरे
से लिंक करें। इस विकल्प का उपयोग केवल तभी किया जा सकता है जब चयनित हो प्रारूप एक प्रदान करता है
इंजन पैरामीटर का नाम "हेडर" है। इसके लिए जनरेट किया गया HTML संलग्न है
ऑप्शन से हमें जो भी डेटा मिला है -शीर्षक जेनरेटर में डालने से पहले
दस्तावेजों।

जब कई बार उपयोग किया जाता है तो सभी परिभाषाएँ एकत्र हो जाती हैं और एक नेविगेशन बार होता है
दाएँ किनारे पर दिखाई गई अंतिम परिभाषा और पहली परिभाषा के साथ बनाया गया
बाईं ओर.

यूआरएल सापेक्ष हो सकता है. उस स्थिति में इसे मुख्य के सापेक्ष माना जाता है
फ़ाइलें (टीओसी और कीवर्ड इंडेक्स), और अन्य सभी को अभी भी लिंक करने के लिए रूपांतरित किया जाएगा
अच्छी तरह।

प्रारूप
सबसे पहले द प्रारूप तर्क को कोड वाली टीसीएल फ़ाइल के पथ के रूप में माना जाएगा
अनुरोधित फ़ॉर्मेटिंग इंजन के लिए. तर्क को इनमें से किसी एक के नाम के रूप में माना जाएगा
नीचे सूचीबद्ध पूर्वनिर्धारित प्रारूप यदि और केवल यदि पथ मौजूद नहीं है।

नोट a सीमा: यदि प्रारूप को टीसीएल स्क्रिप्ट को लागू करने के लिए पथ के रूप में माना जाता है
इंजन सफल था, तो इस स्क्रिप्ट को न केवल इंजन एपीआई को लागू करना होगा
डॉक्टरूल्स, अर्थात् doctools_api, लेकिन के लिए docto_api और docidx_api भी। अन्यथा
सामग्री तालिका और कीवर्ड इंडेक्स का निर्माण विफल हो जाएगा।

पूर्वनिर्धारित प्रारूपों की सूची, यानी पैकेज द्वारा प्रदान की गई doctools:

एनरॉफ प्रोसेसर *रॉफ़ आउटपुट उत्पन्न करता है, जो यूनिक्स मैनपेजों के लिए मानक प्रारूप है।

HTML प्रोसेसर वेब ब्राउज़र में उपयोग और प्रदर्शन के लिए HTML आउटपुट उत्पन्न करता है। यह
इंजन वर्तमान में आवश्यक विभिन्न इंजन पैरामीटर प्रदान करने वाला एकमात्र इंजन है
आउटपुट के अतिरिक्त अनुकूलन के लिए।

टीएमएमएल प्रोसेसर टीएमएमएल आउटपुट, टीसीएल मैनपेज मार्कअप लैंग्वेज, एक व्युत्पन्न उत्पन्न करता है
एक्सएमएल का।

लाटेकस प्रोसेसर LaTeX आउटपुट उत्पन्न करता है।

विकि प्रोसेसर विकी मार्कअप उत्पन्न करता है जैसा कि समझा जाता है विकिट.

सूची प्रोसेसर द्वारा प्रदान की गई जानकारी निकालता है मैनपेज_शुरू. यह प्रारूप है
मेटा डेटा को निकालने के लिए आंतरिक रूप से उपयोग किया जाता है जिसमें से सामग्री की तालिका और दोनों
कीवर्ड इंडेक्स से प्राप्त होते हैं।

रिक्त प्रोसेसर कोई आउटपुट उत्पन्न नहीं करता है. ये इसके बराबर है मान्य.

निर्देशिका संरचनाएं
इस अनुभाग में हम एप्लिकेशन द्वारा उत्पन्न निर्देशिका संरचनाओं का वर्णन करते हैं
उत्पादन सभी दस्तावेज़ों को संसाधित करते समय इनपुटनिर्देशिका. दूसरे शब्दों में, यह केवल है
उपयोग के मामलों के लिए प्रासंगिक [2] और [3]।

[2] इनपुट के एकल सेट को संसाधित करते समय निम्नलिखित निर्देशिका संरचना बनाई जाती है
दस्तावेज़. उपयोग किया गया फ़ाइल एक्सटेंशन HTML में आउटपुट के लिए है, लेकिन वह प्रासंगिक नहीं है
संरचना के लिए और इसका उपयोग केवल उचित फ़ाइल नाम रखने के लिए किया गया था।

आउटपुट/
toc.html
सूचकांक
फ़ाइलें /
पथ/से/FOO.html

उदाहरण में अंतिम पंक्ति स्थित FOO फ़ाइल के लिए जेनरेट किए गए दस्तावेज़ को दिखाती है

इनपुटनिर्देशिका/पथ/से/FOO

[3] कई पैकेजों को दस्तावेजों के एकीकृत सेट में विलय करते समय उत्पन्न निर्देशिका
संरचना थोड़ी गहरी है:

उत्पादन
.toc
.idx
.tocdoc
.idxdoc
.xrf
toc.html
सूचकांक
FOO1/
...
FOO2/
toc.html
फ़ाइलें /
पथ/से/BAR.html

प्रत्येक निर्देशिका FOO1, ... में पैकेज के लिए उत्पन्न दस्तावेज़ शामिल हैं
FOO1, ... और उपयोग के मामले में दिखाई गई संरचना का अनुसरण करता है [2]। एकमात्र अपवाद है
कि कोई प्रति-पैकेज सूचकांक नहीं है।

फ़ाइलें ".toc"".idx", और".xrf"संपूर्ण की आंतरिक स्थिति समाहित करें
आउटपुट और अगले आह्वान तक पढ़ा और अद्यतन किया जाएगा। उनकी सामग्री नहीं होगी
प्रलेखित किया जाए. जब आउटपुट के लिए सभी पैकेज वांछित हो जाएं तो इन फ़ाइलों को हटा दें
संसाधित, यानी जब आउटपुट पूरा हो जाए।

फ़ाइलें ".tocdoc", और".idxdoc", doctoc और docidx में मध्यवर्ती फ़ाइलें हैं
मार्कअप, क्रमशः, सामग्री की मुख्य तालिका और कीवर्ड इंडेक्स युक्त
चुने गए आउटपुट स्वरूप में उनके रूपांतरण से पहले दस्तावेज़ों का सेट। वे हैं
doctoc और docidx के प्रदर्शन के रूप में काम करने के लिए, यथास्थान छोड़ दिया गया है, अर्थात हटाया नहीं गया है
मार्कअप।

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