locos x rails

I18nRails Globalization

Tuesday, April 7, 2009

Fabio Akita

AkitaOnRails.com

Tutorial-like

I18n Before 2.2

Monkey Patch Approach

Many incompatible

projects

Reinventing the Wheel all the time

September 2007

Rails I18n Project

Lead fromSven 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

./script/generate nifty_layout

rails locos

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

rails locos

./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 "hello"=> "Hello world"

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

>> I18n.t "hello"=> "Hello world"

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

>> I18n.locale = :"pt-BR"

>> I18n.t "hello"=> "Alo Mundo"

>> I18n.l Time.now=> "Quarta, 01 de Abril de 2009, 22:49 hs"

>> I18n.l Time.now, :format => :short=> "01/04, 22:52 hs"

>> time_ago_in_words(1.month.ago)=> "about 1 month">> time_ago_in_words(1.5.hours.ago)=> "about 2 hours"

>> time_ago_in_words(1.month.ago)=> "aproximadamente 1 mês">> time_ago_in_words(1.5.hours.ago)=> "aproximadamente 2 horas"

>> I18n.t [:hello, :world]=> ["alo", "mundo"]

>> I18n.t :brazil, :defaults => [:argentina, "Chile"]=> "Argentina"

message: "Hello, {{name}}!"

I18n.t :message, :name => "John" # => "Hello John!"

# en-US :days => { :one => "one day" :other => "{{count}} days" }

I18n.t :days, :count => 1 # => "one day" I18n.t :days, :count => 2 # => "2 days"

Extracting Strings

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

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

config/locales/pt-BR.rb{ :"pt-BR" => { :hello => "Alô Mundo", :contacts => { :index => { :name => "Nome", :email => "Email", :phone => "Telefone", :mobile => "Celular" } } }}

<tr> <th><%= t("contacts.index.name") %></th> <th><%= t("index.email", :scope => "contacts") %></th> <th><%= t("phone", :scope => "contacts.index") %></th> <th><%= t(".mobile") %></th></tr>

en: hello: "Hello world" contacts: index: name: Name email: Email phone: Phone mobile: Mobile

config/locales/en.yml

Setting Locale

class ApplicationController < ActionController::Base helper :all protect_from_forgery before_filter :set_locale private def set_locale I18n.locale = params[:locale] if params[:locale] endend

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] endend

More strings

<td><%= link_to t("common.show"), contact %></td><td><%= link_to t("common.edit"), edit_contact_path(contact) %></td><td><%= link_to t("common.destroy"), contact, :confirm => t('common.destroy_confirm'), :method => :delete %></td>

{ :"pt-BR" => { :hello => "Alô Mundo", :common => { :show => "Mostrar", :edit => "Editar", :destroy => "Apagar", :destroy_confirm => "Tem certeza?" }, ... }}

en: hello: "Hello world"

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

config/locales/en.yml

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("common.submit") %><% end %>

...:activerecord => { :models => { :contact => "Contato" }, :attributes => { :contact => { :name => "Nome", :email => "Email", :phone => "Telefone", :mobile => "Celular" } }}...

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

Name: <%=h @contact.name %> Email: <%=h @contact.email %> Phone: <%=h @contact.phone %> Mobile: <%=h @contact.mobile %>

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

Name: <%=h @contact.name %> Email: <%=h @contact.email %> Phone: <%=h @contact.phone %> Mobile: <%=h @contact.mobile %>

<%= 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 %>

flash[:notice] = "Successfully created contact."

flash[:notice] = t("contacts.messages.successful_create")

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

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

app/controllers/contacts_controller.rb

class Contact < ActiveRecord::Base validates_presence_of :nameend

app/models/contact.rb

Routing

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

{ :locale => :"pt-BR", :controller => "contacts", :action => "new"}

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

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

./script/generate controller page

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

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

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

<%= render :partial => "header" %>

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

app/views/page/about.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/about.pt-BR.html.erb

<% title "Hino Oficial do Projeto Rails I18n" %><h3>Judas Priest - Painkiller</h3>

<% title "Official Rails I18n Project Hymn" %><h3>Judas Priest - Painkiller</h3>

app/views/page/_header.html.erb

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

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

6 ~ 20x faster at lookups

Slightly less memory efficient

Slower to reload

Faster for production

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

Globalize 2

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

./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! endend

class Contact < ActiveRecord::Base translates :description validates_presence_of :nameend

... <%= f.label :description %> <%= f.text_area :description %><%= f.submit t("common.submit") %>

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

I18n.fallbacks[:en]

config/initializers/globalize.rb

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.comfabioakita@gmail.com

locos x rails

en i18n

hsquot i18n

quotmundoquot i18n

hoursquot i18n

i18n filestuesday

quothello worldquot

quotptbrquot i18n

quotalo mundoquot i18n

Technology

fotos dos locos

los autos locos

locos slideshow

ruby on rails - university of california, san diegoruby on...

folder pesa locos

¡locos en accion!

ruby on rails - university of utah - mac managers€¦ ·...

cuentos locos

testing in rails 3.x

locos anhelos

virus locos

esos locos bajitos

animales locos

financiacion de locos

datos locos

autos locos

macworld 2008 - it854 - riding the rails on os x

momentos locos

#riding_rails riding rails 勉強会 #1 docker x rails -...

aÑos locos