perl - pod2html : Linking to Other Files

Question

我有一堆分布在多个 Perl 脚本文件上的 POD。我想使用另一个 .pod 为所有这些 POD 编写一个着陆页文件。

例如，在文件夹 /my/root/sub_folder/ 中我有一个脚本文件 FirstScript.pl使用以下 POD。

=head1 DESCRIPTION

This is the description

=cut

在TOC.pod文件，我正在尝试按如下方式链接到该部分。

=over 4

=item L<Link Text|FirstScript/"DESCRIPTION">

=cut

当我运行时:

pod2html --podroot=/my/root --podpath=sub_folder --infile=TOC.pod
    --outfile=TOC.html

我得到了错误:

pod2html: TOC.pod: cannot resolve L<Link Text|FirstScript/"DESCRIPTION">
    in paragraph X.

如果我将文件扩展名 (.pl) 添加到 name，链接将被解析L<> 的一部分代码，但结果 URL 的格式为“.pl.html”，这不是我希望各个输出文件的样子。

这里有什么问题？我在使用 podroot 吗？和 podpath以一种不应该使用的方式？

Answer 1

您想使用 Pod::Simple::HTMLBatch ，它会为您生成目录，并且会正确创建和链接 FirstScript.html

perl -MPod::Simple::HTMLBatch -e Pod::Simple::HTMLBatch::go perl_files_in_sub_folder html_out_folder

• Pod::Simple::HTMLBatch - 将多个 Pod 文件转换为多个 HTML 文件
• Pod::ProjectDocs/pod2projdocs - 从 pod 生成类似项目文档的 CPAN。
• Pod::POM::Web - HTML Perldoc 服务器
• Pod::HtmlTree - 从您模块的 PM 创建 HTML 文档的层次结构。
• 和荣誉奖 unixonly http://perl.overmeer.net/oodoc/