Slides from my presentation for #parisrb on the 6th Feb 2012

1. TRANSLATING RUBY OSS
Christopher Dell
@tigrish

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

3. SOME TRANSLATED PROJECTS

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

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

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

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

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

10. THE PROGRAMMER

11. THE PROGRAMMER
is involved in internationalization

12. THE PROGRAMMER
is involved in internationalization
i18n

14. THE TRANSLATOR

15. THE TRANSLATOR
is involved in localization

16. THE TRANSLATOR
is involved in localization
l10n

18. FIGHT!

20. heart will go
on edition
not a real project
celine-db

21. heart will go
on edition
not a real project
celine-db-i18n

23. What should our default
language be?

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

26. ✔

27. ✔
✔

28. ✔
✔
?

30. PROO00OOOOOT

32. All your base are belong
to en-US

34. Colour Colour
Localisation Localization

35. Colour Colour
Localisation Localization
Jam Jelly

36. Colour Colour
Localisation Localization
Jam Jelly
Jelly Jell-o

37. Colour Colour
Localisation Localization
Jam Jelly
Jelly Jell-o
06/02/2012 6th Feb 2012 2nd Jun 2012

38. LANGUAGES ≠LOCALES

40. Let’s use YAML for storage
and distribution

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

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

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

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

48. I18N-SPEC
github.com/tigrish/i18n-spec

49. I18N-SPEC
github.com/tigrish/i18n-spec
describe "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

50. I18N-SPEC
github.com/tigrish/i18n-spec
describe "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
Dir.glob('config/locales/*.yml') do |locale_file|
describe "a locale file" do
it_behaves_like 'a valid locale file', locale_file
end
end

51. I18N-SPEC
github.com/tigrish/i18n-spec

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

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

55. There’s a grammar
error !

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

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

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

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

61. CLDR
Unicode Common Locale Data Repository
cldr.unicode.org

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

63. CLDR

64. CLDR

65. CLDR
XML

66. CLDR
XML
Java

68. RUBY-CLDR
github.com/svenfuchs/ruby-cldr

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

70. if n % 10 == 1 && n % 100 != 11
:one
elsif [2, 3, 4].include?(n % 10) && ![12, 13, 14].include?(n % 100)
:few
elsif n % 10 == 0 || [5, 6, 7, 8, 9].include?(n % 10) || [11, 12, 13, 14].include?(n % 100)
:many
else
:other
end

71. if n % 10 == 1 && n % 100 != 11
:one
elsif [2, 3, 4].include?(n % 10) && ![12, 13, 14].include?(n % 100)
:few
elsif n % 10 == 0 || [5, 6, 7, 8, 9].include?(n % 10) || [11, 12, 13, 14].include?(n % 100)
:many
else
:other
end
0 : many 10 : many 20 : many 30 : many
1 : one 11 : many 21 : one 30.5 : other
2 : few 12 : many 22 : few
3 : few 13 : many 23 : few
4 : few 14 : many 24 : few
5 : many 15 : many 25 : many
6 : many 16 : many 26 : many
7 : many 17 : many 27 : many
8 : many 18 : many 28 : many
9 : many 19 : many 29 : many

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

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

74. <? 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

75. <? 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

76. v1.0

77. v1.0
celine-db-i18n

78. MANUAL

79. MANUAL
✓ Only use what you need

80. MANUAL
✓ Only use what you need
✓ Good translation visibility

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

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

83. BUNDLER

84. BUNDLER
✓ All locales included

85. BUNDLER
✓ All locales included
✓ Easy updates

86. BUNDLER
✓ All locales included X Memory usage
✓ Easy updates

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

88. LOCALE

89. LOCALE
✓ Good translation visibility

90. LOCALE
✓ Good translation visibility
✓ Easy updates

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

92. • 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