Man page - pod2pandoc(1)

Packages contains this manual

Package: pod2pandoc
apt-get install pod2pandoc

Manuals in package:

pod2pandoc(1)

Documentations in package:

pod2pandoc

Manual

POD2PANDOC

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO

NAME

pod2pandoc - convert Pod to Pandoc document model

SYNOPSIS

pod2pandoc [OPTIONS] {INPUT} [ [ -- ] PANDOC_ARGUMENTS ]
pod2pandoc Module.pm -o Module.pdf
pod2pandoc script.pl -t markdown
pod2pandoc Module::Name -o Module-Name.html
pod2pandoc lib/ wiki/ --ext .md --wiki --index Home -t markdown_github
pod2pandoc lib/ docs/ --standalone

DESCRIPTION

pod2pandoc converts "Plain Old Documentation" format (aka Pod, see perlpod) to the Pandoc <http://pandoc.org/> document model for further processing to other document formats ( HTML, Markdown, LaTeX, PDF, EPUB, docx, ODT, man...).

By default or with input "-" a document is read from STDIN. Multiple input files are combined to one document and listed in document metadata field "file". The result is printed in JSON format or passed to Pandoc if additional options such as "-t" or "-o" are given.

To process a whole directory of ".pm" and/or ".pod" files, specify an input directory as first input and an optional output directory as second.

OPTIONS

--help|-h|-?

Print out usage information and exit.

--parse FORMATS

Parse and include data sections. Use "*" for all.

--podurl URL

Base URL to Perl modules. Default: "https://metacpan.org/pod/". A false value such as 0 or "" will disable linking to external modules.

--ext EXT

Output file extension when processing a directory. Default: "html".

--index NAME

Index file (e.g. "index.html") name when processing a directory. Can be disabled with 0.

--name

Include "NAME" section which is removed by default.

--wiki

Create wikilinks when processing a directory.

--update

Only process when input file is newer then output file.

--default-meta FILE

Read default metadata from given file.

--quiet

Don’t emit warnings and status information.

...

Additional options are passed through to pandoc executable.