newspeak

Natural language localization for node.js and browserify

newspeak

This package is inspired by Mozilla's L20n project. In Mozilla's words:

L20n allows localizers to put small bits of logic into localization resources to codify the grammar of the language.

This includes different forms for plurals, gender and conjugation. Supporting languages such as Polish should become much easier.

Newspeak is diferrent in that the syntax is just JavaScript. A basic understanding of JS should be sufficient to get started. Not only has this the advantage of being easy, it's also very fast.

$ npm i --save newspeak
// Initialize newspeak. 
var newspeak = require('newspeak');
var l20n = newspeak({gender: 'male', name: 'Tobi'});
l20n.language('en_US');
 
// Add a language decision tree. 
var data = {
  usersfunction(obj) {
    if (0 === obj.count) return 'nobody';
    if (1 === obj.count) return 'someone';
    return '{{count}} people';
  }
}
l20n.add('en_US', data);
 
// Request a string based on parameters. 
l20n.get('users', {count: 3});
// => '3 people' 

Initializes an instance of newspeak. Takes an optional {Object} opts as an argument.

var newspeak = require('newspeak');
var l20n = newspeak({age: 13, foo: 'bar'});

Set a {String} language to access corresponding language strings. Emits a change event whenever the language changes, but not the first time it's set.

l20n.on('update', function(lang) {console.log(lang)});
 
l20n.language('en_US');
l20n.language('da_DK');
//=> 'sp' 

Store an {Object} opts to define configuration variables.

l20n.config({gender: 'male', name: 'Tobi'});

Register an {Object} data with language strings. Takes a {String} language and {Object} data as arguments. {Object} data can contain both functions and strings.

var data = {
  favorite_foodfunction(args) {
    if (args.mood == 'hungry') return "I'm {{mood}} and want pizza."
    if (args.mood == 'happy') return "I'm {{mood}} and want a salad."
  },
  favorite_color: 'green',
  user_gender: '{{gender}}'
}
l20n.add('en_US', data);

Remove an {Object} data from the store. Takes an {String} language and {Object} data as arguments. .remove() will traverse data keys 1 level deep.

l20n.remove('en_US', data);

Get a parsed {String} from the store. Takes a {String} query and {Object} opts as arguments.

l20n.get('favorite_food', {mood: happy});
// => "I'm happy and want a salad." 
 
l20n.get('favorite_color');
// => 'green' 
 
l20n.get('user_gender');
// => 'male' 

MIT