Stávající překlady

Lingo.dev CLI se snadno začlení do projektů, které už mají překladové soubory. Porovná zdrojové klíče s existujícími cílovými soubory, vygeneruje jen chybějící překlady a vaši dosavadní práci nechá beze změny.

Jak to funguje#

Když CLI spustíte nad projektem s částečně hotovými překlady, provede analýzu chybějících položek:

// locales/en.json (source - 4 keys)
{
  "welcome": "Welcome to our app",
  "button.save": "Save",
  "button.cancel": "Cancel",
  "error.network": "Network error"
}

// locales/es.json (existing - 2 keys translated)
{
  "welcome": "Bienvenido a nuestra aplicación",
  "button.save": "Guardar"
}

Spuštěním npx lingo.dev@latest run doplníte jen chybějící klíče:

// locales/es.json (after run - all 4 keys present)
{
  "welcome": "Bienvenido a nuestra aplicación",
  "button.save": "Guardar",
  "button.cancel": "Cancelar",
  "error.network": "Error de red"
}

Stávající překlady v souborech welcome a button.save zůstanou beze změny.

První spuštění#

Při prvním spuštění CLI vytvoří soubor i18n.lock podle aktuálního stavu projektu. Tento lockfile ukládá otisky veškerého zdrojového obsahu, takže se při dalších spuštěních znovu nevygenerují už existující překlady — i když původně vznikly v jiném nástroji.

Migrace z jiných nástrojů#

CLI funguje s překladovými soubory vytvořenými v libovolném nástroji, pokud používají podporovaný formát (JSON, YAML, PO atd.):

Obnovení překladů#

Pokud mají stávající překlady problémy s kvalitou, můžete je cíleně přeložit znovu:

# Retranslate all Spanish content
npx lingo.dev@latest run --force --target-locale es

# Retranslate a specific key across all languages
npx lingo.dev@latest run --force --key error.network

Další možnosti najdete v části Retranslation.

Další kroky#