Rychlý start

Aktualizováno: minulé čtvrtletí · 2 min čtení

Zastaralé

Tato dokumentace pokrývá starší CLI (v0). Aktuální CLI je v1. Zobrazit aktuální dokumentaci CLI

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:

  1. Připojí váš účet – ověří vás pomocí API klíče
  2. Vybere projekt – zvolíte existující projekt, nebo vytvoříte nový
  3. Nastaví jazyky – vyberete, které jazyky chcete podporovat
  4. 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#