pod2epub - A utility to convert Pod to an ePub eBook.
pod2epub [options] podfile --outfile file.epub
Main options (see manpage for all options): -o --outfile Name of output ePub file. -t --title Add ePub book title. -a --author Add ePub book author. -s --stylesheet Change the default stylesheet. -c --cover Add cover image. -h --help Print a brief help message. -m --man Print the full manpage. Example: pod2epub some_module.pm -o some_module.epub
This program is used for converting Pod documents to ePub eBooks. The output eBook can be read on a variety of hardware and software eBook readers.
Pod is Perl's Plain Old Documentation format, see http://perldoc.perl.org/perlpod.html. EPub is an eBook format, see http://en.wikipedia.org/wiki/Epub.
The input file containing Pod documentation.
The output ePub file. This is a required argument.
Specify the CSS stylesheet that the ePub eBook will use. If none is supplied the following minimal stylesheet is used:
h1 { font-size: 110%; } h2, h3, h4 { font-size: 100%; }
Add an image for use as a book cover.
Add the ePub book title. Defaults to "Pod Document". A future release will parse this from the Pod document where possible.
Add the ePub book author. Defaults to "Perl Author". A future release will parse this from the Pod document where possible.
Print a brief help message and exit.
Output the Pod documentation in XHTML format without converting it ePub. This can be useful for debugging XHTML errors.
Add the ePub book language. Defaults to "en".
Prints the manpage and exit.
Prints the version of the pod2epub application.
pod2epub
Generate a "Pod Errors" section at the end of the document if there are Pod errors. This is the default. To turn this feature off use --no-errata or -no-e. Equivalent to the Pod::Simple no_errata_section() method.
--no-errata
-no-e
no_errata_section()
Parse the document title from the Pod doc, where possible.
Parse the author name from the Pod doc, where possible.
Add an XHTML validation option.
Add controls and defaults for internal links.
John McNamara jmcnamara@cpan.org
© MMXII, John McNamara.
All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.
1 POD Error
The following errors were encountered while parsing the POD:
Non-ASCII character seen before =encoding in '©'. Assuming CP1252
To install App::Pod2Epub, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::Pod2Epub
CPAN shell
perl -MCPAN -e shell install App::Pod2Epub
For more information on module installation, please visit the detailed CPAN module installation guide.