HTML::WikiConverter::WUserpContributed Perl DocuHTML::WikiConverter::WebApp(3)NAMEHTML::WikiConverter::WebApp - Web interface to HTML::WikiConverter
SYNOPSIS
Inside the index.cgi instance script (which is included with this
distribution):
#!/usr/bin/perl
use HTML::WikiConverter::WebApp;
my %config = (
template_path => '/path/to/web/templates',
);
HTML::WikiConverter::WebApp->new( PARAMS => \%config )->run;
DESCRIPTION
This module provides a CGI::Application interface to
HTML::WikiConverter and all installed dialect modules.
Refer to the INSTALL file for installation instructions.
QUERY PARAMETERS
This application accepts a number of query parameters to control its
behavior. The most basic is the run mode parameter, "m". This
application can be in one of two run modes: "new" or "convert". (These
correspond to the "new_page()" and "output_page()" methods,
respectively.) "new" causes a new page to be displayed, while "convert"
displays the results of html-to-wiki conversion.
Additional query parameters can be passed independent of run mode:
· source_type
One of "raw_html", "from_uri", or "sample_html".
· dialect
Any installed dialect, eg "MediaWiki".
· base_uri
Base URL to be used for converting relative links to absolute ones.
· wiki_uri
Template for wiki URLs. When scanning the HTML source, if a URL (as
in an "a href" or "img src" attribute value) is found matching this
template, it will be treated to a link to a wiki article/image.
Consult "ATTRIBUTES" in HTML::WikiConverter for more information.
Note that this is a bit less flexible than using the "wiki_uri"
attribute directly in HTML::WikiConverter. That attribute allows
multiple templates, allows coderefs, and regexps, etc. This option
only accepts a single scalar representing a very simple wiki URL
template.
· show_parsed_html
If enabled, an additional textarea containing the parsed HTML will
be displayed.
· escape_entities
If enabled, unsafe HTML entities ("<", ">", and "&") will be
encoded using HTML::Entities.
· format
One of "html" or "xml". Determines the type of output displayed by
this application.
METHODS
setup
Sets up the app for CGI::Application.
new_page
Corresponds to the "new" run mode. Returns a blank form. If arguments
are available on the CGI query string, these are used as default values
for the form fields.
output_page
Corresponds to the "convert" run mode. Same as "new_page()" but returns
the wiki markup for the provided html as well.
load_template
Loads the specified HTML::Template template.
display_error
Error-catching method called by CGI::Application if a run mode fails
for any reason. Displays a basic form with a styled error message up
top.
AUTHOR
David J. Iberri, "<diberri at cpan.org>"
BUGS
Please report any bugs or feature requests to "bug-html-wikiconverter
at rt.cpan.org", or through the web interface at
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=HTML-WikiConverter
<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=HTML-WikiConverter>. I
will be notified, and then you'll automatically be notified of progress
on your bug as I make changes.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc HTML::WikiConverter::WebApp
You can also look for information at:
· AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/HTML-WikiConverter-WebApp
<http://annocpan.org/dist/HTML-WikiConverter-WebApp>
· CPAN Ratings
http://cpanratings.perl.org/d/HTML-WikiConverter-WebApp
<http://cpanratings.perl.org/d/HTML-WikiConverter-WebApp>
· RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=HTML-WikiConverter-WebApp
<http://rt.cpan.org/NoAuth/Bugs.html?Dist=HTML-WikiConverter-
WebApp>
· Search CPAN
http://search.cpan.org/dist/HTML-WikiConverter-WebApp
<http://search.cpan.org/dist/HTML-WikiConverter-WebApp>
COPYRIGHT & LICENSE
Copyright (c) David J. Iberri, all rights reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
perl v5.14.1 2009-03-07 HTML::WikiConverter::WebApp(3)