Rychlý start

Začněte s CLI za méně než 5 minut.

Požadavky

Ujistěte se, že máte nainstalovaný Node.js 18.0 nebo novější. Ověříte to spuštěním node --version.

Instalace#

Nainstalujte CLI globálně pomocí vámi preferovaného správce balíčků:

bash

npm install -g lingo.dev

Ověření instalace#

Ověřte, že je CLI správně nainstalované:

bash

lingo --version

Měli byste vidět výstup podobný tomuto:

plaintext

lingo.dev v0.133.9
Node.js v20.10.0

Inicializace projektu#

Přejděte do adresáře projektu a spusťte:

bash

cd my-project
lingo init

Tento interaktivní příkaz:

Připojí váš účet – ověří vás pomocí API klíče
Vybere projekt – zvolíte existující projekt, nebo vytvoříte nový
Nastaví jazyky – vyberete, které jazyky chcete podporovat
Nastaví strukturu souborů – zvolíte, kam se budou ukládat překladové soubory

Konfigurace vytvořena

CLI vytvoří soubor i18n.json s vaším nastavením. Kdykoli ho pak můžete podle potřeby upravit.

Váš první překlad#

Vytvořte jednoduchý překladový soubor:

json

{
  "welcome": {
    "title": "Welcome to Lingo.dev",
    "subtitle": "The Localization Engineering Platform"
  },
  "auth": {
    "login": "Log in",
    "logout": "Log out"
  }
}

Spuštění překladu#

Přeložte obsah do všech nakonfigurovaných cílových jazyků:

bash

lingo run

CLI:

✅ Najde vaše zdrojové soubory
✅ Vypočítá rozdíl vůči lockfilu
✅ Odešle změněný obsah do vašeho překladového backendu
✅ Zapíše překlady na disk

Režim watch (vývoj)#

Při aktivním vývoji zapněte režim watch, aby se při změně zdrojových souborů překlady automaticky aktualizovaly:

bash

lingo run --watch

Režim watch ukončíte stisknutím Ctrl+C.

Kde hledat pomoc#

Potřebujete poradit?

bash

# Show help for all commands
lingo --help

# Show help for a specific command
lingo run --help

Přidejte se do naší Discord komunity a získejte podporu v reálném čase!

Další kroky#

Extrakce klíčů pomocí AI

Nastavení i18n s podporou AI

Překladové klíče

Zamykání, ignorování a přejmenování klíčů

Podporované jazyky

100+ jazyků a jejich variant

Podporované formáty

JSON, YAML, Markdown a další

Byla tato stránka užitečná?

Začněte s CLI za méně než 5 minut.

Požadavky

Ujistěte se, že máte nainstalovaný Node.js 18.0 nebo novější. Ověříte to spuštěním node --version.

Instalace#

Nainstalujte CLI globálně pomocí vámi preferovaného správce balíčků:

bash

npm install -g lingo.dev

Ověření instalace#

Ověřte, že je CLI správně nainstalované:

bash

lingo --version

Měli byste vidět výstup podobný tomuto:

plaintext

lingo.dev v0.133.9
Node.js v20.10.0

Inicializace projektu#

Přejděte do adresáře projektu a spusťte:

bash

cd my-project
lingo init

Tento interaktivní příkaz:

Připojí váš účet – ověří vás pomocí API klíče
Vybere projekt – zvolíte existující projekt, nebo vytvoříte nový
Nastaví jazyky – vyberete, které jazyky chcete podporovat
Nastaví strukturu souborů – zvolíte, kam se budou ukládat překladové soubory

Konfigurace vytvořena

CLI vytvoří soubor i18n.json s vaším nastavením. Kdykoli ho pak můžete podle potřeby upravit.

Váš první překlad#

Vytvořte jednoduchý překladový soubor:

json

{
  "welcome": {
    "title": "Welcome to Lingo.dev",
    "subtitle": "The Localization Engineering Platform"
  },
  "auth": {
    "login": "Log in",
    "logout": "Log out"
  }
}

Spuštění překladu#

Přeložte obsah do všech nakonfigurovaných cílových jazyků:

bash

lingo run

CLI:

✅ Najde vaše zdrojové soubory
✅ Vypočítá rozdíl vůči lockfilu
✅ Odešle změněný obsah do vašeho překladového backendu
✅ Zapíše překlady na disk

Režim watch (vývoj)#

Při aktivním vývoji zapněte režim watch, aby se při změně zdrojových souborů překlady automaticky aktualizovaly:

bash

lingo run --watch

Režim watch ukončíte stisknutím Ctrl+C.

Kde hledat pomoc#

Potřebujete poradit?

bash

# Show help for all commands
lingo --help

# Show help for a specific command
lingo run --help

Přidejte se do naší Discord komunity a získejte podporu v reálném čase!

Další kroky#

Extrakce klíčů pomocí AI

Nastavení i18n s podporou AI

Překladové klíče

Zamykání, ignorování a přejmenování klíčů

Podporované jazyky

100+ jazyků a jejich variant

Podporované formáty

JSON, YAML, Markdown a další