Scroll to navigation

App::pod2pandoc(3pm) User Contributed Perl Documentation App::pod2pandoc(3pm)

NAME

App::pod2pandoc - implements pod2pandoc command line script

SYNOPSIS

  use App::pod2pandoc;
  # pod2pandoc command line script
  my ($input, $opt, @args) = parse_arguments(@ARGV);
  pod2pandoc($input, $opt, @args);
  # parse a Perl/Pod file and print its JSON serialization
  pod2pandoc( ['example.pl'], {} );
  # parse a Perl/Pod file and convert to HTML with a template
  pod2pandoc( ['example.pl'], {}, '--template', 'template.html' );
  # process directory of Perl modules
  pod2pandoc( [ lib => 'doc'], { ext => 'html' }, '--standalone' );

DESCRIPTION

This module implements the command line script pod2pandoc.

FUNCTIONS

pod2pandoc( \@input, [ \%options, ] \@arguments )

Processed input files with given pod2pandoc options ("data-sections", "podurl", "ext", "wiki", "meta", "update", and "quiet") . Additional arguments are passed to "pandoc" executable via module Pandoc.

Input can be either files and/or module names or directories to recursively search for ".pm" and ".pod" files. If no input is specified, Pod is read from STDIN. When processing directories, the last input directory is used as output directory.

This function is exported by default.

parse_arguments( @argv )

Parses options and input arguments from given command line arguments. May terminate the program with message, for instance with argument "--help".

SEE ALSO

This module is part of Pod::Pandoc and based on the modules Pod::Simple::Pandoc, Pod::Pandoc::Modules, Pandoc::Element and Pandoc.

2022-01-20 perl v5.32.1