3

我有一堆 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 的样子。

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

4

2 回答 2

5

你想使用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/
于 2012-03-25T23:06:01.067 回答
0

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

于 2020-03-06T23:20:17.633 回答