// load modules 
var express = require('express'),
    i18n = require("i18n");

i18n.configure({
    locales:['en', 'de'],
    directory: __dirname + '/locales'
});

var greeting = i18n.__('Hello');

// Configuration 
app.configure(function() {
 
    [...]
 
    // default: using 'accept-language' header to guess language settings 
    app.use(i18n.init);
 
    [...]
});

app.get('/de', function(req, res){
  var greeting = res.__('Hello');
});

app.use(express.static(__dirname + '/www'));
app.use('/en', express.static(__dirname + '/www'));
app.use('/de', express.static(__dirname + '/www'));

i18n.configure({
    locales:['en', 'de'],
    directory: __dirname + '/locales'
});

i18n.configure({
    directory: __dirname + '/locales'
});

i18n.configure({
    // setup some locales - other locales default to en silently 
    locales:['en', 'de'],
 
    // fall back from Dutch to German 
    fallbacks:{'nl': 'de'},
 
    // you may alter a site wide default locale 
    defaultLocale: 'de',
 
    // sets a custom cookie name to parse locale settings from - defaults to NULL 
    cookie: 'yourcookiename',
 
    // query parameter to switch locale (ie. /home?lang=ch) - defaults to NULL 
    queryParameter: 'lang',
 
    // where to store json files - defaults to './locales' relative to modules directory 
    directory: './mylocales',
 
    // controll mode on directory creation - defaults to NULL which defaults to umask of process user. Setting has no effect on win. 
    directoryPermissions: '755',
 
    // watch for changes in json files to reload locale on updates - defaults to false 
    autoReload: true,
 
    // whether to write new locale information to disk - defaults to true 
    updateFiles: false,
 
    // sync locale information accros all files - defaults to false 
    syncFiles: false,
 
    // what to use as the indentation unit - defaults to "\t" 
    indent: "\t",
 
    // setting extension of json files - defaults to '.json' (you might want to set this to '.js' according to webtranslateit) 
    extension: '.js',
 
    // setting prefix of json files name - default to none '' (in case you use different locale files naming scheme (webapp-en.json), rather then just en.json) 
    prefix: 'webapp-',
 
    // enable object notation 
    objectNotation: false,
 
    // setting of log level DEBUG - default to require('debug')('i18n:debug') 
    logDebugFn: function (msg) {
        console.log('debug', msg);
    },
 
    // setting of log level WARN - default to require('debug')('i18n:warn') 
    logWarnFn: function (msg) {
        console.log('warn', msg);
    },
 
    // setting of log level ERROR - default to require('debug')('i18n:error') 
    logErrorFn: function (msg) {
        console.log('error', msg);
    },
 
    // object or [obj1, obj2] to bind the i18n api and current locale to - defaults to null 
    register: global,
 
    // hash to specify different aliases for i18n's internal methods to apply on the request/response objects (method -> alias). 
    // note that this will *not* overwrite existing properties with the same name 
    api: {
      '__': 't',  //now req.__ becomes req.t 
      '__n': 'tn' //and req.__n can be called as req.tn 
    }
});

res.cookie('yourcookiename', 'de', { maxAge: 900000, httpOnly: true });

var anyObject = {};
 
i18n.configure({
  locales: ['en', 'de'],
  register: anyObject
});
 
anyObject.setLocale('de');
anyObject.__('Hallo'); // --> Hallo` 

i18n.configure({
  locales: ['en', 'de'],
  register: global
});
 
i18n.setLocale('de');
__('Hello'); // --> Hallo` 

var app = express();
app.use(cookieParser());
app.use(i18n.init);

{
  req: {
    locals: {},
    res: {
      locals: {},
    }
  }
}

{
  req: {
    locals: {
      locale: "de",
      __: [function],
      __n: [function],
      [...]
    },
    res: {
      locals: {
        locale: "de",
        __: [function],
        __n: [function],
        [...]
      },
      locale: "de",
      __: [function],
      __n: [function],
      [...]
    },
    locale: "de",
    __: [function],
    __n: [function],
    [...]
  }
}

// template and global (this.locale == 'de') 
__('Hello'); // Hallo 
__('Hello %s', 'Marcus'); // Hallo Marcus 
__('Hello {{name}}', { name: 'Marcus' }); // Hallo Marcus 
 
// scoped via req object (req.locale == 'de') 
req.__('Hello'); // Hallo 
req.__('Hello %s', 'Marcus'); // Hallo Marcus 
req.__('Hello {{name}}', { name: 'Marcus' }); // Hallo Marcus 
 
