Xpoint
   [напомнить пароль]

Pod::Simple::HTML и Pod::Perldoc

Метки: [без меток]
2013-02-04 18:03:42 [обр] heed(0/3)[досье]

Возможно в "основы" надо было постить.
Потомучто не вообще не очень понимаю работу с модулями
Например если набросать такой скрипт

#!perl
print 'Content-type: text/html'."\n\n";
   $ARGV[0] = '-o';
   $ARGV[1] = 'html';
   $ARGV[2] = $ENV{'QUERY_STRING'};

#непомогает    use Pod::Simple::HTML ('');
#непомогает    use base 'Pod::Simple::HTML';
#всёравно $Perldoc_URL_Prefix полностью чтобы ссылки были свои, не на search.cpan.org
   $Pod::Simple::HTML::Perldoc_URL_Prefix = '?';

    use Pod::Perldoc ();
    Pod::Perldoc->run();

то и не знаю, эти $ARGV[0...] как-то не выглядят вообще
, не понял что такое _PACKAGE_->_accessorize(... имена настроек ) в этом HTML.pm

И вообще насчёт того можно-ли юзать Pod::Perldoc но с более полным использованием Pod::Simple::HTML
или всё-таки правильнее вместо Pod::Perldoc делать свой модуль?

// Просто на локальном apache(win32) хочетелось-бы сделать, что-то вроде поиска по ключевым словам по perldoc

спустя 12 минут [обр] heed(0/3)[досье]
Вопрос скорее такой: Как правильнее юзать Pod::Perldoc с более полным использованием Pod::Simple::HTML
и подходит-ли вообще Pod::Perldoc для таких целей.
спустя 8 часов [обр] Евгений Седов aka KPbIC(9/187)[досье]
Natural Docs вас не устроит?
спустя 13 часов [обр] heed(0/3)[досье]

На первый взгляд c модулями perl вроде тоже работает

h:\home\site\www\ND>set path=h:\usr\local\perl\bin;%path%

h:\home\site\www\ND>NaturalDocs.bat -i h:\usr\64_local\perl\lib -o HTML h:\home\lib\test -p h:\home\lib\data
Finding files and detecting changes...
Parsing 1718 files...
Parsing 1718 files... (6%)
Parsing 1718 files... (12%)
Parsing 1718 files... (19%)
....................
Parsing 1718 files... (97%)
Building 671 files...
Building 671 files... (1%)
Building 671 files... (3%)
.............
Building 671 files... (97%)
Building 5 indexes...
Building 5 indexes... (20%)
Building 5 indexes... (40%)
Updating menu...
Updating CSS file...
Done.

Создало html из каждого .pm-файла
, но например рядом с version.pm лежит version.pod , который вобщем-то и нужен, но обработало pm
, в html-файлы не попадали данные из блоков типа =head, =item ...
, в описании "Command Line" не нашёл как разрешить такой вариант.
и мне в конечном итоге надо получить то что по ключевому слову в строке запроса сразу apache откроет найденое описание.
Типа

Вроде разобрался с тем как работает Pod::Perldoc, пришёл к выводу что легче из его кода сделать свой модуль
, чем заставить его сделать то что мне надо :)
Остановися на варианте использовать для "keywords" SQLite, и получается что для меня пока проще взять уже готовое perldoc-html.tar.gz
, и слегка покромсать его, повыпарсивать оттуда ключевые слова, и повесить на это всё обработчик запросов.
Пока буду искать способ перегнать документацию в html, максимально облегчённое, но с нормальной навигацией

спустя 6 часов [обр] heed(0/3)[досье]

Вообщето наоборот, надо пробовать к Pod::Perldoc прикрутить свой обработчик

загадочный модуль :) , для меня так и осталось загадкой
 каким образом вытаскивает из QUERY_STRING строку для поиска например такой код

#!perl
BEGIN{
print 'Content-type: text/html'.$/.$/;
# $ENV{'PERLDOCDEBUG'} = '100';
}
use Pod::Perldoc;
$Pod::Simple::HTML::Perldoc_URL_Prefix = '?';
   my $p = Pod::Perldoc->new;
   $p->opt_o_with('html');
   $p->opt_M_with('Pod::Simple::HTML');
   $p->process();

у как ему подсунуть -v $_ или -f read

Powered by POEM™ Engine Copyright © 2002-2005