हाइपरटॉप - क्लाउड में ऑनलाइन

कार्यक्रम:

नाम

हाइपरटोक - HTML दस्तावेज़ों के लिए सामग्री की एक तालिका तैयार करें

VERSION

3.20 संस्करण

SYNOPSIS

हाइपरटोक --मदद | --मैनपेज | --आदमी_मदद | --आदमी

हाइपरटोक [--बक स्ट्रिंग ] [ --डिबग ] [ --entrysep स्ट्रिंग ] [ -- फूटर पट्टिका ] [ -- हैडर
पट्टिका ] [ --ignore_only_one ] [ --ignore_sole_first ] [ --इनलाइन ] [ --make_anchors ] [
--make_toc] [-notoc_match स्ट्रिंग ] [ --ओल | --nool ] [ --ol_num_levels ] [ --outfile
पट्टिका ] [-ओवरराइट] [-शांत] [-केवल टेक्स्ट] [-शीर्षक स्ट्रिंग ] {--toc_after
टैग=प्रत्यय } { --toc_before टैग=उपसर्ग } { --toc_end टैग=एंडटैग } { --toc_entry टैग=स्तर
} [ --toc_label स्ट्रिंग ] [ --toc_only | --notoc_only] [ --toc_tag स्ट्रिंग ] [
--toc_tag_replace ] [ --use_id ] [ --useorg ] फ़ाइल...

वर्णन

हाइपरटोक आपको "महत्वपूर्ण तत्व" निर्दिष्ट करने की अनुमति देता है जिन्हें हाइपरलिंक किया जाएगा
HTML दस्तावेज़ों के दिए गए सेट के लिए "सामग्री तालिका" (ToC)।

मूल रूप से, उत्पन्न टीओसी एक बहु-स्तरीय स्तरीय सूची है जिसमें लिंक शामिल हैं
महत्वपूर्ण तत्व. हाइपरटोक टीओसी में महत्वपूर्ण तत्वों के लिंक सम्मिलित करता है
उपयोगकर्ता द्वारा निर्दिष्ट स्तर.

उदाहरण:

यदि एच1 को स्तर 1 के रूप में निर्दिष्ट किया गया है, तो वे टीओसी की प्रथम स्तर की सूची में दिखाई देंगे। अगर
H2s को स्तर 2 के रूप में निर्दिष्ट किया जाता है, जबकि वे ToC में दूसरे स्तर की सूची में दिखाई देते हैं।

टीओसी पीढ़ी के दो पहलू हैं: (1) HTML में उपयुक्त एंकर डालना
दस्तावेज़ (--make_anchors), और (2) HTML दस्तावेज़ों से ToC उत्पन्न करना
(--make_toc) से लिंक करने के लिए उनमें ToC को एंकर करें। कोई एक या दोनों करना चुन सकता है
इन।

हाइपरटोक HTML दस्तावेज़ में ToC को शामिल करने की क्षमता का भी समर्थन करता है
--इनलाइन विकल्प के माध्यम से।

हाइपरटोक को महत्वपूर्ण तत्वों से जोड़ने का समर्थन करने के लिए, हाइपरटोक एंकर सम्मिलित करता है
महत्वपूर्ण तत्वों में. कोई हाइपरटोक को फ़िल्टर के रूप में उपयोग कर सकता है, परिणाम आउटपुट कर सकता है
कोई अन्य फ़ाइल, या कोई मूल फ़ाइल को अधिलेखित कर सकता है, मूल फ़ाइल का बैकअप लेकर
प्रत्यय (डिफ़ॉल्ट: "org") फ़ाइल नाम के साथ जोड़ा गया।

कोई कॉन्फ़िगरेशन फ़ाइल के साथ-साथ कमांड-लाइन पर भी विकल्पों को परिभाषित कर सकता है।

विकल्प

विकल्प "--" या "-" से शुरू हो सकते हैं; बूलियन विकल्पों को उनके पहले लगाकर नकारा जा सकता है
"नहीं"; हैश या ऐरे मान वाले विकल्पों को फिर से विकल्प देकर जोड़ा जा सकता है
प्रत्येक मान.

अधिक जानकारी के लिए Getopt::Long देखें।

