babelfish Download - babelfish Quellcode herunterladen

babelfish

Anderer Quellcode

1.0.0

Herunterladen

BabelFish – menschenfreundliches i18n für JS

Internationalisierung mit einfacher Syntax für node.js und Browser.

Klassische Lösungen verwenden mehrere Phrasen für Pluralformen. Stattdessen definiert Babelfish Pluralformen inline – das ist kompakter und für Programmierer einfacher. Außerdem werden Phrasen wie in Ruby in verschachtelte Bereiche gruppiert.

BabelFish unterstützt alle Pluralregeln von Unicode CLDR (über plurals-cldr).

Installation

node.js:

$ npm install babelfish

Browser:

$ bower install babelfish

Verwenden Sie es5-shim für die Kompatibilität mit alten Browsern.

Phrasensyntax

#{varname} Gibt den Wert der Variablen wieder
((Singular|Plural1|Plural2)):count Pluralform

Beispiel:

А у меня в кармане #{nails_count} ((гвоздь|гвоздя|гвоздей)):nails_count

Sie können die Ankervariable für Pluralformen auch weglassen, standardmäßig ist sie count . Somit sind folgende Varianten gleichwertig:

I have #{count} ((nail|nails))
I have #{count} ((nail|nails)):count

Sie können Variablen auch im Plural verwenden:

I have ((#{count} nail|#{count} nails))

Benötigen Sie eine spezielle Nullform oder überschreiben Sie einen bestimmten Wert? Keine Probleme:

I have ((=0 no nails|#{count} nail|#{count} nails))

Escape-Zeichen

Wenn Sie #{ , (( , | oder )) irgendwo im Text benötigen, wo es als Markup-Teil betrachtet werden kann, maskieren Sie sie einfach mit .

Beispiel mit YAML

Da BabelFish die Bereiche reduziert, macht es wirklich Spaß und ist schön, Übersetzungen in YAML-Dateien zu speichern:

---
ru-RU :
  profile : Профиль
  forums : Форумы
  apps :
    forums :
      new_topic : Новая тема
      last_post :
        title : Последнее сообщение
        by : от
  demo :
    apples : " На столе лежит #{count} ((яблоко|яблока|яблок)) "

Verwendung

 // 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 ) ;