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

कार्यक्रम:

नाम

नोटेंगल, नोएवेव, नाउटएंगल - नोएब, एक साक्षर-प्रोग्रामिंग टूल

SYNOPSIS

नुकीला [-Rमूलनाम ...] [-Filter आदेश] [-L[प्रारूप]] [फ़ाइल] ...
संज्ञा [-एमएल|-एम 3|-c|-सी++|-अजीब|-टेक्स|-77|-90|-लिस्प|-मतलब] [-Rमूलनाम ...] [-Filter
आदेश] [-wचौड़ाई] [फ़ाइल] ...
कोई बुनाई नहीं [विकल्प] [फ़ाइल] ...

वर्णन

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

FORMAT OF अब फ़ाइलें

A नोएब फ़ाइल का एक क्रम है हिस्सा, जो किसी भी क्रम में प्रकट हो सकता है। एक टुकड़े में शामिल हो सकता है
कोड या दस्तावेज़ीकरण. दस्तावेज़ीकरण खंड एक पंक्ति से शुरू होते हैं जो at चिह्न से शुरू होती है
(@) के बाद एक स्पेस या न्यूलाइन आती है। उनका कोई नाम नहीं है. कोड खंड प्रारंभ होते हैं
<<टुकड़ा नाम>> =
अपने आप एक लाइन पर. डबल लेफ्ट एंगल ब्रैकेट (<<) पहले कॉलम में होना चाहिए।
खंड दूसरे खंड की शुरुआत या फ़ाइल के अंत तक समाप्त हो जाते हैं। यदि प्रथम
फ़ाइल में पंक्ति किसी खंड की शुरुआत को चिह्नित नहीं करती है, इसे पहला माना जाता है
दस्तावेज़ीकरण खंड की पंक्ति।

दस्तावेज़ीकरण खंडों में वह पाठ होता है जिसे अनदेखा कर दिया जाता है नुकीला और शब्दशः कॉपी किया गया
द्वारा मानक आउटपुट कोई बुनाई नहीं (उद्धृत कोड को छोड़कर)। कोई बुनाई नहीं के साथ काम कर सकते हैं LaTeX, सादा
टेक्स, ट्रोफ or एचटीएमएल. सादे के साथ टेक्स, यह एक संदर्भ सम्मिलित करता है टेक्स मैक्रो पैकेज, nwmac,
जो कमांड को परिभाषित करता है जैसे \अध्याय और \अनुभाग।

कोड खंडों में प्रोग्राम स्रोत कोड और अन्य कोड खंडों के संदर्भ शामिल होते हैं। अनेक कोड
टुकड़ों का नाम एक जैसा हो सकता है; नुकीला एक एकल उत्पन्न करने के लिए उनकी परिभाषाओं को संयोजित करता है
टुकड़ा, जैसा करता है उलझन(1). कोड खंड परिभाषाएँ मैक्रो परिभाषाओं की तरह हैं;
नुकीला एक खंड का विस्तार करके एक प्रोग्राम निकालता है (डिफ़ॉल्ट रूप से, नामित खंड <<*>>).
उस खंड की परिभाषा में अन्य खंडों के संदर्भ शामिल हैं, जो स्वयं हैं
विस्तारित, इत्यादि। नुकीलाका आउटपुट पठनीय है; यह के इंडेंटेशन को सुरक्षित रखता है
उन टुकड़ों के संबंध में विस्तारित टुकड़े जिनमें वे दिखाई देते हैं।

