https://github.com/dominictobias/i18n-simple
A simple, fast, opinionated but flexible string translator for NodeJS
https://github.com/dominictobias/i18n-simple
Last synced: 27 days ago
JSON representation
A simple, fast, opinionated but flexible string translator for NodeJS
- Host: GitHub
- URL: https://github.com/dominictobias/i18n-simple
- Owner: dominictobias
- License: mit
- Created: 2014-05-28T21:30:44.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2014-07-15T08:07:51.000Z (almost 11 years ago)
- Last Synced: 2025-03-19T23:36:12.166Z (about 1 month ago)
- Language: JavaScript
- Size: 211 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# i18n-simple
i18n-simple is a fast, simple yet powerful string translator. It's goal is to put the focus back on rock solid string translation without providing logic to set the language according to cookies or query strings - the implementation is up to you.
## Translation file format
Your translations should be:
- `.js` files using node module export
- Valid javascript objects
- Support for `{1}`, `{2}` style tokens out the box
- By default they go in a `locale/` folder located next to your server start script, e.g. `locale/en-US.js`
module.exports = {
site: {
title: 'My Site',
description: 'A site that is all mine'
},
bankBalance: 'Hi {1}, your balance is {2}',
};
## Setup
// Require in the module.
var i18n = require('i18n-simple');
// Initialize the module.
i18n.init([options]); // See Options section
// Use the module.
i18n.t('site.title'); // Returns 'My Site'
i18n.t('bankBalance', 'Bob', -1203); // Returns 'Hi Bob, your balance is -1203'
## Options
It is recommended you list your available languages with the `supportedLangs` option to save the module having to make a file I/O check.
i18n.init({
localePath: __dirname + 'i18n/', // Defaults to locale/.
fallbackLang: 'en-GB', // If lang and fallbackPrefs didn't exist or failed.
supportedLangs: ['en-GB', 'pt-BR', 'pt-PT'], // Avoid file I/O checks.
setLang: 'en-GB', // Set the initial language.
tplLookupName: 'l' // Default template helper name for translate method is `$`.
});
You might have an app which isn't aware of supported languages, or tries to set the language according to a query string, http header or cookie. In this case you can set a fallback preference:
i18n.init({
fallbackLang: 'en-GB',
fallbackPrefs: {
'pt-BR': ['pt-PT']
}
});
If Brazilian portuguese doesn't exist the app will fallback to portuguese before finally loading the fallbackLang (if defined).
## API
**setLang(name)**
Set the current language. This is the file name minus the extension e.g. `en-US`.
**t(format, [args])**
Translate a string e.g. `i18n.t('site.title')` or `i18n.t('bankBalance', 'Bob', '$67')`.
**lookup(lookupStr)**
This is the internal lookup method before tokens are translated. Useful if you want to override `t` method to do your own token parsing.
## Connect/Express middleware
If you want to use the translate method in templates run this middleware before your routes:
app.use(i18n.helpers);
In Handlebars for example you can now translate in your template like so:
Site title is: {{$ 'site.title'}}
Your bank balance: {{$ 'bankBalance' 'Bob' '$14,461'}}
## Yo Dawg. I hear you like lookups in your lookups?
There is a special syntax for instances where you want tokens to resolve to another lookup:
transports: {
yacht: 'Yacht',
bike: 'Bike'
},
modeOfTransport: 'Your preferred mode of transport is by {0}'
i18n.t('modeOfTransport', '{transports.yacht}'); // 'Your preferred mode of transport is by Yacht'
## Roadmap
- Make it compatible with frontend
- Make input reading generic/extensible and provide examples for json, requirejs, redis and memcached
- Function for plurals? e.g. `i18n.tp('There is {0} cat', 'There are {0} cats', 2)`?
## Contributors
[Michal Kot](https://github.com/michalkot)