Traduce un archivo con CLI v0

Reproduce una ejecución de un pequeño catálogo heredado con un paquete de versión fija y revisa el resultado y su Lockfile.

Usa este procedimiento para un proyecto i18n.json instalado o un entorno de prueba heredado y aislado. Está pensado para lingo.dev@0.138.10, cuyo manifiesto requiere Node.js 18 o posterior. Revisa primero node --version y tu versión instalada de lingo --version. Para proyectos nuevos, usa la guía de inicio rápido actual.

Usa el paquete registrado #

Conserva la versión fija de la dependencia de un proyecto existente. Para un entorno de prueba independiente, elige el administrador de paquetes que usas:

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

Ejecuta solo un comando de instalación. Invoca el ejecutable local mediante npm exec -- lingo, pnpm exec lingo, yarn lingo o bun run lingo. En los ejemplos siguientes, esto se abrevia como lingo. En Windows, usar una instalación local de versión fija e invocar el ejecutable del administrador de paquetes también evita depender de la resolución de comandos por nombre de paquete.

Crea el catálogo y la configuración #

Ejecuta lingo init desde el directorio donde debe residir el proyecto. Esto crea i18n.json; si el archivo ya existe, consérvalo en lugar de reinicializarlo. Crea locales/en.json:

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

Usa el contenedor JSON correspondiente:

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

version es la versión del esquema de configuración, no la del paquete. Este patrón lee el contenido en inglés de locales/en.json y escribe el contenido en español en locales/es.json.

Configura el servicio de traducción #

Para Lingo.dev, proporciona LINGO_API_KEY mediante el mecanismo de gestión de secretos de tu intérprete de comandos. Agrega el engineId que quieres usar a la configuración y asegúrate de que la clave permita traducir a través de ese motor de localización. Si lo omites, se aplica la selección implícita del servicio; la política actual del servicio puede exigir un ID explícito.

La configuración v0 con un proveedor directo es una opción independiente que requiere credenciales específicas del proveedor o un servicio Ollama accesible. Su referencia de configuración explica los campos. Estos no deben incluirse en la configuración JSON de la CLI actual.

Ejecuta y revisa #

sh
lingo run

Revisa tanto las claves como los valores traducidos de locales/es.json. Confirma que el mensaje de guardado siga indicando la acción prevista. Al conectarlo a una aplicación, carga el catálogo de destino mediante el cargador de catálogos que la aplicación usa realmente. Confirma juntos en el repositorio el resultado aceptado, la configuración y i18n.lock.

Una ejecución normal sin cambios en el origen debería conservar los valores de destino existentes. Los cambios en el origen o una ejecución forzada pueden reemplazarlos. Las ejecuciones limitadas a un idioma de destino o a determinadas claves no actualizan una base de referencia de origen existente, y el modo congelado puede inicializar un Lockfile si no existe. Lee establecimiento de la base de referencia antes de considerar que un resultado de alcance limitado equivale a un proyecto completamente actualizado.

Durante el desarrollo, lingo run --watch monitorea los cambios en el origen hasta que lo detienes con Ctrl+C. Antes de ampliar el entorno de prueba, revisa la adopción de traducciones existentes y el control manual del contenido de destino.