The document discusses generating documentation from POD files using various Perl modules. It shows commands to: 1) Convert a POD file to HTML using pod2html and encounters an unknown directive error. 2) Batch convert all POD files in a lib directory to HTML using Pod::Simple::HTMLBatch. 3) Configure Pod::Simple::HTMLBatch to use the Pod::Simple::XHTML renderer. 4) Generate documentation projects from POD files using pod2projdocs. 5) Create a Pod site from lib POD files using podsite.

1. 2011.12.03 hiratara

2. PO
hiratara

3. POD
hiratara

4. @hiratara id:hiratara
(DDR Dark Souls)
2000 Perl ( 1996 )

5. : POD
encoding (euc-jp)

6. pod2html
Pod::Simple
Pod::ProjectDocs
Pod::Site

7. % pod2html --infile=lib/Hiratara/DDR.pod --
outfile=podhtml/DDR.html /Users/tarara/
perl5/perlbrew/perls/perl-5.12.2/bin/pod2html:
lib/Hiratara/DDR.pod: unknown pod directive
'encoding' in paragraph 1. ignoring.

8. % perl -MPod::Simple::HTMLBatch -e 'Pod::Simple::HTMLBatch::go' lib
podsimple_htmlbatch/
T+0s: = Sat Dec 3 11:52:45 2011
T+0s: Starting batch conversion to "podsimple_htmlbatch/"
T+0s: 1 dirs to scan: lib
Noted 2 Pod files total
T+0s: Found 2 modules.
T+0s: Done scanning.
T+0s: Now converting pod files to HTML.
#0/2: Rendering Hiratara::DarkSoul
Done converting 2 files.
T+0s: Preparing list of modules for ToC
T+0s: Writing contents file podsimple_htmlbatch/index.html
T+0s: Done with batch conversion. 2 files done.
T+0s: = Sat Dec 3 11:52:45 2011
All done!

9. % perl -MPod::Simple::HTMLBatch -MPod::Simple::XHTML
my $batchconv = Pod::Simple::HTMLBatch->new;
$batchconv->html_render_class("Pod::Simple::XHTML");
$batchconv->batch_convert([qw/lib/], podsimple_xhtml);

10. % pod2projdocs -out pod2proj -lib lib/

11. % podsite --name Hiratara --doc-root podsite/ --base-uri / lib/
plackup -MPlack::App::File -e 'Plack::App::File->new(root => ".")'