pod2html:链接到其他文件

Question

我有一堆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)添加到代码的name一部分,则解析链接L<>,但结果URL的格式为" .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