John McNamara
and 1 contributors


App::Pod2Epub - Convert Pod to an ePub eBook.


This module 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 EPub is an eBook format, see

This module comes with a pod2epub utility that will convert Pod to an ePub eBook.


To create a simple filter to convert Pod to an XHTML format suitable for inclusion in an ePub eBook.

    #!/usr/bin/perl -w

    use strict;
    use App::Pod2Epub;

    my $parser = App::Pod2Epub->new();

    if (defined $ARGV[0]) {
        open IN, $ARGV[0]  or die "Couldn't open $ARGV[0]: $!\n";
    } else {
        *IN = *STDIN;

    if (defined $ARGV[1]) {
        open OUT, ">$ARGV[1]" or die "Couldn't open $ARGV[1]: $!\n";
    } else {
        *OUT = *STDOUT;



To convert Pod to ePub using the installed pod2epub utility:

    pod2epub -o some_module.epub


At the moment this module isn't very useful on its own. It is mainly in existence as a backend for pod2epub.

It provides a framework to convert Pod documents to an XHTML format suitable for inclusion in an ePub eBook. The ePub creation is handled by EBook::EPUB in pod2epub. Future versions will move that functionality into this module so that it has a utility of its own.



The new method is used to create a new App::Pod2Epub object.

Other methods

App::Pod2Epub inherits all of the methods of its parent modules Pod::Simple and Pod::Simple::XHTML. See Pod::Simple for more details if you need finer control over the output of this module.


This module also installs a pod2epub command line utility. See pod2epub --help for details.

EBook::EPUB, a general module for generating EPUB documents.

Pod::Simple::XHTML which this module subclasses.


Thanks to Sean M. Burke and the past and current maintainers for Pod::Simple.

Thanks to Oleksandr Tymoshenko for the excellent EBook::EPUB.


John McNamara,


Copyright 2010-2012 John McNamara.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License. See for more information.