Templa...xtile2(3pm)

✨ Template::Plugin::Textile2 ✨

okay bestie, welcome to Template::Plugin::Textile2 — that's a module from the User Contributed Perl Documentation crew, and she's here to serve. 💅

---

🌸 NAME 🌸

Template::Plugin::Textile2 — the way to use Textile formatting with Template Toolkit. no cap. 🧚

---

🎀 SYNOPSIS 🎀

watch this slay:

  [% 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>

see how the input just became HTML? that's her. that's the whole vibe. ✨

---

💖 DESCRIPTION 💖

so basically this module wraps Text::Textile into a plugin for Template Toolkit. 🫶

it hands you a filter named textile2, and she is highkey aiming to be a more feature-full version of Template::Plugin::Textile, because she lets you pass parameters straight through to Text::Textile. main character energy, honestly. 👑

use her like this:

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

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

or like this, if you're feeling compact:

    [% mytext | textile2 %]

and here's the good part — you can pass the same options you would pass to Text::Textile, directly when using the template. for instance, if you wanna disable processing of HTML tags, you just do:

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

and if you want to avoid your text getting wrapped up in <p&gt...</p&gt, you can use:

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

that's the trick, iykyk. 🤫

fr fr, go see Text::Textile for all the details — she's the one holding the lore. 📚

---

💜 AUTHOR 💜

Michele Beltrame mb@italpro.net. iconic. ✨

---

🌈 LICENSE 🌈

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

---

🦋 SEE ALSO 🦋

• Text::Textile
• Template

---

and that's a wrap, bestie 💖 this page came to you from perl v5.34.0, dated 2022-06-17, and she ate. no crumbs. 🎀✨