CLI

Traduce archivos del proyecto, recupera los resultados y mantén los catálogos de origen que usan las aplicaciones React.

La CLI de Lingo.dev conecta los archivos de tu proyecto con un motor de localización. Configura las rutas de origen y los idiomas de destino, envía el contenido seleccionado y recupera los archivos traducidos. Las ejecuciones posteriores procesan los cambios a partir de la versión de referencia del contenido de origen que quedó registrada.

@lingo.dev/cli instala el ejecutable lingo. Comienza con tu primer archivo para seguir el proceso completo de configuración y recuperación.

Instala la versión actual de @lingo.dev/cli y usa lingo --version para registrar la versión que utiliza tu proyecto. Para lingo.dev@0.138.10 y sus proyectos i18n.json, consulta la Referencia de la CLI v0.

Instala según tu forma de trabajar #

Para una dependencia del proyecto registrada en el control de versiones:

sh
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --version

Para un ejecutable disponible en toda la terminal:

sh
npm install --global @lingo.dev/cli
lingo --help

Este manual usa lingo directamente. Si lo instalas de forma local, ejecútalo mediante tu gestor de paquetes. npx @lingo.dev/cli@latest y pnpm dlx @lingo.dev/cli@latest ejecutan la versión más reciente sin una instalación persistente. Fija una versión cuando el comportamiento local y el de CI deban coincidir; los ejemplos de CI usan Node.js 22.

lingo update usa el método de instalación detectado. Usa el gestor de paquetes para especificar una versión o cuando la instalación no se reconozca o sea temporal.

Traduce archivos o extrae mensajes #

Para los recursos existentes, configura los archivos, autentícate y vincula un motor de localización. La traducción se ejecuta en el servidor. push --wait espera y descarga los resultados; los comandos independientes push y pull te permiten recuperarlos más tarde.

Para las llamadas en el código fuente de React, la extracción crea JSONC y declaraciones de TypeScript de forma local. No traduce ni instala un entorno de ejecución. Agrega el catálogo extraído a la configuración de archivos para traducirlo y luego cárgalo mediante el flujo de trabajo de catálogos de React.

Conserva el estado necesario para las actualizaciones #

Un primer envío estándar almacena los bytes de origen. La operación de completado crea los archivos de destino que faltan; los envíos estándar posteriores traducen los cambios en el contenido de origen. Mantén .lingo/config.json, .lingo/lock.json y las traducciones aceptadas juntos en el control de versiones. Las credenciales y el puntero a la última ejecución permanecen en tu directorio personal.

Enviar, Recuperar y Lockfile y caché explican las opciones de modo y recuperación. Comandos enumera los comandos de configuración, traducción y mantenimiento de catálogos.