Locos x Rails

I18n
Rails Globalization

Tuesday, April 7, 2009

Fabio Akita
AkitaOnRails.com


Tutorial-like


I18n Before 2.2


Chaos


Monkey Patch
Approach


Many
incompatible
projects


Reinventing the
Wheel all the time


September 2007


Rails I18n Project


Lead from
Sven Fuchs
adva-cms.org


Every plugin
creator gathered


Common Goals:


100% swappable


The Least
Denominator


Not a full blown
L10n solution


Common,
Powerful API


Simple Backend
(en_US only)


Getting Started ...


rails locos


rails locos

./script/generate nifty_layout


rails locos

./script/generate nifty_layout

./script/generate nifty_scaffold Contact
name:string email:string phone:string
mobile:string


Getting i18n files


config/locales/pt-BR_rails.yml


config/locales/pt-BR.rb


>> I18n.locale = :en



>> I18n.translate quot;helloquot;
=> quot;Hello worldquot;



>> I18n.translate quot;helloquot;

>> I18n.localize Time.now
=> quot;Wed, 01 Apr 2009 22:52:08 -0300quot;



>> I18n.t quot;helloquot;

>> I18n.l Time.now
=> quot;Wed, 01 Apr 2009 22:52:08 -0300quot;


>> I18n.locale = :quot;pt-BRquot;



=> quot;Alo Mundoquot;




>> I18n.l Time.now
=> quot;Quarta, 01 de Abril de 2009, 22:49 hsquot;




>> I18n.l Time.now
=> quot;Quarta, 01 de Abril de 2009, 22:49 hsquot;

>> I18n.l Time.now,
:format => :short
=> quot;01/04, 22:52 hsquot;


>> time_ago_in_words(1.month.ago)
=> quot;about 1 monthquot;
>> time_ago_in_words(1.5.hours.ago)
=> quot;about 2 hoursquot;


=> quot;about 1 monthquot;
=> quot;about 2 hoursquot;


=> quot;aproximadamente 1 mêsquot;
=> quot;aproximadamente 2 horasquot;


>> I18n.t [:hello, :world]
=> [quot;aloquot;, quot;mundoquot;]


>> I18n.t [:hello, :world]
=> [quot;aloquot;, quot;mundoquot;]

>> I18n.t :brazil,
:defaults => [:argentina, quot;Chilequot;]
=> quot;Argentinaquot;


message: quot;Hello, {{name}}!quot;



I18n.t :message, :name => quot;Johnquot;
# => quot;Hello John!quot;




# en-US
:days => {
:one => quot;one dayquot;
:other => quot;{{count}} daysquot;
}




# en-US
:days => {
:one => quot;one dayquot;
:other => quot;{{count}} daysquot;
}

I18n.t :days, :count => 1 # => quot;one dayquot;
I18n.t :days, :count => 2 # => quot;2 daysquot;


Extracting Strings


app/views/contacts/views/index.html.erb

<tr>
<th>Name</th>
<th>Email</th>
<th>Phone</th>
<th>Mobile</th>
</tr>

<tr>
<th>Name</th>
<th>Email</th>
<th>Phone</th>
<th>Mobile</th>
</tr>

{
:quot;pt-BRquot; => {
:hello => quot;Alô Mundoquot;,

:contacts => {
:index => {
<tr>
:name => quot;Nomequot;,
<th>Name</th>
:email => quot;Emailquot;,
<th>Email</th>
:phone => quot;Telefonequot;,
<th>Phone</th>
:mobile => quot;Celularquot;
<th>Mobile</th>
}
</tr>
}
}
}

<tr>
<th><%= t(quot;contacts.index.namequot;) %></th>
<th><%= t(quot;index.emailquot;, :scope => quot;contactsquot;) %></th>
<th><%= t(quot;phonequot;, :scope => quot;contacts.indexquot;) %></th>
<th><%= t(quot;.mobilequot;) %></th>
</tr>

config/locales/en.yml

en:
hello: quot;Hello worldquot;

contacts:
index:
name: Name
email: Email
phone: Phone
mobile: Mobile


Setting Locale


app/controllers/application_controller.rb

class ApplicationController < ActionController::Base
helper :all
protect_from_forgery

before_filter :set_locale

private

def set_locale
I18n.locale = params[:locale] if params[:locale]
end
end

More strings


<td><%= link_to t(quot;common.showquot;), contact %></td>
<td><%= link_to t(quot;common.editquot;),
edit_contact_path(contact) %></td>
<td><%= link_to t(quot;common.destroyquot;), contact,
:confirm => t('common.destroy_confirm'),
:method => :delete %></td>


{
:quot;pt-BRquot; => {
:hello => quot;Alô Mundoquot;,

:common => {
:show => quot;Mostrarquot;,
:edit => quot;Editarquot;,
:destroy => quot;Apagarquot;,
:destroy_confirm => quot;Tem certeza?quot;
},

...
}
}


config/locales/en.yml

en:
hello: quot;Hello worldquot;

common:
show: Show
edit: Edit
destroy: Destroy
destroy_confirm: Are you sure?

...


ActiveRecord


<% form_for @contact do |f| %>
<%= f.error_messages %>

<%= f.label :name %> 
<%= f.text_field :name %>


<%= f.label :email %> 
<%= f.text_field :email %>


<%= f.label :phone %> 
<%= f.text_field :phone %>


