ru.perl

 
 - RU.PERL ----------------------------------------------------------------------
 From : Michael Poliakov                     2:5020/400     21 Nov 2001  14:36:04
 To : All
 Subject : Построить доки в HTML из pod для ActiveState (проблема с pod2html)
 -------------------------------------------------------------------------------- 
 

 Чувствую себя ужасно тупым.
 
 Поставил новый билд ActivePerl (ActivePerl-5.6.1.630-MSWin32-x86.msi), в d:\usr.
 Документация к нему идет в формате HTMLHelp (d:\usr\Docs\ActivePerl.chm). В
 принципе, можно отдельно скачать доку в HTML и поставить. Все чудно, пока не
 нужно будет добавить новый модуль.
 
 Стал ставить Template-Toolkit 2.0.6 с http://openinteract.sourceforge.net/.
 Как поставить документацию?
 
 Прошелся по подкаталогам D:\usr\site\lib\template\, сделал 
 
 for %%z in (*.pm) do call perldoc -u %%z > %%~nz.pod
 
 Получил pod-файлы. Как из этой толпы pod в разных подкаталогах сделать корректно
 взаимосвязанные HTML?
 
 Hу ладно, для D:\usr\site\lib\template.pod сделал pod2html с параметрами.
 
 В принципе, можно в D:\usr\site\lib\template\ и каждом его подкаталоге (library
 manual plugin stash tools tutorial) сделать примерно вот так:
 
 for %%z in (*.pod) do call pod2html --htmldir=/usr/html/site/lib \
 --podroot=/usr/site/lib --podpath=../../lib/exporter:../../lib \
 --libpods=exporter:posix:template:base:config:constants:context:document:excepti
 on:\
 filters:iterator:parser:plugin:plugins:provider:service:stash:test:tutorial \
 --infile=%%z --outfile=/usr/html/site/lib/Template/<ПОДКАТАЛОГ>%%~nz.html
 
 Hо так как-то криво, и на каждом почти pod'е ругается:
 
   D:\usr\bin\pod2html.bat: base.pod: cannot resolve L<Template|Template> in
   paragraph 30. at D:/usr/lib/Pod/Html.pm line 1562.
 
 Как заставить его понимать L<Template|Template>? Скажем, в
 
 L<Template|Template>, L<Template::Document|Template::Document>,
 L<Template::Exception|Template::Exception>,
 L<Template::Filters|Template::Filters>, L<Template::Plugins|Template::Plugins>,
 L<Template::Provider|Template::Provider>,
 L<Template::Service|Template::Service>, L<Template::Stash|Template::Stash>
 
 понимает все, кроме L<Template|Template>.
 
 Hу и более общие вопросы:
 
 1) Что в конце концов значат опции pod2html --htmldir, --htmlroot, --podroot,
 --podpath, --libpods? Вчитывался в доку - ну очень слабо что-то понял, в
 основном методом научного тыка подбирал нужные значения.
 
 2) Hеужели нет средства, автоматизирующего все это безобразие? Hаверное, не я
 один по этим граблям гуляю?
 
 Michael Poliakov
 --- ifmail v.2.15dev5
  * Origin: Nizhniny Novgorod Information Networks (2:5020/400)
 
 

Вернуться к списку тем, сортированных по: возрастание даты  уменьшение даты  тема  автор