ϐrown

Mustache-ish but clean template engine on steroids in 846 gzipped kilobytes

Usage

$ npm install brown

or in the browser:

Simple

brown.render( "hello {{foo.bar}}", {
foo: {
bar: "world"
}
});

outputs:

hello world

Functions

Create a fullfledged template engine by adding functions:

brown.encode = function(key,type) {
var html = this[key] || '';
return type == "html" ?
String(html).replace(/&/g, '&').replace(/"/g, '"').replace(/'/g, ''').replace(//g, '>') :
html
};

brown.render( 'a href="{{href}}" onclick="{{encode:label:html}}"': "{{label}}", {
href="/",
label:"my \"label\""}
});

outputs:

If / Else / Looping

> Need more? See brown-ext-basic for if/foreach/filter/loop-functionality.

Generate xml/html from jsonportable JADE

ϐrown can be monkeypatched, to automatically produce xml-trees from json (like JADE), see this coffeescript example:

json =
ul:
li: 'a href="{{foo}}": "Click me"

brown.render json,{ foo: "/" }

outputs:

• 
  Click me
  

How?
Simple, by just monkeypatching ϐrown with json-dsl. See coffeescript / JS examples.

Commandline util

Use as a commandline generator (install using npm install -g ) :

$ brown
Usage: brown [jsonstring|jsonfile]

examples:
$ brown 'foo {{foo}}' '{"foo":"world"}'
$ brown foo.html data.json

Goals / Philosophy

* lightweight and extendable
* monkeypatchable syntax
* mustache without the noise and weight (mustache is a whopping 97k and pretty slow)

I got a lot of projects using mustache.
The mustache syntax can easily get really noisy, and annoying because of absense of function arguments.
Brown is a way to slowly abandon the noisy syntax, and replace it with readable functions.

Hence the brown-ext-basic extension to easily convert it to brown syntax:

| | mustache | brown |
|--------------------|-------------------------------------------------|-------------------------------------------------|
| array iteration | {{#array}} {{.}} {{/array} | {{foreach:items:itemtemplate:"no items found"}} |
| if/else | {{#foo}}{{foo}}{{/foo}}{{^foo}} no foo {{/foo}} | {{if:foo:foo:"no foo"}} |
| object iteration | n/a | {{foreach:items:itemtemplate:"no items found"}} |
| global functions | n/a | brown.foo = (arg1,arg2) -> return arg1+arg2 |
| partial | {{ > templatename }} | {{include:templatename}} |
| chaining functions | n/a | {{foo:htmlencode:uppercase}} |template functions suite
| filesize | 97k | 846 bytes (gzipped)

With ϐrown as a fundament you can literally extend and overload anything.

Extentions

* brown-ext-basic template functions suite
* brown-express middleware

Roadmap

* stability and peace