मैन पेज सेक्शन से लिंक करना?


13

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 का उपयोग करें एक टैग जो मनुष्य के उप-लिंक के बाहरी लिंक की अनुमति देता है पृष्ठों


3
एक अच्छे विचार की तरह लगता है। कृपया इसके लिए बग रिपोर्ट दर्ज करें।
फ्लोरियन डिस्च

@FlorianDiesch ज़रूर, यह स्पष्ट हिस्सा है;) वास्तव में, manpages.ubuntu.com एक बहुत ही साफ कार्यान्वयन की तरह है, लेकिन मुझे याद है कि यह एक एकल डेवलपर द्वारा किया गया है। आइए देखें ...
वोल्कर सेगेल


1
@AaAAli Meta केवल उबंटू के बारे में सवालों के लिए है , उबंटू परियोजना या अन्य उबंटू-संबंधित वेबसाइटों के बारे में नहीं।
एलियाह कगन

1
वैसे, मैंने यहां एक बहुत ही समान प्रश्न लिखा: unix.meta.stackexchange.com/q/3960/135943
Wildcard

जवाबों:


7

हाँ, यह है, यह http://man.cx/ है । इसका उद्देश्य सभी साइट में एक से अधिक भाषाओं में सभी मैन पेज हैं। एंकर दुर्भाग्य से नाम नहीं हैं, लेकिन गिने जाते हैं: उदाहरण के लिए http://man.cx/printf#heading1 आपको printfमैन पेज की पहली हेडिंग में ले जाएगा । फिर भी मुझे लगता है कि यह बिना एंकर से बेहतर है;)

पुनश्च। साइट को अपने खोज इंजन में जोड़ें, फिर आप बस man printfअपने पता बार में टाइप कर सकते हैं , और यह आपको सही पृष्ठ पर ले जाएगा, सुपर कमाल!


1
खोज इंजन के रूप में ब्राउज़र एकीकरण के लिए महान विचार!
फिलिप वेंडर

टिप्पणी के बिना नीचे?
गेरहार्ड बर्गर

2

पर unix.stackexchange , वहाँ तरीके से वर्णन किया जाता है हाइपरटेक्स्ट के रूप में ऑफ़लाइन manpages का उपयोग भी। मेरे लिए सबसे आसान तरीका w3mman लगता है, जो पैकेज का हिस्सा है w3m, इसलिए:

sudo apt-get install w3m

जब आपने एक आदमी पृष्ठ खोला w3mman man, तो आप TABअगले लिंक पर नेविगेट करने के लिए उपयोग कर सकते हैं । (अन्य मैन-टिपिकल कीबोर्ड शॉर्टकट एक ही काम करते हैं: स्क्रॉल करना, खोजना, छोड़ना :-)

पुष्टिकरण बंद करने के लिए (जैसा manव्यवहार करता है):

  • संपादित करें ~/.w3m/config

    • यदि विद्यमान नहीं है: cp /etc/w3m/config ~/.w3m/
  • सेट confirm_qq 0

सामान्य मैन कमांड को बदलने के लिए :

  • संपादित करें ~/.bashrc

    • जोड़ना alias man='w3mman'
  • source ~/.bashrc

अब man <some command>सामान्य व्यक्ति के बजाय w3mman का उपयोग करेंगे :) मुझे यह इस तरह से पसंद है। पूछने के लिए धन्यवाद! :)

हमारी साइट का प्रयोग करके, आप स्वीकार करते हैं कि आपने हमारी Cookie Policy और निजता नीति को पढ़ और समझा लिया है।
Licensed under cc by-sa 3.0 with attribution required.