YAML
Překládejte vnořené řetězcové hodnoty v YAML beze změny klíčů katalogu. Pokud má kořen nebo schéma zvláštní význam, zvolte jiný handler.
Handler souborů yaml překládá řetězcové hodnoty ve vnořených mapováních a sekvencích. Zachovává klíče, které kód aplikace používá k vyhledávání, i čísla a booleovské hodnoty. Použijte ho pro katalog, jehož struktura zůstává ve všech jazycích stejná.
Zvažte, zda je obecný YAML vhodnou volbou #
Tento katalog například sdružuje zprávy pro dokončení nákupu bez obalového klíče určujícího jazyk:
checkout:
title: Complete your order
steps:
- Review your items
- Confirm delivery
retries: 3Handler vybere checkout.title a oba řetězce v sekvenci. retries zůstane číselnou hodnotou. Vybral by i identifikátor v uvozovkách, protože jde o řetězec. Při rozhodování, která data do katalogu zařadit, mějte tento rozdíl na paměti.
Pro obalový klíč en: ve stylu Rails, který se musí změnit na cílový jazyk, použijte YAML s jazykem v kořeni. Obecný YAML zachová en:, i když se název souboru změní na es.yml. Rails pak může obsah ignorovat, protože kořen stále označuje angličtinu.
Pro specifikaci API použijte OpenAPI. Obecný YAML by vybral i identifikátory operací, odkazy a příklady, jejichž hodnotou je řetězec. Samotná přípona .yml tyto různé účely nerozliší.
Opětovné použití a rekonstrukce #
Aktuální zdroj určuje podobu výstupního stromu. Podle předchozího zdroje se zjišťuje, zda se řetězec na dané cestě změnil, a existující cíl poskytuje hodnoty na odpovídajících cestách. Nové překlady nahradí změněné řetězce. Nezměněné řetězce si mohou ponechat stávající překlady, i když spadají do výběru omezeného podle klíče nebo termínu.
CLI pro --key poskytuje uložený výchozí stav, takže tento výběr nevede spolehlivě k novému vygenerování nezměněných textů v YAML. Ani přidání --force do stejného příkazu na tom nic nezmění. Pokud potřebujete přesnou opravu, upravte cíl přímo. Pro nové vygenerování uložte schválené cílové soubory a použijte --force na celé soubory ve zvoleném rozsahu bez --key. Po nahrazení zkontrolujte celý soubor.
Při rekonstrukci se používá syntaktický strom YAML, který při nahrazování hodnot zachovává komentáře a strukturu kotev. Serializace může sjednotit formátování. Komentáře zůstávají součástí dokumentu a neslouží jako instrukce pro překladatele. Ověřte chování aliasů v nástroji, který vaše soubory YAML zpracovává, zejména pokud na jednu hodnotu vede více odkazů.
Spuštění s rozsahem omezeným podle klíče může vynechat nevyřešený řetězec v mapování mimo tento rozsah, pokud pro něj neexistuje cílová hodnota. Řetězce v sekvencích si ponechají zdrojovou hodnotu, aby se neposunuly pozice položek. Zpracování jen části rozsahu tedy nezaručuje, že je přeložen každý řetězec v souboru.
Nakonfigurujte a načtěte katalog #
Pro zdroje .yaml nebo .yml výslovně nastavte format: "yaml" v konfiguraci CLI. Vyhledávání souborů při odesílání vynechává soubory YAML bez výslovně nastaveného formátu. GitHub App používá vlastní výběr repozitářů.
Přizpůsobte cílovou cestu způsobu, jakým aplikace načítá soubory. Zdroj jako config/locales/checkout.en.yml a zdroj na cestě locales/en/checkout.yml vyžadují odlišný způsob odvození cesty. Zprávy jsou identifikovány i svou pozicí v sekvenci: přesunutí položky může změnit, který existující překlad jí bude odpovídat. Po úpravách struktury zkontrolujte načtený katalog. Pro vyhledávání v Rails, výběr jazyka a použití náhradního jazyka postupujte podle návodu Lokalizace aplikace Rails a použijte handler s jazykem v kořeni.