pod2html：鏈接到其他文件

Question

我有一堆遍佈多個Perl腳本文件的POD。我想使用另一個.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. 

，如果我的文件擴展名（特等）增加的對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 

• 波德::簡單:: HTMLBatch - 波德幾個文件轉換爲HTML數文件
• Pod :: ProjectDocs/pod2projdocs - ganerates CPAN像來自pod的項目文檔。
• Pod :: POM :: Web - HTML Perldoc服務器
• Pod :: HtmlTree - 從模塊的PM創建HTML文檔的層次結構。
• 和榮譽獎unixonly http://perl.overmeer.net/oodoc/