YAML s jazykovým kořenem

Přeložte hodnoty pod jedním jazykovým kořenem a kořen přejmenujte podle cílového jazyka.

Rails načítá jazyk z kořene souboru YAML. Soubor s názvem checkout.es.yml tedy stále definuje anglické texty, pokud má kořen en:. Obslužná rutina yaml-root-key přeloží zprávy pod tímto kořenem a změní kořen na cílový jazyk. Cesty pro vyhledávání zpráv tak zůstanou ve všech jazycích stejné.

Jazykový obal a cesty ke zprávám #

Zdrojový katalog může obsahovat interpolaci i větve pro množná čísla:

yaml
en:
  checkout:
    greeting: Hello, %{name}
    items:
      one: One item
      other: "%{count} items"

Cesty ke zprávám jsou checkout.greeting, checkout.items.one a checkout.items.other. Nezahrnují en, takže anglický zdroj a španělský překlad mohou používat stejné identifikátory zpráv. Cílový obal se změní na es; checkout, one a other zůstanou klíči.

Syntaxe interpolace a názvy kategorií množných čísel jsou součástí rozhraní aplikace. Samotný překlad textů nenastaví pravidla množných čísel v Rails ani nepřidá všechny kategorie, které cílový jazyk vyžaduje. Než přeložené texty přijmete, ověřte v aplikaci jejich zobrazení s příslušnými počty a proměnnými.

Parser vyžaduje jediný kořenový pár se skalárním klíčem a mapováním pod ním. Jazyk může mít prázdný obsah, ale skalární zprávu nebo seznam přímo pod kořenem parser odmítne. Soubor YAML s více jazyky rozdělte na samostatné soubory pro jednotlivé jazyky. Pokud chcete všechny kořeny zachovat beze změny, použijte obecný YAML. Tuto obslužnou rutinu nevybírejte pro specifikaci OpenAPI.

Aktualizace a omezený rozsah #

Vnořené řetězcové hodnoty se porovnávají podle cest pod jazykovým obalem. Aktuální zdroj určuje strukturu, zatímco předchozí zdroj a existující překlad umožňují převzít nezměněné hodnoty. Komentáře a kotvy procházejí serializací stromu YAML, která může sjednotit formátování.

I při omezení rozsahu na klíče nebo termíny lze znovu použít nezměněné překlady, pokud je k dispozici předchozí zdroj. Příkaz --key v CLI používá uložený výchozí stav a přidání --force tomuto opětovnému použití nezabrání. Pokud potřebujete opravit konkrétní formulaci, upravte přímo cílový překlad. Chcete-li soubor znovu vygenerovat po změně pokynů, uložte přijaté cílové překlady a použijte --force pro celý soubor s omezeným rozsahem a bez --key. Poté zkontrolujte každou změněnou zprávu.

Při omezení rozsahu na klíče mohou být vynechány nevyřešené řetězce v mapování mimo zvolený rozsah. Prvky sekvencí si ponechávají zdrojové hodnoty, aby se neposouvaly jejich pozice. Úplnost kontrolujte zvlášť, nezávisle na úspěšném parsování, zejména pokud vytváříte nový jazyk s úzce vymezeným rozsahem.

Nastavení jazyka a cílového umístění #

U zdrojů .yml nebo .yaml nastavte format: "yaml-root-key" výslovně. Z přípony souboru nelze jazykový obal určit. Vzory souborů a uspořádání cílových souborů popisují Konfigurace CLI a GitHub.

Rekonstrukce vyžaduje cílový jazyk. Pokud chybí, selže. Volba localeFormat v CLI mění zápis cesty, nikoli jazyk uvedený uvnitř souboru YAML. Zkontrolujte cílové umístění i kořen cílového souboru a poté přes Rails načtěte pozdrav a zprávu s množnými čísly. Návod Lokalizace aplikace Rails ukazuje, jak tyto soubory souvisejí s výběrem jazyka pro požadavek, pomocnými metodami a chováním při použití náhradního jazyka.