README
1NAME
2 Dancer::Template::Xslate - Text::Xslate wrapper for Dancer
3
4VERSION
5 version 0.03
6
7DESCRIPTION
8 This class is an interface between Dancer's template engine abstraction
9 layer and the Text::Xslate module.
10
11 In order to use this engine, use the template setting:
12
13 template: xslate
14
15 This can be done in your config.yml file or directly in your app code
16 with the set keyword.
17
18 You can configure Text::Xslate:
19
20 template: xslate
21 engines:
22 xslate:
23 cache_dir: .xslate_cache/
24 cache: 1
25 extension: tx # Dancer's default template extension is "tt"
26 module:
27 - Text::Xslate::Bridge::TT2Like # to keep partial compatibility with Template Toolkit
28
29CAVEATS
30 Cascading
31 Dancer already provides a <cascade>-like feature, called a "layout",
32 in order to augment other template engines lacking such a feature.
33 In order to use Xslate's "cascade", turn off "layout" by commenting
34 out or removing the appropriate line in your Dancer application
35 config.
36
37 Smart HTML Escaping
38 Use of Dancer's "layout" feature will cause HTML templates to be
39 HTML-entity encoded twice if Xslate's "smart HTML escaping" feature
40 is enabled. Xslate's "type" option can be set to "text" to disable
41 smart-escaping, or, once again, "layout" can be disabled in favor of
42 "cascade".
43
44SEE ALSO
45 Dancer
46 Text::Xslate
47
48AUTHOR
49 franck cuny <franck@lumberjaph.net>
50
51COPYRIGHT AND LICENSE
52 This software is copyright (c) 2011 by franck cuny.
53
54 This is free software; you can redistribute it and/or modify it under
55 the same terms as the Perl 5 programming language system itself.
56
57