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