Nastavení · Lingo.dev

Nainstalujte Lingo.dev CLI, nastavte projekt a vygenerujte první překlady.

Požadavky

Je potřeba Node.js 18 nebo novější. Verzi zkontrolujete spuštěním node -v.

Krok 1. Inicializace projektu#

Přejděte do projektu

bash

cd your-project-directory

Spusťte příkaz init

bash

npx lingo.dev@latest init

Uživatelé Windows: Pokud npx lingo.dev nefunguje, nejdřív nainstalujte balíček pomocí npm install lingo.dev@latest a pak místo něj použijte npx lingo.

Postupujte podle pokynů. CLI vytvoří v kořenovém adresáři projektu konfigurační soubor i18n.json.

Krok 2. Konfigurace bucketu#

V souboru i18n.json nastavte alespoň jeden bucket — tedy formát souboru spárovaný s include patterny, které CLI říkají, kde se nachází přeložitelný obsah:

json

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  },
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"]
    }
  }
}

Zástupný symbol [locale] se za běhu převede na nakonfigurované kódy jazyků — locales/en.json pro zdrojový jazyk, locales/es.json pro španělštinu a tak dále.

Úplný seznam podporovaných formátů souborů a konfigurací jejich bucketů najdete v části Podporované formáty.

Krok 3. Připojení překladového backendu#

CLI potřebuje k vytváření překladů překladový backend. Máte dvě možnosti:

lokalizační engine v Lingo.dev automaticky uplatní hlas značky, glosář, pravidla a konfiguraci modelu při každém požadavku na překlad.

Vytvořte si účet a na stránce API Keys vygenerujte API klíč.
Nastavte API klíč jako proměnnou prostředí:

bash

export LINGO_API_KEY="your-api-key"

Žádná další konfigurace není potřeba — CLI používá výchozí lokalizační engine vaší organizace. Pokud chcete cílit na konkrétní engine, přidejte do engineId i18n.json:

json

{
  "engineId": "eng_SxjMwMsfOIsvV1wh"
}

Krok 4. Generování překladů#

bash

npx lingo.dev@latest run

CLI najde zdrojové soubory, extrahuje z nich přeložitelný obsah, odešle ho do nakonfigurovaného překladového backendu a výsledky zapíše zpět na disk. Vytvoří se také soubor i18n.lock, který sleduje, co už bylo přeloženo — commitněte ho spolu s jazykovými soubory.

Další kroky#

i18n.json

Kompletní konfigurační Reference

Podporované formáty

JSON, YAML, Markdown a více než 20 formátů souborů

Připojte svůj engine

Směrujte překlady přes svůj lokalizační engine

Jak to funguje

Překladový pipeline v pěti krocích