Przeglądarki dokumentacji Perla (POD)?

Szukam dobrego odczytu na ekranie POD.Przeglądarki dokumentacji Perla (POD)?

Przez wiele lat używałem perldoc lub man uruchomiony w xterm czytać dokumentację Perl na ekranie, a mały program niestandardowy zbudowany wokół Pod::LaTeX go wydrukować. Wersja drukowana jest dobra: skrypt wykonuje dobrą robotę. Jednak na ekranie czytanie jest bolesna:

Możesz szukać, ale powodzenia w znalezieniu np sekcję w DBIx::Class::ResultSetas. Mniej nie wie nic na temat struktury dokumentu, a poszukiwania popularnych angielskich słów są bezcelowe.
Obawiam się, że za każdym razem dokument mówi mi o tym, że see section so-and-so. Wspaniały. Teraz muszę to znaleźć. A potem powrót do miejsca, w którym byłam, nie będzie trywialny (choć to może być moja mniejsza ignorancja)
Zobacz dokument tak i tak jest gorzej. !perldoc foo działa, ale przełączanie między tymi dwoma dokumentami jest wtedy trudne. Możesz to obejść, zawieszając mniej i uruchamiając perldoc z powłoki, ale to więcej klawiszy i jestem leniwy.
Formatowanie pozostawia wiele do życzenia.

Chcę móc kliknąć spis treści i przejść do tej sekcji. Chcę móc kliknąć "zobacz inne" i iść tam. I tak dalej. Do tej pory znam dwie możliwości:

search.cpan.org, przykład DBIx::Class::ResultSet. Wymaga połączenia z Internetem, ale zwykle nie stanowi to problemu.
Podbrowser. Właśnie zacząłem próbować tego, wygląda całkiem nieźle.

Używam systemu Debian GNU/Linux, zarówno Lenny, jak i Squeeze. Ale sugeruj programy na wszystkich platformach, aby były tak użyteczne, jak to tylko możliwe.

Źródło

2009-10-02 derobert

Wiele rzeczy, na które narzekasz, to rzeczy, które robię w oddzielnym oknie terminala (lub na ekranie, czy coś w tym stylu). Nie przejmuję się tak bardzo formatowaniem. :) –

Możesz wypróbować Pod::Browser, który jest wbudowanym serwerem http, z którym możesz się połączyć za pomocą przeglądarki, lub czymś w rodzaju Tk::Pod, która jest przeglądarką gui pod.

Źródło

2009-10-02 15:21:29 mpeters

Więc wiesz, twój pierwszy link jest martwy. – ale10ander

@Cptn_Hammer naprawiono dla mpeterów – derobert

Ja polecam konwersji całe POD HTML przy użyciu pod2html

To sprawia, że można przeglądać, powiązane i ładne, i można dostosować wygląd & czuć poprzez CSS.

Źródło

2009-10-02 15:15:37 DVK

To jest to, czego używam, ponieważ jest użyteczny, gdy jest odłączony od sieci i jest tak samo użyteczny z linii poleceń z rysikiem (bit niestety nie jest w standardowej dystrybucji MacOSX, ale ma to w Macportach). Zastanawiam się, czy możliwe jest ustawienie preferencji ExtUtils :: MakeMaker do budowania dokumentów html domyślnie dla wszystkich instalacji ...? – Ether

Czy widziałeś CPAN::Mini::Webserver lub Pod::POM::Web lub Apache::Perldoc? Ustanawiają one lokalny sposób wyświetlania ładnych wersji HTML swoich dokumentów.

Źródło

2009-10-02 16:07:06

Tylko po to, aby dodać jeszcze dwa serwery POD, które do tej pory wydawały się być pominięte!

Źródło

2009-10-03 16:21:25 draegtun

Co jest do wyboru pomiędzy tymi różnymi opcjami – justintime

@justintime: Not used Pod :: Webserver, więc nie mogę tego komentować. Ale używam Pod :: Server i byłem z niego bardzo zadowolony. Podoba mi się sposób, w jaki renderuje POD, a ponieważ jest zbudowany na strukturze Squatting, czuję się komfortowo wiedząc, że mogę wprowadzić lokalne poprawki, jeśli zajdzie taka potrzeba (czego do tej pory nie robiłem ... ale dodanie opcji wyszukiwania byłoby dobrym pomysłem!) . – draegtun

Mają również spojrzeć gtk2 :: Ex :: PodViewer który jest doskonałym widza GUI oparte na GTK. Jeśli korzystasz również z systemu Windows, możesz znaleźć wstępnie skompilowaną osłonę w Camelboksie (http://code.google.com/p/camelbox/).

Źródło

2011-03-15 10:28:03 register

Na pierwszy rzut oka podviewer (v0.18, który według CPAN jest najnowszy) wygląda jak mniej polerowany podbrowser. – derobert

Przeglądarki dokumentacji Perla (POD)?

Odpowiedz

Powiązane problemy