Empieza a usar la CLI en menos de 5 minutos.
Requisitos previos
Asegúrate de tener Node.js 18.0 o superior instalado. Ejecuta node --version para comprobarlo.
Instalación#
Instala la CLI de forma global con el gestor de paquetes que prefieras:
npm install -g lingo.devComprueba la instalación#
Confirma que la CLI se ha instalado correctamente:
lingo --versionDeberías ver una salida como esta:
lingo.dev v0.133.9
Node.js v20.10.0Inicializa tu proyecto#
Ve al directorio de tu proyecto y ejecuta:
cd my-project
lingo initEste comando interactivo te permitirá:
- Conectar tu cuenta - Autenticarte con tu clave de API
- Seleccionar un proyecto - Elegir un proyecto existente o crear uno nuevo
- Configurar idiomas - Seleccionar qué idiomas quieres admitir
- Definir la estructura de archivos - Elegir dónde guardar los archivos de traducción
Configuración creada
La CLI crea un archivo i18n.json con tu configuración. Puedes modificarlo más adelante cuando lo necesites.
Tu primera traducción#
Crea un archivo de traducción sencillo:
{
"welcome": {
"title": "Welcome to Lingo.dev",
"subtitle": "The Localization Engineering Platform"
},
"auth": {
"login": "Log in",
"logout": "Log out"
}
}Ejecuta las traducciones#
Traduce tu contenido a todos los idiomas de destino configurados:
lingo runLa CLI se encargará de:
- ✅ Detectar tus archivos fuente
- ✅ Calcular un delta respecto al lockfile
- ✅ Enviar el contenido modificado a tu backend de traducción
- ✅ Guardar las traducciones en disco
Modo watch (desarrollo)#
Si estás desarrollando activamente, activa el modo watch para volver a traducir automáticamente cuando cambien los archivos fuente:
lingo run --watchPulsa Ctrl+C para salir del modo watch.
Obtener ayuda#
¿Necesitas ayuda?
# Show help for all commands
lingo --help
# Show help for a specific command
lingo run --helpÚnete a nuestra comunidad de Discord y obtén soporte en tiempo real.
