Translating ruby OSS

TRANSLATING RUBY OSS Christopher Dell @tigrish

DISCLAIMER WOW!I cofounded this Try it, it’s awesome! http://www.localeapp.com

SOME TRANSLATED PROJECTS

SOME TRANSLATED PROJECTS Gems- rails- devise- will-paginate

SOME TRANSLATED PROJECTS Gems Apps- rails - ChiliProject- devise - Spree- will-paginate - LocomotiveCMS

SOME TRANSLATED PROJECTS Gems Apps CLIs- rails - ChiliProject - remarkable- devise - Spree -?- will-paginate - LocomotiveCMS

SOME TRANSLATED PROJECTS Gems Apps CLIs- rails - ChiliProject - remarkable- devise - Spree -?- will-paginate - LocomotiveCMS i18n gem

THE TERRIBLE TWO Terrance Phillip“the translator” “the programmer”

THE PROGRAMMER

THE PROGRAMMERis involved in internationalization

THE PROGRAMMERis involved in internationalization i18n

THE TRANSLATOR

THE TRANSLATOR is involved in localization

THE TRANSLATOR is involved in localization l10n

FIGHT!

heart will go on editionnot a real project celine-db

heart will go on editionnot a real project celine-db-i18n

What should our default language be?

What should our default language be? ...probably English

✔ ✔

✔ ✔ ?

PROO00OOOOOT

All your base are belong to en-US

Colour ColourLocalisation Localization

Colour ColourLocalisation LocalizationJam Jelly

Colour ColourLocalisation LocalizationJam JellyJelly Jell-o

Colour Colour Localisation Localization Jam Jelly Jelly Jell-o06/02/2012 6th Feb 2012 2nd Jun 2012

LANGUAGES ≠LOCALES

Let’s use YAML for storage and distribution

Let’s use YAML for storage and distribution• Ruby std lib

Let’s use YAML for storage and distribution• Ruby std lib• Used by i18n’s Simple Backend

Let’s use YAML for storage and distribution• Ruby std lib• Used by i18n’s Simple Backend• Text ﬁle, simple structure

