Internationalization (i18n) Copyright Quoin Inc/ 2016

Transcription

1 Internationalization (i18n) Copyright Quoin Inc/ 2016

2 Internationalization The process of extracting strings and other elements that may vary by location so they can customized for a specified locale.

3 i18n A Numeronym for internationalization where i is the first letter, n is the last letter, and 18 is the number of letters in between

4 i18n vs L10n L10n - localization From W3C Localization refers to the adaptation of a product, application or document content to meet the language, cultural and other requirements of a specific target market (a locale). Internationalization is the design and development of a product, application or document content that enableseasy localization for target audiences that vary in culture, region, or language.

5 Ruby on Rails Support The Rails framework has built in support for i18n. locale I18n.t - translate (used to translate strings in UI) I18n.l - localize (used to localize date formats)

6 Internationalization vs Localization from Rails docs The process of internationalization usually means to abstract all strings and other locale specific bits (such as date or currency formats) out of your application. The process of localization means to provide translations and localized formats for these bits.

7 locale Definition of the local environment parameters that affect the translations and rules used for tailoring the applications user interface Example locales en - English fr - French es - Spanish ar - Arabic

8 I18n.t Uses locale specific dictionaries to translate labels into display text. The application (html views, reports, other application code, etc) uses labels instead of the actual text. The translation logic provided by the Rails framework then uses the dictionary associated with the set locale to replace the label with the display text in the UI.

9

10 I18n.t use in a view

11 From the translation dictionary

12 I18n.l Uses format dictionaries to format locale specific elements such as dates, times, currency into the appropriate format for the current locale.

13

14 i18n.l - use in code

15 I18n.l

16 Setting locale in the application

17 Default locale We can configure a system to have a default locale.

18 Setting locale in tests

19 Right to Left vs. Left to Right Some languages such as Arabic read Right to Left instead of Left to Right When we set the locale, we also set the Right to Left based on the set = (I18n.locale == :ar? 'rtl' : 'ltr') Our styling framework Zurb Foundation has support for Right to Left

20 Translations in our forms We created a concern LocalizableProperty This will take a declared property and expand it out to handle the different locales. For example, if we declare a localized property display_text, this concern would expand it out to a _en, _fr, _es, _ar version to handle the different localized values It defines wrapper methods so the normal reference to that property (ex: referencing display_text will return the value appropriate for the current locale In our Field model, we declare several properties using this localize_properties

21

22

23

24

25 Select Options translations For select fields options, we use an id/display_text key/value pair We store the id on the record in the database We use the appropriate translated display_text to display in the UI

26

27

28 Transifex for Translations Transifex is a service that allows you to upload a dictionary and then have teams of translators translate that dictionary into other languages. You can then download their translations and use them in your project. We upload our English dictionary (en.yml) to Transifex to be translated into other languages. We can upload our configurable forms to Transifex to be translated. Transifex offers various pricing packages, but since Primero is open source, we can use a free Transifex account.

29

30

31

32

33

34

35

36

37

38

39 QUESTIONS????