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:
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 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:
{
"welcome": "Welcome back",
"button.save": "Save changes"
}Usa el contenedor 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. 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 #
lingo runRevisa 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.