node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Build Status Dependency Status NPM version Bitdeli Badge

Compile Jade templates (with internationalization and translation support)

Getting started

This plugin is exactly the same as grunt-contrib-jade, but it adds high level support for Jade template internationalization based on JSON/YAML/JS files

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-jade-i18n --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile:


This plugin requires Grunt ~0.4.0

The "jade" task

Run this task with the grunt jade command.

Task targets, files and options may be specified according to the grunt Configuring tasks guide

This plugin provides a localization mechanism for Jade templates. Since localization is done once during the build process, there is no performance hit on the application, opposed to dynamic translation on the client side

Usage example

Gruntfile configuration
  jade: {
    templates: {
      options: {
        // jade i18n specific options 
        i18n: {
          locales: 'locales/*.json',
          namespace: '$i18n'
        // Jade specific options 
        pretty: true
      files: {
        "path/to/dest.html": ["path/to/templates/*.jade", "another/path/tmpl.jade"]

See Gruntfile for more configuration examples

Example JSON locale file (es_ES.json)
  "hello": {
    "world": "Hola Mundo"
Example Jade template with internationalization
  h1 #{$}!


Only jade-i18n specific options are listed below

To see all the available options available, please see grunt-contrib-jade


Type: String|Array

Path to localization files. Please check the examples in tests. Glob patterns can be used

JSON, YAML and JS formats are supported for the translation templates


Type: String Default: '$i18n'

Namespace to expose translation keys in Jade template


Type: Boolean Default: false

Generate the HTML output files with the extension prefix with the current language. By default it will create different folders for each language

Setting this option into true, the generated HTML files will look like this:

├── view.en-en.html

... instead of:

├── en-EN/
│   └── view.html
└── es-ES/
    └── view.html

See test for more examples


Instead of a formal styleguide, take care to maintain the existing coding style.

Add unit tests for any new or changed functionality


Clone the repository

$ git clone && cd grunt-jade-i18n

Install dependencies

$ npm install

Run tests

$ npm test

Release History

  • 0.1.5 2013.01.07
    • Fix #4
  • 0.1.4 2013.01.03
    • Upgrade grunt-contrib-fade task dependency to 0.9.0
  • 0.1.3 2013.12.19
    • Fix #2
    • Fix #3
  • 0.1.2 2013.12.11
    • Fix locale bad formed name
  • 0.1.1 2013.12.10
    • Minor refactor
    • Improvements: avoid possible configuration issues with output file extensions
  • 0.1.0 2013.12.09
    • Initial release

To Do

Do you miss something? Open an issue or make a PR!



Copyright (c) 2013 Adesis Netlife S.L

Released under MIT license