--argफ़ाइल फ़ाइल का नाम
अधिक विकल्प पढ़ने के लिए फ़ाइल का नाम. इसका प्रयोग एक से अधिक बार किया जा सकता है. के लिए
उदाहरण:

--argfile your.args --argfile my.args

अधिक जानकारी के लिए "विकल्प फ़ाइलें" देखें।

--बक
--बक स्ट्रिंग

यदि इनपुट फ़ाइल/फ़ाइलें ओवरराइट की जा रही हैं/हो रही हैं (--ओवरराइट चालू है), तो कॉपी करें
मूल फ़ाइल "फ़ाइल का नाम.स्ट्रिंग"। यदि मान खाली है, तो कोई बैकअप फ़ाइल नहीं है
लिखा हुआ। (डिफ़ॉल्ट: संगठन)

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

--entrysep
--entrysep स्ट्रिंग

गैर- आइटम प्रविष्टियों के लिए विभाजक स्ट्रिंग (डिफ़ॉल्ट: ",")

--फुटर
--फुटर पट्टिका

सामग्री तालिका के लिए पादलेख पाठ वाली फ़ाइल।

--हेडर
--हेडर पट्टिका

सामग्री तालिका के लिए हेडर टेक्स्ट वाली फ़ाइल।

--मदद
एक संक्षिप्त सहायता संदेश प्रिंट करें और बाहर निकलें।

--केवल_एक_को_अनदेखा_करें
यदि टीओसी में केवल एक आइटम होगा, तो टीओसी न बनाएं।

--ignore_sole_first
यदि टीओसी में पहला आइटम उच्चतम स्तर का है, और यह उनमें से एकमात्र है
स्तर, इसे अनदेखा करें। यह उन वेब-पेजों में उपयोगी है जहां केवल एक H1 हेडर है
कोई पहले से नहीं जानता कि केवल एक ही होगा या नहीं।

--इन - लाइन
किसी दिए गए बिंदु पर दस्तावेज़ में ToC डालें। अधिक जानकारी के लिए "इनलाइनिंग द टीओसी" देखें।

--मेक_एंकर्स | --gen_anchors
सामग्री तालिका से लिंक करने के लिए एंकर बनाएं।

--make_toc | --gen_toc
एक सामग्री तालिका बनाएं जो महत्वपूर्ण तत्वों से जुड़ी हो।

--आदमी_मदद | --मैनपेज | --आदमी
सभी दस्तावेज़ प्रिंट करें और बाहर निकलें।

--notoc_match
--notoc_match स्ट्रिंग

यदि कुछ व्यक्तिगत टैग हैं जिन्हें आप तालिका में शामिल नहीं करना चाहते हैं
सामग्री, भले ही वे "महत्वपूर्ण तत्वों" से मेल खाते हों, फिर यदि यह पैटर्न
टैग के अंदर की सामग्री से मेल खाता है (मुख्य भाग से नहीं), तो वह टैग शामिल नहीं किया जाएगा,
न तो एंकर तैयार करने में और न ही टीओसी तैयार करने में। (डिफ़ॉल्ट: वर्ग = "नोटोक")

--ओएल | --नूल
सामग्री तालिका प्रविष्टियों (दी गई गहराई तक) के लिए एक क्रमबद्ध सूची का उपयोग करें। यदि --ol है
गलत (यानी --nool सेट है) तो नहीं है ToC प्रविष्टियों के लिए क्रमबद्ध सूची का उपयोग करें।

(डिफ़ॉल्ट: ग़लत)

(यह निर्धारित करने के लिए --ol_num_levels देखें कि ऑर्डर-सूची सूची कितनी गहराई तक जाती है)

--ol_num_levels
यदि --ol सत्य है तो OL सूची में गहरे स्तरों की संख्या बढ़ जाएगी। यदि शून्य पर सेट किया जाए,
सभी स्तरों के लिए एक आदेशित सूची का उपयोग करेगा। (डिफ़ॉल्ट:1)

--आउटफाइल
--आउटफाइल पट्टिका

आउटपुट लिखने के लिए फ़ाइल। यह वह जगह है जहां संशोधित HTML आउटपुट और तालिका-
सामग्री को जाता है. यदि आप फ़ाइल नाम के रूप में '-' देते हैं, तो आउटपुट STDOUT पर जाएगा।
(डिफ़ॉल्ट: STDOUT)

