Přidávání a správa jazyků v CLI v0

Vyberte požadovanou jazykovou variantu, přidejte cílový jazyk ve starší verzi a ověřte, jak s ním pracují soubory i aplikace.

Ve verzi v0 určuje locale.source původní jazyk a locale.targets vybírá cílové jazyky pro opakované překlady. Zvolte variantu, kterou vaši čtenáři potřebují, a pak ověřte, že ji konfigurace, názvy souborů, backend i aplikace používají jednotně.

Přidání jednoho cílového jazyka #

Chcete-li ke stávající španělštině a francouzštině přidat němčinu, upravte i18n.json:

json
{
  "locale": { "source": "en", "targets": ["es", "fr", "de"] }
}

Spusťte nainstalovaný binární soubor verze v0 pro tento cílový jazyk:

sh
lingo run --target-locale de

Přepínač pro toto spuštění nahradí seznam cílových jazyků a umožní vybrat i jazyk, který v konfiguraci chybí. Pro další spuštění ho přidejte do konfigurace. Vzor pro samostatné soubory locales/[locale].json vytvoří soubor locales/de.json; než němčinu zpřístupníte čtenářům, zkontrolujte hodnoty a načtěte tento soubor v aplikaci.

Pokud cílový jazyk chybí, je potřeba doplnit všechny vybrané klíče. Pokud už existuje, stávající hodnoty se obvykle zachovají a doplní se jen chybějící klíče. Změny ve zdroji ale mohou i tak vyžadovat nový překlad. Pokud mají ostatní schválené jazyky zůstat beze změn, nekombinujte první přidání nového jazyka s plošným vynucením překladu.

Omezení spuštění na cílový jazyk neaktualizuje stávající referenční stav kontrolních součtů zdroje. Při pozdějším běžném spuštění se může změněný zdroj zpracovat znovu. Než tedy budete předpokládat, že kontrola v omezeném rozsahu změny trvale vypořádala, postupujte podle pravidel vypořádání.

Rozlišení regionu a písma tam, kde na nich záleží #

json
{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-MX", "pt-BR", "fr-CA"]
  }
}

Jazykové varianty s určeným regionem rozlišují požadované jazykové zvyklosti: anglické color/colour, španělské ordenador/computadora a portugalské trem/comboio ukazují, proč samotná volba jazyka nemusí stačit. Použití výrazů ale stále závisí na kontextu; jazyková značka nezaručuje, že každý vygenerovaný výraz bude pro dané publikum vhodný. Také u čínštiny může být nutné rozlišovat písmo nebo region, například pomocí zh-Hans nebo zh-TW.

Prohlédněte si seznamy pro nainstalovanou verzi:

sh
lingo show locale sources
lingo show locale targets

Tyto seznamy nezaručují, že každý backend danou volbu přijme nebo poskytne kvalitní výsledek. Než rozsah rozšíříte, ověřte vybranou dvojici malým zkušebním spuštěním a nespoléhejte na dříve uváděný počet jazyků.

Oddělení identity jazyka od uspořádání souborů #

Starší verze pro požadavky API sjednocuje několik způsobů zápisu používaných na různých platformách. Soubory přesto mohou vyžadovat podtržítka nebo názvy podle pravidel pro prostředky systému Android. Použijte nastavení oddělovače a uspořádání daného formátu a pak zkontrolujte, kam se výstup skutečně uložil.

Překlad nenastavuje dir, nezrcadlí ovládací prvky ani nepřidává směrování. Arabština, hebrejština, perština a urdština běžně vyžadují zobrazení zprava doleva (RTL); zkontrolujte rozhraní, které obsah používá, včetně vložených čísel a identifikátorů. Aplikace musí nový jazyk nejen rozpoznat, ale také načíst jeho obsah.

Odebrání cílového jazyka #

Odebráním kódu z locale.targets se jazyk přestane vybírat při dalších spuštěních. Stávající soubory zůstanou zachovány. O tom, zda je ponecháte, přestanete poskytovat, nebo odstraníte, rozhodněte zvlášť. Operace Vymazat je destruktivní a může vybrat i zdrojový obsah; nejde o totéž jako odebrání nakonfigurovaného jazyka.