Inicio rápido

Max PrilutskiyCEO y cofundadorActualizado: hace 3 meses · 2 min de lectura

Obsoleto

Estos documentos cubren el CLI heredado (v0). El CLI actual es v1. Ver la documentación actual del CLI

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:

bash
npm install -g lingo.dev

Comprueba la instalación#

Confirma que la CLI se ha instalado correctamente:

bash
lingo --version

Deberías ver una salida como esta:

plaintext
lingo.dev v0.133.9
Node.js v20.10.0

Inicializa tu proyecto#

Ve al directorio de tu proyecto y ejecuta:

bash
cd my-project
lingo init

Este comando interactivo te permitirá:

  1. Conectar tu cuenta - Autenticarte con tu clave de API
  2. Seleccionar un proyecto - Elegir un proyecto existente o crear uno nuevo
  3. Configurar idiomas - Seleccionar qué idiomas quieres admitir
  4. 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:

json
{
  "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:

bash
lingo run

La 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:

bash
lingo run --watch

Pulsa Ctrl+C para salir del modo watch.

Obtener ayuda#

¿Necesitas ayuda?

bash
# 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.

Siguientes pasos#