NAME

Dotiac::DTL::Addon::html_template::Convert - Convert HTML::Template to Dotiac::DTL

SYNOPSIS

        #!/usr/bin/perl -w
        use Dotiac::DTL::Addon::html_template::Convert;

        # open the html template
        my $template = HTML::Template->new(filename => 'test.tmpl');

        # fill in some parameters
        $template->param(HOME => $ENV{HOME});
        $template->param(PATH => $ENV{PATH});

        # send the obligatory Content-Type and print the template output
        print "Content-Type: text/html\n\n", $template->output;

DESCRIPTION

Converts HTML::Template templates to Dotiac::DTL templates.

Just replace

        use HTML::Template;

with use Dotiac::DTL::Addon::html_template::Convert;

or

        use Dotiac::DTL::Addon::html_template::Convert qw/combine/;     

in the script that calls that template.

Dotiac::DTL::Addon::html_template::Convert will then convert the template into Dotiac::DTL/Django template code and render it.

If the input is a filename, it will also save the converted versions under "FILENAME"+[+/-]+4 chars+".html" and won't reconvert as long as that file is there and not outdated.

When using mostly scalarrefs as data, "use Dotiac::DTL::Addon::html_template::Replace" is a better choice and faster.

The 4 chars save the options of the HTML::Template, cause different options of HTML::Template result in different compiled template.

The 4 Bytes in the new name:

First: g or n

"g" stands for global_vars on, "n" for off.

Second: i or s

"i" stands for case_insensitive, "c" for case_sensitive

Third: l or c

"l" stands for "loop_context_var" on, "c" for clear loop ("loop_context_var" off)

Last: j, h, u, o

Save the default escape status:

"j" for "JS", "h" for "HTML", "u" for "URL", o for "off"

For example: On all options to default, the flag will be "nico", all options on it will be "gslh"

combine

When set "combine" in the use statement, this module will allow combined Django and HTML::Template code:

Valid template:

        {% if test or failed %}<TMPL_VAR test>{% endif %}

This is done by first converting HTML::Template code into Django template code and then parsing the whole thing again.

        {% if test or failed %}{{ test }}{% endif %}

The flags will be added with a leading "+" instead of a "-".

What won't work

Some options are accepted (global_vars,filter,loop_context_vars,associate,case_sensitive) the others are ignored (caching).

Sadly, the params() call without arguments and query() won't work at all prior to Dotiac::DTL 0.8, since Dotiac::DTL doesn't really care for variables until it renders.

Compiling

There is one additional option to new():

compile

Instructs Dotiac::DTL to compile the template, only works with filenames

        my $t=HTML::Template->new(filename=>"foo.html",compile=>1);

This will first translate to "foo.html[FLAGS].html" and then on the next run compile to "foo.html[FLAGS]..html.pm"

BUGS

Please report any bugs or feature requests to https://sourceforge.net/tracker2/?group_id=249411&atid=1126445

SEE ALSO

Dotiac::DTL, Dotiac::DTL::Addon, http://www.dotiac.com, http://www.djangoproject.com

AUTHOR

Marc-Sebastian Lucksch

perl@marc-s.de

cpanm Dotiac::DTL::Addon::html_template

perl -MCPAN -e shell
install Dotiac::DTL::Addon::html_template