Internationalization support for grunt.

This plugin requires Grunt ~0.4.0

Please note this is a coffeescript task and the sources are located in src folder, javascript is generated.

Run this task with the grunt i18n command. Task targets, files and options may be specified according to the grunt Configuring tasks guide.

This plugin provides a localization mechanism for grunt templates. It was developed as a tool for localizing AngularJS templates during a grunt build process. Since localization is done once during the build there is no performance hit on the application, as oppose to dynamic localization.

Please check the test as they demonstrate the usage pretty well. In short you need localization files and a HTML template/s. As an output you get one translated HTML template/s per localization file.

Available options to configure the task.

Type: String|Array

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

Type: String

Root output folder.

Type: String

Base folder for HTML templates which should not be preserved while translating. Please check the tests if you don't get it ;)

Type: String

Custom delimiters name to be used instead of the default <% %>. See the grunt.template documentation for more details.

Type: String

Supports 'json', 'yaml', 'transifex', 'properties'.

Locales from Transifex have all their translations below one root property, the name of the translation:

{
  "en_US": {
    "message": "Hello world!",
    "nested": {
      "msg": "and hello to you"
    }
  }
}

Type: Object

Custom parser to read locale files. There are 2 functions which have to be provided:

• resolveLocale: (localePath) -> locale - get locale from locale path
• readLocaleData: (localePath) -> data - read locale file

For example check src/parsers.coffee

• 2013-11-11   v0.7.0   Properties parser. Custom parsers
• 2013-12-31   v0.6.0   Transifex locale format added
• 2013-12-06   v0.5.0   Can read locals in yaml format
• 2013-11-29   v0.4.0   Custom delimiters and localization file existence checks
• 2013-10-23   v0.3.0   Fix for separator in output path. Add logging messages
• 2013-10-22   v0.2.0   Might be useful for others
• 2013-05-28   v0.1.0   Initial release, not really useful for anybody except me ;)