Apache::AxKit::Provider::File::Formatter version 0.96
=====================================================

This is an AxKit Provider that may be used to apply any module that
conforms with the Formatter API to a file. At the time of this
writing, there are three modules in the Formatter:: namespace, one for
formatting the Text::Textile syntax, one to use HTML::Tidy to clean up
existing HTML and one to add minimal HTML markup to a preformatted
plain text.

The Formatter API is a very simple API, designed to do simple
conversion between different syntaxes. The API Specification itself
can be found in the Formatter distribution on CPAN and has currently
version 0.93, but is expected to be rather stable. The author will
make a 1.0 release of the Provider once the Formatter API hits 1.0. It
is mostly used to make HTML from some simple text-based syntax, but it
can be used to convert anything.

This Provider will let you use any syntax that there is a Formatter
module for with minimum effort.

If you want to output HTML, and not XML for further processing, you
may configure AxKit to use the supplied transforms/xhtml2html.xsl
XSLT, see inline POD for an example. You may need to apply a
stylesheet even if you just want XML too, in that case, you may find
transforms/do-nothing.xsl handy.

INSTALLATION

To install this module use the CPAN or CPANPLUS tools, or type the
following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module only depends on AxKit, but you would need to have at least
one of the modules in the Formatter:: namespace to use this Provider
meaningfully. See CPAN for available Formatters. 

COPYRIGHT AND LICENCE

Copyright (C) 2005 by Kjetil Kjernsmo

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.4 or,
at your option, any later version of Perl 5 you may have available.