babelfish
1.0.0
透過 Node.js 和瀏覽器的簡單語法進行國際化。
經典的解法使用多個短語來表示複數。 Babelfish
定義了內聯複數 - 這更緊湊,並且對程式設計師來說更容易。此外,短語被分組到嵌套範圍中,就像在 Ruby 中一樣。
BabelFish
支援 unicode CLDR 中的所有複數規則(透過plurals-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)。