--ओवरराइट
आउटपुट के साथ इनपुट फ़ाइल को अधिलेखित करें। यदि यह प्रभावी है, तो --outfile को अनदेखा कर दिया जाता है।
में इस्तेमाल किया generate_anchors "जगह में" और अंदर एंकर बनाने के लिए generate_toc if
--इनलाइन विकल्प प्रभावी है. (डिफ़ॉल्ट:बंद)

--शांत
सूचनात्मक संदेशों को दबाएँ. (डिफ़ॉल्ट: बंद)

--सिर्फ टेक्स्ट
महत्वपूर्ण तत्वों में केवल पाठ्य सामग्री का उपयोग करें।

--शीर्षक
--शीर्षक स्ट्रिंग

ToC पृष्ठ के लिए शीर्षक (यदि --header या --inline या --toc_only का उपयोग नहीं कर रहे हैं) (डिफ़ॉल्ट: "तालिका
सामग्री का")

--toc_बाद
--toc_बाद टैग=प्रत्यय

--toc_after "H2="

टीओसी में महत्वपूर्ण तत्वों के लेआउट को परिभाषित करने के लिए। टैग HTML टैग है जो
तत्व की शुरुआत को चिह्नित करता है। प्रत्यय जिसे इसमें जोड़ना आवश्यक है
उस टैग के लिए सामग्री तालिका प्रविष्टि तैयार की गई। यह एक संचयी हैश तर्क है.
(डिफ़ॉल्ट: अपरिभाषित)

--toc_before
--toc_before टैग=उपसर्ग

--toc_before "H2="

टीओसी में महत्वपूर्ण तत्वों के लेआउट को परिभाषित करने के लिए। टैग HTML टैग है
जो तत्व की शुरुआत का प्रतीक है। उपसर्ग वह है जिसे पहले से जोड़ना आवश्यक है
उस टैग के लिए बनाई गई विषय-सूची प्रविष्टि में। यह एक संचयी हैश है
तर्क। (डिफ़ॉल्ट: अपरिभाषित)

--toc_end
--toc_end टैग=एंडटैग

--toc_end "H1=/H1"

महत्वपूर्ण तत्वों को परिभाषित करने के लिए. टैग HTML टैग है जो शुरुआत का प्रतीक है
तत्व। एंडटैग HTML टैग जो तत्व के अंत को चिह्नित करता है। कब
इनपुट फ़ाइल में मिलान करने पर, मामले को अनदेखा कर दिया जाता है (लेकिन सुनिश्चित करें कि आपके सभी टैग विकल्पों
एक ही टैग का संदर्भ बिल्कुल वही है!)। यह एक संचयी हैश तर्क है.
(डिफ़ॉल्ट: H1=/H1 H2=/H2)

--toc_entry
--toc_entry टैग=स्तर

--toc_entry "TITLE=1" --toc_entry "H1=2"

महत्वपूर्ण तत्वों को परिभाषित करने के लिए. टैग HTML टैग है जो शुरुआत का प्रतीक है
तत्व। स्तर टैग को किस स्तर का माना जाता है। का मान है स्तर
संख्यात्मक और गैर-शून्य होना चाहिए। यदि मान ऋणात्मक है, तो क्रमिक प्रविष्टियाँ
important_element द्वारा दर्शाए गए मान को निर्धारित मान से अलग किया जाएगा
--एंट्रीसेप विकल्प। यह एक संचयी हैश तर्क है. (डिफ़ॉल्ट: H1=1 H2=2)

--toc_लेबल | --toclabel
--toc_लेबल स्ट्रिंग

HTML टेक्स्ट जो ToC को लेबल करता है। सदैव प्रयोग किया जाता है। (डिफ़ॉल्ट: "सामग्री तालिका")

--toc_only | --notoc_only
केवल विषय-सूची, अर्थात् विषय-सूची और toc_label को आउटपुट करें।
यदि कोई --हेडर या --फ़ुटर है, तो ये भी आउटपुट होंगे।

यदि --toc_only गलत है (अर्थात --notoc_only सेट है) तो यदि कोई --header नहीं है, और
--इनलाइन सत्य नहीं है, तो एक उपयुक्त HTML पेज हेडर आउटपुट होगा, और यदि है
नहीं --footer और --inline सत्य नहीं है, तो एक HTML पेज फ़ुटर आउटपुट होगा।
(डिफ़ॉल्ट:--notoc_only)

--toc_tag
--toc_tag स्ट्रिंग

यदि किसी ToC को इनलाइन शामिल किया जाना है, तो यह वह पैटर्न है जिसका उपयोग टैग से मिलान करने के लिए किया जाता है
जहां टीओसी लगाया जाना चाहिए। यह एक स्टार्ट-टैग, एक एंड-टैग या एक टिप्पणी हो सकती है, लेकिन
< को छोड़ दिया जाना चाहिए; यानी, यदि आप चाहते हैं कि टीओसी को बॉडी के बाद रखा जाए
टैग करें, फिर "बॉडी" दें। यदि आप एक विशेष टिप्पणी टैग चाहते हैं तो टीओसी को कहां बनाना चाहिए
जाएं, फिर टिप्पणी चिह्न शामिल करें, उदाहरण के लिए: "!--toc--" (डिफ़ॉल्ट:BODY)

--toc_tag_replace
--toc_tag के संयोजन में, यह यह बताने के लिए एक ध्वज है कि दिया गया टैग होना चाहिए या नहीं
प्रतिस्थापित किया जाना चाहिए, या यदि टीओसी को टैग के बाद रखा जाना चाहिए। यह उपयोगी हो सकता है यदि आपका
toc_tag एक टिप्पणी है और ToC लागू होने के बाद आपको इसकी आवश्यकता नहीं है।
(डिफ़ॉल्ट: ग़लत)

--use_id
आईडी का उपयोग करें = "नाम" <a name=" के बजाय एंकर के लिएनाम"> एंकर। हालांकि अगर एक एंकर
किसी महत्वपूर्ण तत्व के लिए पहले से ही मौजूद है, इससे उस विशेष तत्व के लिए कोई आईडी नहीं बनेगी
तत्व।

--useorg
इनपुट स्रोत के रूप में पहले से मौजूद बैकअप फ़ाइलों का उपयोग करें; अर्थात्, फॉर्म की फ़ाइलें
फ़ाइल का नाम.बक (देखें--बक)।

फ़ाइल प्रारूप

ऑप्शंस फ़ाइलें
--argfile का उपयोग करके फ़ाइलों के साथ-साथ कमांड-लाइन पर भी विकल्प दिए जा सकते हैं
फ़ाइल का नाम कमांड-लाइन में विकल्प. साथ ही, फ़ाइलें ~/.hypertocrc और ./.hypertocrc हैं
विकल्पों की जाँच की गई।

प्रारूप इस प्रकार है: # से शुरू होने वाली पंक्तियाँ टिप्पणियाँ हैं। PoD में संलग्न पंक्तियाँ
मार्कर टिप्पणियाँ भी हैं. ख़ाली रेखाओं को नज़रअंदाज कर दिया जाता है. विकल्प स्वयं होने चाहिए
यह देखते हुए कि वे कमांड लाइन पर कैसे होंगे, यानी विकल्प का नाम (समेत la
--) उसके बाद उसका मूल्य (यदि कोई हो)।

उदाहरण के लिए:

# ToC को तीन-स्तरीय सेट करें
--toc_entry H1=1
--toc_entry H2=2
--toc_entry H3=3

--toc_end H1=/H1
--toc_end H2=/H2
--toc_end H3=/H3

--argfile देकर विकल्प फ़ाइलों को नेस्ट किया जा सकता है फ़ाइल का नाम विकल्प के अंदर तर्क
फ़ाइल, यह जाएगी और उस संदर्भित फ़ाइल को भी प्राप्त करेगी।

अधिक जानकारी के लिए Getopt::ArgvFile देखें।

विवरण

महत्वपूर्ण तत्व
आपकी विषय-सूची के लिए महत्वपूर्ण तत्वों को परिभाषित करने के कुछ उदाहरण यहां दिए गए हैं।

उदाहरण of चूक

यदि कुछ भी स्पष्ट रूप से निर्दिष्ट नहीं है तो निम्नलिखित डिफ़ॉल्ट सेटिंग को दर्शाता है:

--toc_entry "H1=1" --toc_end "H1=/H1" --toc_entry "H2=2" --toc_end "H2=/H2"

या, यदि इसे संभावित "विकल्प फ़ाइलों" में से एक में परिभाषित किया गया था:

# न्यूनता समायोजन
--toc_entry H1=1
--toc_end H1=/H1
--toc_entry H2=2
--toc_end H2=/H2

उदाहरण of पहले बादमे

निम्नलिखित विकल्प पहले/बाद के विकल्पों का उपयोग करते हैं:

# एक विकल्प फ़ाइल जो कुछ फ़ॉर्मेटिंग जोड़ती है
# लेवल 1 ToC प्रविष्टियाँ बनाएं
--toc_entry H1=1
--toc_end H1=/H1
--toc_before H1=
--toc_after H1=

# स्तर 2 टीओसी प्रविष्टियाँ बनाएं
--toc_entry H2=2
--toc_end H2=/H2
--toc_before H2=
--toc_after H2=

# स्तर 3 की प्रविष्टियाँ यथावत करें
--toc_entry H3=3
--toc_end H3=/H3

उदाहरण of रिवाज समाप्त

निम्नलिखित विकल्प परिभाषा शब्दों को अनुक्रमित करने का प्रयास करते हैं:

# एक विकल्प फ़ाइल जो शब्दावली प्रकार के दस्तावेज़ों के लिए काम कर सकती है
--toc_entry H1=1
--toc_end H1=/H1
--toc_entry H2=2
--toc_end H2=/H2

# मान लें कि दस्तावेज़ में प्रत्येक DT के लिए एक DD है, अन्यथा ToC है
# को बहुत सारे टेक्स्ट वाली प्रविष्टियाँ मिलेंगी।
--toc_entry DT=3
--toc_end DT=DD
--toc_before DT=
--toc_after DT=

फॉर्मेटिंग la टीओसी
--toc_entry आदि विकल्प आपको यह नियंत्रण देते हैं कि ToC प्रविष्टियाँ कैसी दिख सकती हैं, लेकिन वहाँ
बनाई गई ToC फ़ाइल के अंतिम स्वरूप को प्रभावित करने के लिए अन्य विकल्प हैं।

--हेडर विकल्प के साथ, दी गई फ़ाइल की सामग्री को इससे पहले जोड़ा जाएगा
उत्पन्न टीओसी. यह आपको परिचयात्मक पाठ, या किसी अन्य पाठ से पहले रखने की अनुमति देता है
टीओसी.

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

--toc_label विकल्प के साथ, दी गई स्ट्रिंग की सामग्री को इससे पहले जोड़ा जाएगा
उत्पन्न टीओसी (लेकिन --हेडर फ़ाइल से लिए गए किसी भी पाठ के बाद)।

--फ़ुटर विकल्प के साथ, फ़ाइल की सामग्री जेनरेट होने के बाद जोड़ दी जाएगी
टीओसी.

नोट:
यदि आप -फुटर का उपयोग करते हैं, तो सुनिश्चित करें कि इसमें समापन बॉडी और HTML टैग शामिल हैं (जब तक कि,
बेशक, आप --इनलाइन विकल्प का उपयोग कर रहे हैं)।

यदि --हेडर विकल्प निर्दिष्ट नहीं है, तो उपयुक्त आरंभिक HTML मार्कअप होगा
जोड़ा गया, जब तक कि --toc_only विकल्प निर्दिष्ट न हो। यदि --फ़ुटर विकल्प नहीं है
निर्दिष्ट, उपयुक्त समापन HTML मार्कअप जोड़ा जाएगा, जब तक कि --toc_only विकल्प न हो
अधिकृत है।

यदि आप शीर्ष लेख, पाद लेख, फ़ाइलों से निपटना नहीं चाहते/चाहते हैं, तो आप इसके लिए पात्र हैं
ToC फ़ाइल का शीर्षक, --title विकल्प, निर्दिष्ट करें; और यह आपको एक निर्दिष्ट करने की अनुमति देता है
शीर्षक, या लेबल, ToC प्रविष्टियों की सूची से पहले रखने के लिए, --toc_label विकल्प। दोनों विकल्प
डिफ़ॉल्ट मान हैं, प्रत्येक विकल्प पर अधिक जानकारी के लिए "विकल्प" देखें।

यदि आप नहीं चाहते कि HTML पेज टैग की आपूर्ति की जाए, और केवल ToC ही चाहते हैं, तो
--toc_only विकल्प निर्दिष्ट करें. यदि कोई --header या --footer फ़ाइलें नहीं हैं, तो यह होगा
बस --toc_label और ToC की सामग्री को ही आउटपुट करें।

इनलाइन la टीओसी
ToC को सीधे HTML दस्तावेज़ में शामिल करने की क्षमता इसके माध्यम से समर्थित है
--इनलाइन विकल्प.

इनलाइनिंग संसाधित फ़ाइलों की सूची में पहली फ़ाइल पर की जाएगी, और केवल की जाएगी
किया गया यदि उस फ़ाइल में --toc_tag मान से मेल खाने वाला एक प्रारंभिक टैग है।

यदि --overwrite सत्य है, तो सूची में पहली फ़ाइल को इसके साथ अधिलेखित कर दिया जाएगा
उत्पन्न टीओसी को उचित स्थान पर डाला गया। अन्यथा पहले का एक संशोधित संस्करण
फ़ाइल या तो STDOUT या --outfile विकल्प द्वारा परिभाषित आउटपुट फ़ाइल में आउटपुट है।

विकल्प --toc_tag और --toc_tag_replace का उपयोग यह निर्धारित करने के लिए किया जाता है कि ToC कहाँ और कैसे है
आउटपुट में डाला गया।

उदाहरण 1

#यह डिफ़ॉल्ट है
--toc_tag बॉडी --notoc_tag_replace

यह जेनरेट की गई ToC को पहली फ़ाइल के BODY टैग के बाद रखेगा। यदि - हेडर
विकल्प निर्दिष्ट किया गया है, फिर निर्दिष्ट फ़ाइल की सामग्री को बॉडी के बाद डाला जाता है
टैग। यदि --toc_label विकल्प खाली नहीं है, तो --toc_label द्वारा निर्दिष्ट पाठ
विकल्प डाला गया है. फिर ToC डाला जाता है, और अंत में, यदि --footer विकल्प है
निर्दिष्ट, यह पादलेख सम्मिलित करता है। फिर बाकी इनपुट फ़ाइल वैसे ही चलती है जैसी थी
पहले.

उदाहरण 2

--toc_tag '!--toc--' --toc_tag_replace

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

नोट:
हेडर फ़ाइल में आरंभिक HTML टैग और HEAD तत्व नहीं होना चाहिए
संसाधित की जा रही HTML फ़ाइल में पहले से ही ये टैग/तत्व शामिल होने चाहिए।

उदाहरण

बनाएं an इनलाइन टीओसी एसटी एक पट्टिका
हाइपरटोक --inline --make_anchors --overwrite --make_toc index.html

यह "index.html" में एंकर बनाएगा, "टेबल ऑफ़" शीर्षक के साथ एक ToC बनाएगा
सामग्री" और इसे "index.html" के बॉडी टैग के बाद रखें। फ़ाइल Index.html.org होगी
इसमें ToC या एंकर के बिना, मूल Index.html फ़ाइल शामिल है।

बनाएं a टीओसी पट्टिका से विभिन्न फ़ाइलों
सबसे पहले, एंकर बनाएं.

हाइपरटोक --make_anchors --overwrite index.html fred.html george.html

फिर ToC बनाएं

हाइपरटोक --मेक_टोक --आउटफाइल टेबल.एचटीएमएल इंडेक्स.एचटीएमएल फ्रेड.एचटीएमएल जॉर्ज.एचटीएमएल

बनाएं an इनलाइन टीओसी बाद la प्रथम शीर्षक of la प्रथम पट्टिका
हाइपरटोक --मेक_एंकर्स --इनलाइन --ओवरराइट --मेक_टोक --टोक_टैग /एच1 \
--notoc_tag_replace --toc_label "" Index.html fred.html जॉर्ज.html

यह "index.html", "fred.html" और "george.html" फ़ाइलों में एंकर बनाएगा, बनाएगा
बिना हेडर वाला एक टीओसी और इसे "index.html" में पहले H1 हेडर के बाद रखें और बैकअप लें
मूल फ़ाइलें "index.html.org", "fred.html.org" और "george.html.org"

बनाएं an इनलाइन टीओसी साथ में रिवाज तत्व
हाइपरटोक --शांत --मेक_एंकर्स --बक "" --ओवरराइट \
--make_toc --inline --toc_label "" --toc_tag '!--toc--' \
--toc_tag_replace \
--toc_entry H2=1 --toc_entry H3=2 \
--toc_end H2=/H2 --toc_end H3=/H3 myfile.html

यह मूल फ़ाइल को अधिलेखित करके एक इनलाइन ToC बनाएगा, और एक को प्रतिस्थापित करेगा
टिप्पणी करें, और जो H2 हेडर को लेवल 1 और H3 हेडर को लेवल 2 के रूप में लेता है। यह हो सकता है
उपयोगी जहां .html फ़ाइल किसी अन्य प्रक्रिया द्वारा उत्पन्न होती है, और फिर आप बना सकते हैं
अंतिम चरण के रूप में टीओसी।

बनाएं a टीओसी साथ में रिवाज तत्व
हाइपरटोक --शांत --मेक_एंकर्स --बक "" --ओवरराइट \
--toc_entry शीर्षक=1 --toc_end शीर्षक=/शीर्षक
--toc_entry H2=2 --toc_entry H3=3 \
--toc_end H2=/H2 --toc_end H3=/H3 \
--make_toc --outfile Index.html \
मैरी.एचटीएमएल फ्रेड.एचटीएमएल जॉर्ज.एचटीएमएल

यह H2 और H3 तत्वों पर एंकर बनाता है, और Index.html नामक एक ToC फ़ाइल बनाता है,
शीर्षक, और H2 और H3 तत्वों पर अनुक्रमण।

बनाएं a टीओसी साथ में रिवाज तत्व और विकल्पों पट्टिका
'custom.opt' नामक एक विकल्प फ़ाइल इस प्रकार दी गई है:

# शीर्षक, H2 और H3
--toc_entry शीर्षक=1
--toc_end शीर्षक=/शीर्षक
--toc_entry H2=2
--toc_end H2=/H2
--toc_entry H3=3
--toc_end H3=/H3

तो पिछले उदाहरण में निम्नानुसार छोटी कमांड लाइनें हो सकती हैं:

हाइपरटोक --शांत --मेक_एंकर्स --बक "" --ओवरराइट \
--argfile Custom.opt --make_toc --outfile index.html mary.html fred.html george.html

टिप्पणियाँ

· हाइपरटोक महत्वपूर्ण तत्वों के अंदर एंकर का पता लगाने के लिए काफी स्मार्ट है। यदि एंकर
NAME विशेषता को परिभाषित करता है, हाइपरटोक मान का उपयोग करता है। अन्यथा, यह अपना स्वयं का नाम जोड़ता है
एंकर को विशेषता. यदि --use_id सत्य है, तो यह उसी प्रकार जाँचता है और उपयोग करता है
आईडी.

· यदि शीर्षक तत्व को एक महत्वपूर्ण तत्व के रूप में निर्दिष्ट किया गया है तो उसे विशेष रूप से व्यवहार किया जाता है। यह है
TITLE तत्वों में एंकर (ए) सम्मिलित करना अवैध है। इसलिए, हाइपरटोक वास्तव में होगा
दस्तावेज़ के TITLE तत्व के बजाय फ़ाइल नाम से ही लिंक करें।

· हाइपरटोक एक महत्वपूर्ण तत्व को अनदेखा कर देगा यदि इसमें कोई गैर-व्हाट्सएप शामिल नहीं है
पात्र। ऐसी स्थिति होने पर एक चेतावनी संदेश उत्पन्न होता है।

· यदि आपके पास महत्वपूर्ण तत्वों का एक क्रम है जो थोड़ा अव्यवस्थित रूप से बदलता है
फैशन, जैसे H1 -> H3 -> H2 या यहां तक ​​कि H2 -> H1, हालांकि हाइपरटोक इससे संबंधित है
एक ऐसी सूची बनाएं जो अभी भी अच्छी HTML हो, यदि आप उसमें ऑर्डर की गई सूची का उपयोग कर रहे हैं
गहराई, तो आपको एक अतिरिक्त सूची तत्व के रूप में, अजीब नंबरिंग मिलेगी
तत्वों को सही स्तर पर रखने के लिए डाला गया।

उदाहरण के लिए (H2 -> H1 --ol_num_levels=1 के साथ):

1.
* मेरा H2 हैडर
2. मेरा H1 हैडर

उदाहरण के लिए (H1 -> H3 -> H2 --ol_num_levels=0 और H3 भी महत्वपूर्ण हैं):

1. मेरा H1 हैडर
1.
1. मेरा H3 हैडर
2. मेरा H2 हैडर
2. मेरा दूसरा H1 हैडर

ऐसे मामलों में --ol विकल्प का उपयोग न करना ही बेहतर होगा।

· यदि कोई एंकर बनाते समय --ओवरराइट का उपयोग नहीं कर रहा है, तो कमांड की आवश्यकता है
सही फ़ाइल नाम देने के लिए दो पासों में किया जाता है (वास्तविक वाले)।
उनमें एंकर) टीओसी पीढ़ी के हिस्से में। अन्यथा टीओसी में एंकर होंगे
उन फ़ाइलों की ओर इशारा करना जिनमें ये नहीं हैं।

