Přidejte jazyk, aniž byste vše překládali znovu
Přidejte nový cílový jazyk, zachovejte schválené překlady a ověřte, že aplikace dokáže používat nové prostředky.
Přidání jazyka zahrnuje tři úkoly: vybrat jazyk pro překlad, vytvořit prostředky a zajistit, aby je aplikace načítala. Nová jazyková volba v rozhraní sama o sobě nevytvoří katalog překladů. Přeložený katalog zase nezajistí, že ho bude daná trasa používat.
Začněte se zdrojem a schválenými cílovými překlady, které lze v případě potřeby obnovit. Zaznamenejte požadovaný jazyk, případně i oblast nebo písmo. pt-BR a pt-PT označují různá publika, jejichž požadavky na formulace se mohou lišit.
Projděte stávající strukturu a pokyny #
Sepište vzory cest ke zdrojovým souborům, stávající cílové jazyky a očekávané výstupní cesty. Samostatné cílové soubory lze přidávat nezávisle na sobě. Sdílený katalog řetězců Xcode ale ukládá několik jazykových variant do jednoho souboru, takže samotná existence souboru nepotvrzuje jazykové pokrytí.
Prověřte podporu nového jazyka v modelech, terminologii, míru formálnosti a styl komunikace pro nové publikum. Pokyny pro blízké jazykové varianty přebírejte jen tam, kde jsou použitelné. Terminologie může být společná, zatímco zvyklosti v oslovování se liší. Podpora jazyků psaných zprava doleva vyžaduje také úpravy směru zobrazení a rozvržení aplikace, nejen překlad řetězců.
Přidejte cílový jazyk do aktuálního projektu CLI #
Aktuální cílové jazyky CLI určuje targetLocales v .lingo/config.json. push nemá volbu --target-locale ani --locale. V monorepozitáři ověřte, která konfigurace projektu se podle pracovního adresáře použije.
Před přidáním cílového jazyka dokončete pomocí lingo push --wait všechny nevyřízené běžné aktualizace zdroje pro stávající jazyky. Dokončete kontrolu, stáhněte výstup a porovnejte cílové překlady s aktuálním zdrojem. Při přidávání nového jazyka tuto revizi zdroje neměňte.
Zpětné doplnění ponechává stávající cílové soubory beze změny. Pokud vytváří pouze soubory nového jazyka, zachová dosavadní výchozí stav zdroje, aby pozdější běžné odeslání mohlo zpracovat nevyřízené úpravy pro ostatní jazyky. Když tyto aktualizace dokončíte předem, budou stávající i nové cílové překlady vycházet ze stejné zkontrolované revize zdroje.
Poté přidejte cílový jazyk do konfigurace projektu s nainstalovaným CLI, ověřeným přihlášením a nastaveným propojením a zkontrolujte plánované doplnění chybějících souborů:
lingo push --backfill-missing --estimate
lingo push --backfill-missing --waitOdhad nic nepřekládá ani nevytváří úlohu, ale pro účely plánování nahrává soubory, které na serveru chybí. Neprobíhá offline a nezaručuje konečné náklady. Zpětné doplnění prochází nakonfigurované vzory cest a doplňuje chybějící cílové soubory; nové klíče do stávajícího cílového souboru nedoplňuje. Jakmile je nový jazyk aktuální, další běžné změny zdroje se zpracovávají pomocí lingo push --wait vůči uloženému výchozímu stavu.
U sdílených katalogů XCStrings se práce plánuje pro každý jazyk zvlášť v rámci jednoho souboru. Nové položky zkontrolujte podle workflow pro iOS.
Pokud má požadavek cílit jen na jeden jazyk, omezte seznam v targetLocales v kontrolované větvi nebo konfiguraci úlohy a poté obnovte úplný seznam. Nepřidávejte vynucení jen proto, abyste zahrnuli nový jazyk: znovu přeloží stávající cílové překlady v daném rozsahu a může nahradit zkontrolované formulace. Tyto rozdíly popisuje Odeslání; příznaky starší generace najdete v referenční příručce jazyků pro CLI v0.
Stanovte asistentovi stejné hranice #
Agent může projít strukturu, navrhnout pokyny pro daný jazyk a připravit přehled změn konfigurace. Určete, zda smí měnit lokální soubory, nastavení lokalizačního engine ve vlastnictví organizace, nebo obojí. Tyto pravomoci rozlišuje Delegování.
Požádejte ho, aby vysvětlil, které primární a záložní modely se použijí a které pokyny jsou sdílené a které platí jen pro daný jazyk. Před porovnáním výstupu ověřte uložený stav. Výběr vysvětluje Určení jazyka; preference modelu není měřítkem jazykové kvality.
Ověřte výsledek pro nové publikum #
Porovnejte vrácené cesty a přehled změn se zamýšleným rozsahem. Stávající schválené cílové překlady by měly zůstat beze změny, pokud pro změnu není důvod v podobě aktualizace zdroje nebo schválené opravy. Pomocí nástrojů aplikace pro práci s prostředky ověřte proměnné, větve pro tvary množného čísla a jazyková metadata.
Načtěte reprezentativní obsah v novém jazyce. Kromě významu zkontrolujte také použití záložních variant, přetékání obsahu a směr zobrazení. Než rozšíříte pokrytí, uchovejte revizi zdroje a výsledek pro měření.
Po odebrání z konfigurace se jazyk přestane vybírat pro nové úlohy; prostředky ani trasy používané za běhu se tím neodstraní. O těchto změnách rozhodněte samostatně, zejména pokud jeden sdílený katalog obsahuje zdroj i několik jazyků.