pod2html：他のファイルへのリンク

Question

私は、複数のPerlスクリプトファイルにPODが広がっています。 .podファイルを使用して、ランディングページをこれらのすべてのPODに書込みたいと思います。

フォルダ内に/my/root/sub_folder/と入力してください。次のPODを持つスクリプトファイル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 

私はエラーを取得する取得：私はのname部分にファイル拡張子（.plという）を追加した場合

pod2html: TOC.pod: cannot resolve L<Link Text|FirstScript/"DESCRIPTION"> 
    in paragraph X. 

はリンクが解決されましたL<>コードですが、結果のURLの形式は「.pl .html」です。これは個々のアウトファイルをどのようにしたいのかではありません。

ここで何が間違っていますか？ 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 

• ポッド::シンプル:: HTMLBatch - いくつかのポッドのファイルは、いくつかのHTMLに変換ファイル
• Pod :: ProjectDocs/pod2projdocs - ポッドからプロジェクトのようなCPANを取得します。
• Pod :: POM :: Web - HTML Perldocサーバー
• Pod :: HtmlTree - モジュールのPMからHTMLドキュメントの階層を作成します。
• と佳作unixonly http://perl.overmeer.net/oodoc/