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:
lingo extract --check
lingo checkPouž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 vzorku | Kontrolní 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í.