Instala el CLI de Lingo.dev, configura tu proyecto y genera tus primeras traducciones.
Requisitos previos
Necesitas Node.js 18 o superior. Ejecuta node -v para verificar tu versión.
Paso 1. Inicializa un proyecto#
Ve a tu proyecto
cd your-project-directoryEjecuta el comando init
npx lingo.dev@latest initUsuarios de Windows: Si npx lingo.dev no funciona, primero instala el paquete con npm install lingo.dev@latest y luego usa npx lingo.
Sigue las instrucciones. El CLI crea un archivo de configuración i18n.json en la raíz de tu proyecto.
Paso 2. Configura un bucket#
En i18n.json, configura al menos un bucket: un formato de archivo junto con patrones de inclusión que le indican al CLI dónde está el contenido traducible:
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["locales/[locale].json"]
}
}
}El marcador de posición [locale] se resuelve en tiempo de ejecución con los códigos de idioma que configuraste: locales/en.json para el idioma de origen, locales/es.json para español, y así sucesivamente.
Consulta la lista completa de formatos de archivo compatibles y sus configuraciones de bucket en Formatos compatibles.
Paso 3. Conecta un backend de traducción#
El CLI necesita un backend de traducción para generar traducciones. Tienes dos opciones:
Un motor de localización en Lingo.dev aplica automáticamente voz de marca, glosario, instrucciones y configuración del modelo a cada solicitud de traducción.
Crea una cuenta y genera una clave de API desde la página API Keys.
Configura la clave de API como variable de entorno:
export LINGO_API_KEY="your-api-key"No necesitas configuración adicional: el CLI usa el motor de localización predeterminado de tu organización. Para usar un motor específico, agrega engineId a tu i18n.json:
{
"engineId": "eng_SxjMwMsfOIsvV1wh"
}Paso 4. Genera traducciones#
npx lingo.dev@latest runEl CLI detecta tus archivos de origen, extrae el contenido traducible, lo envía al backend de traducción que configuraste y guarda los resultados en disco. También crea un archivo i18n.lock para llevar el seguimiento de lo que ya se tradujo; haz commit de ese archivo junto con tus archivos de idioma.
