templates/lib/helpers/single.js

System for creating and managing template collections, and rendering templates with any node.js template engine. Can be used as the basis for creating a static site generator or blog framework.

'use strict';

var utils = require('../utils');

module.exports = function (app, collection, options) {
  var plural = options.plural;
  var single = options.inflection;

  app.helper('view', function (name, type) {
    if (typeof type === 'string') {
      type = app.views[type];
    } else {
      type = 'pages';
    }
    return app.find(name, type);
  });

  /**
   * Create async helpers for each default template `type`.
   *
   * @param {String} `type` The type of template.
   * @param {String} `plural` Plural form of `type`.
   * @api private
   */

  app.asyncHelper(single, function (key, locals, opts, cb) {
    var args = [].slice.call(arguments, 1);
    cb = args.pop();

    try {
      var view = app.getView(plural, key);
      if (!Object.keys(view).length) {
        view = collection[key];
      }

      if (!view || !Object.keys(view).length) {
        app.emit('error', 'missing ' + single + ' `' + key + '`');
        return cb(null, '');
      }

      var locs = utils.getLocals.apply(utils.getLocals, args);
      locs = locs || {};
      var ctx = utils.merge({}, this.context.view.locals, view.context(locs));

      view.render(ctx, function (err, res) {
        if (err) return cb(err);
        return cb(null, res.content);
      });

    } catch(err) {
      err.reason = 'error in helper: ' + single + ': ' + key;
      app.emit('error', err);
      cb(null, '');
    }
  });
};