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

Question

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

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

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

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

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

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

Answer 1

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

Answer 2

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

Это делает его доступным для просмотра, связана между собой и приятным глазом, и вы можете настроить внешний вид & чувствовать себя с помощью CSS.

Answer 3

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

Answer 4

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

• Pod::Server
• Pod::Webserver

Answer 5

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