pod2html：链接到其他文件答案

【问题标题】：pod2html: Linking to Other Filespod2html：链接到其他文件
【发布时间】：2012-04-07 21:49:42
【问题描述】：

我有一堆 POD 分布在多个 Perl 脚本文件中。我想使用另一个 .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 "，这不是我希望单个输出文件的样子。

这里有什么问题？我是否以不应该使用的方式使用podroot 和podpath？

【问题讨论】：

【解决方案1】：

你想使用Pod::Simple::HTMLBatch，它会为你生成一个TOC，它会正确创建和链接FirstScript.html

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

【讨论】：

谢谢，但这不是我正在寻找的答案。我希望能够在更大的文档中创建这些链接，而不是单独自动生成 TOC。我正在尝试使用 POD 编写工具的用户手册，在此过程中，我需要链接到 POD 的各个部分，这些部分分布在许多文件中。
当然是 :) 并且它比 pod2html 简单得多，开箱即用，只要尝试一下就可以了

【解决方案2】：

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

【讨论】：