NAME
Apache2::PPI::HTML - Apache 2 interface to PPI::HTML
DESCRIPTION
PPI::HTML is a HTML syntax highlighter for Perl source code. Because it
is based on PPI it can correctly parse just about anything you can
possibly throw at it, and then flexibly generate a HTML version based on
any arbitrary colour scheme you wish, or use a standalone CSS file for
it's style information.
This initial version is primarily intended to serve as a highlighting
service to a AJAX-based syntax highlighter.
The handler recieves a chunk of Perl source code from the browser in the
CGI 'code' parameter, and a second 'ajax' param determines if the
highlighter is running in AJAX mode.
In AJAX mode, the fragment of formatted HTML is handed back straight up,
without any surrounding body or headers or the other parts of the HTML
wrapper.
With AJAX mode off, it returns a complete HTML document.
With this initial version, you may have some difficulties getting CSS
actually working.
We recommend you wait for the next release, which will support a range
of pre-packaged colour schemes being created for PPI::HTML.
TO DO
- Add support for PPI::HTML 0.06 colour schemes.
- Add support for acting as a content filter.
If you like the idea of this module, and would like to volunteer to help
maintain or improve it, your assistance you be greatly welcomed.
Inquiries via the PPI dicussion mailing list, located on the SourceForge
website. <
http://sourceforge.net/projects/parseperl>.
SUPPORT
Bugs should be reported via the CPAN bug tracker at
<
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Apache2-PPI-HTML>
For other issues, contact the author.
AUTHOR
Written by Pete Sergeant (in about 3 minutes) :)
Documented and wrapped for release by Adam Kennedy
COPYRIGHT
Copyright 2005 Pete Sergeant, Adam Kennedy. All rights reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included
with this module.
