Современный конвертер POD в HTML для получения результатов, таких как search.cpan.org - PullRequest
7 голосов
/ 14 февраля 2011

Существует ли код для преобразования POD в HTML аналогично search.cpan.org?Я бы хотел запустить его над моими дистрибутивными модулями CPAN, чтобы посмотреть, как они будут выглядеть перед выпуском.

pod2html, который поставляется с Perl, кажется довольно устаревшим.Он делает странные вещи, такие как размещение временных файлов в текущем каталоге и создание ссылок, таких как «такая-то справочная страница», и вывод намного уступает прекрасному выводу search.cpan.org.Но не уверен, что другие люди используют.

Ответы [ 4 ]

12 голосов
/ 14 февраля 2011

Перед загрузкой в ​​CPAN я проверяю свой POD, просматривая его в браузере из http://search.cpan.org/pod2html.

Формы там, я нажимаю Browse...

Я перехожу в каталогсодержащий мой код и дважды щелкните по файлу .pm.

Затем нажмите Submit Query.

Это самое близкое, что я видел, к реальной вещи.

См. Также pod2cpanhtml.

8 голосов
/ 15 февраля 2011

Я написал pod2cpanhtml именно по тем причинам, которые вы описываете.

Это всего лишь небольшой кусочек кода, который использует Pod :: Simple :: HTML и search.cpan.org CSS , но я нахожу это очень полезным.

3 голосов
/ 14 февраля 2011

Добавляя предложения мобов, я был вполне доволен Pod :: ProjectDocs . Требовалось несколько незначительных настроек, но это более или менее похоже на CPAN.

2 голосов
/ 14 февраля 2011

В соответствии с этим потоком perlmonks хитрость заключается в использовании Pod::HtmlEasy.Или, возможно, хитрость заключается в использовании Apache::Pod::HTML.Или Pod::Tree?Я не знаю, но там есть несколько предложений.

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...