· --इनलाइन का उपयोग करते समय, यदि कोई टीओसी सेट करता है तो ओवरराइटिंग करते समय सावधानी बरतनी होगी
किसी दिए गए टैग (जैसे कि डिफ़ॉल्ट बॉडी) के बाद शामिल किया जाना चाहिए, यदि कोई कमांड चलाता है
बार-बार एक ही फाइल में एक के बाद एक कई टीओसी मिल सकते हैं।

चेतावनियां

· संस्करण 3.10 (और ऊपर) पहले की तुलना में अधिक वर्बोज़ (एसईओ-अनुकूल) एंकर उत्पन्न करता है
संस्करण. इस प्रकार पुराने संस्करणों से उत्पन्न एंकर संस्करण 3.10 से मेल नहीं खाएंगे
लंगर।

· हाइपरटोक का संस्करण 3.00 (और ऊपर) संस्करण 2.x की तुलना में कुछ अलग व्यवहार करता है
हाइपरटोक। अब इसे एक ही बार में सब कुछ करने के लिए डिज़ाइन किया गया है, और इसमें कुछ कमी आई है
विकल्प: --इनफ़ाइल विकल्प का अब उपयोग नहीं किया जाता है (सभी फ़ाइल नाम अंत में रखे गए हैं
आदेश); --toc_file विकल्प अब मौजूद नहीं है; --आउटफ़ाइल विकल्प का उपयोग करें
बजाय; --tocmap विकल्प अब समर्थित नहीं है.

