CLI
Traduce los archivos del proyecto, recupera los resultados y mantén los catálogos de origen que utilizan 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. En las siguientes ejecuciones, se utiliza la versión de referencia del contenido de origen registrada para procesar los cambios.
@lingo.dev/cli instala el ejecutable lingo. Empieza por tu primer archivo para seguir todos los pasos de configuración y recuperación.
Instala la versión actual de @lingo.dev/cli y usa lingo --version para dejar constancia de 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 instalarlo como dependencia del proyecto registrada en el control de versiones:
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --versionPara disponer del ejecutable en toda la consola:
npm install --global @lingo.dev/cli
lingo --helpEste manual utiliza 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 última versión sin instalarla de forma permanente. Fija una versión cuando necesites que el comportamiento sea el mismo en local y en CI; los ejemplos de CI utilizan Node.js 22.
lingo update utiliza el método de instalación detectado. Usa el gestor de paquetes para elegir una versión concreta o si la instalación no se reconoce o es 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; push y pull te permiten separar estos pasos y recuperarlos más adelante.
Para las llamadas en el código fuente de React, extraer crea JSONC y declaraciones de TypeScript de forma local. No traduce ni instala un entorno de ejecución. Añade el catálogo extraído a la configuración de archivos para traducirlo y, después, cárgalo mediante el flujo de trabajo de catálogos de React.
Conserva el estado necesario para las actualizaciones #
El primer envío normal almacena los bytes del contenido de origen. El proceso de completado crea los archivos de destino que faltan; los siguientes envíos normales traducen los cambios en el contenido de origen. Guarda .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 los modos de ejecución y de recuperación. Comandos recoge los comandos de configuración, traducción y mantenimiento de catálogos.