oracular (3) Text::Markup::Textile.3pm.gz

Name

       Text::Markup::Textile - Textile parser for Text::Markup

Synopsis

         my $html = Text::Markup->new->parse(file => 'README.textile');
         my $raw  = Text::Markup->new->parse(
             file    => 'README.textile',
             options => [ raw => 1 ],
         );

Description

       This is the Textile <https://textile-lang.com> parser for Text::Markup.  It reads in the file (relying on
       a BOM <https://www.unicode.org/unicode/faq/utf_bom.html#BOM>), hands it off to Text::Textile for parsing,
       and then returns the generated HTML as an encoded UTF-8 string with an "http-equiv="Content-Type""
       element identifying the encoding as UTF-8.

       It recognizes files with the following extension as Textile:

       .textile

       To change it the files it recognizes, load this module directly and pass a regular expression matching
       the desired extension(s), like so:

         use Text::Markup::Textile qr{text(?:ile)?};

       Normally this module returns the output wrapped in a minimal HTML document skeleton. If you would like
       the raw output without the skeleton, you can pass the "raw" option to "parse".

       In addition, Text::Markup::Mediawiki supports all of the Text::Textile options, including:

       "disable_html"
       "flavor"
       "css"
       "charset"
       "docroot"
       "trim_spaces"
       "preserve_spaces"
       "filter_param"
       "filters"
       "char_encoding"
       "disable_encode_entities"
       "handle_quotes"

Author

       David E. Wheeler <david@justatheory.com>

Copyright and License

       Copyright (c) 2011-2024 David E. Wheeler. Some Rights Reserved.

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