Perl документация (POD) браузеры? [закрытый]

Я ищу хороший опыт чтения на экране стручка.

в течение многих лет, я использовал perldoc или man работает в xterm для чтения документации Perl на экране и небольшой пользовательской программы, построенной вокруг Pod::LaTeX распечатать его. Печатная версия хороша: сценарий делает хорошую работу. Тем не менее, экранное чтение болезненно:

  • вы можете искать, но удачи в поисках, например, на DBIx::Class::ResultSet. Меньше ничего не знает о структура документа и поиск общих английских слов бессмысленны.
  • я боюсь каждый раз, когда документ говорит мне see section so-and-so. Отличный. Теперь я должен это найти. И тогда возвращение туда, где я был, не будет тривиальным (хотя это может быть мое меньшее невежество)
  • см. документ такой-то хуже. !perldoc foo работает, но переключение между двумя документами, то тяжело. Вы можете в основном обойти это, приостановив меньше и работает perldoc от раковина, но это больше нажатий клавиш, и я ленив.
  • форматирование оставляет желать лучшего.

Я хочу иметь возможность щелкнуть оглавление и перейти к этому разделу. Я хочу иметь возможность нажать "увидеть другое" и пойти туда. И так далее. До сих пор я знаю две возможности:--12-->

  • search.cpan.org, пример DBIx::Class::ResultSet. Требуется подключение к Интернету, но это обычно не проблема.
  • Podbrowser. Только начал пробовать, выглядит неплохо.

Я запускаю Debian GNU / Linux, как Lenny, так и Squeeze. Но, пожалуйста, предложить программы для всех платформ, чтобы сделать это как можно более полезным.

5 ответов


вы можете попробовать Pod:: Browser который является встроенным HTTP-сервером, к которому вы можете подключиться с помощью браузера, или что-то вроде Tk:: Pod который является браузером GUI pod.


видели CPAN::Mini:: Webserver или Pod::POM:: Web или Apache:: Perldoc? Они настраивают локальный способ просмотра хороших HTML-версий ваших документов.


Я бы рекомендовал преобразовать весь ваш POD в HTML, используя pod2html

Это делает его просматриваемым, связанным и красивым, и вы можете настроить внешний вид с помощью css.


просто добавить еще два сервера POD, которые, казалось, были пропущены до сих пор!


Посмотрите также на Gtk2::Ex:: PodViewer, который является отличным зрителем GUI на основе GTK. Если вы используете также Windows, вы можете найти встроенную оболочку в Camelbox (http://code.google.com/p/camelbox/).