summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--dist.ini6
-rw-r--r--lib/Dancer/Template/Xslate.pm15
2 files changed, 18 insertions, 3 deletions
diff --git a/dist.ini b/dist.ini
index c0b0ace..60f31c5 100644
--- a/dist.ini
+++ b/dist.ini
@@ -3,7 +3,7 @@ author = franck cuny <franck@lumberjaph.net>
license = Perl_5
copyright_holder = franck cuny
copyright_year = 2011
-version = 0.02
+version = 0.03
[@Filter]
bundle = @Basic
@@ -18,8 +18,8 @@ bugtracker.github = user:franckcuny
[MetaResources]
repository = git://github.com/franckcuny/dancer-template-xslate.git
-bugtracker = http://rt.cpan.org/Public/Dist/Display.html?Name=Dancer::Template::Xslate
-homepage = http://search.cpan.org/perldoc?Dancer::Template::Xslate
+bugtracker = https://github.com/franckcuny/dancer-template-xslate/issues
+homepage = https://github.com/franckcuny/dancer-template-xslate
[Test::PodSpelling]
stopwords = franck
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