summary refs log tree commit diff
diff options
context:
space:
mode:
authorRichard Simões <rsimoes@cpan.org>2012-04-12 19:15:04 -0500
committerRichard Simões <rsimoes@cpan.org>2012-04-12 19:15:04 -0500
commit8ef9676ec71b63947b761a7f163c1b0cdbc146a0 (patch)
tree33315c98ad9d4f16c714c0b3998487ad2408b1c3
parentMerge pull request #6 from ywatase/add_pod_about_layout (diff)
downloaddancer-template-xslate-8ef9676ec71b63947b761a7f163c1b0cdbc146a0.tar.gz
Further document caveats involving Dancer's C<layout> feature.
-rw-r--r--lib/Dancer/Template/Xslate.pm22
1 files changed, 11 insertions, 11 deletions
diff --git a/lib/Dancer/Template/Xslate.pm b/lib/Dancer/Template/Xslate.pm
index 3bb3314..f2446b3 100644
--- a/lib/Dancer/Template/Xslate.pm
+++ b/lib/Dancer/Template/Xslate.pm
@@ -81,21 +81,21 @@ You can configure L<Text::Xslate>:
         module:
           - Text::Xslate::Bridge::TT2Like # to keep partial compatibility with Template Toolkit
 
-=head1 CASCADE
+=head1 CAVEATS
 
-Dancer already provides a CASCADE-like ability, which called a "layout". The
-reason is written on L<Dancer::Template::TemplateToolkit>
+=head2 Cascading
 
-If you might want to use CASCADE, you should turn off "layout" function.
+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.
 
-=over 4
+=head2 Smart HTML Escaping
 
-=item * Disable the layout in Dancer
-
-You can do this by simply commenting (or removing) the C<layout> configuration
-in the F<config.yml> file.
-
-=back
+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