98 lines
3.2 KiB
JavaScript
98 lines
3.2 KiB
JavaScript
(function() {
|
|
/**
|
|
Template helper definitions for Handlebars.
|
|
@license MIT. See LICENSE.md for details.
|
|
@module handlebars-helpers.js
|
|
*/
|
|
var HANDLEBARS, HMS, _, blockHelpers, helpers, path;
|
|
|
|
HANDLEBARS = require('handlebars');
|
|
|
|
_ = require('underscore');
|
|
|
|
helpers = require('./generic-helpers');
|
|
|
|
path = require('path');
|
|
|
|
blockHelpers = require('./block-helpers');
|
|
|
|
HMS = require('../core/status-codes');
|
|
|
|
/**
|
|
Register useful Handlebars helpers.
|
|
@method registerHelpers
|
|
*/
|
|
module.exports = function(theme, rez, opts) {
|
|
var curGlob, ex, glob, slash, wrappedHelpers;
|
|
helpers.theme = theme;
|
|
helpers.opts = opts;
|
|
helpers.type = 'handlebars';
|
|
// Prepare generic helpers for use with Handlebars. We do this by wrapping them
|
|
// in a Handlebars-aware wrapper which calls the helper internally.
|
|
wrappedHelpers = _.mapObject(helpers, function(hVal, hKey) {
|
|
if (_.isFunction(hVal)) {
|
|
return _.wrap(hVal, function(func) {
|
|
var args;
|
|
args = Array.prototype.slice.call(arguments);
|
|
args.shift(); // lose the 1st element (func) [^1]
|
|
//args.pop() # lose the last element (HB options hash)
|
|
args[args.length - 1] = rez; // replace w/ resume object
|
|
return func.apply(this, args); // call the generic helper
|
|
});
|
|
}
|
|
return hVal;
|
|
}, this);
|
|
HANDLEBARS.registerHelper(wrappedHelpers);
|
|
// Prepare Handlebars-specific helpers - "blockHelpers" is really a misnomer
|
|
// since any kind of Handlebars-specific helper can live here
|
|
HANDLEBARS.registerHelper(blockHelpers);
|
|
if (_.isString(theme.helpers)) {
|
|
// Register any theme-provided custom helpers...
|
|
|
|
// Normalize "theme.helpers" (string or array) to an array
|
|
theme.helpers = [theme.helpers];
|
|
}
|
|
if (_.isArray(theme.helpers)) {
|
|
glob = require('glob');
|
|
slash = require('slash');
|
|
curGlob = null;
|
|
try {
|
|
_.each(theme.helpers, function(fGlob) { // foreach theme.helpers entry
|
|
var files;
|
|
curGlob = fGlob; // ..cache in case of exception
|
|
fGlob = path.join(theme.folder, fGlob); // ..make relative to theme
|
|
files = glob.sync(slash(fGlob)); // ..expand the glob
|
|
if (files.length > 0) { // ..guard against empty glob
|
|
_.each(files, function(f) { // ..loop over concrete paths
|
|
HANDLEBARS.registerHelper(require(f)); // ..register the path
|
|
});
|
|
} else {
|
|
throw {
|
|
fluenterror: HMS.themeHelperLoad,
|
|
inner: er,
|
|
glob: fGlob
|
|
};
|
|
}
|
|
});
|
|
} catch (error) {
|
|
ex = error;
|
|
throw {
|
|
fluenterror: HMS.themeHelperLoad,
|
|
inner: ex,
|
|
glob: curGlob,
|
|
exit: true
|
|
};
|
|
}
|
|
}
|
|
};
|
|
|
|
// [^1]: This little bit of acrobatics ensures that our generic helpers are
|
|
// called as generic helpers, not as Handlebars-specific helpers. This allows
|
|
// them to be used in other templating engines, like Underscore. If you need a
|
|
// Handlebars-specific helper with normal Handlebars context and options, put it
|
|
// in block-helpers.coffee.
|
|
|
|
}).call(this);
|
|
|
|
//# sourceMappingURL=handlebars-helpers.js.map
|