The following template engines are supported:
- react-jsx, automatically discovered by using the
- jade, automatically discovered by using the
- ejs, automatically discovered by using the
- hogan.js, automatically discovered by using the
- mustache, automatically discovered by using the
- handlebars, automatically discovered by using the
- html, automatically discovered by using the
As you can see from the list above, we support multiple version engines for the
mustache extension. You can supply your preference through the API. If no
preference is given it will iterate over the template engines and the one that
is successfully required will be used automatically.
Temper is distributed through npm:
npm install --save temper
Temper doesn't depend on any template engines so you need to install these your
self. For these examples I'm going to assume that you have
jade installed as
template engine. Run
npm install --save jade if this is not the case.
Initialising temper is quite simple:
'use strict';var Temper =temper = ;
Temper constructor allows the following options:
cacheshould we cache the compiled template, this defaults to
NODE_ENVis set to
production. You usually want to have this disabled during development so you can see the changes in your template without having to restart your node process.
The following methods can be used to interact with
temper.fetch method allows you to pre-compile your template file. This
is advised as requiring modules and reading files is done synchronous. Simply
call this method with a file location and an option engine argument.
Temper will try it's best to automatically discover template engines based on
file extensions, but sometimes this is impossible. There are tons of
compatible template engines and we cannot figure out which one you want based on
the extension. But for template languages such as
jade it's quite simple.
var data = temper;var data = temper;
- This is an optional property. Some of the supported engines require a helper library to be included at the client-side. If this property is not empty you should include this string together with your client side template on your page.
- The client-side compatible version of your given template. This is already converted to a string for your convenience.
- The server-side compatible version of your given template. It's a function that's ready to be used.
- The name of the template engine that was used to compile your template.
- An object that contains the hashes for the library, client and server.
The resulting compiled template have a uniform interface. It's a function that accepts the template data as first argument and returns the generated template.
var template = temperhtml = ;console;