Rails on the road

Niente di nuovo, si sapeva che il vecchio Globalize sarebbe stato integrato in rails 2.2, ma adesso che l’ho provato posso raccontarvi qualcosa in più.

Tutte le nuove applicazioni hanno una nuova cartella config/locales che continene file .yml o .rb con le vostre traduzioni.

Nel file environment.rb ci sono le configurazioni per l’internazionalizzazione, di default la lingua è l’en:

    1   # The internationalization framework can be changed to have another default locale (standard is :en) or more load paths.
    2   # All files from config/locales/*.rb,yml are added automatically.
    3   # config.i18n.load_path << Dir[File.join(RAILS_ROOT, 'my', 'locales', '*.{rb,yml}')]
    4   # config.i18n.default_locale = :de

Se volete ridefinire gli errori in italiano, potete creare un file it.yml e:

    1 it:
    2 activerecord:
    3   errors:
    4     messages:
    5      accepted:                  "deve essere accettato"
    6      blank:                     "non può essere vuoto"
    7      confirmation:              "non corrisponde alla conferma"
    8      empty:                     "non può essere vuoto"
    9      equal_to:                  "deve essere uguale a {{count}}"
   10      even:                      "deve esspere pari"
   11      exclusion:                 "è riservato"
   12      greater_than:              "deve essere più grande di {{count}}"
   13      greater_than_or_equal_to:  "deve essere più grande o uguale a {{count}}"
   14      inclusion:                 "non è incluso nella lista"
   15      invalid:                   "è invalido"
   16      less_than:                 "deve essere meno di {{count}}"
   17      less_than_or_equal_to:     "deve essere meno o uguale a  {{count}}"
   18      not_a_number:              "non è un numero"
   19      odd:                       "deve essere dispari"
   20      taken:                     "è già stato preso"
   21      too_long:                  "è troppo lungo (max {{count}} caratteri)"
   22      too_short:                 "è troppo corto (almeno {{count}} caratteri)"
   23      wrong_length:              "lunghezza errata (dovrebbe essere {{count}} characters)"

In generale l’utilizzo è molto semplice, nelle vostre viste usate qualcosa del tipo

    1 <p><%= I18n.t :hello %></p>

e nel file .yml della traduzione definite:

    1 it:
    2 hello: "Ciao mondo!"

In development vedrete subito la traduzione, in production chiaramente no, per rendere effettive le modifiche dovrete fare il reload delle traduzioni:

    1     I18n.reload!() 

Se volete passare parametri alla traduzione è molto semplice farlo, il metodo t consente di specificare la label e dei parametri passati come hash in questo modo protrete ad esempio salutare un mondo specifico!!

    1 <p><%= I18n.t :hello, :world => "Terra!" %></p>

e nel file delle traduzioni

    1 it:
    2 hello: "Ciao {{world}}"

Così la traduzione sarà “Ciao Terra!”

Date un occhio su @artweb design e sul Google group.

Piccola nota

Se per caso lanciando il server e visualizzando una pagina della vostra applicazione vi si dovesse presentare

    1 ActionView::TemplateError (can't convert Array into String)...

allora dipende dall’inclusione dei locales nell’environment.rb, correggete il “<<” con un “+=”.

    1   # The internationalization framework can be changed to have another default locale (standard is :en) or more load paths.
    2   # All files from config/locales/*.rb,yml are added automatically.
    3   config.i18n.load_path += Dir[File.join(RAILS_ROOT, 'my', 'locales', '*.{rb,yml}')]
    4   config.i18n.default_locale = :it