/lib/ruby/1.9.2/psych.rb:148:in `parse: couldnt parse YAML at line 182 column 9 (Psych::SyntaxError)

I18N-SPECgithub.com/tigrish/i18n-spec

I18N-SPEC github.com/tigrish/i18n-specdescribe "config/locales/en.yml" do it { should be_parseable } it { should have_valid_pluralization_keys } it { should have_one_top_level_namespace } it { should be_named_like_top_level_namespace } it { should_not have_legacy_interpolations }end

I18N-SPEC github.com/tigrish/i18n-specdescribe "config/locales/en.yml" do it { should be_parseable } it { should have_valid_pluralization_keys } it { should have_one_top_level_namespace } it { should be_named_like_top_level_namespace } it { should_not have_legacy_interpolations }endDir.glob(config/locales/*.yml) do |locale_file| describe "a locale file" do it_behaves_like a valid locale file, locale_file endend

I18N-SPECgithub.com/tigrish/i18n-spec

I18N-SPEC github.com/tigrish/i18n-specdescribe "config/locales/fr.yml" do it { should be_a_subset_of ‘config/locales/en.yml’ }end

I18N-SPEC github.com/tigrish/i18n-specdescribe "config/locales/fr.yml" do it { should be_a_subset_of ‘config/locales/en.yml’ }enddescribe "config/locales/fr.yml" do it { should be_a_complete_translation_of ‘config/locales/en.yml’ }end

There’s a grammar error !

There’s a grammar error ! In French, the phrase :“1.2 regards fataux” should be : “1.2 regard fatal”

<?= t(:regard_fatal, :count => 1.2) ?>

<?= t(:regard_fatal, :count => 1.2) ?>regard_fatal: one: 1 regard fatal other: %{count} regards fataux

<?= t(:regard_fatal, :count => 1.2) ?> WTF?regard_fatal: one: 1 regard fatal other: %{count} regards fataux

CLDRUnicode Common Locale Data Repository cldr.unicode.org

CLDRUnicode Common Locale Data Repository cldr.unicode.org • Dates, Times, Time Zones • Numbers, Currencies • Sorting • Languages, Countries • Pluralizations • Charsets, Collations • Transliterations

CLDRXML

CLDRXMLJava

RUBY-CLDRgithub.com/svenfuchs/ruby-cldr

data/fr/plurals.rb{ :fr => { :i18n => { :plural => { :keys => [:one, :other], :rule => lambda { |n| n.between?(0, 2) && n != 2 :one : :other } } } }}

if n % 10 == 1 && n % 100 != 11 :oneelsif [2, 3, 4].include?(n % 10) && ![12, 13, 14].include?(n % 100) :fewelsif n % 10 == 0 || [5, 6, 7, 8, 9].include?(n % 10) || [11, 12, 13, 14].include?(n % 100) :manyelse :otherend

if n % 10 == 1 && n % 100 != 11 :oneelsif [2, 3, 4].include?(n % 10) && ![12, 13, 14].include?(n % 100) :fewelsif n % 10 == 0 || [5, 6, 7, 8, 9].include?(n % 10) || [11, 12, 13, 14].include?(n % 100) :manyelse :otherend0 : many 10 : many 20 : many 30 : many1 : one 11 : many 21 : one 30.5 : other2 : few 12 : many 22 : few3 : few 13 : many 23 : few4 : few 14 : many 24 : few5 : many 15 : many 25 : many6 : many 16 : many 26 : many7 : many 17 : many 27 : many8 : many 18 : many 28 : many9 : many 19 : many 29 : many

kittens: zero: Sorry, no kittens other: %{count} kittens

<? if kittens.size > 0 ?> <?= t :kittens,kittens: :count => kittens.size ?%> zero: Sorry, no kittens <? else ?> other: %{count} kittens <?= t :no_kittens ?%> <? end ?>

<? if kittens.size > 0 ?> <?= t :kittens,kittens: :count => kittens.size ?%> zero: Sorry, no kittens <? else ?> other: %{count} kittens <?= t :no_kittens ?%> <? end ?>kittens: one: One kitten other: %{count} kittens

<? if kittens.size > 0 ?> <?= t :kittens,kittens: :count => kittens.size ?%> zero: Sorry, no kittens <? else ?> other: %{count} kittens <?= t :no_kittens ?%> <? end ?>kittens: kittens: one: One kitten one: %{count} kitten other: %{count} kittens other: %{count} kittens

v1.0celine-db-i18n

MANUAL

MANUAL✓ Only use what you need

MANUAL✓ Only use what you need✓ Good translation visibility

MANUAL✓ Only use what you need X Need to repeat for each additional locale✓ Good translation visibility

MANUAL✓ Only use what you need X Need to repeat for each additional locale✓ Good translation visibility X Need to repeat with each update

BUNDLER

BUNDLER✓ All locales included

BUNDLER✓ All locales included✓ Easy updates

BUNDLER✓ All locales included X Memory usage✓ Easy updates

BUNDLER✓ All locales included X Memory usage✓ Easy updates X Load path issues

LOCALE

LOCALE✓ Good translation visibility

LOCALE✓ Good translation visibility✓ Easy updates

LOCALE✓ Good translation visibility X Small selection of libraries✓ Easy updates

• locale : http://www.localeapp.com/• i18n : https://github.com/svenfuchs/i18n• rails-i18n : https://github.com/svenfuchs/rails-i18n• i18n-spec : https://github.com/tigrish/i18n-spec• cldr : http://cldr.unicode.org/• ruby-cldr : https://github.com/svenfuchs/ruby-cldr• devise-i18n : https://github.com/tigrish/devise-i18n• will-paginate-i18n : https://github.com/tigrish/will-paginate-i18n

Translating ruby OSS

by Christopher Dell on Feb 07, 2012

Accessibility

Categories

Tags

Upload Details

Usage Rights

1 Embed 72

Statistics

Translating ruby OSS — Presentation Transcript