GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TEMPLATE::ALLOY::HTE (3)

.ds Aq ’

NAME

Template::Alloy::HTE - HTML::Template and HTML::Template::Expr roles.

CONTENTS

DESCRIPTION

The Template::Alloy::HTE role provides syntax and interface support for the HTML::Template and HTML::Template::Expr modules.

Provides for extra or extended features that may not be as commonly used. This module should not normally be used by itself.

See the Template::Alloy documentation for configuration and other parameters.

HOW IS Template::Alloy DIFFERENT FROM HTML::Template

Alloy can use the same base template syntax and configuration items as HTE and HT. The internals of Alloy were written to support TT3, but were general enough to be extended to support HTML::Template as well. The result is HTML::Template::Expr compatible syntax, with Alloy speed and a wide range of additional features.

The TMPL_VAR, TMPL_IF, TMPL_ELSE, TMPL_UNLESS, TMPL_LOOP, and TMPL_INCLUDE all work identically to HTML::Template.
o Added support for other TT3 directives and for TT style dot notation.



    <TMPL_SET a = "bar">
    <TMPL_SET b = [1 .. 25]>
    <TMPL_SET foo = PROCESS filename.tt>

    <TMPL_GET foo>  # similar to <TMPL_VAR NAME="foo">
    <TMPL_GET b.3>
    <TMPL_GET my.nested.chained.variable.1>
    <TMPL_GET my_var | html>

    <TMPL_USE foo = DBI(db => ...)>
    <TMPL_CALL foo.connect>



Any of the TT directives can be used in HTML::Template documents.

For many die-hard HTML::Template fans, it is probably quite scary to be providing all of the TT functionality. All of the extended TT functionality can be disabled by setting the NO_TT configuration item. The NO_TT configuration is automatically set if the SYNTAX is set to ht and the output method is called.

o There is an ELSIF!!!



    <TMPL_IF foo>
      FOO
    <TMPL_ELSIF bar>
      BAR
    <TMPL_ELSE>
      Done then
    </TMPL_IF>



o Added CHOMP capabilities (PRE_CHOMP and POST_CHOMP)



    Foo
    <~TMPL_VAR EXPR="1+2"~>
    Bar

    Prints Foo3Bar



o Added INTERPOLATE capability



    <TMPL_SET foo = FOO>
    <TMPL_CONFIG INTERPOLATE => 1>
    $foo <TMPL_GET foo> ${ 1 + 2 }

    Prints

    FOO FOO 3



o Allow for HTML::Template templates to include TT style templates.



    <TMPL_CONFIG SYNTAX => tt3>
    <TMPL_INCLUDE "filename.tt">



o Allow for Expr parsing to follow proper precedence rules.



   <TMPL_VAR EXPR="1 + 2 * 3">

   Properly prints 7.



o Uses all of the caching and opcode tree optimizations provided by Template::Alloy and Template::Alloy::XS.
o Alloy does not provide the query method from HTML::Template. This is because parsing of the document is delayed until the output method is called, and because Alloy supports TT style chained variables which often are not resolvable until run time.

UNSUPPORTED HT CONFIGURATION

die_on_bad_params Alloy does not resolve variables until the template is output.
force_untaint
strict Alloy is strict on parsing HT documents.
shared_cache, double_cache Alloy doesn’t have shared caching. Yet.
search_path_on_include Alloy will check the full path array on each include.
debug items The HTML::Template style options are included here, but you can use the TT style DEBUG and DUMP directives to do introspection.
max_includes Alloy uses TT’s recursion protection.
filter Alloy doesn’t offer these.

ROLE METHODS

register_function Defines a new function for later use as text vmethod or top level function.
clear_param Empties the parameter list.
query Not supported.
new_file Creates a new object that will process the passed file.



    $obj = Template::Alloy->new_file("my/file.hte");



new_scalar_ref Creates a new object that will process the passed scalar ref.



    $obj = Template::Alloy->new_scalar_ref(\"some template text");



new_array_ref New object that will process the passed array (each item represents a line).



    $obj = Template::Alloy->new_array_ref(\@array);



new_filehandle


    $obj = Template::Alloy->new_filehandle(\*FH);



parse_tree_hte Called by parse_tree when syntax is set to ht or hte. Parses for tags HTML::Template style.
param See Template::Alloy.
output See Template::Alloy.

AUTHOR

Paul Seamons <paul@seamons.com>

LICENSE

This module may be distributed under the same terms as Perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 TEMPLATE::ALLOY::HTE (3) 2013-08-23

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.