pod2html: ссылки на другие файлы - PullRequest
Новая
       3

pod2html: ссылки на другие файлы

2 голосов
/ 23 марта 2012

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

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

1 Ответ

5 голосов
/ 26 марта 2012

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