pod2html：链接到其他文件

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) 添加到L<>代码的name部分，链接将被解析，但结果 URL 的格式为“ .pl .html”，这不是我希望单个输出文件的方式像。

这里有什么问题？ 我podpath以不应该使用的方式使用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/odoc/

Answer 2

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