Какой модуль Perl я использую для преобразования Pod в HTML? - PullRequest
Новая
       6

Какой модуль Perl я использую для преобразования Pod в HTML?

8 голосов
/ 24 июля 2011

Мне нужно конвертировать Pod в HTML. Существует несколько модулей Pod :: HTML и Pod :: Simple :: *. Какой из них мне следует использовать?

1 Ответ

11 голосов
/ 24 июля 2011

Краткий ответ: Pod :: Simple :: XHTML . Это дает полезный, но краткий вывод HTML. Вы можете увидеть пример вывода, просмотрев источник HTML на http://metacpan.org.

Он также работает с Pod :: Simple :: HTMLBatch , который вы должны проверить, если вы конвертируете более одного файла. Обратите внимание, что для Pod :: Simple :: HTMLBatch по умолчанию используется Pod :: Simple :: HTML. Но сопровождающий Pod :: Simple, Дэвид Уилер, рекомендует , используя Pod :: Simple :: XHTML. 

use Pod::Simple::HTMLBatch;    
use Pod::Simple::XHTML;

mkdir './html' or die "could not create directory: $!";

my $convert = Pod::Simple::HTMLBatch->new;
$convert->html_render_class('Pod::Simple::XHTML');
$convert->add_css('http://www.perl.org/css/perl.css');
$convert->css_flurry(0);
$convert->javascript_flurry(0);
$convert->contents_file(0);    
$convert->batch_convert('./pod', './html');
...