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:
const l = useLingo();
const label = l.text("Place order", { context: "Checkout submit button" });Spusťte extrakci z kořenového adresáře projektu:
lingo extract --src src --source-locale enPokud 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 #
| Volba | Vý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. |
--check | Porovná 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í.