NAME

HTML::Template::Extension::DOC - Plugins for comments in template

SYNOPSIS

use HTML::Template::Extension;

my $text = qq
   |
    <HTML><HEAD></HEAD><BODY>
    <H1>This is a template example...</H1>
    <TMPL_DOC>An example use of TMPL_DOC tag </TMPL_DOC>
    The sum between 1+1 is: <TMPL_VAR NAME="result">
    </BODY></HTML>
   |;

my $comp       = new HTML::Template::Extension(
                                           scalarref => \$text,
                                           plugins=>["DOC"],
                                           );

$comp->param('result' => 1+1);

print $comp->output;

#   OUTPUT:
#
#   <HTML><HEAD></HEAD><BODY>
#   <H1>This is a template example...</H1>
#        The sum between 1+1 is: 2
#   </BODY></HTML>

DESCRIPTION

DOC plugin add a <TMPL_DOC>some comments</TMPL_DOC> to standard HTML::Template syntax to permit to add comments to template that, for indeed, a web graphic designer can view in a WYSIWYG environment.

All text between <TMPL_DOC> and </TMPL_DOC> and tag itself will be deleted before HTML::Template parsing and retuning template output.

AUTHOR

Bruni Emiliano, <info@ebruni.it>

SEE ALSO

HTML::Template
HTML::Template::Extension::DO_NOTHING
HTML::Template::Extension::SLASH_VAR
HTML::Template::Extension::CSTART
HTML::Template::Extension::DOC
HTML::Template::Extension::HEAD_BODY