NAME
Text::KwikiFormat - Translate Kwiki formatted text into HTML
VERSION
Version 0.01
SYNOPSIS
use Text::KwikiFormat;
my $html = Text::KwikiFormat::format('some kwiki text');
DESCRIPTION
This module allows you to convert Kwiki text using the Kwiki::Formatter module. In the current version, it only passes the input to the formatter and spits out the converted HTML content as it. Customization is not supported.
For people interested in using CGI::Kwiki to convert the Kwiki text, see the module Text::KwikiFormatish.
EXPORT
You can also import a customized subroutine with default options set up, pretty much the same way as in Text::WikiFormat. Currently, only two keys are supported:
prefix
, the KwikiLink prefixas
, an alias for the imported function (defaults 'wikiformat
')
Examples:
# import 'kwikiformat'
use Text::KwikiFormat 'kwikiformat';
# ... the same thing
use Text::KwikiFormat as => 'kwikiFormat';
# import 'wikiformat' with a custom prefix
use Text::KwikiFormat prefix => 'http://www.example.com/';
my $text = wikiformat 'some kwiki text';
SUBROUTINES/METHODS
This module supports only one interface subroutine format()
.
format($text, $newtags, $opts)
The first argument $text
is the text to convert.
The second argument is not used. I keep it here to comply with the Text::WikiFormat calling convention.
The options are specified as a hash reference via the third argument $opts
. Currently, only one option is supported:
prefix
This is the path to the Wiki. The actual linked item itself will be appended to the prefix. This is useful to create full URIs:
{ prefix => 'http://example.com/kwiki.pl?page=' }
LIMITATIONS
The current version does one and only one thing: send the input to Kwiki and fetch the output AS IS. To customize the output format, one needs to subclass all the necessary Kwiki::Formatter::* modules and rework the HTML output, which is a lot of work. (I will reconsider implementing that based on the number of RT tickets asking for this feature.)
AUTHOR
Ruey-Cheng Chen, <rueycheng at gmail.com>
BUGS
Please report any bugs or feature requests to bug-text-kwikiformat at rt.cpan.org
, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Text-KwikiFormat. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
LICENSE AND COPYRIGHT
Copyright 2012 Ruey-Cheng Chen.
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 http://dev.perl.org/licenses/ for more information.