
Rails i18n: täydellinen Ruby on Rails:in kansainvälistämisopas
Ensimmäisestä kieliversiotiedostosta tuotantoon: määritä Rails I18n, käytä t()-apufunktiota, käsittele CLDR-monikkosäännöt, korjaa tavalliset sudenkuopat ja lisää älykkäät varakieliketjut.
Ymmärrä Rails I18n -arkkitehtuuri
Rails sisältää I18n-gemin. Käännöstiedostot sijaitsevat config/locales/-hakemistossa YAML-tiedostoina (oletus) tai Ruby-tiedostoina. Ohjelmistokehys tarjoaa t()-apufunktion (I18n.translaten alias) näkymissä, kontrollereissa, malleissa ja postittajissa. Rails I18n on tarkoituksella yksinkertainen — se käsittelee heti peruskäännökset, interpoloinnin ja monikkomuodot.
# Rails includes i18n out of the box via the i18n gem
# config/application.rb
module MyApp
class Application < Rails::Application
# Default locale
config.i18n.default_locale = :en
# Available locales
config.i18n.available_locales = [:en, :de, :ja, :es, :fr, :'pt-BR']
# Fallback to default locale when translation is missing
config.i18n.fallbacks = true
# Load translations from nested directories
config.i18n.load_path += Dir[Rails.root.join('config', 'locales', '**', '*.{rb,yml}')]
end
end# config/routes.rb
Rails.application.routes.draw do
scope "/:locale", locale: /en|de|ja|es|fr|pt-BR/ do
root "home#index"
resources :products
end
root "home#index"
end
# app/controllers/application_controller.rb
class ApplicationController < ActionController::Base
around_action :switch_locale
private
def switch_locale(&action)
locale = params[:locale] || I18n.default_locale
I18n.with_locale(locale, &action)
end
def default_url_options
{ locale: I18n.locale }
end
endMääritä kieliversioasetukset
Aseta default_locale, available_locales ja varakielitoiminta config/application.rb-tiedostossa tai alustajassa. Määritä kieliversion tunnistus ApplicationControllerissa before_actionilla, joka asettaa kieliversion URL-osoitteesta, istunnosta, evästeestä tai Accept-Language-otsakkeesta.
# config/locales/en.yml
en:
nav:
home: "Home"
about: "About"
settings: "Settings"
greeting: "Hello, %{name}!"
cart:
item_count:
one: "%{count} item"
other: "%{count} items"
# config/locales/de.yml
de:
nav:
home: "Startseite"
about: "Über uns"
settings: "Einstellungen"
greeting: "Hallo, %{name}!"
cart:
item_count:
one: "%{count} Artikel"
other: "%{count} Artikel"Käytä t()-apufunktiota
t()-apufunktio on käytettävissä kaikkialla Rails:issa — näkymissä, kontrollereissa, malleissa, postittajissa ja töissä. Se vastaanottaa avaimen, valinnaiset interpolointimuuttujat sekä oletusarvojen ja käyttöalueen kaltaiset asetukset. Rails tukee näkymissä laiskoja hakuja, jotka rajaavat avaimet automaattisesti nykyiseen kontrolleriin ja toimintoon.
# In views (ERB)
<h1><%= t('nav.home') %></h1>
<p><%= t('greeting', name: @user.name) %></p>
# In controllers
flash[:notice] = t('flash.product_created')
# In models
validates :name, presence: { message: I18n.t('errors.blank') }
# With HTML (safe)
<%= t('terms_html', link: link_to(t('terms_link'), '/terms')) %>Käsittele monikkomuodot
Rails I18n käyttää CLDR-monikkoluokkia: zero, one, two, few, many, other. Englanti tarvitsee vain one- ja other-luokat, mutta muut kielet tarvitsevat useampia muotoja. Määritä monikkokäännökset sisäkkäisinä YAML-avaimina kohdekielten tarvitsemien määräluokkien alle.
# In YAML:
en:
cart:
item_count:
zero: "No items"
one: "%{count} item"
other: "%{count} items"
# Arabic (6 forms):
ar:
cart:
item_count:
zero: "لا عناصر"
one: "عنصر واحد"
two: "عنصران"
few: "%{count} عناصر"
many: "%{count} عنصرًا"
other: "%{count} عنصر"
# Usage in views:
<%= t('cart.item_count', count: @cart.items.size) %>Lisää varakieliketjut
Rails:in sisäänrakennettu I18n.fallbacks tarjoaa vain perustason siirtymisen alueellisesta oletuskieliversioon. Puuttuvan avaimen kohtaava pt-BR-käyttäjä näkee pt-PT:n sijaan englannin. rails-locale-chain lisää määritettävät syväyhdistetyt ketjut, jotta alueelliset käyttäjät näkevät aina lähimmän saatavilla olevan käännöksen.
# Lazy lookups use the controller/action as scope
# app/views/products/index.html.erb
# Instead of t('products.index.title'), just use:
<h1><%= t('.title') %></h1>
<p><%= t('.description') %></p>
# Rails looks up: products.index.title and products.index.description
# config/locales/en.yml
en:
products:
index:
title: "All Products"
description: "Browse our catalog"Automatisoi käännökset
Kun Rails I18n on otettu käyttöön, käännä YAML-kieliversiotiedostosi tekoälyllä. i18n Agent tukee YAML:ia suoraan — osoita se lähdekielen tiedostoon, niin se luo kaikki kohdekielet säilyttäen sisäkkäiset avaimet, interpolointimuuttujat ja monikkomuodot.
# Gemfile
gem 'rails-locale-chain'
# config/initializers/locale_chain.rb
Rails.application.config.i18n.fallbacks = {
'pt-BR': ['pt', 'en'],
'zh-Hant-TW': ['zh-Hant', 'zh', 'en'],
'es-419': ['es', 'en'],
}
# The gem deep-merges translations across the chain
# pt-BR -> pt -> en
# Missing keys in pt-BR are filled from pt, then enTavalliset sudenkuopat
InvalidPluralizationData-virheet
Laiskat haut näkymien ulkopuolella
YAML-syntaksivirheet rikkovat kaikki käännökset
Kokeile i18n Agent:ia nyt
Pudota käännöstiedostosi tähän
JSON, YAML, PO, XML, CSV, Markdown, Properties
tai valitse napsauttamalla
Kohdekielet