2009-10-02 13 views
12

मैं देख रहा हूं कि एक अच्छा ऑन-स्क्रीन पीओडी पढ़ने का अनुभव है।पर्ल प्रलेखन (पीओडी) ब्राउज़र?

वर्षों के लिए, मैं perldoc या man एक xterm में चल रहा का उपयोग किया है स्क्रीन पर पर्ल प्रलेखन, और एक छोटे से कस्टम Pod::LaTeX के आसपास बनाया गया कार्यक्रम उसका प्रिंट ले पढ़ने के लिए। मुद्रित संस्करण अच्छा है: स्क्रिप्ट एक अच्छी नौकरी करता है। हालांकि, के लिए स्क्रीन पर पढ़ने दर्दनाक है:

  • आप खोज सकते हैं, लेकिन सौभाग्य उदा खोजने, DBIx::Class::ResultSet में as अनुभाग। दस्तावेज़ की संरचना के बारे में कुछ भी नहीं पता है, और सामान्य अंग्रेजी शब्दों की खोज व्यर्थ हैं।
  • मुझे हर बार डर है कि दस्तावेज़ मुझे see section so-and-so बताता है। महान। अब मुझे यह खोजना है। और फिर जहां मैं था वहां वापस आना छोटा नहीं होगा (हालांकि यह मेरी कम अज्ञानता दिखा सकता है)
  • दस्तावेज़ देखें और इससे भी बदतर है। !perldoc foo काम करता है, लेकिन दो दस्तावेज़ों के बीच स्विच करना मुश्किल है। आप शेल से perldoc को कम करके और चलने से अधिकतर इसे प्राप्त कर सकते हैं, लेकिन यह अधिक कीस्ट्रोक है और मैं आलसी हूं।
  • स्वरूपण वांछित होने के लिए बहुत कुछ छोड़ देता है।

मैं सामग्री की एक तालिका पर क्लिक करने में सक्षम होना चाहता हूं, और उस अनुभाग पर जाना चाहता हूं। मैं उस पर क्लिक करने में सक्षम होना चाहता हूं "अन्य देखें" और वहां जाएं। और इसी तरह। अब तक, मैं दो संभावनाओं की पता:

  • search.cpan.org, उदाहरण के DBIx::Class::ResultSet। एक इंटरनेट कनेक्शन की आवश्यकता है, लेकिन यह आमतौर पर एक समस्या नहीं है।
  • Podbrowser। बस यह कोशिश करना शुरू कर दिया, बहुत अच्छा लग रहा है।

मैं डेनी जीएनयू/लिनक्स, लेनी और निचोड़ दोनों चला रहा हूं। लेकिन कृपया इसे यथासंभव उपयोगी बनाने के लिए सभी प्लेटफार्मों के कार्यक्रमों का सुझाव दें।

+3

आप जिन चीजों के बारे में शिकायत करते हैं, उनमें से एक सामान मैं एक अलग टर्मिनल विंडो (या स्क्रीन, या जो कुछ भी) में करता हूं। मुझे स्वरूपण के बारे में बहुत कुछ परवाह नहीं है, या तो। :) –

उत्तर

7

आप Pod::Browser को आजमा सकते हैं जो अंतर्निहित http सर्वर है जिसे आप अपने ब्राउज़र से कनेक्ट कर सकते हैं, या Tk::Pod जैसे कुछ gui pod ब्राउज़र है।

+0

तो आप जानते हैं, आपका पहला लिंक मर चुका है। – ale10ander

+1

@Cptn_Hammer ने इसे mpeters – derobert

2

मैं pod2html

यह ब्राउज़ करने योग्य, जुड़ा हुआ है और देख अच्छा बना देता है का उपयोग करके HTML करने के लिए अपने सभी पॉड परिवर्तित recomment होता है, और आप देखो & अनुकूलित कर सकते हैं सीएसएस के माध्यम से लग रहा है।

+1

यह वही है जो मैं उपयोग करता हूं, क्योंकि यह नेट से डिस्कनेक्ट होने पर आसान है और लिंक्स के साथ कमांड लाइन से उपयोग करने योग्य है (थोड़ा दुखद मानक मैकोज़क्स वितरण में नहीं है, लेकिन मैकपोर्ट्स में यह है)। मुझे आश्चर्य है कि क्या सभी इंस्टॉलेशन के लिए डिफ़ॉल्ट रूप से HTML डॉक्स बनाने के लिए ExtUtils :: मेकमेकर वरीयता सेट करना संभव है ...? – Ether

5

क्या आपने CPAN::Mini::Webserver या Pod::POM::Web या Apache::Perldoc देखा है? ये आपके दस्तावेज़ों के अच्छे, HTML संस्करण देखने के लिए एक स्थानीय तरीका स्थापित करते हैं।

1

बस दो और पीओडी सर्वर जोड़ने के लिए जो अब तक याद किया गया था!

+0

के लिए तय किया है इन विभिन्न विकल्पों के बीच चयन करने के लिए क्या है – justintime

+0

@justintime: नहीं उपयोग किया गया पॉड :: वेबसर्वर इसलिए उस पर टिप्पणी नहीं कर सकता है। लेकिन मैं पॉड :: सर्वर का उपयोग करता हूं और इसके साथ बहुत खुश हूं। मुझे पीओडी प्रस्तुत करने का तरीका पसंद है और क्योंकि यह स्क्वाटिंग फ्रेमवर्क पर बनाया गया है, मुझे सहज महसूस होता है कि यदि आवश्यक हो तो मैं स्थानीय संशोधन कर सकता हूं (जो कि मैं अब तक नहीं हूं ... लेकिन एक खोज विकल्प जोड़ना एक अच्छा विचार होगा!) । – draegtun

0

Gtk2 :: पूर्व :: PodViewer पर एक नज़र भी एक उत्कृष्ट जीयूआई जीटीके के आधार पर दर्शक है कि लो। यदि आप विंडोज का उपयोग कर रहे हैं तो आप कैमेलबॉक्स (http://code.google.com/p/camelbox/) में प्रीबिल्ट रैपर पा सकते हैं।

+0

पहली नज़र में, पॉडव्यूवर (v0.18, जो सीपीएएन कहता है नवीनतम है) कम पॉलिश वाले पॉडब्रोसर की तरह दिखता है। – derobert

संबंधित मुद्दे