Zkontrolujte lokalizaci v Reactu při kontrole kódu

Odhalte různé chyby v lokalizaci ještě před sloučením pomocí extrakce, kontrol katalogů, TypeScriptu a sestavení aplikace.

Změněný text v Reactu se ke čtenářům dostává přes zdrojový kód, extrakci, cílový katalog a načítací mechanismus aplikace. Vedle samotného znění proto kontrolujte i celý tento řetězec. Správný překlad pod neaktuálním identifikátorem se nikdy nezobrazí; náhradní zobrazení zdrojového textu může skrýt chybějící překlad, zatímco obrazovka zůstane použitelná.

Tento postup platí pro aktuální balíček pro React s katalogy JSONC extrahovanými pomocí CLI. Kontroly extrakce v CLI doplňte kontrolami sestavení a vykreslování, které používá váš projekt.

Nejprve prověřte změnu ve zdrojovém kódu #

Přečtěte si nový zdrojový text jako instrukci nebo sdělení pro uživatele. Poté si přečtěte jeho kontext. „Tlačítko“ popisuje podobu prvku; „Zrušit naplánovanou platbu před odesláním“ vysvětluje akci, jejíž význam musí zůstat zachován. Identitu zprávy určuje zdrojový text i kontext, takže i pouhá změna kontextu může vyžadovat novou cílovou položku.

Zástupné symboly kontrolujte jako hodnoty s neměnným účelem. Překladatel musí mít možnost přesunout jméno osoby nebo částku, aniž by se změnila jejich identita. U formátovaného textu ponechte navigaci a chování komponent v kódu a překládejte větu kolem pojmenovaných značek. Přesná rozhraní API najdete v částech Zprávy a Formátovaný text.

Před kontrolou cílových překladů zkontrolujte extrakci #

V příslušném adresáři projektu s nainstalovaným CLI:

sh
lingo extract --check
lingo check

Použijte stejné volby --src, --source-locale, --out a --types jako příkaz pro extrakci ve vašem projektu. Výchozí zdrojový jazyk je en; konfigurace lokalizace výchozí hodnotu tohoto příkazu nemění. Poté spusťte kontrolu TypeScriptu a produkční sestavení používané v repozitáři, včetně vygenerovaných deklarací.

Chyba, kterou záměrně zavedete do lokálního testovacího vzorkuKontrolní krok a očekávaný výsledek
Změňte zdrojový text, aniž byste znovu vygenerovali katalogy nebo deklarace.extract --check porovná vygenerovaný výstup a selže, pokud je neaktuální.
Vynechte povinný kontext v extrahované zprávě.check ohlásí problém s extrakcí nebo kontextem; zkontrolujte zdrojový kód a obnovte správný význam.
V existujícím cílovém katalogu JSONC nechte některou položku chybět nebo ji ponechte prázdnou.check ohlásí chybějící překlad v nalezeném katalogu.
Ponechte vygenerované deklarace neaktuální.Extrakce nebo kontrola odhalí nesoulad vygenerovaného výstupu; TypeScript samostatně ověří jeho použití v aplikaci.
Narušte import jazyka nebo integraci s frameworkem.Skutečné sestavení aplikace by mělo odhalit chybu integrace.

Při prvním zavádění těchto kontrol použijte lokální testovací vzorek. extract --check uspěje i tehdy, když nenajde žádné zdrojové soubory, proto ověřte, že uvedený adresář obsahuje kód, který chcete kontrolovat. Jinak může úspěšný výsledek znamenat, že kontrola vůbec nic neprověřila.

Výslovně ověřte pokrytí požadovaných jazyků #

Pokud vzory files v .lingo/config.json odpovídají zdrojovému katalogu (například locales/en.jsonc), lingo check vyžaduje také soubor pro každý nakonfigurovaný cílový jazyk. Vzor zapisovaný pomocí lingo init --yes, tedy locales/en.json, neodpovídá katalogu .jsonc, takže s ním proběhnou pouze kontroly Reactu. Chybějící klíč se hlásí jen v existujících cílových katalozích JSONC. V rámci kontroly porovnejte seznam požadovaných jazyků se soubory a importy. V lokálním testovacím vzorku dočasně odeberte cílovou položku a podívejte se, jak se na obrazovce projeví náhradní zobrazení zdrojového textu.

U reprezentativních dvojic zdrojového a cílového textu ověřte význam, zejména u změněných příslibů a produktových termínů. Úspěšná kontrola konzistence JSONC správnost významu neposuzuje. ARB, Android XML, katalogy Apple a statické dokumenty vyžadují validaci vlastní danému formátu, nikoli tuto kontrolu pokrytí určenou pro React.

Vyřešte rozdíly bez ztráty zkontrolovaného výstupu #

Pomocí lingo extract znovu vygenerujte neaktuální výstup, prověřte přidané a osiřelé položky a přeložte potřebné změny. Zachovejte zkontrolované znění cílových textů i soubor zámku lokalizace. Odstranění osiřelých položek mění katalogy a mělo by projít kontrolou odděleně od změny zdrojového textu.

Rozhodněte, zda budou překlady přicházet do zdrojové větve, nebo prostřednictvím samostatného PR s překlady. Průvodce CI vysvětluje výhody a nevýhody jednotlivých způsobů doručování i rozdíly při použití spravované aplikace. V obou případech oddělte oprávnění ke sloučení od oprávnění ke spuštění a od schvalování obsahu.

Nakonec načtěte změněnou obrazovku v cílovém jazyce s reprezentativními hodnotami. Vyzkoušejte odkazy ve formátovaném textu, prověřte chování při náhradním zobrazení zdrojového textu a porovnejte zobrazený text se zamýšlenou akcí. Kontrola je hotová teprve tehdy, když prověříte cestu zprávy programem i její znění.