};
=head1 TEMPLATE SYNTAX
The template directives are surrounded by '' delimiters.
An optional dash can be squeezed in (''), which will
cause all preceding or following whitespaces (including carriage returns)
to be squished from the rendered document.
This is useful to keep a stylesheet readable without
generating transformed document with many whitespace gaps. The dash can be
added independently to the right and left delimiter.
For example

will be rendered as

A Tale of Two Cities

As an empty directive is an no-op, one can
take advantage of it and use '' as
a magic template compacter.
=head2 Template Directives
=head3
Evaluates the code enclosed without printing anything.
Example:
To make the directive output something, simply C it.
albedo_index > 50 %>
To create a loop in your template, use two directives to wrap the opening and
closing pieces of code:

I need a .

=head3
Evaluates the enclosed code and prints its result.
Author:
=head3
Comments out the enclosed text, which will neither be executed or
show in the rendered document.
=head3
Takes the XPath expression, applies it on the current
node and renders the resulting nodes. Equivalent of doing
render( $node->findnodes( $xpath ), $args ) %>
Example:
$xss->set( chapter => { content => <
END_CONTENT
=head3
Takes the XPath expression and prints its value. Equivalent of doing
findvalue( $xpath ) %>
=head1 EXPORTED FUNCTIONS
=head2 xsst( $template )
Takes the template given as a string and convert it as a
C object ready to be used by a style attribute
of the stylesheet.
my $template = xsst q{

List of stuff

};
$xss->set( list => { content => $template } );
From the point of view of the stylesheet, the template object created by
C is just another coderef, and will be passed the usual rendering node,
xml node and option hashref arguments. For convenience, those are already
made available as C, C and C.
my $template = xstt q{

stylesheet->stash->{section_nbr}++ %>.

childNodes ) { %>
do something...
};
=head1 ATTRIBUTES
=head2 template
The original template string.
=head2 code
The code generated out of the original template, as a string.
my $template = xsst q{ Hello stylesheet->stash->{name} %> };
print $template->code;
=head1 AUTHOR
Yanick Champoux
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2011 by Yanick Champoux.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
__END__