// scoped via res object (res.locale == 'de') 
res.__('Hello'); // Hallo 
res.__('Hello %s', 'Marcus'); // Hallo Marcus 
res.__('Hello {{name}}', { name: 'Marcus' }); // Hallo Marcus 
 
// passing specific locale 
__({phrase: 'Hello', locale: 'fr'}); // Salut 
__({phrase: 'Hello %s', locale: 'fr'}, 'Marcus'); // Salut Marcus 
__({phrase: 'Hello {{name}}', locale: 'fr'}, { name: 'Marcus' }); // Salut Marcus 

// short syntax is best suited for reading 
// --> writes '%s cat' to both `one` and `other` plurals 
__n('%s cat', 1) // --> 1 Katze 
__n('%s cat', 3) // --> 3 Katzen 
 
// long syntax works fine in combination with `updateFiles` 
// --> writes '%s cat' to `one` and '%s cats' to `other` plurals 
// "one" (singular) & "other" (plural) just covers the basic Germanic Rule#1 correctly.  
__n("%s cat", "%s cats", 1); // 1 Katze 
__n("%s cat", "%s cats", 3); // 3 Katzen 
 
// scoped via req object (req.locale == 'de') 
req.__n("%s cat", 1); // 1 Katze 
req.__n("%s cat", 3); // 3 Katzen 
 
// scoped via res object (res.locale == 'de') 
res.__n("%s cat", 1); // 1 Katze 
res.__n("%s cat", 3); // 3 Katzen 
 
// passing specific locale 
__n({singular: "%s cat", plural: "%s cats", locale: "fr"}, 1); // 1 chat 
__n({singular: "%s cat", plural: "%s cats", locale: "fr"}, 3); // 3 chat 
 
// the all in one object signature 
__n({singular: "%s cat", plural: "%s cats", locale: "fr", count: 1}); // 1 chat 
__n({singular: "%s cat", plural: "%s cats", locale: "fr", count: 3}); // 3 chat 

__n('%s dog', 1)

__n('%s kitty', '%s kittens', 0)

__n('%s cat', 0); // --> 0 кошек 
__n('%s cat', 1); // --> 1 кошка 
__n('%s cat', 2); // --> 2 кошки 
__n('%s cat', 5); // --> 5 кошек 
__n('%s cat', 6); // --> 6 кошек 
__n('%s cat', 21); // --> 21 кошка 

// assume res is set to german 
res.setLocale('de');
 
// start simple 
res.__mf('Hello'); // --> Hallo 
 
// can replace too 
res.__mf('Hello {name}', { name: 'Marcus' }) // --> Hallo Marcus 
 
// and combines with sprintf 
res.__mf('Hello {name}, how was your %s?', 'test', { name: 'Marcus' }) // --> Hallo Marcus, wie war dein test? 
 
// now check out a plural rule 
res.__mf('{N, plural, one{# cat} few{# cats} many{# cats} others{# cats}}', {N: 1})
 
// results for "1" in   (all use "one") 
// en --> 1 cat 
// de --> 1 Katze 
// fr --> 1 chat 
// ru --> 1 кошка       ru uses "__one__" when ending on "1" 
 
// results for "0" in   (most use "others") 
// en --> 0 cats 
// de --> 0 Katzen 
// fr --> 0 chat        fr uses "__one__" for zero 
// ru --> 0 кошек       ru uses "__many__" 
 
// results for "2" in   (most use "others") 
// en --> 2 cat 
// de --> 2 Katze 
// fr --> 2 chat 
// ru --> 2 кошки       ru uses "__few__" when ending on "1" 
 
// results for "5" in   (most use "others") 
// en --> 5 cat 
// de --> 5 Katze 
// fr --> 5 chat 
// ru --> 5 кошек       ru uses "__many__" 
 
// results for "21" in  (most use "others") 
// en --> 21 cat 
// de --> 21 Katze 
// fr --> 21 chat 
// ru --> 21 кошка       ru uses "__one__" when ending on "1" 

i18n.__l('Hello'); // --> [ 'Hallo', 'Hello' ] 

// this will match routes 
// EN --> /:locale/products/:id? 
// ES --> /:locale/productos/:id? 
app.get( __l('/:locale/products/:id?'), function (req, res) {
    // guess what you might use req.params.locale for? 
});

i18n.__h('Hello'); // --> [ { de: 'Hallo' }, { en: 'Hello' } ] 

setLocale('de');
setLocale(req, 'de');
req.setLocale('de');

