PlatformaVytvořit účet

Rychlý start

Max PrilutskiyCEO a spoluzakladatel2 min čtení

Od začátku do konce: instalace, přihlášení, propojení s enginem, odeslání zdrojů, stažení překladů.

Požadavky

Node.js 22+ (node -v pro ověření). Po instalaci CLI spustíte jako lingo.

Nastavení#

1

Instalace

bash
npm install -g @lingo.dev/cli

Případně pnpm add -g @lingo.dev/cli / yarn global add @lingo.dev/cli / bun add -g @lingo.dev/cli.

2

Přihlášení

bash
lingo login

Otevřete Lingo.dev v prohlížeči a povolte přístup pro CLI. Pokud ještě nejste přihlášeni, nejprve se přihlaste. CLI ukládá relaci do ~/.lingo/credentials.json. V CI nebo neinteraktivním prostředí použijte klíč API: lingo login --api-key lk_... (nebo nastavte --api-key jako globální přepínač u libovolného příkazu).

3

Inicializace projektu

V kořenovém adresáři projektu:

bash
lingo init

CLI se zeptá na source locale, target locales a file patterns (globy odkazující na vaše zdrojové soubory). Sekci lokalizace zapíše do .lingo/config.json. Tento soubor commitněte — je to zdroj pravdy pro to, co se bude překládat.

4

Propojení s enginem

bash
lingo link

Vyberte (nebo vytvořte) organizaci a lokalizační engine. Engine obsahuje konfiguraci vašeho AI modelu, glosáře, hlas značky a pravidla — stačí ho jednou nastavit na platformě Lingo.dev a pak ho znovu využijete napříč projekty. link přidá orgId a engineId do .lingo/config.json (a také je commitne).

První push#

Jakmile máte připravený neprázdný zdrojový soubor (např. locales/en.json):

bash
lingo push --backfill-missing --wait

Přeloží všechny chybějící cílové texty ve všech nakonfigurovaných vzorech. --wait ponechá CLI připojené, dokud se běh nedokončí, a potom zapíše výstupy (locales/de.json, locales/fr.json, ...) na disk. V čistém checkoutu to může trvat od několika sekund (u malých JSON souborů) po několik minut (u velkých markdown balíčků). Bez --wait se push ukončí hned po odeslání běhu a lingo pull zapíše výstupy později.

Po dokončení:

text
✓ Run lrg_a8c... : localized 12 target file(s), uploaded 1 new artifact(s).

Další spuštění#

Po úpravě zdrojových souborů běžný lingo push přeloží jen změny — soubory, jejichž hash zdroje se nezměnil, server přeskočí. Lokální úpravy cílových souborů se ve výchozím nastavení zachovají; pokud je chcete přepsat, použijte --force (s rozsahem).

bash
lingo push                       # delta only
lingo push docs/en/**/*.md       # scoped: only this subtree
lingo push docs/en/about.md -f   # scoped + force: retranslate even if up to date

Každý z nich se ukončí hned po odeslání běhu — přidejte --wait, pokud chcete výstupy zapsat v rámci stejného příkazu, nebo je později stáhněte pomocí lingo pull.

Stažení později#

push uloží ID běhu do ~/.lingo/runs/<hash>.json (podle absolutní cesty projektu). Později, na stejném počítači a ze stejného checkoutu:

bash
lingo pull

…počká, než se poslední push dokončí, pokud stále běží, a potom zapíše jeho výstupy. Hodí se, pokud během překladu zavřete terminál. Na ostatních počítačích se překlady objeví, jakmile je commitnete.

Kam dál#

  • Konfigurace — schéma .lingo/config.json, lockfile a kde se ukládá stav běhu.
  • lingo push — vzory s rozsahem, --force, sémantika opakování pokusů.
  • lingo pull — detekce konfliktů, --dry-run.