dgeni-packages/nunjucks/services/nunjucks-template-engine.js

A collection of dgeni packages for generating documentation from source code

const nunjucks = require('nunjucks');

/**
 * @dgService templateEngine
 * @description A nunjucks powered template rendering engine
 */
module.exports = function templateEngine(templateFinder) {

  return {

    /**
     * Nunjucks specific options, such as using `{$ $}` for nunjucks interpolation
     * rather than `{{ }}`, which conflicts with AngularJS
     */
    config: {autoescape: false},

    filters: [],
    tags: [],

    getRenderer() {
      const loader = new nunjucks.FileSystemLoader(templateFinder.templateFolders, {watch: false, noCache: false});
      const engine = new nunjucks.Environment(loader, this.config);

      // Configure nunjucks with the custom filters
      this.filters.forEach(filter => engine.addFilter(filter.name, filter.process));

      // Configure nunjucks with the custom tags
      this.tags.forEach(tag => engine.addExtension(tag.tags[0], tag));

      return function render(template, data) {
        return engine.render(template, data);
      };
    }
  };
};