कोड को दस्तावेज़ के टुकड़ों में दोहरे वर्गाकार कोष्ठक लगाकर उद्धृत किया जा सकता है ([[...]])
चारों ओर से। इन दोहरे वर्गाकार कोष्ठकों को नजरअंदाज कर दिया जाता है नोटेंगल, लेकिन उनका उपयोग किया जा सकता है
कोई बुनाई नहीं कोड को विशेष टाइपोग्राफ़िक उपचार देने के लिए, उदाहरण के लिए, हाइपरटेक्स्ट लिंक। यदि उद्धृत किया गया है
कोड तीन या अधिक वर्गाकार कोष्ठकों के साथ समाप्त होता है, कोई बुनाई नहीं सबसे सही जोड़ा चुनता है, ताकि,
उदाहरण के लिए, [[ए[आई]]] सही ढंग से पार्स किया गया है. कोड खंडों के नाम भीतर प्रकट हो सकते हैं
उद्धृत कोड जब तक कि वह उद्धृत कोड स्वयं किसी कोड खंड के नाम का हिस्सा न हो।

कोड में, नोएब अयुग्मित दोहरे बाएँ या दाएँ कोण कोष्ठकों को शाब्दिक मानता है << और >>.
दस्तावेज़ीकरण में ऐसे किसी भी ब्रैकेट, यहां तक ​​कि युग्मित ब्रैकेट या ब्रैकेट को भी बाध्य करने के लिए
इसे शाब्दिक मानते हुए, चिह्न पर पूर्ववर्ती का उपयोग करें (उदा @<).

कुछ प्रोग्रामिंग या फ़ॉर्मेटिंग भाषाओं के लिए एकल की आवश्यकता हो सकती है @ पहले कॉलम में साइन इन करें.
नोवेब उपयोगकर्ता दोगुना लगाकर इस प्रभाव को प्राप्त कर सकते हैं @@ पहले कॉलम में; इस में
केवल स्थिति, यह एकल के लिए है @ संकेत।

उलझना

नुकीला और संज्ञा विकल्पों के समान सेट को स्वीकार करें, हालाँकि कुछ विकल्पों का प्रभाव होता है
केवल एक या दूसरे पर. विकल्प हैं:

-Rनाम इसका विस्तार करें <<नाम>> कोड खंड. -R प्रत्येक मामले में विकल्प दोहराया जा सकता है
चंक को आउटपुट में लिखा जाता है। अगर कोई नहीं -R विकल्प दिया गया है, नामित खंड का विस्तार करें
<<*>>.

-Lप्रारूप
खंड सीमाओं पर पंक्ति संख्या संकेत उत्सर्जित करें। एक पंक्ति संख्या संकेत
इसके बाद आने वाली पंक्ति के स्रोत की पहचान करता है। में प्रारूप, %F इंगित करता है
स्रोत फ़ाइल का नाम, %L स्रोत फ़ाइल की पंक्ति संख्या इंगित करता है, %N
एक नई पंक्ति इंगित करता है, और %% प्रतिशत चिह्न दर्शाता है। एक चिन्ह और अंक हो सकता है
प्रतिशत चिह्न और ` के बीच डाला गयाL', जिस स्थिति में लाइन नंबर होगा
उस राशि से समायोजित किया जाए। अगर प्रारूप छोड़ दिया गया है, डिफ़ॉल्ट प्रारूप वह है
सी प्रीप्रोसेसर द्वारा स्वीकृत: `#रेखा %L "%F"%N'. का उपयोग करते समय -Lप्रारूप विकल्प,
नुकीला यह सुनिश्चित करता है कि सभी टेक्स्ट इनपुट और आउटपुट में एक ही कॉलम में दिखाई दें।
संज्ञा इस विकल्प को अनदेखा करता है.

सामान्य प्रारूप स्ट्रिंग में शामिल हैं:
C -एल'#लाइन %L "%F"%N'
सन फोरट्रान -एल'\# %L "%F"%N'
आइकॉन -एल'#लाइन %-1L "%F"%N'
मॉड्यूल-3 -एल'<*लाइन %L "%एफ" *>%N'
एसएमएल/एनजे -एल'(*#लाइन %L "%एफ"*)'

विपरीत समस्या को हल करने के लिए, यानी नोएब को कुछ समझदारीपूर्ण कार्य करने के लिए प्रेरित करना
#रेखा इसके इनपुट में देखें शार्पलाइन उदाहरण निर्देशिका में फ़िल्टर करें।

