Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including muban-convert-hbs with all npm packages installed. Try it out:

var mubanConvertHbs = require("muban-convert-hbs")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

muban-convert-hbs v1.1.1

Convert muban hbs templates to htl, django, twig and others.

muban-convert-hbs

Convert Handlebars templates to HTL, django, twig and others. It supports all of the commonly used features, and will add support for additional Handlebars Helpers to implement additional features that are popular in the target template language.

Handbelars templates are used in Muban to optimize frontend development for server-rendered HTML pages. This module is used to convert the development templates into server templates that can be used for the actual implementation, without having to do that manually.

Using this module doesn't guarantee 100% perfect target templates, so some manual checking is required to make sure the resulting templates are doing what is intended.

Installation

yarn add muban-convert-hbs
npm i -S muban-convert-hbs

Basic usage

import fs from 'fs';
import path from 'path';
import convert from 'muban-convert-hbs';
// var convert = require('muban-convert-hbs').default; // when using es5

const htl = convert(fs.readFileSync(path.resolve(__dirname, './foo.hbs'), 'utf-8'), 'htl');
const django = convert(fs.readFileSync(path.resolve(__dirname, './foo.hbs'), 'utf-8'), 'dtl');
const twig = convert(fs.readFileSync(path.resolve(__dirname, 'foo.hbs'), 'utf-8'), 'twig');

Building

In order to build muban-convert-hbs, ensure that you have Git and Node.js installed.

Clone a copy of the repo:

git clone https://github.com/mediamonks/muban-convert-hbs.git

Change to the muban-convert-hbs directory:

cd muban-convert-hbs

Install dev dependencies:

yarn

Use one of the following main scripts:

yarn build            # build this project
yarn dev              # run compilers in watch mode, both for babel and typescript
yarn test             # run the unit tests incl coverage
yarn test:dev         # run the unit tests in watch mode
yarn lint             # run eslint and tslint on this project
yarn doc              # generate typedoc documentation

When installing this module, it adds a pre-commit hook, that runs lint and prettier commands before committing, so you can be sure that everything checks out.

Support

Look at the test fixtures to see what is run through the tests.

In general, the following features are supported:

  • variables
  • raw
  • comments
  • if
    • else
    • else if
  • each
    • scoping
    • this
    • @key
    • @index
    • as |block params|
  • partials
    • passing context
    • passing parameters
    • dynamic using the lookup helper

Please check this pages for more information about the supported template languages and the exact features that are supported there:

Contribute

View CONTRIBUTING.md

Changelog

View CHANGELOG.md

Authors

View AUTHORS.md

LICENSE

MIT © MediaMonks

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free