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», это не то, как я хочу, чтобы отдельные файлы были похожими.

Что здесь не так? Использую ли я podroot и podpath таким образом, который не предназначен для использования?

Answer 1

Вы хотите использовать 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 - ganerates CPAN как проектные документы из pod.
• Pod :: POM :: Web - HTML Perldoc server
• Pod :: HtmlTree - создать иерархию HTML-документов из PM вашего модуля.
• и похвальный unixonly http://perl.overmeer.net/oodoc/