atma-i18n

Localization Module (NodeJS and Browser)

• MaskJS Localization Util
• Localization Function

Node.js

Resolve language from the current request(middleware)

Browser

Resolve language from navigator.language or location.query ('/?language=en')

If the language is not supported, the default one is taken.

Formatter

Atma-Formatter is used to format/interpolate strings.

Pluralization

Refer to the atma-formatter.

Usage

Mask Util

~[L: ID [,...expressions]] ~[L: (expression) [,...expressions]]

• Simple: ~[L:fooId]

• Formatting:

  Example:

  	header > '~[L:welcomeId, name]'
  	// same as
  	header > '~[L:"welcomeId", name]'
  

  $L.extend('en', {
  	welcome: 'Hello {0}!'
  });
  mask.render(template, { name: 'Baz' });
  

• get i18n ID from model: Example:

  	var menu = [ 'todo', 'task' ]
  	ul {
  		for (item of menu) {
  			li > '~[L:("m_" + item)]'
  		}
  	}
  

  $L.extend('en', {
  	m_todo: 'My Todos',
  	m_task: 'My Tasks'
  });
  mask.render(template);
  

Function

Browser @see examples

	$L('titleHello');

Node

	connect
		.use($L.middleware({
			support: [ 'en', 'de', 'ru' ],
			path: '/public/localization/%%.json'
		});
	// Aftewards each `req` has `$L` function.
	// Or use direct
	$L.fromReq(req)('id');

Configuration

IncludeJS

Browser

Load this library with IncludeJS - after defining the list of supported languages and the path to translations, it will load also supported translations

include
	.embed('/atma/localization.js?path=/public/i18n/%%.json&langs=de,it,fr')
	.done(function(){
		// appropriate translationis is loaded and ready to use
		$L('welcome', 'Baz')
	});
	

NodeJS

Use the middleware function so that not all translations are loaded at once, but only with the first incomming request.

(c) MIT, Atma.js Project