# Template Plugin #

## Introduction ##

The template plugin provides allows for bundling of handlebars templates with the dependent javascript
code, allowing templates to be kept in separate files and removing any need for additional requests to
load the templates required by a given module.

## Usage ##

The template plugin looks for a `template` configuration object defined on the root lumbar config.
This object should be a hash of javascript pathnames whose values are arrays of template files. On build,
each module that includes a file listed in this hash will have the associated templates defined at least
once in the output.

### Configuration ###

  * `precompile` : Options to pass to handlebars precompile method if precompilation is desired. Leave
        falsy or undefined to load the templates through client-side compilation.
  & `precompile.template` : An optional string for the code to be generated when a compiled template
        is inserted into the module source. The template will recieve three variables: `data`, 
        `templateCache` and `name`. It may be a string handlbars template or a path to a file ending in `.handlebars`
  * `templateCache` : Object that templates will be assigned to. This field is defined on the root 
        and defaults to `{AppModule}.templates` where {AppModule} is the name of the application module.
        This instance can be any object and should be manually defined by the client code.
  * `templates.template` : An optional string for the code to be generated when a template is inserted into
        the module source. The template will recieve three variables: `data`, `templateCache` and `name`. It may be a string handlbars template or a path to a file ending in `.handlebars`

## Example ##

    {
      "modules": {
        "base": [
          {"src": "js/base.js"}
        ]
      },
      "templates": {
        "js/base.js": [
          "templates/home.handlebars",
          "templates/footer.handlebars"
        ],

        "knownHelpers": [
          "template",
          "view"
        ],
        "precompile": {,
          "knownHelpersOnly": true
        }
      },

      "templateCache": "TemplateCache",
      "templateTemplate": "{{{templateCache}}}['{{{name}}}'] = Handlebars.compile('{{{data}}}');",
      "precompiledTemplate": "{{{templateCache}}}['{{{name}}}'] = Handlebars.template({{{data}}});"
    }