Přeložte soubor pomocí CLI v0

Zopakujte překlad malého staršího katalogu s pevně nastavenou verzí balíčku a zkontrolujte výstup i Lockfile.

Tento postup použijte pro projekt s nainstalovaným i18n.json nebo pro izolovaný starší testovací projekt. Je určen pro lingo.dev@0.138.10, jehož manifest vyžaduje Node.js 18 nebo novější. Nejprve zkontrolujte node --version a nainstalovaný lingo --version. U nových projektů postupujte podle aktuálního průvodce rychlým startem.

Použijte zaznamenanou verzi balíčku #

U existujícího projektu ponechte závislost na pevně nastavené verzi. Pro samostatný testovací projekt zvolte správce balíčků, který používáte:

sh
npm install --save-dev lingo.dev@0.138.10
pnpm add --save-dev lingo.dev@0.138.10
yarn add --dev lingo.dev@0.138.10
bun add --dev lingo.dev@0.138.10

Spusťte pouze jeden instalační příkaz. Lokální binární soubor spouštějte přes npm exec -- lingo, pnpm exec lingo, yarn lingo nebo bun run lingo. V příkladech níže tento způsob zkracujeme na lingo. Ve Windows se lokální instalací s pevně nastavenou verzí a spouštěním binárního souboru přes správce balíčků také vyhnete závislosti na vyhledávání příkazu podle názvu balíčku.

Vytvořte katalog a konfiguraci #

Spusťte lingo init z adresáře, ve kterém má být projekt umístěn. Tím se vytvoří i18n.json. Pokud soubor již existuje, zachovejte jej a znovu jej neinicializujte. Vytvořte locales/en.json:

json
{
  "welcome": "Welcome back",
  "button.save": "Save changes"
}

Použijte odpovídající skupinu pro JSON:

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

version označuje verzi konfiguračního schématu, nikoli verzi balíčku. Tento vzor načítá angličtinu z locales/en.json a zapisuje španělštinu do locales/es.json.

Nastavte překladový backend #

Pro Lingo.dev zadejte LINGO_API_KEY prostřednictvím mechanismu shellu pro práci s tajnými údaji. Do konfigurace přidejte požadované engineId a ověřte, že klíč umožňuje překládat přes daný lokalizační engine. Pokud údaj vynecháte, použije se implicitní výběr backendu. Aktuální pravidla služby však mohou vyžadovat výslovné zadání ID.

Samostatnou možností je konfigurace v0 pro přímé připojení k poskytovateli. Vyžaduje přihlašovací údaje daného poskytovatele nebo dostupnou službu Ollama. Jednotlivá pole popisuje referenční dokumentace konfigurace. Do konfigurace JSON aktuálního CLI tato pole nepatří.

Spusťte překlad a zkontrolujte výsledek #

sh
lingo run

V locales/es.json zkontrolujte klíče i samotné přeložené hodnoty. Ověřte, že zpráva o uložení stále pojmenovává zamýšlenou akci. Při napojení na aplikaci načtěte cílový katalog pomocí mechanismu, který aplikace skutečně používá. Schválený výstup, konfiguraci a i18n.lock uložte společně do commitu.

Běžné spuštění beze změn ve zdroji by mělo zachovat stávající cílové hodnoty. Změny zdroje nebo vynucené spuštění je mohou nahradit. Spuštění omezená na cílový jazyk nebo konkrétní klíče neaktualizují existující výchozí stav zdroje a zmrazený režim může inicializovat chybějící Lockfile. Než budete dílčí výstup považovat za plně aktualizovaný projekt, přečtěte si o ustálení výchozího stavu.

Při vývoji lingo run --watch sleduje změny zdroje, dokud jej nezastavíte pomocí Ctrl+C. Než testovací projekt rozšíříte, prostudujte si převzetí existujících překladů a ruční správu cílových hodnot.