我用哪个Perl模块将Pod转换为HTML？

Question

我需要将Pod转换为HTML。有许多Pod :: HTML和Pod :: Simple :: *模块。我应该使用哪一个？

Answer 1

简短回答是Pod::Simple::XHTML。它产生有用而简洁的HTML输出。您可以通过查看http://metacpan.org处的html源来查看输出示例。

它也可以与Pod::Simple::HTMLBatch一起使用，如果要转换多个文件，应该查看它。请注意，Pod :: Simple :: HTMLBatch的默认值是Pod :: Simple :: HTML。但Pod :: Simple的维护者，David Wheeler，recommends使用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');