brown

ϐrown

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

Usage

$ npm install brown

or in the browser:

<script type='text/javascript' src='brown.min.js'></script>

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, '&amp;').replace(/"/g, '&quot;').replace(/'/g, '&#39;').replace(/</g, '&lt;').replace(/>/g, '&gt;') :
          html
};

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

outputs:

<div>
  <ul>
    <li>
      <a href="/" onclick="my &quot;label&quot;">my "label"</a>
    </li>
  </ul>
</div>

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:

<ul>
  <li>
    <a href="/">Click me </a>
  </li>
</ul>

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 <string|file> [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}}
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