3

複数の Perl スクリプト ファイルにまたがる一連の POD があります。別のファイルを使用して、これらすべての PODのランディング ページを作成したいと考えてい.podます。

たとえば、フォルダーに次の POD を/my/root/sub_folder/含むスクリプト ファイルがあるとします。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<>ますが、結果の URL は「.pl .html」の形式になります。これは、個々の出力ファイルをどのようにしたいかではありません。

ここで何が問題なのですか？podrootandを意図しない方法で使用しpodpathていませんか?

4

2 に答える 2

5

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/odoc/
于 2012-03-25T23:06:01.067 に答える