The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Dancer::Template::Tenjin - Tenjin wrapper for Dancer

VERSION

version 0.5

SYNOPSIS

# in your config.yml
template: "tenjin"

# note: templates must use the '.tt' extension

# you might also want to add (if your templates are UTF-8, which is the
# default encoding used by Tenjin):
charset: "UTF-8"

DESCRIPTION

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

Tenjin is a fast and feature-full templating engine that can be used by Dancer for production purposes. In comparison to Template::Toolkit, it is much more lightweight, has almost no dependencies, and supports embedded Perl code instead of defining its own language.

In order to use this engine, you need to set your webapp's template engine in your app's configuration file (config.yml) like so:

template: "tenjin"

You can also directly set it in your app code with the set keyword.

Now you can create Tenjin templates normally, but note that due to a Dancer restriction your template files must end in the '.tt' extension as Dancer automatically adds this extension to the template names you declare in your apps.

METHODS

init()

Initializes a template engine by generating a new instance of Tenjin.

render( $template, $tokens )

Receives a template name and a hash-ref of key-value pairs to pass to the template, and returns the template rendered by Tenjin.

SEE ALSO

Dancer, Tenjin

AUTHOR

Ido Perlmuter, <ido at ido50 dot net>

ACKNOWLEDGEMENTS

  • Alexis Sukrieh, <sukria@cpan.org>

    Author of Dancer, who wrote Dancer::Template::Toolkit, on which this module is based.

  • Sawyer X, <xsawyerx at cpan.org>

    Submitted helpful changes for version 0.3.

  • Franck Cuny <franck at lumberjaph dot net>

    Submitted a simple test for version 0.4.

TODO

  • Non-file sources

    Find a way to allow using templates from other source, such as a database, just like in Catalyst::View::Tenjin.

  • Fine-tune Tenjin

    Allow passing arguments to Tenjin, such as USE_STRICT.

BUGS

Please report any bugs or feature requests to bug-dancer-template-tenjin at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Dancer-Template-Tenjin. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Dancer::Template::Tenjin

You can also look for information at:

LICENSE AND COPYRIGHT

Copyright 2010-2011 Ido Perlmuter.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.