summaryrefslogtreecommitdiff
path: root/lib/Dancer/Template/Xslate.pm
diff options
context:
space:
mode:
Diffstat (limited to 'lib/Dancer/Template/Xslate.pm')
-rw-r--r--lib/Dancer/Template/Xslate.pm15
1 files changed, 15 insertions, 0 deletions
diff --git a/lib/Dancer/Template/Xslate.pm b/lib/Dancer/Template/Xslate.pm
index 9777ee9..688a645 100644
--- a/lib/Dancer/Template/Xslate.pm
+++ b/lib/Dancer/Template/Xslate.pm
@@ -83,6 +83,21 @@ You can configure L<Text::Xslate>:
module:
- Text::Xslate::Bridge::TT2Like # to keep partial compatibility with Template Toolkit
+=head1 CAVEATS
+
+=head2 Cascading
+
+Dancer already provides a <cascade>-like feature, called a "layout", in order
+to augment other template engines lacking such a feature. If you want to use
+Xslate's C<cascade>, turn off C<layout> by commenting out or removing the
+appropriate line in your Dancer config file.
+
+=head2 Smart HTML Escaping
+
+Use of Dancer's C<layout> feature will cause HTML templates to be HTML-entity
+encoded twice if Xslate's "smart HTML escaping" feature is enabled. Xslate's
+C<type> option can be set to "text" to disable smart-escaping, or, once again,
+C<layout> can be disabled in favor of C<cascade>.
=head1 SEE ALSO