i18n.setLocale(req, 'ar'); // --> req: مرحبا res: مرحبا res.locals: مرحبا 
i18n.setLocale(res, 'ar'); // --> req: Hallo res: مرحبا res.locals: مرحبا 
i18n.setLocale(res.locals, 'ar'); // --> req: Hallo res: Hallo res.locals: مرحبا 

i18n.setLocale([req, res.locals], req.params.lang); // --> req: مرحبا res: Hallo res.locals: مرحبا 

i18n.setLocale(res, 'ar', true); // --> req: Hallo res: مرحبا res.locals: Hallo 

getLocale(); // --> de 
getLocale(req); // --> de 
req.getLocale(); // --> de 

getCatalog(); // returns all locales 
getCatalog('de'); // returns just 'de' 
 
getCatalog(req); // returns current locale of req 
getCatalog(req, 'de'); // returns just 'de' 
 
req.getCatalog(); // returns current locale of req 
req.getCatalog('de'); // returns just 'de' 

app.use(function(req, res, next) {
    // express helper for natively supported engines 
    res.locals.__ = res.__ = function() {
        return i18n.__.apply(req, arguments);
    };
 
    [...]
 
    next();
});

// register helper as a locals function wrapped as mustache expects 
app.use(function (req, res, next) {
    // mustache helper 
    res.locals.__ = function () {
      return function (text, render) {
        return i18n.__.apply(req, arguments);
      };
    };
 
    [...]
 
    next();
});

var greeting = __('Hello %s, how are you today?', 'Marcus');

var greeting = __('Hello %s, how are you today? How was your %s.', 'Marcus', __('weekend'));

var example = __('%1$s, %1$s, %1$s', 'repeat');

var example = __('%2$d then %1$s then %3$.2f', 'First', 2, 333.333);

var greeting = __('Hello {{name}}, how are you today?', { name: 'Marcus' });

var greeting = __('Hello {{name}}, how was your %s.', __('weekend'), { name: 'Marcus' });

var greeting = __( __('Hello {{name}}, how was your %s?', { name: 'Marcus' }), __('weekend') );

var singular = __n('%s cat', '%s cats', 1);
var plural = __n('%s cat', '%s cats', 3);

var singular = __n('There is one monkey in the %%s', 'There are %d monkeys in the %%s', 1, 'tree');
var plural = __n('There is one monkey in the %%s', 'There are %d monkeys in the %%s', 3, 'tree');

__n('%s cat', 1) // --> 1 Katze 
__n('%s cat', 3) // --> 3 Katzen 

__n('dogs', 0) // --> no dog 
__n('dogs', 1) // --> one dog 
__n('dogs', 2) // --> some dogs 
__n('dogs', 10) // --> many dogs 
__n('dogs', 25) // --> dozens of dogs 
__n('dogs', 42) // --> a horde of 42 dogs 
__n('dogs', 199) // --> too many dogs 

// interval matched by number 
__n('dogs', 0) // --> no dog 
__n('dogs', 1) // --> one dog 
__n('dogs', 2) // --> less than ten dogs 
__n('dogs', 9) // --> less than ten dogs 
__n('dogs', 10) // --> less than 20 dogs 
__n('dogs', 19) // --> less than 20 dogs 
__n('dogs', 20) // --> too many dogs 
__n('dogs', 199) // --> too many dogs 
 
// no interval returned, but found a catchall 
__('dogs') // --> too many dogs 

// will always use a found catchall 
__('example', {me: 'marcus'}) // --> and a catchall rule for marcus to get my number %s 
__('example', ['one'], {me: 'marcus'}) // --> and a catchall rule for marcus to get my number one 
 
// will search a matching interval or fallback to catchall 
__n('example', 1, {me: 'marcus'}) // --> and a catchall rule for marcus to get my number 1 
__n('example', 2, {me: 'marcus'}) // --> 2 is between two and five for marcus 
__n('example', 5, {me: 'marcus'}) // --> 5 is between two and five for marcus 
__n('example', 3, {me: 'marcus'}) // --> 3 is between two and five for marcus 
__n('example', 6, {me: 'marcus'}) // --> and a catchall rule for marcus to get my number 6 

var greetings = ['Hi', 'Hello', 'Howdy'];
for (var i=0; i < greetings.length; i++) {
    console.log( __(greetings[i]) );
};

"greeting": {
    "formal": "Hello",
    "informal": "Hi",
    "placeholder": {
        "formal": "Hello %s",
        "informal": "Hi %s"
    }
}

"greeting": {
    "formal": "greeting.formal",
    "informal": "greeting.informal"
}

__("greeting.formal:Hello")
__("greeting.placeholder.informal:Hi %s")