# I18n node

Super simple i18n library with express middleware and Mustache syntax.

## Installation

	$ npm install i18n-node

## Features

- Based on [Mustache](http://mustache.github.io/) syntax (full partials support)
- Reads translations from file system
- Simple
- Automatically detects locale
- Easy translation method
- Post processors

## Why

We wanted a simple i18n library built on top of the logic-less template syntax provided by [Mustache](http://mustache.github.io/). Most libraries use sprintf, which is awesome, but it requires a specific order of data, which isn't desirable in our case.

## Locales

All locales must conform to the locale format `ll_CC`, where ll is a two-letter language code, and CC is a two-letter country code. For instance, en_US represents U.S. English.

## Examples

An example of a locale file could be:

```json
{
	"common:hello": "Hello {{name}}!"
}
```

```js
var I18n = require('i18n-node');
var i18n = new I18n({
	directory: __dirname + '/locales/'
});
i18n.t('en_US', 'common:hello', {
	name: 'guest'
}); // => "Hello guest!"
```

### Using Middleware

```js
var I18n = require('i18n-node');
var express = require('express');
var app = express();
var i18n = new I18n({
	directory: __dirname + '/locales/'
});

app.configure(function () {
	app.use(i18n.middleware());
	app.use(app.router);
});

app.get('/', function (req, res) {
	res.send(req.t('common:hello', {
		name: 'guest'
	}));
});
```

## Future Stuff

- Singular/plural support
- Number formatting across locales taking imperial countries into account
- Unit tests!

Hope you like it!