تنزيل babelfish - تنزيل كود المصدر babelfish

babelfish

شفرة المصدر الأخرى

1.0.0

تنزيل

BabelFish - i18n صديق للإنسان لـ JS

التدويل باستخدام بناء جملة سهل لـnode.js والمتصفح.

تستخدم الحلول الكلاسيكية عبارات متعددة لصيغ الجمع. يعرّف Babelfish صيغ الجمع المضمنة بدلاً من ذلك - وهذا أكثر إحكاما وسهل للمبرمجين. أيضًا، يتم تجميع العبارات في نطاقات متداخلة، كما هو الحال في روبي.

يدعم 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))

الهروب من الأحرف

إذا كنت بحاجة إلى #{ أو (( أو | أو )) في مكان ما في النص، حيث يمكن اعتباره جزءًا ترميزيًا - فما عليك سوى الهروب منها باستخدام .

مثال مع YAML

نظرًا لأن 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 ) ;