NAME¶

Pod::Simple::HTMLBatch - convert several Pod files to several HTML files

SYNOPSIS¶

  perl -MPod::Simple::HTMLBatch -e 'Pod::Simple::HTMLBatch::go' in out

DESCRIPTION¶

This module is used for running batch-conversions of a lot of HTML documents

This class is NOT a subclass of Pod::Simple::HTML (nor of bad old Pod::Html) -- although it uses Pod::Simple::HTML for doing the conversion of each document.

The normal use of this class is like so:

  use Pod::Simple::HTMLBatch;
  my $batchconv = Pod::Simple::HTMLBatch->new;
  $batchconv->some_option( some_value );
  $batchconv->some_other_option( some_other_value );
  $batchconv->batch_convert( \@search_dirs, $output_dir );

  % mkdir out_html
  % perl -MPod::Simple::HTMLBatch -e Pod::Simple::HTMLBatch::go @INC out_html
      (to convert the pod from Perl's @INC
       files under the directory ./out_html)

  % mkdir ../seekrut
  % chmod og-rx ../seekrut
  % perl -MPod::Simple::HTMLBatch -e Pod::Simple::HTMLBatch::go . ../seekrut
      (to convert the pod under the current dir into HTML
       files under the directory ./seekrut)

  % perl -MPod::Simple::HTMLBatch -e Pod::Simple::HTMLBatch::go happydocs .
      (to convert all pod from happydocs into the current directory)

MAIN METHODS¶

$batchconv = Pod::Simple::HTMLBatch->new;

This creates a new batch converter. The method doesn't take parameters. To change the converter's attributes, use the "ACCESSOR METHODS"" in " below.

$batchconv->batch_convert( indirs, outdir );

This searches the directories given in indirs and writes HTML files for each of these to a corresponding directory in outdir. The directory outdir must exist.

$batchconv->batch_convert( undef , ...);

$batchconv->batch_convert( q{@INC}, ...);

These two values for indirs specify that the normal Perl @INC

$batchconv->batch_convert( \@dirs , ...);

This specifies that the input directories are the items in the arrayref "\@dirs".

$batchconv->batch_convert( "somedir" , ...);

This specifies that the director "somedir" is the input. (This can be an absolute or relative path, it doesn't matter.)

A common value you might want would be just "." for the current directory:

     $batchconv->batch_convert( "." , ...);
    

$batchconv->batch_convert( 'somedir:someother:also' , ...);

This specifies that you want the dirs "somedir", "someother", and "also" scanned, just as if you'd passed the arrayref "[qw( somedir someother also)]". Note that a ":"-separator is normal under Unix, but Under MSWin, you'll need 'somedir;someother;also' instead, since the pathsep on MSWin is ";" instead of ":". (And that is because ":" often comes up in paths, like "c:/perl/lib".)

(Exactly what separator character should be used, is gotten from $Config::Config{'path_sep'}, via the Config module.)

$batchconv->batch_convert( ... , undef );

This specifies that you want the HTML output to go into the current directory.

(Note that a missing or undefined value means a different thing in the first slot than in the second. That's so that batch_convert() with no arguments (or undef arguments) means "go from @INC, into the current directory.)

$batchconv->batch_convert( ... , 'somedir' );

This specifies that you want the HTML output to go into the directory 'somedir'. (This can be an absolute or relative path, it doesn't matter.)

Note that you can also call "batch_convert" as a class method, like so:

  Pod::Simple::HTMLBatch->batch_convert( ... );

That is just short for this:

  Pod::Simple::HTMLBatch-> new-> batch_convert(...);

That is, it runs a conversion with default options, for whatever inputdirs and output dir you specify.

NOTES ON CUSTOMIZATION¶

TODO

  call add_css($someurl) to add stylesheet as alternate
  call add_css($someurl,1) to add as primary stylesheet
  call add_javascript
  subclass Pod::Simple::HTML and set $batchconv->html_render_class to
    that classname
  and maybe override
    $page->batch_mode_page_object_init($self, $module, $infile, $outfile, $depth)
  or maybe override
    $batchconv->batch_mode_page_object_init($page, $module, $infile, $outfile, $depth)
  subclass Pod::Simple::Search and set $batchconv->search_class to
    that classname

SEE ALSO¶

Pod::Simple, Pod::Simple::HTMLBatch, perlpod, perlpodspec

SUPPORT¶

Questions or discussion about POD and Pod::Simple should be sent to the pod-people@perl.org mail list. Send an empty email to pod-people-subscribe@perl.org to subscribe.

This module is managed in an open GitHub repository, <https://github.com/perl-pod/pod-simple/>. Feel free to fork and contribute, or to clone <git://github.com/perl-pod/pod-simple.git> and send patches!

Patches against Pod::Simple are welcome. Please send bug reports to <bug-pod-simple@rt.cpan.org>.

COPYRIGHT AND DISCLAIMERS¶

Copyright (c) 2002 Sean M. Burke.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

AUTHOR¶

Pod::Simple was created by Sean M. Burke <sburke@cpan.org>. But don't bother him, he's retired.

Pod::Simple is maintained by:

• Allison Randal "allison@perl.org"
• Hans Dieter Pearcey "hdp@cpan.org"
• David E. Wheeler "dwheeler@cpan.org"