gulp-nunjucks-api

gulp-nunjucks-api

Render Nunjucks templates with data, custom filters, custom context functions and options for other Nunjucks API features.

Install

Install with npm

npm install --save-dev gulp-nunjucks-api

Example

var gulp = require('gulp');
var nunjucksRender = require('gulp-nunjucks-api');

gulp.task('default', function () {
  return gulp.src('src/templates/*.html')
    .pipe(nunjucksRender({
		  src: 'src/templates',
      data: require('./global-data.json'),
      filters: require('./global-filters.js'),
      functions: require('./global-functions.js')
		}))
		.pipe(gulp.dest('dist'));
});

Example with gulp data

var gulp = require('gulp');
var nunjucksRender = require('gulp-nunjucks-api');
var data = require('gulp-data');

function getDataForFile(file){
  return {
    example: 'data loaded for ' + file.relative
  };
}

gulp.task('default', function () {
	return gulp.src('src/templates/*.html')
	  .pipe(data(getDataForFile))
		.pipe(nunjucksRender({
      src: 'src/templates/'
    }))
		.pipe(gulp.dest('dist'));
});

API

nunjucks-render(options)

Same options as nunjucks.configure():

• watch (default: false) reload templates when they are changed.
• express an express app that nunjucks should install to.
• autoescape (default: false) controls if output with dangerous characters are escaped automatically.
• tags (default: see nunjucks syntax) defines the syntax for nunjucks tags.

With the following additional options:

• extension (default: ".html") String. File extension to output.
• src (default: undefined) String or Array. Search path(s) for nunjucks.configure().
• data (default: {}) Ojbect. Global data merged into the Nunjucks render context.
• filters (default: {}) Object. Global filter functions added to the Nunjucks environment.
• functions (default: {}) Object. Global functions merged into the Nunjucks render context.
• globals (default: undefined) Object. A single object which provides data, filters and functions objects instead of setting each of these options separately. Other global options are merged into this object.

For example

nunjucksRender({
  data: {css_path: 'http://company.com/css/'}
});

For the following template

<link rel="stylesheet" href="{{ css_path }}test.css" />

Would render

<link rel="stylesheet" href="http://company.com/css/test.css" />

Watch mode

Nunjucks' watch feature, which is normally enabled by default, is disabled by
default for gulp. Pass watch: true to enable it:

nunjucksRender({
  src: './source',
  watch: true
});

License

MIT © Devoptix LLC

Shout-outs

Carlos G. Limardo who wrote gulp-nunjucks-render which I am forking in order to update Nunjucks and do other stuff.

Sindre Sorhus who wrote the original gulp-nunjucks for precompiling Nunjucks templates. I updated his to render instead of precompile.