view release on metacpan or  search on metacpan

bin/docmake  view on Meta::CPAN

#!/usr/bin/perl
# PODNAME: docmake

use strict;
use warnings;

use App::Docmake ();

exit( App::Docmake->new( { argv => [@ARGV] } )->run() );

__END__

=pod

=encoding UTF-8

=head1 NAME

docmake - a tool to render DocBook/XML into various output formats.

=head1 VERSION

version 0.1101

=head1 SYNOPSIS

    # To render input.xml file into XHTML
    docmake --ns -o output.xhtml xhtml input.xml

    # Same with more verbose output
    docmake -v ---ns o output.xhtml xhtml input.xml

    # Avoid trailing slash when emitting to a dummy file in a dir
    docmake ---ns -trailing-slash=0 -o output/index.xhtml xhtml5 input.xml

    # Render into pdf
    docmake -v --ns -o output.pdf pdf input.xml

    # Same while not rebuilding if not necessary
    docmake -v --ns --make -o output.pdf pdf input.xml

    # Render using a Stylesheet
    docmake -v --ns -o output.xhtml -x my-stylesheets.xsl xhtml input.xml

=head1 DESCRIPTION

B<docmake> is a tool to render DocBook/XML into its resultant formats
using XSLT: XHTML, XSL-FO, PDF, RTF, etc. For a brief help type
C<docmake help> .

It aims to be a replacement for xmlto -
L<http://cyberelk.net/tim/software/xmlto/> . As opposed to xmlto,
it is written in Perl, which is easier to get right than xmlto's Bash, and
xmlto hasn't been updated for a long time when I started work on docmake.

=head1 USAGE

The basic invocation of docmake is:

    docmake [flags] MODE input.xml

=head2 MODES

The available modes are:

=over 4

=item * help

To get help.

=item * fo

Convert to XSL-FO.

=item * manpages

Convert to Unix man pages.

=item * rtf

Convert to Word/RTF.

=item * xhtml

Convert to XHTML.

=item * xhtml-1_1

Convert to XHTML-1.1.

=item * xhtml5

Convert to XHTML5.

=item * pdf

Convert to PDF.

=back

=head2 FLAGS

The available flags are:

=over 4

=item * -h ; --help

Display some rudimentary help.

=item * --man

Display the man page.