Linux Certif

Toute la documentation sur la certification Linux LPI

CGI::Ex::Template.3pm

NAME

CGI::Ex::Template - Template::Alloy based TT2/TT3/HT/HTE/Tmpl/Velocity engine.

SYNOPSIS

Template::Toolkit style usage

     my $t = Template::Alloy->new(
         INCLUDE_PATH => ['/path/to/templates'],
     );
 
     my $swap = {
         key1 => 'val1',
         key2 => 'val2',
         code => sub { 42 },
         hash => {a => 'b'},
     };
 
     # print to STDOUT
     $t->process('my/template.tt', $swap)
         || die $t->error;
 
     # process into a variable
     my $out = '';
     $t->process('my/template.tt', $swap, \$out);
 
     ### Alloy uses the same syntax and configuration as Template::Toolkit
 
 

HTML::Template::Expr style usage

     my $t = Template::Alloy->new(
         filename => 'my/template.ht',
         path     => ['/path/to/templates'],
     );
 
     my $swap = {
         key1 => 'val1',
         key2 => 'val2',
         code => sub { 42 },
         hash => {a => 'b'},
     };
 
     $t->param($swap);
 
     # print to STDOUT (errors die)
     $t->output(print_to => \*STDOUT);
 
     # process into a variable
     my $out = $t->output;
 
     ### Alloy can also use the same syntax and configuration as HTML::Template
 
 

Text::Tmpl style usage

     my $t = Template::Alloy->new;
 
     my $swap = {
         key1 => 'val1',
         key2 => 'val2',
         code => sub { 42 },
         hash => {a => 'b'},
     };
 
     $t->set_delimiters('#[', ']#');
     $t->set_strip(0);
     $t->set_values($swap);
     $t->set_dir('/path/to/templates');
 
     my $out = $t->parse_file('my/template.tmpl');
 
     my $str = "Foo #[echo $key1]# Bar";
     my $out = $t->parse_string($str);
 
 
     ### Alloy uses the same syntax and configuration as Text::Tmpl
 
 

Velocity (VTL) style usage

     my $t = Template::Alloy->new;
 
     my $swap = {
         key1 => 'val1',
         key2 => 'val2',
         code => sub { 42 },
         hash => {a => 'b'},
     };
 
     my $out = $t->merge('my/template.vtl', $swap);
 
     my $str = "#set($foo 1 + 3) ($foo) ($bar) ($!baz)";
     my $out = $t->merge(\$str, $swap);
 
 

DESCRIPTION

CGI::Ex::Template is the original base for the code that is now Template::Alloy. Template::Alloy employed enough complexity and featureset to warrant moving it out to a separate namespace.

CGI::Ex::Template is now a place holder subclass of Template::Alloy. You can use CGI::Ex::Template as a standalone module - but it is suggested that you use Template::Alloy directly instead.

For examples of usage, configuration, syntax, bugs, vmethods, directives, etc please refer to the Template::Alloy documentation.

LICENSE

This module may be distributed under the same terms as Perl itself.

AUTHOR

Paul Seamons <perl at seamons dot com>