-tk इनपुट से आउटपुट तक अछूते टैब को कॉपी करें, और इंडेंटेशन के लिए टैब का उपयोग करें, यह मानते हुए
प्रत्येक को रोकता है k कॉलम. डिफ़ॉल्ट रूप से, टैब को प्रत्येक 8 स्टॉप के साथ रिक्त स्थान तक विस्तारित किया जाता है
कॉलम।

-Filter सीएमडी
फ़िल्टर करें नोएब स्रोत के माध्यम से सीएमडी इसे टूल फॉर्म में बदलने के बाद और उससे पहले
उलझाना नुकीला की खोज सीएमडी सबसे पहले उपयोगकर्ता पर पथ, फिर /usr/lib/noweb.
ऐसे फ़िल्टर का उपयोग सुविधाएँ जोड़ने के लिए किया जा सकता है नुकीला; उदाहरण के लिए देखें
/usr/lib/noweb/emptydefn. केवल विशेषज्ञों के लिए.

-मार्कअप पार्सर
उपयोग पार्सर इनपुट फ़ाइल को पार्स करने के लिए. अन्य फ़ाइलों पर नोएब टूल का उपयोग सक्षम बनाता है
प्रारूप; उदाहरण के लिए, nummarkup पार्सर समझता है न्यूवेब(1) प्रारूप. देखना
noebfilters(7) अधिक जानकारी के लिए. केवल विशेषज्ञों के लिए.

-अजीब | -c | -मैं कर सकता हूं | -Icon | -एमएल | -एम 3 | -पास्कल | -77 | -90 | -टेक्स
. संज्ञा दस्तावेज़ीकरण के हिस्सों को टिप्पणियों में बदल देता है, टिप्पणी का उपयोग करें
नामित भाषा का प्रारूप. -c डिफ़ॉल्ट है। नुकीला इन विकल्पों पर ध्यान नहीं देता.

-wn . संज्ञा दस्तावेज़ीकरण के हिस्सों को टिप्पणियों में परिवर्तित करता है, टिप्पणियाँ बनाता है
चौड़ाई की रेखाएँ n. नुकीला इस विकल्प को अनदेखा करता है.

बुनाई

से आउटपुट कोई बुनाई नहीं में इस्तेमाल किया जा सकता है टेक्स दस्तावेज जो \इनपुट एनडब्लूमैक, in LaTeX दस्तावेजों
कि का उपयोग करें नोएब पैकेज (देखें noebstyle(1)), और में एचटीएमएल ब्राउज़ किए जाने वाले दस्तावेज़
मौज़ेक(1). कोई बुनाई नहीं कुछ हद तक कोड खंडों के साथ व्यवहार करता है LaTeX सूची वातावरण। यदि ``@
'' जो एक कोड खंड को समाप्त करता है उसके तुरंत बाद पाठ आता है, वह पाठ अनुसरण करता है
पैराग्राफ ब्रेक के बिना कोड खंड। यदि शेष पंक्ति रिक्त है, कोई बुनाई नहीं डालता है टेक्स
``ऊर्ध्वाधर मोड'' में, और बाद का पाठ एक नया, इंडेंटेड पैराग्राफ शुरू करता है।

जब तक ओवरफ़ुल से बचने के लिए आवश्यक न हो, कोड खंडों के बीच में कोई पेज ब्रेक नहीं होता है
vbox. कोड खंड से ठीक पहले का दस्तावेज़ीकरण खंड उसी पृष्ठ पर दिखाई देता है
उस कोड खंड के रूप में जब तक कि ऐसा करने से पिछले नियम का उल्लंघन न हो।

कोई बुनाई नहीं इसमें कोई अतिरिक्त नई पंक्तियाँ सम्मिलित नहीं की गई हैं टेक्स आउटपुट, इसलिए दी गई पंक्ति संख्याएँ टेक्स
त्रुटि संदेश इनपुट फ़ाइल के समान ही हैं।

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