<%= f.label :mobile %> 
<%= f.text_field :mobile %>

<%= f.submit t(quot;common.submitquot;) %>
<% end %>

...
:activerecord => {
:models => {
:contact => quot;Contatoquot;
},
:attributes => {
:contact => {
:name => quot;Nomequot;,
:email => quot;Emailquot;,
:phone => quot;Telefonequot;,
:mobile => quot;Celularquot;
}
}
}
...


./script/plugin install git://github.com/iain/i18n_label.git


app/views/contacts/views/show.html.erb


Name:
<%=h @contact.name %>


Email:
<%=h @contact.email %>


Phone:
<%=h @contact.phone %>


Mobile:
<%=h @contact.mobile %>

app/views/contacts/views/show.html.erb


<%= Contact.human_attribute_name('name') %>:
<%=h @contact.name %>


<%= Contact.human_attribute_name('email') %>:
<%=h @contact.email %>


<%= Contact.human_attribute_name('phone') %>:
<%=h @contact.phone %>


<%= Contact.human_attribute_name('mobile') %>:
<%=h @contact.mobile %>

app/controllers/contacts_controller.rb
flash[:notice] = quot;Successfully created contact.quot;

flash[:notice] = t(quot;contacts.messages.successful_createquot;)

messages:
successful_create: Successfully created contact.
successful_update: Successfully updated contact.
successful_destroy: Successfully destroyed contact.

:messages => {
:successful_create => quot;Contato criado com sucesso.quot;,
:successful_update => quot;Contato atualizado com sucesso.quot;,
:successful_destroy => quot;Contato apagado com sucesso.quot;,
},


app/models/contact.rb

class Contact < ActiveRecord::Base
validates_presence_of :name
end

Routing


http://localhost:3000/pt-BR/contacts/new

{ :locale => :quot;pt-BRquot;,
:controller => quot;contactsquot;, :action => quot;newquot;}




./script/plugin install
git://github.com/svenfuchs/routing-filter.git




./script/plugin install
git://github.com/svenfuchs/routing-filter.git

ActionController::Routing::Routes.draw do |map|
map.filter 'locale'
map.resources :contacts
end


Views


./script/generate controller page


class PageController < ApplicationController
def show
render :template => params[:id]
end
end

class PageController < ApplicationController
def show
render :template => params[:id]
end
end

app/views/page/_header.html.erb
app/views/page/about.html.erb

app/views/page/_header.pt-BR.html.erb
app/views/page/about.pt-BR.html.erb


<%= render :partial => quot;headerquot; %>

Faster than a bullet 
Terrifying scream 
Enraged and full of anger 
He’s half man and half machine

Faster than a bullet 
Terrifying scream 
Enraged and full of anger 
He’s half man and half machine

app/views/page/about.pt-BR.html.erb


Mais rápido que uma bala 
Um grito apavorante 
Enfurecido e cheio de raiva 
Ele é metade homem, metade máquina

app/views/page/_header.html.erb

<% title quot;Official Rails I18n Project Hymnquot; %>
<h3>Judas Priest - Painkiller</h3>

app/views/page/_header.pt-BR.erb

<% title quot;Hino Oficial do Projeto Rails I18nquot; %>
<h3>Judas Priest - Painkiller</h3>

Browser
Languages


./script/plugin install git://github.com/iain/http_accept_language.git




def set_locale
# comment the next line to disable http_accept_language
recognition
params[:locale] = request.compatible_language_from(
I18n.available_locales) unless params[:locale]
I18n.locale = params[:locale] if params[:locale]
end


Fast Backend


./script/plugin install git://github.com/thedarkone/i18n.git



I18n.backend = I18n::Backend::Fast.new



I18n.backend = I18n::Backend::Fast.new

6 ~ 20x faster at lookups

Slightly less memory efﬁcient

Slower to reload

Faster for production


Globalize 2


./script/plugin install git://github.com/joshmh/globalize2.git


./script/generate migration AddDescriptionFieldForContact


./script/generate migration AddDescriptionFieldForContact

class AddDescriptionFieldForContact < ActiveRecord::Migration
def self.up
add_column :contacts, :description, :text
Contact.create_translation_table! :description => :text
end

def self.down
remove_column :contacts, :description
Contact.drop_translation_table!
end
end


translates :description
end


translates :description
end

app/views/contacts/views/_form.html.erb

...

<%= f.label :description %> 
<%= f.text_area :description %>

<%= f.submit t(quot;common.submitquot;) %>

config/initializers/globalize.rb

I18n.fallbacks[:en]


Globalize2
• Model Translation
• Custom Pluralization
• Locale Fallbacks
• Globalize::LoadPath
• Globalize::Translation classes
• Missing Translation Log Handler


More Resources
• Gettext
• Masao’s Mutoh
• http://github.com/mutoh/gettext
• Fernando Blat
• http://github.com/ferblape/i18n_gettext
• http://guides.rails.info/i18n.html
• http://rails-i18n.org/

git clone
git://github.com/akitaonrails/locosxrails_i18n_demo.git


Muchas Gracias!
www.akitaonrails.com
fabioakita@gmail.com


Locos x Rails

Recommended

Recommended

More Related Content

Viewers also liked

Viewers also liked (19)

Similar to Locos x Rails

Similar to Locos x Rails (20)

More from Fabio Akita

More from Fabio Akita (20)

Recently uploaded

Recently uploaded (20)

Locos x Rails