Instala la CLI de Lingo.dev, configura tu proyecto y genera tus primeras traducciones.
Requisitos previos
Necesitas Node.js 18 o superior. Ejecuta node -v para comprobar 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, instala primero el paquete con npm install lingo.dev@latest y luego usa npx lingo.
Sigue las indicaciones. La 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 con patrones de inclusión que indican a la 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 hayas configurado: locales/en.json para el idioma de origen, locales/es.json para español, y así sucesivamente.
Para consultar la lista completa de formatos de archivo compatibles y la configuración de sus buckets, consulta Formatos compatibles.
Paso 3. Conecta un backend de traducción#
La CLI necesita un backend de traducción para generar traducciones. Tienes dos opciones:
Un motor de localización en Lingo.dev aplica automáticamente la voz de marca, el glosario, las instrucciones y la configuración del modelo a cada solicitud de traducción.
Crea una cuenta y genera una clave de API en 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: la CLI usa el motor de localización predeterminado de tu organización. Para usar un motor específico, añade engineId a tu i18n.json:
{
"engineId": "eng_SxjMwMsfOIsvV1wh"
}Paso 4. Genera traducciones#
npx lingo.dev@latest runLa CLI detecta tus archivos de origen, extrae el contenido traducible, lo envía al backend de traducción que hayas configurado y guarda los resultados en disco. También crea un archivo i18n.lock para hacer seguimiento de lo que ya se ha traducido; inclúyelo en el commit junto con tus archivos de idioma.
