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:
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --versionPara un ejecutable disponible en toda la terminal:
npm install --global @lingo.dev/cli
lingo --helpEste 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.