Gulp plugin for compiling Pug templates
This Gulp plugin enables you to compile your Pug templates into HTML or JS, with support for template locals, custom Pug filters, AMD wrapping, and others. Here is a simple example using gulp-pug
:
var pug = require('gulp-pug');
gulp.task('views', function buildHTML() {
return gulp.src('views/*.pug')
.pipe(pug({
// Your options in here.
}))
});
opts
(Object
): Any options from Pug's API in addition topug
's own options.opts.locals
(Object
): Locals to compile the Pug with. You can also provide locals through thedata
field of the file object, e.g. withgulp-data
. They will be merged withopts.locals
.opts.data
(Object
): Same asopts.locals
.opts.client
(Boolean
): Compile Pug to JavaScript code.opts.pug
: A custom instance of Pug forgulp-pug
to use.
To change opts.filename
use gulp-rename
before gulp-pug
.
Returns a stream that compiles Vinyl files as Pug.
pug
gulp-data
: Using locals in your Pug templates easier.gulp-rename
: Changeopts.filename
passed into Pug.gulp-wrap-amd
: Wrap your Pug in an AMD wrapper.
- Many thanks to Blaine Bublitz for the original
gulp-jade
plugin.
MIT © Jamen Marzonie