-लेटेक्स रैपर सहित LaTeX उत्सर्जित करें लेख शैली के साथ नोएब पैकेज और पेज
शैली। (गलती करना)

-टेक्स रैपर सहित सादा TeX उत्सर्जित करें nwmac मैक्रोज़.

-एचटीएमएल HTML रैपर का उपयोग करके HTML उत्सर्जित करें। आउटपुट बिना रुचिकर नहीं है -सूचकांक or -x.
टैग और , स्वयं की तर्ज पर, की एक सूची तैयार करें
क्रमशः टुकड़े और पहचानकर्ताओं का एक सूचकांक। यदि ये टैग मौजूद नहीं हैं,
सूची और अनुक्रमणिका फ़ाइल के अंत में रखी गई हैं।

-लेटेक्स+एचटीएमएल
मान लें कि दस्तावेज़ीकरण खंड LaTeX हैं, लेकिन उपयुक्त रूप से कोड खंडों के लिए HTML उत्पन्न करें
इसलिए रूपांतरण के साथ चिह्नित किया गया लेटेक्स2एचटीएमएल(1) उचित उत्पादन देता है। एक LaTeX आवरण
निहित है, लेकिन इसे बंद किया जा सकता है -n. उपयोग of इसका विकल्प is बहिष्कृत; उपयोग
-एचटीएमएल साथ में -Filter l2h बजाय.

-ट्रॉफ़ फेंकना ट्रोफ(1) मार्कअप (बिना किसी आवरण के)। परिणाम के साथ कार्रवाई की जानी चाहिए
नोरॉफ़(1). के लिए बग रिपोर्ट -ट्रॉफ़ अहरोन रॉबिंस को <[ईमेल संरक्षित]>.

-n किसी भी रैपर (हेडर या ट्रेलर) का उपयोग न करें। यह विकल्प तब उपयोगी होता है जब कोई बुनाई नहीं's
आउटपुट एक बड़े दस्तावेज़ का हिस्सा होगा। यह सभी देखें -देरी।

-Filter सीएमडी
फ़िल्टर करता है नोएब स्रोत के माध्यम से सीएमडी इसे टूल फॉर्म में बदलने के बाद और उससे पहले
में परिवर्तित करना TeX. कोई बुनाई नहीं की खोज सीएमडी सबसे पहले उपयोगकर्ता पर पथ, फिर
/usr/lib/noweb. ऐसे फ़िल्टर का उपयोग सुविधाएँ जोड़ने के लिए किया जा सकता है कोई बुनाई नहीं; एक के लिए
उदाहरण, देखें /usr/lib/noweb/noxref.krom. कोई बुनाई नहीं चार फ़िल्टर तक का समर्थन करता है; एक
शेल प्रवंचना द्वारा और अधिक प्राप्त किया जा सकता है, उदाहरण के लिए, -Filter "आइकन.फ़िल्टर | noidx"।
-ऑटोडेफ़्स, -x, -सूचकांक, तथा -सूचकांकसे विकल्प फ़िल्टर के रूप में कार्यान्वित किए जाते हैं। फिल्टर
शेल के साथ निष्पादित किया जाता है विकसित करना आदेश, तो सीएमडी तदनुसार उद्धृत किया जाना चाहिए।

-मार्कअप पार्सर
उपयोग पार्सर इनपुट फ़ाइल को पार्स करने के लिए. अन्य फ़ाइलों पर नोएब टूल का उपयोग सक्षम बनाता है
प्रारूप; उदाहरण के लिए, nummarkup पार्सर समझता है न्यूवेब(1) प्रारूप. देखना
noebfilters(7) अधिक जानकारी के लिए. केवल विशेषज्ञों के लिए.

-Option चुनना
जोड़ता है \अबविकल्प{चुनना} को LaTeX शीर्षक. देखना noebstyle(1) के मूल्यों के लिए ऑप्ट.
आम तौर पर केवल के साथ उपयोगी है -लेटेक्स विकल्प, लेकिन -Option longxref काला जादू करता है
साथ में -एचटीएमएल.

