Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A templating engine minus the code.
JavaScript
tree: 552e2d0540

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
test
LICENSE
README.md
index.js
package.json

README.md

Liquor

Liquor is a templating engine for node. It's very lightweight. It's essentially embedded javascript with some shorthand significant whitespace notation available. This is to discourage use of raw code and make templates look nicer.

Usage

Backticks are used for evaluation, while #{} is used for interpolation.

?:data
  <table>
    <tr>
      @:col 
        <td>#{this}</td>
    </tr>
    @:data
      <tr>
        <td>#{this.color}</td>
        <td>#{this.animal}</td>
      </tr>
  </table>

!:data
  <div>
    ?:error
      <p>Sorry, there was a problem: #{error}.</p>
      <p>Please, try again!</p>
    !:error
      <p>Sorry, no error message.</p>
  </div>

Is essentially shorthand for:

`if (typeof data !== 'undefined' && data) {`
  <table>
    <tr>
      `each(col, function() {`
        <td>#{this}</td>
      `})`
    </tr>
    `each(data, function() {`
      <tr>
        <td>#{this.color}</td>
        <td>#{this.animal}</td>
      </tr>
    `})`
  </table>
`} else {`
  <div>
    `if (typeof error !== 'undefined' && error) {`
      <p>Sorry, there was a problem: #{error}.</p>
      <p>Please, try again!</p>
    `} else {`
      <p>Sorry, no error message.</p>
    `}`
  </div>
`}`
`/* liquor also exposes an "each" helper function */`
`/* it is the same one used internally for @ statements */`
`if (messages) 
  each(messages, function(message, key) {`
    <p>#{key}: #{message.content}</p>
  `})`

If you're worried about the notorious "undefined" problem with variables expressed in raw evaluation of JS, you can access them as properties on a variable called $, which exists within the context of a template, and holds all of the locals and helpers:

e.g.

`if ($.messages) {` <p>#{JSON.stringify(messages)}</p> `}`

License

(c) Copyright 2011, Christopher Jeffrey. See LICENSE for more info.

Something went wrong with that request. Please try again.