我使用哪個 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推薦使用 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');