Satoshi Tanimoto > Template-Plugin-KwikiFormat > Template::Plugin::KwikiFormat

Download:
Template-Plugin-KwikiFormat-1.04.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 1.04   Source  

NAME ^

Template::Plugin::KwikiFormat - filter to convert kwiki formatted text to html

SYNOPSIS ^

  [% USE KwikiFormat %]
  
  [% FILTER kwiki %]
  
  == title
  
  *bold* /italic/
  
  [% END %]

DESCRIPTION ^

A wrapper around Kwiki::Formatter.

Template::Plugin::KwikiFormat allows you to use KwikiFormats in data displayed by Template::Toolkit.

MARKUP SYNTAX

See here:

http://www.kwiki.org/?KwikiFormattingRules

BUT:

WikiLinks don't work without a kwiki, so we need some magic / dirty tricks to make it work (i.e.: subroutine redefinition at runtime)

ANOTHER BUT:

I slightly altered the meaning of ForcedLinks. In Kwiki, something like this

  [SomePage see here]

results in a link to the Kwiki-Page "SomePage" labeld with "see here".

With Template::Plugin::KwikiFormat, you can (ab)use this syntax for local (relative) links. i.e.:

  [/some/page.html see here]

gets rendered as a link to "/some/page.html" labled with "see here".

One of the fragments inside the square bracktes needs to start with a slash for this to work.

METHODS

new

generate new plugin

kwiki

convert text

AUTHOR ^

Thomas Klausner, domm@zsi.at, http://domm.zsi.at

With a lot of thanks to Jon Åslund (Jooon) from #kwiki for coming up with how to do it.

Additional thanks to Ian Langworth.

From March 2006, this module is taken over and maintained by Satoshi Tanimoto <tanimoto@cpan.org>

COPYRIGHT ^

Copyright 2004, Thomas Klausner, ZSI

You may use, modify, and distribute this package under the same terms as Perl itself.

syntax highlighting: