NAME
    Dancer::Template::Handlebars - Wrapper for the Handlebars template
    system

VERSION
    version 0.1.0

SYNOPSIS
        # in config.yml
       template: handlebars

       engines:
            handlebars:
                helper_modules:
                    - MyApp::HandlebarsHelpers

       # in the app
       get '/style/:style' => sub {
           template 'style' => {
               style => param('style')
           };
       };

       # in views/style.mustache
       That's a nice, manly {{style}} mustache you have there!

DESCRIPTION
    Wrapper for Text::Handlebars, the Perl implementation of the Handlebars
    templating system.

  Configuration
    The arguments passed to the 'handlebars' engine are given directly to
    the Text::Handlebars constructor, with the exception of "helper_modules"
    (see below for details).

  Calls to 'template()'
    When calling "template", one can use a filename as usual, or can pass a
    string reference, which will treated as the template itself.

        get '/file' => sub {
            # look for the file views/my_template.hbs
            template 'my_template', {
                name => 'Bob',
            };
        };

        get '/string' => sub {
            # provide the template directly
            template \'hello there {{name}}', {
                name => 'Bob',
            };
        };

    The default extension for Handlebars templates is '"hbs"'.

  Helper Functions
    Handlebars helper functions can be defined in modules, which are passed
    via "helper_modules" in the configuration. See
    Dancer::Template::Handlebars::Helpers for more details on how to
    register the functions themselves.

AUTHOR
    Yanick Champoux <yanick@babyl.dyndns.org>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2014 by Yanick Champoux.

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

