HTML में अनुभाग लंगर के साथ ऑनलाइन मैन पेज?
उपखंडों में सीधे लिंक के साथ उबंटू मैन पेजों का एक ऑनलाइन संस्करण होना अच्छा होगा। यह कई मामलों में प्रासंगिक दस्तावेज़ के लिए किसी को इंगित करने की अनुमति देगा - उदाहरण के लिए विभिन्न StackExchange साइटों के उत्तर में।
मैं वर्णन करूंगा कि एक पूर्ण समाधान कैसे दिख सकता है, और किन तरीकों से उपयोगी होगा। मुझे नहीं लगता कि एक पूर्ण समाधान कहीं उपलब्ध है, इसलिए सवाल यह है
आज कौन से आंशिक समाधान मौजूद हैं?
उदाहरण के लिए, किसी भी तरह से लिंक करने के बजाय मैन पेजों में खोज करने के लिए व्यवस्थित तरीके आंशिक समाधान होंगे।
Manpages.ubuntu.com के
मैन पेज ज्यादातर समस्या को हल करते हैं, लेकिन उनमें शीर्षकों या अनुभागों में एंकर नहीं होते हैं।
इसका मतलब है, अगर मैं man bash
ऑनलाइन में "पैरामीटर विस्तार" को इंगित करना चाहता हूं, तो मुझे
उपयोग करना होगा
में "पैरामीटर विस्तार" देखें ... और "पैरामीटर विस्तार" की खोज के लिए अपने ब्राउज़र का उपयोग करें]
man bash
यह सबसे लंबे वेब पेज के रूप में शीर्ष पर बैश मैन पेज खोलता है।
खोल में, मैं कह सकता हूँ
देख
man bash | less "+/Parameter Expansion"
जो स्टार्टअप पर सही जगह पर कूदता है।
यह उन लिंक एंकरों के लिए वास्तव में मददगार होगा, जिनका नाम उन शीर्षकों की तरह होगा जो वे इंगित करते हैं। किसी प्रकार के इंडेक्स नंबर द्वारा नामित एंकर अभी भी मदद करेंगे, लेकिन इसका उपयोग करने के लिए वास्तविक वेब पेज पर एक मैनुअल लुकअप की आवश्यकता होती है।
चूंकि शीर्षकों में एंकरों को जोड़ने के लिए HTML स्तर पर यह मुश्किल नहीं है, मुझे यकीन है कि ऐसे मैन पेज मौजूद हैं;
लेकिन क्या ऑनलाइन कहीं एंकर के साथ उबंटू मैन पेजों का संग्रह है, या कम से कम एक अच्छा सबसेट है?
उदाहरण कोड
से की धारा "पैरामीटर विस्तार" शीर्षक
http://manpages.ubuntu.com/bash
जो तरह-ऑफ-द रीडायरेक्ट करने
http://manpages.ubuntu.com/manpages/trusty/en/man1/bash.1.html
[ ... ]
tildes in assignments to <b>PATH</b>, <b>MAILPATH</b>, and <b>CDPATH</b>, and the shell
assigns the expanded value.
<b>Parameter</b> <b>Expansion</b>
The `<b>$</b>' character introduces parameter expansion, command substitution,
or arithmetic expansion. The parameter name or symbol to be expanded
[ ... ]
इस अनुभाग को सीधे लिंक करने में सक्षम होने के लिए, हमें कुछ इस तरह की आवश्यकता है:
[ ... ]
tildes in assignments to <b>PATH</b>, <b>MAILPATH</b>, and <b>CDPATH</b>, and the shell
assigns the expanded value.
<a href="#ParameterExpansion"><b>Parameter</b> <b>Expansion</b></a>
The `<b>$</b>' character introduces parameter expansion, command substitution,
or arithmetic expansion. The parameter name or symbol to be expanded
[ ... ]
यह HTML कोड में एक टैग, और एक विशेषता, रिक्त स्थान के बिना अनुभाग नाम जोड़ता है:
<b>Parameter</b> <b>Expansion</b>
<a href="#ParameterExpansion"><b>Parameter</b> <b>Expansion</b></a>
अब, हम जैसे अनुभाग से लिंक कर सकते हैं
http://manpages.ubuntu.com/bash#ParameterExpansion
या यहां तक कि
manpages.ubuntu.com/bash#ParameterExpansion
जो एक फुट नोट का उपयोग करता है और जैसा लिखा जाता है,
[manpages.ubuntu.com/bash#ParameterExpansionourcing [6]
अन्य संदर्भ दस्तावेजों का उपयोग
कई मामलों में, वैकल्पिक संदर्भ दस्तावेज उपलब्ध हैं, मैन पेज से ही उपलब्ध हैं। इनमें अक्सर एक अच्छी लिंक संरचना होती है जिसका उपयोग सामग्री की तालिका से वर्गों तक लिंक करने के लिए किया जाता है, बस हमें जो चाहिए।
लेकिन यह सामान्य समस्या को हल नहीं करता है , क्योंकि इस तरह के दस्तावेज़ मौजूद हैं या नहीं, यह पता लगाने का कोई सामान्य तरीका नहीं है और लिंक संरचना का उपयोग करना है।
ऊपर इस्तेमाल किए गए बैश उदाहरण के लिए, बैश संदर्भ मैनुअल का उपयोग व्यक्तिगत समाधान के रूप में किया जा सकता है, जिसे मैन्युअल रूप से देखा जाता है:
बैश संदर्भ मैनुअल अनुभाग शेल-पैरामीटर-विस्तार
[बैश संदर्भ मैनुअल अनुभाग शेल-पैरामीटर-विस्तार] (http://www.gnu.org/software/bash/manual/bash.html#Shell-Parameter-Expansion के
रूप में लिखा गया है
प्रस्तावित कार्यान्वयन
वास्तव में manpages.ubuntu.com पर इस विचार को लागू करने का प्रस्ताव करने के लिए ,
मैंने संबंधित प्रोजेक्ट "ubuntu-manpage-repository" पर एक निकट से संबंधित बग / एन्हांसमेंट अनुरोध दायर किया:
लॉन्चपैड # 1355271: HTML का उपयोग करें एक टैग जो मनुष्य के उप-लिंक के बाहरी लिंक की अनुमति देता है पृष्ठों