NAME
Template::Filters - defines post-processing filters for template blocks
SYNOPSIS
[% FILTER html %]
x < 10 && y != 0
[% END %]
[% FILTER format('<!-- %-40s -->') %]
This will end up formatted, line-by-line,
as HTML comments...
[% END %]
etc...DESCRIPTION
The 'html' filter converts the characters '<', '>' and '&' to '<', '>' and '&', respectively, protecting them from being interpreted as representing HTML tags or entities. The 'html_para' filter converts text into HTML paragraphs <p>....</p>. The 'html_break' filter is similar, but uses <br><br> as a paragraph delimiter.
The 'format' filter takes a format string as a parameter (as per printf()) and formats each line of text accordingly. The 'truncate' filter truncates text at a given length and the 'repeat' filter duplicates text any number of times. The 'remove' filter removes a specified character sequence or Perl regular expression, and the 'replace' filter does the same, allowing a replacement string to be specified.
The 'redirect' and 'into' filters can be used to redirect a text block to another file, or to store it in a named variable, respectively.
See Template for full (and possibly more up-to-date) information on using these filters.
See the module source code for insights on writing additional filter.
AUTHOR
Andy Wardley <cre.canon.co.uk>
REVISION
$Revision: 1.3 $
COPYRIGHT
Copyright (C) 1996-1999 Andy Wardley. All Rights Reserved. Copyright (C) 1998-1999 Canon Research Centre Europe Ltd.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.