Inicio rápido

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

Obsoleto

Esta documentación cubre el CLI heredado (v0). La versión actual del CLI es la v1. Ver la documentación actual de 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 tu administrador de paquetes preferido:

bash
npm install -g lingo.dev

Verifica la instalación#

Confirma que la CLI esté instalada correctamente:

bash
lingo --version

Deberías ver un resultado como este:

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. Conectarte a tu cuenta - Autentícate con tu API key
  2. Seleccionar un proyecto - Elige un proyecto existente o crea uno nuevo
  3. Configurar idiomas - Selecciona qué idiomas quieres admitir
  4. Definir la estructura de archivos - Elige 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 hará lo siguiente:

  • ✅ Detectar tus archivos de origen
  • ✅ Calcular un delta con 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 de origen:

bash
lingo run --watch

Presiona Ctrl+C para salir del modo watch.

Obtén 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 para recibir soporte en tiempo real!

Próximos pasos#