JSIN - Javascript Include

Template engine for use at server and client side.

Features

• Well-known PHP-like template tags.
• Accurate quote parsing.
• Asynchronous compiling of templates on the fly.
• Pre-compiling for use in browser.
• Supports includings and layoutings.

Usage

Syntax

Constructions:

• <?js /* any javascript code */ ?>
• <?= /* print value or result of expression */ ?>
• <?h= /* print value or result of expression with escaped html special chars <>&" */ ?>
• <?s= /* print value or result of expression with backslashed script special chars \\n\r"' */ ?>

Functions:

• print(string)
• printh(string, [apos]) - if set apos to true, then apostrophe ' will be escaped instead of quotes ".
• prints(string)
• include(template, [data])
• layout(template, [data], callback)
• contents()

Example

<!-- mytemplate.jsin -->
<h1>Example</h1>
<p>
    <?= "Check ?>'\" special chars and variable " + boo ?>
<p>
    <?h= "Check html escaping &<>\"" ?>
<p>
    <?s= "Check script escaping \\\n\r\"\'" ?>
</p>
<p>
    <?js if (1 === 1) { ?>
        1 === 1
    <?js } else { ?>
        1 !== 1
    <?js } ?>
</p>
<?js

include('include');

print("<p>Example print</p>\n");

?>
<?js layout('layout', function(){ ?>
        <div>
            <p>Example layout inside</p>
            <?js include('layout-include-inside') ?>
        </div>
<?js }) ?>

<p>Thanx!</p>

<!-- layout.jsin -->
<div>
    <p>Example layout begin with variable <?= boo ?></p>
    <div>
        <?js contents() ?>
    </div>
    <?js include('layout-include') ?>
    <p>Example layout end</p>
</div>

Server side

var jsin = require('jsin');

jsin.setDirectory('path/to/templates');

// you can omit extension .jsin
jsin.include('mytemplate', {
    boo: 'booooooo'
}, function(err, res) {
    if (err) {
        console.log('Error: ' + err);
    } else {
        console.log(res);
    }
});

Client side

Compile client-side script using jsinc command-line tool:

$ jsinc path/to/*.jsin jsin.compiled.js

or

$ jsinc -d path/to/jsin/dir jsin.compiled.js

Options:

• -d - compile all files in directory and subdirectories, excluding this directory from template names.
• -t - compile templates only, exclude definition of jsin object.
• -b - beautify.
• -u - uglify.

In browser:

<script src="jsin.compiled.js"></script>
<script>
    var res = jsin.include('mytemplate', {
        boo: 'booooo'
    });
    document.getElementById('res').innerHTML = res;
</script>

License

Copyright © 2014 Maksim Krylosov [email protected]

This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.