gulp-nunjucks-render-env

Render Nunjucks templates, with optional Environment.

Issues with the output should be reported on the Nunjucks issue tracker.

Install

Install with npm

npm install --save-dev gulp-nunjucks-render-env

Example

1var gulp = require('gulp');
2var nunjucks = require('nunjucks');
3var nunjucksRender = require('gulp-nunjucks-render-env');
4
5gulp.task('default', function () {
6	var env = new nunjucks.Environment(/* ... */);
7    var context = { template: 1, vars: 2, here: 3};
8	return gulp.src('src/templates/*.html')
9		.pipe(nunjucksRender(context, env))
10		.pipe(gulp.dest('dist'));
11});

Example with gulp data

1var gulp = require('gulp');
2var nunjucksRender = require('gulp-nunjucks-render');
3var data = require('gulp-data');
4
5function getDataForFile(file){
6    return {
7        example: 'data loaded for ' + file.relative
8    };
9}
10
11gulp.task('default', function () {
12	return gulp.src('src/templates/*.html')
13	    .pipe(data(getDataForFile))
14		.pipe(nunjucksRender())
15		.pipe(gulp.dest('dist'));
16});

API

nunjucks-render(context)

Same context as nunjucks.render().

For example

nunjucksRender({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" />

License

MIT © Carlos G. Limardo

Shout-outs

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