अब यह अपर-केस टैग के बजाय लोअर-केस टैग उत्पन्न करता है।

· हाइपरटोक बहुत कुशल (मेमोरी और गति) नहीं है, और बड़े पैमाने पर धीमा हो सकता है
दस्तावेजों।

· अब जब एंकर और टीओसी का निर्माण एक ही बार में हो गया है, तो और भी अधिक मेमोरी बन गई है
पहले की तुलना में उपयोग किया जाता है। एकाधिक प्रसंस्करण करते समय यह अधिक उल्लेखनीय है
फ़ाइलें, चूंकि सभी फ़ाइलों को संसाधित करने से पहले उन्हें मेमोरी में पढ़ा जाता है।

· यदि कोई महत्वपूर्ण तत्व किसी के अंदर समाहित है तो अमान्य मार्कअप उत्पन्न किया जाएगा
लंगर डालना। उदाहरण के लिए:

FOO कमांड

में परिवर्तित किया जाएगा (यदि h1 एक महत्वपूर्ण तत्व है),

The FOO कमांड

जो अवैध है क्योंकि एंकरों को नेस्ट नहीं किया जा सकता।

एंकर स्टेटमेंट को एंकर किए जाने वाले तत्व के भीतर रखना बेहतर शैली है। के लिए
उदाहरण के लिए, निम्नलिखित को प्राथमिकता दी जाती है:

FOO कमांड

हाइपरटोक "foo" NAME का पता लगाएगा और उसका उपयोग करेगा।

आईडी का उपयोग करना और भी बेहतर है:

FOO कमांड

· उद्धरण चिह्नों के बिना NAME विशेषताएँ पहचानी नहीं जातीं।

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