Merge pull request #4 from Faldrian/addedConfigurationSupport

Added configuration support

README.md

@@ -57,6 +57,38 @@ exports.config =
       outputDirectory: 'app/another_directory'
 ```
 
+### Additional project-specific configuration
+
+You can set the context and configure Handlebars in your project by using an extra file (default: `./staticHandlebarsExtras.js` in your projects root directory).
+
+```coffee
+exports.config =
+  plugins:
+    staticHandlebars:
+      includeFile: 'app/another_directory'
+```
+
+The file may look like this:
+```coffee
+/*
+  Parameters:
+  - handlebars -> reference to the handlebars object
+
+  Returns:
+  - context -> object which represents the context in which the templates will be executed
+*/
+
+module.exports = function(handlebars) {
+  var context = {
+    color: 'blue'
+  };
+
+  // make calls on the 'handlebars'-variable to define additional helpers etc.
+
+  return context;
+};
+```
+
 ## TODO
 
 This library has a long way to go in terms of configurability and compatability

src/index.coffee

@@ -12,6 +12,12 @@ module.exports = class StaticHandlebarsCompiler
   constructor: (@config) ->
     @outputDirectory = @config?.plugins?.staticHandlebars?.outputDirectory || 'public'
 
+    # Load additional configuration / context from a project-specific file
+    includeFile = @config?.plugins?.staticHandlebars?.includeFile
+    if includeFile?
+      absoluteFile = sysPath.join(sysPath.resolve('./'), includeFile)
+      @extras = require(absoluteFile)
+
   withPartials: (callback) ->
     partials = {}
     errThrown = false
@@ -36,12 +42,13 @@ module.exports = class StaticHandlebarsCompiler
     try
       basename = sysPath.basename(path, ".hbs")
       template = handlebars.compile(data)
+      context = if @extras then @extras(handlebars) else {}
 
       @withPartials (err, partials) =>
         if err?
           callback(err)
         else
-          html = template({}, partials: partials, helpers: @makeHelpers(partials))
+          html = template(context, partials: partials, helpers: @makeHelpers(partials))
           newPath = @outputDirectory + path.slice(13, -4) + ".html"
 
           mkdirp.sync(sysPath.dirname(newPath))