Talk presented at Rubyconf Brasil 2016

1. SHIPPING YOUR PRODUCT OVERSEAS
an i18n treasure guide to avoid monkey jobs.

2. dbusanello
dbusanello
dbusanello
diogo_0Diogo Busanello

4. RD Station

5. > 5000 Clients

6. World Domination

7. Culture Code: Lean

8. Specialized
Team

9. Back to
Basics
i18n

10. I18n.t('some.key') #translation
en:
some:
key: Value

11. Lazy lookup
en:
# (...)
rubyconf:
# (...)
talk:
hello: Hello Rubyconf!
# (...)
<!-- app/views/rubyconf/talk.html.erb -->
<%= t('.hello') %>

12. Scope
path = 'rubyconf.talk'
I18n.t('blank', scope: path)

13. Other Language
I18n.t('blank', scope: path, locale: :en)

14. Variables
<%= t('.sorry', name: 'Dave') %>
en:
rubyconf:
talk:
sorry: I’m sorry %{name}! I’m afraid I can’t do that.

15. Pluralize
<%= t('.email', count: @account.emails.count) %>
en:
email:
zero: You don’t have email.
one: You have one email.
few: You have some emails.
many: You have %{count} emails.

16. en:
(...)
description1: You were desconected.
description2: Try Again
description3: in a few moments
<%= t('.description1') %><strong><%= t('.description2') %></strong>
<%= t('.description3') %>

17. _html
<%= t('.description_html') %>
en:
(...)
description_html: You were desconected. <strong>
Try Again</strong> in a few moments

18. Link :(
<%= t('.description_html') %>
en:
(...)
description_html: Lorem ipsum dolor sit amet,
consectetur.<a href="/configuration"
target="_blank">Configuration</a>. Lorem ipsum!

19. description_html: <p>Get more information from your Lead and place
your brand using your own application in %{link}. Or creat...
configuration: Configuration
Link :D
<%= t('.description_html',
link: link_to( t('.configuration'), configuration_path,
{ target: "_blank" })) %>

20. The Journey
b e g i n s .
The GOOD

21. #1 DRY
#2 Automate if possible
#3 Identify Patterns (DRY)

22. Everything is keyed!
Now what?

23. #1 Translate
i18n-tasks
#2 Specs
i18n-specs

24. Choosing the language
class ApplicationController < ActionController::Base
before_action :set_locale
def set_locale
I18n.locale = account.language || I18n.default_locale
end
end

26. What we’ve
missed
The BAD

27. I18n-tasks
glebm/i18n-tasks

28. Librarian

29. Convention
over
Configuration

30. rails g scaffold landing_pages/page
create app/models/landing_pages/page.rb
create app/controllers/landing_pages/pages_controller.rb
create app/views/landing_pages/pages
create app/views/landing_pages/pages/index.html.erb
create app/views/landing_pages/pages/edit.html.erb
create app/views/landing_pages/pages/show.html.erb
create app/views/landing_pages/pages/new.html.erb

31. rails g scaffold landing_pages/page
create app/models/landing_pages/page.rb
create app/controllers/landing_pages/pages_controller.rb
create app/views/landing_pages/pages
create app/views/landing_pages/pages/index.html.erb
create app/views/landing_pages/pages/edit.html.erb
create app/views/landing_pages/pages/show.html.erb
create app/views/landing_pages/pages/new.html.erb
create config/locales/landing_pages/pages/index/en.yml
create config/locales/landing_pages/pages/index/pt-BR.yml
create config/locales/landing_pages/pages/edit/en.yml
create config/locales/landing_pages/pages/edit/pt-BR.yml

32. # config/locales/landing_pages/pages/index/en.yml
en:
landing_pages:
pages:
index:
hello: Hello Rubyconf!

33. The
UGLY

34. #1 I18n-js apdex on the roof
#2 Legacy
#3 The Forgotten

35. TIME TO TIME
TRAVEL
the mysteries of

36. class ApplicationController < ActionController::Base
around_action :set_time_zone, if: :current_user
def set_time_zone(&block)
Time.use_zone(current_user.timezone, &block)
end
end

37. Get Current Time
Correct
Time.zone.now
Time.current
Acceptable
Time.now.in_time_zone
DateTime.now.in_time_zone
Wrong
Time.now
DateTime.now

38. Correct
Time.zone.local(2012, 6, 10, 12, 00)
Wrong
Time.new(2012, 6, 10, 12, 00)
DateTime.new(2012, 6, 10, 12, 00)
Build Time

39. Correct
Time.zone.at(timestamp)
Acceptable
Time.at(timestamp).in_time_zone
Wrong
Time.at(timestamp)
Time From Timestamp

40. Correct
Time.zone.parse(str)
Time.zone.strptime(str, "%Y-%m-%d %H:%M")
Acceptable
DateTime.strptime(str, "%Y-%m-%d %H:%M %Z").in_time_zone
Wrong
Time.parse(str)
DateTime.strptime(str, "%Y-%m-%d %H:%M")
Parse Time

41. Don’t forget to
use
Time.zone

42. Rails will handle timezone for you.
Database will store the datetime
in UTC.
But how to GROUP BY Date?

43. def timezone_offset
Time.current.formatted_offset
end
def create_date_with_timezone(column_name = 'created_at')
"DATE(#{column_name}::TIMESTAMPTZ AT TIME ZONE INTERVAL " +
"'#{timezone_offset}'::INTERVAL) as #{column_name}_timezone"
end
SQL Level

44. WRAPPING UP

45. Go for scaffold locales
Break build if you forget a key or a
translation
Start thinking your features globally

46. THANK YOU!
we’re
h i r i n g
shipit.resultadosdigitais.com.br
diogobusanello@gmail.com