Интернационализация с простым синтаксисом для node.js и браузера.
Классические решения используют несколько фраз во множественном числе. Вместо этого Babelfish
определяет множественное число в строке — это более компактно и легко для программистов. Кроме того, фразы группируются во вложенные области видимости, как в Ruby.
BabelFish
поддерживает все правила множественного числа из CLDR Unicode (через множественное число-cldr).
узел.js:
$ npm install babelfish
браузер:
$ bower install babelfish
Используйте es5-shim для совместимости со старыми браузерами.
#{varname}
Отображает значение переменной.((Singular|Plural1|Plural2)):count
Форма множественного числапример:
А у меня в кармане #{nails_count} ((гвоздь|гвоздя|гвоздей)):nails_count
Вы также можете опустить переменную привязки для множественного числа, по умолчанию это будет count
. Таким образом, следующие варианты равнозначны:
I have #{count} ((nail|nails))
I have #{count} ((nail|nails)):count
Также вы можете использовать переменные во множественном числе:
I have ((#{count} nail|#{count} nails))
Нужна специальная нулевая форма или перезаписать какое-либо конкретное значение? Никаких проблем:
I have ((=0 no nails|#{count} nail|#{count} nails))
Если вам нужен #{
, ((
, |
или ))
где-то в тексте, где его можно рассматривать как часть разметки — просто экранируйте их с помощью .
Поскольку BabelFish сглаживает области видимости, хранить переводы в файлах YAML действительно весело и приятно:
---
ru-RU :
profile : Профиль
forums : Форумы
apps :
forums :
new_topic : Новая тема
last_post :
title : Последнее сообщение
by : от
demo :
apples : " На столе лежит #{count} ((яблоко|яблока|яблок)) "
// Create new instance of BabelFish with default language/locale: 'en-GB'
var BabelFish = require ( 'babelfish' ) ;
var i18n = new BabelFish ( 'en-GB' ) ;
// Fill in some phrases
i18n . addPhrase ( 'en-GB' , 'demo.hello' , 'Hello, #{user.name}.' ) ;
i18n . addPhrase ( 'en-GB' , 'demo.conv.wazup' , 'Whats up?' ) ;
i18n . addPhrase ( 'en-GB' , 'demo.conv.alright' , 'Alright, man!' ) ;
i18n . addPhrase ( 'en-GB' , 'demo.coerce' , 'Total: #{count}.' ) ;
i18n . addPhrase ( 'ru-RU' , 'demo.hello' , 'Привет, #{user.name}.' ) ;
i18n . addPhrase ( 'ru-RU' , 'demo.conv.wazup' , 'Как дела?' ) ;
i18n . addPhrase ( 'uk-UA' , 'demo.hello' , 'Здоровенькі були, #{user.name}.' ) ;
// Set locale fallback to use the most appropriate translation when possible
i18n . setFallback ( 'uk-UA' , 'ru-RU' ) ;
// Translate
var params = { user : { name : 'ixti' } } ;
i18n . t ( 'ru-RU' , 'demo.hello' , params ) ; // -> 'Привет, ixti.'
i18n . t ( 'ru-RU' , 'demo.conv.wazup' ) ; // -> 'Как дела?'
i18n . t ( 'ru-RU' , 'demo.conv.alright' ) ; // -> 'Alright, man!'
i18n . t ( 'uk-UA' , 'demo.hello' , params ) ; // -> 'Здоровенькі були, ixti.'
i18n . t ( 'uk-UA' , 'demo.conv.wazup' ) ; // -> 'Как дела?'
i18n . t ( 'uk-UA' , 'demo.conv.alright' ) ; // -> 'Alright, man!'
// When params is number or strings, it will be coerced to
// `{ count: XXX, value: XXX }` - use any of those in phrase.
i18n . t ( 'en-GB' , 'demo.coerce' , 5 ) ; // -> 'Total: 5.'
// You may wish to "dump" translations to load in browser later
// Dump will include all fallback translations and fallback rules
var locale_dump = i18n . stringify ( 'ru-RU' ) ;
var i18n_new = require ( 'babelfish' ) ( 'en-GB' ) ; // init without `new` also works
i18n_new . load ( locale_dump ) ;
// Use objects instead of strings (object/array/number/boolean) - can be
// useful to prepare bulk data for external libraries.
// Note, only JSON-supported types are ok (no date & regex)
i18n . addPhrase ( 'en-GB' , 'demo.boolean' , true ) ;
i18n . addPhrase ( 'en-GB' , 'demo.number' , 123 ) ;
i18n . addPhrase ( 'en-GB' , 'demo.array' , [ 1 , 2 , 3 ] ) ;
// fourth param required for hashes (objects) to disable flattening,
// other types are autodetected
i18n . addPhrase ( 'en-GB' , 'demo.array' , { foo : 1 , bar : "2" } , false ) ;
Просмотрите файл ЛИЦЕНЗИИ (MIT).