Perl-документации (POD)?

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

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

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

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

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

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

Ответы

Ответ 1

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

Ответ 3

Я бы пересчитал преобразование всех ваших POD в HTML с помощью pod2html

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

Ответ 4

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

Ответ 5

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