lingo extract

Generujte zdrojový JSONC a deklarace TypeScriptu z explicitních volání překladu.

lingo extract přiřazuje explicitně definovaným zprávám v Reactu identitu v katalogu. Prohledává volání v TypeScriptu/TSX, lokálně zapisuje zdrojový JSONC a deklarace a zachovává metadata, která propojují každou položku s jejím zdrojem. Nepřepisuje libovolný JSX ani neodesílá požadavky na překlad.

V nakonfigurované komponentě Reactu vypadá podporované volání takto:

tsx
const l = useLingo();
const label = l.text("Place order", { context: "Checkout submit button" });

Spusťte extrakci z kořenového adresáře projektu:

sh
lingo extract --src src --source-locale en

Pokud používáte výchozí cesty, zkontrolujte locales/en.jsonc a lingo.d.ts. Zdrojový katalog obsahuje hodnoty zpráv, kontext a umístění ve zdrojovém kódu. Průvodce rychlým zprovozněním v Reactu uvádí potřebné importy a nastavení poskytovatele pro komponentu.

Volby #

VolbaVýchozí hodnota nebo účinek
--src <path>Adresář k prohledání, ve výchozím nastavení src.
--source-locale <locale>Zdrojový jazyk výstupu, ve výchozím nastavení en.
--out <path>Má přednost před nakonfigurovanou hodnotou i18n.messagesPath i výchozí hodnotou locales.
--types <path>Má přednost před nakonfigurovanou hodnotou i18n.typesPath i výchozí hodnotou lingo.d.ts.
--checkPorovná vygenerované bajty s obsahem na disku, aniž by cokoli zapisovala.

Cesty se vyhodnocují relativně k nejbližšímu kořenovému adresáři projektu. Zdrojový jazyk nepřebírá lokalizační nastavení sourceLocale; jiný jazyk je nutné zadat explicitně. Při běžném zápisu se vytvářejí adresáře pro deklarace.

Co analyzátor rozpozná #

Analyzátor rozpoznává text, rich, plural a select u proměnných, kterým byl přiřazen výsledek useLingo nebo createLingo, a také u obvyklých příjemců volání l a .l. Přijímá řetězcové literály, šablonové řetězce bez výrazů a statické objekty s tvary zpráv.

Dynamické zprávy nemají stabilní zdroj, který by bylo možné extrahovat. Destrukturováním výsledku tovární funkce se ztratí sledovaná struktura příjemce volání a vyvolá se varování. Soubory deklarací, soubory a adresáře s názvem začínajícím tečkou a node_modules se vynechávají. Pokud neexistují žádné soubory TS/TSX, extrakce to oznámí a skončí bez výsledku; úspěšné ukončení procesu samo o sobě neznamená, že byly nalezeny zprávy.

Zkontrolujte identitu a chování při slučování #

Klíče se odvozují ze zdroje a kontextu. Změna formulace nebo kontextu může vytvořit novou identitu; hodnoty dosazované za běhu ji nemění. Kolize způsobí selhání extrakce a je nutné je vyřešit doplněním rozlišujícího kontextu.

Extrakce slučuje výsledky se stávajícím zdrojovým katalogem: zachovává aktuální hodnoty, aktualizuje metadata kontextu a zdroje, přidává nové položky a označuje zprávy, které už ve zdroji nejsou, jako osiřelé. Seřazený výstup je deterministický. Než osiřelou položku vyhodnotíte jako záměrně odstraněnou z aplikace, zkontrolujte varování.

Zkontrolujte nebo přeložte katalog #

lingo extract --check porovnává bajty katalogu i deklarací, aniž by cokoli zapisoval. lingo check navíc kontroluje kontext, osiřelé položky a nalezené cíle.

Chcete-li katalog přeložit, přidejte skutečnou cestu k .jsonc do files[], proveďte ověření a propojení a pro první odeslání použijte lingo push --backfill-missing --wait. Další změny odesílejte běžným příkazem push. Změna cest pro extrakci automaticky nemění konfiguraci souborů.

Výsledek načtěte pomocí nástroje kompatibilního s JSONC a v souladu se zásadami pro metadata katalogu. Poskytovatel očekává mapu řetězců; samotná cesta k souboru ani běžný import JSON tento převod nezajistí.