blissify
browserify v2 plugin for bliss
Use
Install in local project
install blissify locally to your project
npm install blissify
Make a bliss template
Create templates using bliss; by default blissify transforms .html
files
@!(name)
<h1>Hello @name!</h1>
Require and use those templates in your view (backbone), controller (spine), etc.
var template = require('template.html');
$('body').html(template({name: 'Nali'}));
Transform with browserify
On the command line, transform module with browserify -t
option:
browserify -t blissify main.js > bundle.js
Or, in a bundler script (e.g. bundler.js
), use blissify as a transform:
var browserify = require('browserify');
var blissify = require('blissify');
var b = browserify();
b.add('view.js');
b.transform(blissify);
b.bundle().pipe(process.stdout);
Then, run the script to bundle it up:
node bundler
Pro tip: you can configure a custom extension for blissify
bundler.transform(blissify.configure('.bliss'));
Debug
To set the transformer in debug mode, set verbose=true
when instatiating blissify
var blissify = require('blissify');
blissify.verbose = true;
When enabled, debug mode will console.log
when a raw template is successfully recompiled and console.error
when a parse error occurs. This is super helpful if you're using watchify. an error will look like:
[blissify] error: <badTemplate.html>
<errorStackTrace>
Note that when in debug mode, the error is not passed to the through
stream.
Upgrading from 0.1.x
to 1.0.0
?
- If using a custom file extension, make sure to use the new configuration pattern
- If using a bundler script, make sure to change
b.transform(blissify())
to b.transform(blissify)
Test
drink up me 'earties, yo ho!