Traducir un archivo con CLI v0
Reproduce una ejecución de un pequeño catálogo heredado con una versión fija del paquete y revisa la salida y el Lockfile.
Sigue este procedimiento para un proyecto con i18n.json instalado o un entorno de pruebas heredado y aislado. Está pensado para lingo.dev@0.138.10, cuyo manifiesto requiere Node.js 18 o posterior. Comprueba primero node --version y la versión de lingo --version que tienes instalada. Los proyectos nuevos deben seguir la guía de inicio rápido actual.
Usa el paquete registrado #
Conserva la versión fija de la dependencia del proyecto existente. Para un entorno de pruebas independiente, elige el gestor de paquetes que utilices:
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.10Ejecuta un único 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, esta invocación se abrevia como lingo. En Windows, usar una instalación local con una versión fija e invocar el ejecutable del gestor 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 que deba alojar el proyecto. Esto crea i18n.json; si el archivo ya existe, consérvalo en lugar de volver a inicializarlo. Crea locales/en.json:
{
"welcome": "Welcome back",
"button.save": "Save changes"
}Usa el bloque JSON correspondiente:
{
"$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. Añade a la configuración el engineId que quieras utilizar y asegúrate de que la clave permite traducir con ese motor de localización. Si se omite, se aplica la selección implícita del servicio; la política actual del servicio puede exigir un ID explícito.
La configuración de v0 con un proveedor directo es una opción independiente, con 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 #
lingo runRevisa locales/es.json para comprobar tanto las claves como los valores de las traducciones. Confirma que el mensaje de guardado sigue indicando la acción prevista. Al conectarlo a una aplicación, carga el catálogo de destino con el cargador de catálogos que realmente utiliza la aplicación. Registra juntos en el control de versiones la salida aceptada, 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 sustituirlos. Las ejecuciones limitadas a un idioma de destino o a determinadas claves no actualizan la referencia de origen existente, y el modo congelado puede inicializar un Lockfile si falta. Lee consolidación de la referencia de origen antes de dar por hecho que una salida de alcance limitado supone que todo el proyecto está actualizado.
Durante el desarrollo, lingo run --watch supervisa los cambios en el origen hasta que lo detienes con Ctrl+C. Antes de ampliar el entorno de pruebas, consulta adopción de traducciones existentes y control manual de las traducciones de destino.