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


Stories in Ready (WIP) get-translation Build Status

Effective translation workflow.

  • Updated translation keys from source.
  • Intuitive web translation interface.
  • Translate every translation problem you can think of.
  • CLI tool for updating and translating.
  • Support for multiple programming languages.

Today's translation problems

There is a lot of problem involved with translating an application today. Regardless of which languague it is written in. The main problems are maintenance, inefficent workflow and inability to translate complex translations.


  • A key got deleted from source. You have to yourself delete the key in all your localization files.
  • If a translation key got added to source. You have to youself add the key to all you localization files.
  • Translators often need to contact developers for translation.
  • Trouble to translate gender context. E.g. You gave him 5 coins
  • Trouble to translate multiple translation forms. Some languages don't just have singular and plural they have more than 2 plural forms.
  • Translators need to learn complex language syntax to solve complex translations. E.g. ICU.
  • Check this slides for more problems:

Getting started

Install get-translation npm install get-translation -g

Create a new project folder test and initialize a new translation project. The initialization guide will guide you through creating a project.

$ mkdir test
$ cd test
$ gt init

Now, create a source file test.js with (at least) the following code:

var firstnameLabel = gt('FIRSTNAME')
  , lastnameLabel = gt('LASTNAME')
  // Pass in variables 
  , age = 7
  , yourAgeIsLabel = gt('YOUR_AGE_IS', { age : age });
  // Pass in multiple variables 
  , cats = 2
  , dogs = 3
  , catsAndDogsLabel = gt('YOU_HAVE_NUMBER_OF_CATS_AND_DOGS', { cats : cats, dogs : dogs});

Now, lets update translation keys from source:

$ gt update

Lets check which translation keys have been added:

$ gt log

Edit the last translation using log reference:

$ gt edit %1 "Firstname" # using default langague
$ gt edit %1 --locale=zh "名" # using chinese

Translation are now saved to a localization file. To compile to your source programming language:

$ gt compile

Lets set up a web interface for translator to use:

$ gt interface



Copyright (c) 2014 Tingan Ho Licensed under the MIT license.