Michele Beltrame > Template-Plugin-Textile2-1.21 > Template::Plugin::Textile2

Download:
Template-Plugin-Textile2-1.21.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
Report a bug
Module Version: 1.21   Source  

NAME ^

Template::Plugin::Textile2 - Use Textile formatting with Template Toolkit

SYNOPSIS ^

  [% USE Textile2 -%]
  [% FILTER textile2 %]This *bold* and this is _italic_.[% END %]

  <p>this is <strong>bold</strong> and this is <em>italic</em>.


  [% USE Textile2 ( disable_html => 1 ) -%]
  [% FILTER textile2 %]this is<br /> _italic_.[% END %]

  <p>this is&lt;br /&gt; <em>italic</em>.</p>

DESCRIPTION ^

This module wraps Text::Textile into a plugin Template Toolkit. It provides a filter named textile2. This aims to be a more feature-full version Template::Plugin::Textile, by allowing you to pass parameters to Text::Textile.

Use this way:

    [% FILTER textile2 %]
    Reasons to use the Template Toolkit:

    * Seperation of concerns.
    * It's written in Perl.
    * Badgers are Still Cool.
    [% END %]

or:

    [% mytext | textile2 %]

You can pass the same options you would pass to Text::Textile, directly when using the template. For instance to disable processing of HTML tags you can do:

    [% USE Textile2 ( disable_html => 1 ) %]

To avoid your text to be wrapped into &lt;p&gt...&lt;/p&gt you can use:

    [% USE Textile2 ( format_mode => 'inline' ) %]

See Text::Textile for details.

AUTHOR ^

Michele Beltrame mb@italpro.net.

LICENSE ^

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO ^

Text::Textile, Template