jstify

jstify
======


jstify is a Browserify transform for creating modules of pre-compiled Underscore templates. It allows setting the name of the _ module in the template output for use with lodash. Also minifies the template's HTML using HTMLMinifier before compilation.

$3

With npm as a local development dependency:

``bash
npm install --save-dev jstify
`




$3

jstify can take a configuration object with any of the following:

* engine _(optional)_: The value used for var _ = require([engine]); in the template output. The default value is underscore, but may be set to lodash for example. Set it to lodash-micro to only include lodash.escape as a runtime dependency. Set it to global if using a CDN or a separate bundle that exposes the engine required as a global.
* withImports _(optional)_: Whether to simulate Lo-Dash's _.templateSettings.imports in the compiled template. Defaults to false.
* templateOpts _(optional)_: The options to pass to _.template. By default this is empty, check Underscore's template docs for more options.
* minifierOpts _(optional)_: The options to pass to HTMLMinifer. By default, removeComments, collapseWhitespace and conservativeCollapse are set to true, everything else is false. See the HTMLMinifier options docs for more info.
* Set to false to disable HTMLMinifier (This is useful for when your template looks like broken markup and the minifier is complaining).
* Alternatively, you can set noMinify.

The transform is only be applied to .ejs, .tpl, .jst, or .html files.

#### Usage of engine=lodash-micro ####

When file size of the compiled template is critical use lodash-micro configuration for engine. As lodash.escape is the only runtime dependency, this reduces the minified file size to less than 1kb. This should only be used when the template is not using any underscore or lodash functions inline like _.each.




$3

In templates/main.tpl:
`html+erb


I like <%= noun %>


`

In example/main.js:
`js
var template = require('templates/main.tpl');
$('#main').html( template({ noun: 'red bull' }) );
`

#### Transforming with the api ####

`js
var browserify = require('browserify');
var fs = require('fs');
var b = browserify('example/main.js');
b.transform('jstify')
b.bundle().pipe(fs.createWriteStream('bundle.js'));
`

Setting the engine to lodash:
`js
b.transform('jstify', { engine: 'lodash' })
`

Setting a mustache style interpolator, turning off comment removal and turning on redundant attribute removal:
`js
b.transform('jstify', {
templateOpts: {
interpolate: /\{\{(.+?)\}\}/g
},
minifierOpts: {
removeComments: false,
removeRedundantAttributes: true
}
});
`

#### Transforming with the command-line ####

`bash
browserify example/main.js -t jstify > bundle.js
`

Setting the engine to lodash:
`bash
browserify example/main.js -t [ jstify --engine lodash ] > bundle.js
`

Turning off comment removal:
`bash
browserify example/main.js -t [ jstify --minifierOpts [ --collapseWhitespace 0 ] ] > bundle.js
`

_Command-line caveat: Setting options in templateOpts that require a RegExp does not work._

#### Transforming with the require hook ####

For node usage:

`js
require('jstify/register')(/opts/);
`

opts are the same as with browserify usage.

$3

Template source:
`html+erb






`

Compiled without HTML minification:
`js
var _ = require('underscore');
module.exports = function(obj){
var __t,__p='',__j=Array.prototype.join,print=function(){__p+=__j.call(arguments,'');};
with(obj||{}){
__p+='

\n\n

\n i also like cat gifs\n

';
}
return __p;
};
`

Compiled with HTML minification:
`js
var _ = require('underscore');
module.exports = function(obj){
var __t,__p='',__j=Array.prototype.join,print=function(){__p+=__j.call(arguments,'');};
with(obj||{}){
__p+='

';
}
return __p;
};
``