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í:

sh
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --version

Pro instalaci spustitelného souboru dostupného v celém shellu:

sh
npm install --global @lingo.dev/cli
lingo --help

Tato 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ů.