CLI
Překládejte soubory projektu, stahujte výsledky a spravujte zdrojové katalogy pro aplikace v Reactu.
CLI Lingo.dev propojuje soubory ve vašem projektu s lokalizačním engine. Nastavíte cesty ke zdrojovým souborům a cílové jazyky, odešlete vybraný obsah a stáhnete přeložené soubory. Při dalších spuštěních se změny zpracovávají podle uloženého výchozího stavu zdroje.
@lingo.dev/cli nainstaluje spustitelný soubor lingo. Začněte průvodcem prvním souborem, který vás provede celým nastavením i stažením výsledků.
Nainstalujte aktuální @lingo.dev/cli a pomocí lingo --version zaznamenejte verzi používanou ve vašem projektu. Pro lingo.dev@0.138.10 a jeho projekty i18n.json použijte referenci pro CLI v0.
Zvolte instalaci podle toho, jak pracujete #
Pro instalaci jako závislost projektu evidovanou ve správě verzí:
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --versionPro instalaci spustitelného souboru dostupného v celém shellu:
npm install --global @lingo.dev/cli
lingo --helpTato příručka používá přímo lingo. Při lokální instalaci jej spouštějte přes správce balíčků. npx @lingo.dev/cli@latest a pnpm dlx @lingo.dev/cli@latest spouštějí nejnovější vydání bez trvalé instalace. Pokud potřebujete stejné chování lokálně i v CI, nastavte pevnou verzi; příklady pro CI používají Node.js 22.
lingo update používá zjištěný způsob instalace. Pokud chcete konkrétní verzi nebo je instalace nerozpoznaná či dočasná, použijte správce balíčků.
Překládejte soubory nebo extrahujte zprávy #
U existujících zdrojů nakonfigurujte soubory, proveďte ověření a připojte lokalizační engine. Překlad probíhá na serveru. push --wait počká na dokončení a stáhne výsledky; pomocí samostatných push a pull je můžete stáhnout později.
Z volání ve zdrojovém kódu Reactu vytváří extrakce lokálně JSONC a deklarace TypeScriptu. Nic nepřekládá ani neinstaluje běhové prostředí. Přidejte extrahovaný katalog do konfigurace souborů k překladu a poté jej načtěte pomocí workflow pro katalogy v Reactu.
Uchovávejte stav potřebný pro aktualizace #
První běžné odeslání uloží zdrojová data v bajtech. Zpětné doplnění vytvoří chybějící cílové soubory; další běžná odeslání přeloží změny ve zdroji. Uchovávejte .lingo/config.json, .lingo/lock.json a přijaté překlady společně ve správě verzí. Přihlašovací údaje a ukazatel na poslední spuštění zůstávají ve vašem domovském adresáři.
Kapitoly Push, Pull a Lockfile a cache vysvětlují možnosti volby režimu a obnovy. V kapitole Příkazy najdete příkazy pro nastavení, překlad a údržbu katalogů.