shoko v1.0.12
Shoko
A node.js templating engine
Shoko is a simple to use templating engine, with a very straight forward and intuative syntax. Shoko also offers many other features, including: mixins, variables, comments.
As shoko is in it's early development, many features that we intend to add are stil missing.
Installation
Shoko is super easy to get up and running. simply download it from npm, like this.
npm install shoko --saveSyntax
Shoko has a very easy to grasp syntax. Elements in shoko are seprated by curly braces.
Here is an example:
doctype html
html {
head {
title {
'My First Shoko Page'
}
}
body {
h1 {
'Shoko is awesome.'
}
}
}Which will render to this HTML:
<!DOCTYPE html>
<head>
<head>
<title>My First Shoko Page</title>
</head>
<body>
<h1>
My First Shoko Page
</h1>
</body>
</head>API
Shoko is really easy to use.
To render plain shoko text, just use the render function.
const shoko = require('shoko');
let textToRender = 'h1 { "Hello world" }';
//<h1>Hello world</h1>
let renderedHTML = shoko.render(textToRender);To render from a file, use the renderFile function.
let renderedFile = shoko.renderFile('file.sk');Yes, I'ts that simple!
Framework Integration
List of frameworks:
- Express.js
- hapi.js
Integrating with Express.js
Integrating Shoko with Express is so easy.
Just set the engine to the Shoko renderFile function.
app.engine('sk', shoko.renderFile);Then, you can just render views normally. For example:
app.get('/', (res, req) => {
res.render('index', {});
});Integrating with Hapi.js
Like express, integrating Shoko with Hapi is very easy; Just register shoko as the engine.
server.register(require('vision'), (err) => {
server.views({
engines: {
html: require('shoko')
}
});
});Then, you can just render views normally. For example:
server.route({
method: 'GET',
path: '/',
handler: function (request, reply) {
reply.view('index');
}
});