-विलंब डिफ़ॉल्ट रूप से, कोई बुनाई नहीं फ़ाइल-नाम और अन्य जानकारी को आउटपुट से पहले डालता है
कार्यक्रम का पहला भाग. -विलंब उस जानकारी को पहले के बाद तक विलंबित करता है
दस्तावेज़ीकरण खंड, कार्य को थोड़ा सा बनाना वेब ``लिम्बो।'' विकल्प है
आमतौर पर उपयोगकर्ता को किसी विशेष को डालने में सक्षम बनाने के लिए उपयोग किया जाता है LaTeX \documentclass आदेश
और पहले दस्तावेज़ीकरण खंड में अन्य प्रस्तावना सामग्री (यानी, से पहले la
पहला @ चिन्ह). यह विकल्प अनुवर्ती क्रॉस-रेफ़रेंसिंग जानकारी को भी बाध्य करता है
दस्तावेज़ के अंत के बजाय अंतिम भाग से ठीक पहले उत्सर्जित किया जाए;
अंतिम भाग शामिल होने की उम्मीद है \ अंत {दस्तावेज़}। RSI -विलंब विकल्प का तात्पर्य है
-n विकल्प.

-tk प्रत्येक स्टॉप के साथ टैब का विस्तार करें k कॉलम. (डिफ़ॉल्ट रूप से प्रत्येक 8 कॉलम का विस्तार करना है।)

-t टैब को आउटपुट में कॉपी करें.

-v मानक त्रुटि पर पाइपलाइन और आरसीएस जानकारी प्रिंट करें।

अनुक्रमण और प्रति संदर्भ

