pod2html：链接到其他文件

Question

我有一堆POD分布在多个Perl脚本文件中。我想使用另一个.pod文件为所有这些POD编写目标网页。

说，在/my/root/sub_folder/文件夹中，我有一个带有以下POD的脚本文件FirstScript.pl。

=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<>部分，则会解析链接，但结果网址的格式为“ .pl .html“，这不是我想要的个人outfiles的样子。

这里有什么问题？我是否以某种无意使用的方式使用podroot和podpath？

Answer 1

您想使用Pod::Simple::HTMLBatch，它会为您生成TOC，它会正确创建并链接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/

Answer 2

pod2html需要参数--htmldir = ...
就这样。这是我的脚本：
https://www.perlmonks.org/?node_id=55079