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:
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.