|
Documentación
Reservar una demoPlataforma
PlataformaMCPCLI
APIFlujos de trabajo
GuíasRegistro de cambios

Descripción general

  • @lingo.dev/cli

Primeros pasos

  • Guía rápida
  • Configuración

Referencia

  • lingo push
  • lingo pull
  • Otros comandos
  • lingo purge

Configuración

  • Controles de claves
  • Formatos
  • Idiomas

Guías

  • Añadir un idioma
  • Traducciones existentes
  • Retraducción
  • Notas de traducción
  • Ejecuciones, estado y recuperación
  • CI/CD
  • Monorepos
  • Proyectos grandes

¿Buscas la versión anterior de la CLI (v0)? Consulta la documentación de la CLI antigua

Traducciones existentes

No hace falta empezar con un proyecto vacío. Si ya tienes archivos traducidos, el CLI trabaja con ellos: completa lo que falta y mantiene intactas las traducciones que ya tienes.

Haz que la configuración apunte a lo que ya tienes#

Define los idioma de origen y de destino, junto con los patrones de archivo, para que coincidan con la ubicación de tus traducciones actuales:

json
{
  "sourceLocale": "en",
  "targetLocales": ["de", "fr"],
  "files": [{ "pattern": "locales/en.json" }]
}

Si locales/de.json y locales/fr.json ya existen, se quedan tal y como están.

Rellena los huecos#

bash
lingo push --backfill-missing

--backfill-missing solo genera destinos que faltan: un idioma que todavía no tiene archivo o, después de la primera ejecución, claves que el motor aún no ha traducido. Los archivos que ya tienes no se sobrescriben.

text
✓ Run lfr_a8c...: localized 1 target file(s), 2 already up-to-date.

Mantén ciertos valores bloqueados#

Si algunas traducciones existentes se han revisado manualmente y no deben cambiar nunca, márcalas como preservedKeys para que ninguna ejecución futura las toque:

json
{ "pattern": "locales/en.json", "preservedKeys": ["legal.terms"] }

Cómo se inicializa el lockfile#

El primer push registra un hash de cada archivo de origen en .lingo/lock.json. A partir de ahí, un lingo push normal solo envía los archivos de origen que han cambiado: tus traducciones existentes no vuelven a enviarse salvo que cambies el origen o lo fuerces. Haz commit del lockfile junto con tus traducciones. Consulta Configuration.

Sobrescribir a propósito

--backfill-missing nunca sobrescribe. Si quieres regenerar deliberadamente traducciones existentes (tras un cambio de modelo o de instrucciones), usa un push acotado con --force.

¿Te ha resultado útil esta página?

Max PrilutskiyMax Prilutskiy·Actualizado hace 4 días·1 min de lectura