जब used के साथ प्रयोग किया जाता है LaTeX, ट्रोफया, एचटीएमएल, कोई बुनाई नहीं अनुक्रमण और क्रॉस-रेफरेंस प्रदान कर सकता है
टुकड़ों और प्रोग्रामिंग-भाषा पहचानकर्ताओं के लिए जानकारी। पहचानकर्ता परिभाषाएँ
बैकटिक्स (`) का उपयोग करके हाथ से चिह्नित किया जा सकता है; -Filter btdefn विकल्प इन्हें पहचानता है
चिह्न. कुछ भाषाओं के लिए, परिभाषाओं को स्वचालित रूप से उपयोग करके पाया जा सकता है -ऑटोडेफ़्स
विकल्प। यह अनुभाग अनुक्रमण और क्रॉस-रेफरेंस विकल्पों का वर्णन करता है; यह अच्छी तरह से हो सकता है
पहली बार पढ़ने पर छोड़ दिया गया।

-x के लिए लाटेक्स, प्रत्येक खंड के नाम में उसके स्थान की पहचान करते हुए एक पृष्ठ संख्या जोड़ें
चंक की परिभाषा, और परिभाषाओं से संबंधित क्रॉस-रेफरेंस जानकारी उत्सर्जित करें
उपयोग करता है। के लिए एचटीएमएल, खंडों के उपयोग और परिभाषाओं के बीच हाइपरटेक्स्ट लिंक बनाएं।
. कोई बुनाई नहीं -x के साथ प्रयोग किया जाता है लाटेक्स, नियंत्रण क्रम \ nowweb हिस्सा ए तक फैलता है
सभी कोड खंडों की क्रमबद्ध सूची।

-सूचकांक परिभाषित पहचानकर्ताओं के लिए क्रॉस-रेफरेंस जानकारी (या हाइपरटेक्स्ट लिंक) बनाएं।
परिभाषाएँ वे हैं जो इनपुट फ़ाइलों में पाई जाती हैं -ऑटोडेफ़्स भाषा द्वारा या
-Filterbtdefn. आवश्यक है LaTeX or एचटीएमएल। -सूचकांक का तात्पर्य -एक्स; दोनों वसीयत सहित
अजीब दिखने वाला आउटपुट उत्पन्न करें। कोई बुनाई नहीं का क्रॉस-रेफरेंस उत्पन्न नहीं करता है
उद्धृत कोड में दिखाई देने वाले पहचानकर्ता (@[[...@]]), लेकिन यह हाइपरटेक्स्ट उत्पन्न करता है
लिंक. कब कोई बुनाई नहीं -सूचकांक के साथ प्रयोग किया जाता है लाटेक्स, नियंत्रण क्रम \ nowindex
पहचानकर्ताओं के सूचकांक तक विस्तारित होता है।

-सूचकांकसे अनुक्रमणिका
पसंद -अनुक्रमणिका, लेकिन अनुक्रमित किए जाने वाले पहचानकर्ता फ़ाइल से लिए गए हैं अनुक्रमणिका. देखना
नोइंडेक्स(1).

-ऑटोडेफ़्स lang
स्वचालित रूप से पहचानकर्ता परिभाषाएँ खोजें। टुकड़ों में कोड भाषा में होना चाहिए
lang. जायज़ langअलग-अलग हैं लेकिन इसमें शामिल हो सकते हैं tex or आइकन. बिना बेकार -अनुक्रमणिका,
जो इससे पहले होना चाहिए।

-शोऑटोडेफ़्स
के मान दिखाएँ lang के साथ प्रयोग करने योग्य -ऑटोडेफ़्स.

त्रुटि संदेश

If नुकीला or कोई बुनाई नहीं दस्तावेज़ के भीतर एक खंड नाम का सामना होता है, तो यह मान लिया जाता है कि यह
एक त्रुटि को इंगित करता है, आमतौर पर गलत वर्तनी ``< >=''. अन्य त्रुटि संदेश होने चाहिए
स्व-व्याख्यात्मक।

ऐसे खंड को संदर्भित करना गलत है जिसे कभी परिभाषित नहीं किया गया है, लेकिन खंडों का होना ठीक है
परिभाषित और उपयोग नहीं किया गया।

उदाहरण

यदि आपको इस मैन पेज को पचाने में परेशानी हो रही है, तो आप अकेले नहीं हैं। इसके लिए यहां कुछ उदाहरण दिए गए हैं
आप आरंभ करें. मैं मान लूंगा कि आपके पास एक फू.नव खंड में सी प्रोग्राम के साथ फ़ाइल < >
और खंड में एक हेडर फ़ाइल < >, और इसका उपयोग करके आपके दस्तावेज़ को चिह्नित किया गया है
लाटेकस(1). मैं आपको दिखाऊंगा कि सबसे आम विकल्पों का उपयोग करके चीजें कैसे बनाई जाती हैं।

अपने C स्रोत को फिर से बनाने का प्रयास करें
नुकीला -L -Rfoo.c फू.नव > फू.सी
अपनी हेडर फ़ाइल को फिर से बनाने का प्रयास करें
नुकीला -Rfoo.h फू.नव | सीपीएफ फू.एच
यहां दो समझौते हैं. को छोड़ते हुए -L रखता है #रेखा आपकी हेडर फ़ाइल से बाहर, और
का उपयोग सीपीएफ कमांड को दोबारा लिखने से रोकता है फू.एच जब तक कि सामग्री नहीं बदल गई हो.
इस प्रकार, मेकफ़ाइल नियम में डालने के लिए यह अच्छा कोड है।

मुद्रित दस्तावेज़ बनाने के लिए, चलाएँ
कोई बुनाई नहीं -ऑटोडेफ़्स c -सूचकांक फू.नव > foo.tex
यदि आपके पास अपनी स्वयं की प्रस्तावना है, जिसमें शामिल है \documentclass और सब, आपको इसकी भी आवश्यकता होगी
-विलंब विकल्प.

एक वेब पेज बनाने के लिए, चलाएँ
कोई बुनाई नहीं -Filter l2h -ऑटोडेफ़्स c -सूचकांक -एचटीएमएल फू.नव | htmltoc > foo.html
मज़ा लो!

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