Lokalizujte aplikaci v Rails

Přeložte soubory YAML pro Rails s jazykem v kořenovém klíči a ověřte vyhledávání, interpolaci, tvary množného čísla a výběr jazyka pro požadavky.

Rails už zprávám dává stabilní názvy prostřednictvím t a I18n.t. Lingo.dev může přeložit obsah YAML pod těmito názvy, zatímco Rails dál zajišťuje vyhledávání, interpolaci a výběr jazyka. Začněte pozdravem a počtem notifikací a pak je ověřte pomocí stejných pomocných metod, které používá aplikace.

Vložte zdrojové zprávy do jazykového souboru Rails #

Vytvořte nebo rozšiřte config/locales/en.yml:

yaml
en:
  home:
    index:
      welcome: "Welcome, %{name}!"
      cta: "Create an account"
  notifications:
    unread:
      one: "One unread notification"
      other: "%{count} unread notifications"

V app/views/home/index.html.erb můžete pro pozdrav použít vyhledávání relativní k šabloně:

erb
<h1><%= t(".welcome", name: @user_name) %></h1>
<p><%= t("notifications.unread", count: @unread_count) %></p>

Cesta k šabloně určuje pro .welcome úplný klíč home.index.welcome. Volající předává name a count; překlad musí tyto názvy interpolačních proměnných zachovat. Klíče pro množné číslo, například one a other, označují jednotlivé větve a zůstávají beze změny.

Jak budete rozšiřovat pokrytí, přesouvejte zbývající popisky napevno zapsané v šablonách, texty e-mailů a chybové zprávy modelů do příslušných jazykových jmenných prostorů. Překlad souboru ovlivní jen kód, který z něj zprávy načítá.

Vyberte YAML s jazykem v kořenovém klíči #

Rails čte jazyk z kořenového klíče YAML. Pokud přejmenujete en.yml na es.yml, ale ponecháte en:, soubor bude stále definovat anglické zprávy. Použijte obslužný modul yaml-root-key, který přeloží hodnoty a zároveň přejmenuje kořenový klíč.

Z kořenového adresáře projektu nainstalujte a propojte CLI:

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,fr --files 'config/locales/en.yml' --yes
lingo link

Ponechte ID organizace a lokalizačního engine zapsaná v .lingo/config.json. Pole files v tomto souboru nastavte tak, aby obsahovalo zdrojové položky, které váš projekt používá:

json
[
  { "pattern": "config/locales/en.yml", "format": "yaml-root-key" },
  { "pattern": "config/locales/*.en.yml", "format": "yaml-root-key" }
]

Druhá položka zahrnuje soubory pro jednotlivé oblasti, například mailers.en.yml, aniž by vybírala i jejich přeložené protějšky. Pokud projekt takové soubory nemá, odstraňte ji. Formát nastavte výslovně: obecný formát YAML zachovává všechny kořenové klíče, zatímco automatické vyhledávání zdrojů v CLI vyžaduje u souborů YAML výslovnou volbu formátu. Dokument YAML s jazykem v kořenovém klíči popisuje požadavek na mapování s jediným kořenovým klíčem i chování při rekonstrukci.

Přeložte a zkontrolujte načtené hodnoty #

Pokud cílové soubory chybí, spusťte:

sh
lingo push --backfill-missing --wait

Po dokončení otevřete config/locales/es.yml a ověřte, že kořenový klíč je es:. Zkontrolujte, zda vnořené klíče a názvy interpolačních proměnných odpovídají zdroji. Po serializaci zkontrolujte také případné komentáře, kotvy a aliasy. Jiné uspořádání zdrojů může vyžadovat výslovné zadání cílové cesty.

Načtěte výsledek v konzoli Rails nebo v testech aplikace a jazyk přitom vyberte výslovně:

ruby
I18n.with_locale(:es) do
  puts I18n.t("home.index.welcome", name: "Alex", raise: true)
  [0, 1, 2, 20].each do |count|
    puts I18n.t("notifications.unread", count: count, raise: true)
  end
end

Před touto kontrolou nastavte :en, :es a :fr jako dostupné jazyky. Příklad ověřuje vyhledávání a interpolaci; zkontrolujte, zda znění odpovídá zamýšlenému pozdravu a počtu notifikací. Cílové jazyky mohou vyžadovat další pravidla a větve pro množné číslo nad rámec anglických tvarů ve zdroji. Stejnou kontrolu proveďte pro francouzštinu a postupně i pro jmenné prostory e-mailů a validací aplikace, jakmile je přidáte.

Zajistěte, aby požadavky vybíraly stejný jazyk #

V konfiguraci Rails deklarujte podporované jazyky a výchozí jazyk. Zpracování požadavku obalte voláním I18n.with_locale s hodnotou z množiny podporovaných jazyků, aby se nastavení jazyka nepřenášelo do dalšího požadavku.

Pro URL, jako je /es, nakonfigurujte rozsah tras i řadič, který čte params[:locale]. Ve vygenerovaných odkazech zachovávejte jazyk. Pokud aplikace také vyjednává jazyk pomocí Accept-Language, zpracujte váhy kvality a regionální značky místo pouhého převzetí dvoupísmenného podřetězce. Pokud aplikace podporuje výslovnou volbu uživatele, měla by mít přednost.

Chování při použití náhradního jazyka nastavte uváženě. Náhradní jazyk může zachovat použitelnost stránky, ale zároveň skrýt chybějící španělskou zprávu. Povinné cílové položky proto kontrolujte, aniž byste se na něj spoléhali. K lokalizaci data a času používejte tam, kde je to vhodné, pomocnou metodu Rails l místo překládání předem naformátovaného data jako textu.

Otevřete stránku v cílovém jazyce přímo i přes navigaci. Ověřte, že Rails vybere cílový jmenný prostor, zobrazí očekávané interpolované hodnoty a zvládne delší text. lingo check nekontroluje úplnost souborů YAML pro Rails; součástí akceptačního procesu proto musí zůstat načítání v Rails, vykreslování i jazyková kontrola.

Udržujte překlady aktuální i při dalších změnách zdroje #

Uchovávejte zdrojové soubory, schválené cílové soubory, konfiguraci a .lingo/lock.json společně. Po změně zprávy spusťte lingo push --wait pro běžné zpracování změn a porovnejte upravenou zprávu s nezměněnou sousední zprávou. Pokud potřebujete konkrétní opravu překladu nezměněného znění, upravte cílový soubor přímo: při zpracování v rozsahu klíče YAML se může znovu použít stávající překlad. Chcete-li překlady vygenerovat znovu po změně pokynů, uložte schválené cílové soubory před nahrazením celých souborů ve vybraném rozsahu, jak popisuje dokument rozsahy překladu.

Pokud ruční opravy cílových překladů potřebují ochranu před rozdílnými změnami, odešlete úlohu bez --wait, zkontrolujte lingo pull --dry-run a výsledek stáhněte v rámci stejného checkout, ze kterého jste úlohu odeslali. Zápis výsledků při čekání tuto novou kontrolu konfliktů neprovádí. Do ostatních checkout se překlady uložené v commitu dostanou prostřednictvím správy verzí. Viz Zachování zkontrolovaných překladů.

Jakmile tento postup funguje lokálně, zvolte GitHub App nebo automatizaci CI. Před sloučením změn překladů spusťte nad vygenerovanými soubory stejné kontroly Rails.