Richard Simões > Dancer-Template-Xslate > Dancer::Template::Xslate

Download:
Dancer-Template-Xslate-0.03.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 0.03   Source  

NAME ^

Dancer::Template::Xslate - Text::Xslate wrapper for Dancer

VERSION ^

version 0.03

DESCRIPTION ^

This class is an interface between Dancer's template engine abstraction layer and the Text::Xslate module.

In order to use this engine, use the template setting:

    template: xslate

This can be done in your config.yml file or directly in your app code with the set keyword.

You can configure Text::Xslate:

    template: xslate
    engines:
      xslate:
        cache_dir: .xslate_cache/
        cache:     1
        extension: tx                     # Dancer's default template extension is "tt"
        module:
          - Text::Xslate::Bridge::TT2Like # to keep partial compatibility with Template Toolkit

CAVEATS ^

Cascading

Dancer already provides a <cascade>-like feature, called a "layout", in order to augment other template engines lacking such a feature. In order to use Xslate's cascade, turn off layout by commenting out or removing the appropriate line in your Dancer application config.

Smart HTML Escaping

Use of Dancer's layout feature will cause HTML templates to be HTML-entity encoded twice if Xslate's "smart HTML escaping" feature is enabled. Xslate's type option can be set to "text" to disable smart-escaping, or, once again, layout can be disabled in favor of cascade.

SEE ALSO ^

Dancer
Text::Xslate

AUTHOR ^

franck cuny <franck@lumberjaph.net>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2011 by franck cuny.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

syntax highlighting: