HTML::String::TT::Directive - Template::Directive overrides to forcibly escape HTML strings
This is not user serviceable, and is documented only for your edification.
Please use HTML::String::TT as this module could change, be renamed, or if I figure out a better way of implementing the functionality disappear entirely at any moment.
We override this top-level method in order to pretend two things to the perl subroutine definition that TT has generated - firstly,
package HTML::String::TT::_TMPL;
to ensure that no packages marked to be ignored are the current one when the template code is executed. Secondly,
use HTML::String::Overload { ignore => { ... } };
where the ... contains a list of TT internal packages to ignore so that things actually work. This list is not duplicated here since it may also change without warning.
...
Additionally, the hashref option to HTML::String::Overload is not documented there since I'm not yet convinced that's a public API either.
Due to a perl bug (https://rt.perl.org/rt3/Ticket/Display.html?id=49594) we overload this method to change
"<foo>\n<bar>"
into
"<foo>"."\n"."<bar>"
since any string containing a backslash escape doesn't get marked as HTML. Since we don't want to escape things that backslash escapes are normally used for, this isn't really a problem for us.
For no reason I can comprehend at all, Template::Directive's textblock method calls &text instead of using a method call so we have to override this as well.
textblock
&text
See HTML::String for authors.
See HTML::String for the copyright and license.
To install HTML::String, copy and paste the appropriate command in to your terminal.
cpanm
cpanm HTML::String
CPAN shell
perl -MCPAN -e shell install HTML::String
For more information on module installation, please visit the detailed CPAN module installation guide.