stml

Super Type Markup Language

Lightweight JavaScript template engine for better cleaner code.

Install

$ npm install stml
# Or
$ yarn add stml

Usage

import fs from 'fs'
import path from 'path'
import stml from 'stml'

const src = fs.readFileSync(path.join(__dirname, 'template.html'))
const dest = stml.compile(src, {
  locals: {
    entries: ['James', 'John', 'Tom']
  },
  filename: path.join(__dirname, 'template.html')
})

console.log(dest)

API

Name	Type	Default	Description
locals	Object		The options to pass params to template.
filename	String		The absolute path souce filename when extends is declared.
expressionOpen	String	'{'	Expression statement open syntax.
expressionClose	String	'}'	Expression statement close syntax.
blockOpen	String	'<%'	Block statement open syntax.
blockClose	String	'%>'	Block statement close syntax.

Syntax

expression statement

Use jsx syntax for expression statement.

<div>{ name }</div> <!-- escape -->
<div>{- name }</div> <!-- unescape -->

block statement

Use jsp syntax for block statement.

<% if (entries.length) { %>
  <ul>
    <% entries.forEach(function(entry){ %>
      <li>{ entry }</li>
    <% }) %>
  </ul>
<% } %>

extends statement

Use jsp syntax for extends statement.

<% extends 'header.html' %>

License

Released under the MIT license.