|Labs
Reservar una demoPlataforma
React (Lingo Compiler)
Alpha
React (MCP)React (i18n)CLI antiguo (v0)
Obsoleto

Lingo.dev CLI

  • Cómo funciona
  • Configuración
  • Inicio rápido
  • Monorepos

Configuración

  • Formatos compatibles
  • i18n.json
  • i18n.lock
  • Idiomas compatibles

Funciones

  • Traducciones existentes
  • Añadir idiomas
  • Sobrescrituras
  • Notas para traductores
  • Claves de traducción
  • Cambio de nombre de claves
  • Bloqueo de claves
  • Ignorar claves
  • Conservación de claves
  • Extrae claves con IA

Rendimiento

  • Proyectos de gran tamaño
  • Procesamiento en paralelo
  • Estimación de costes

Retraducción

  • Retraducción automática
  • Retraducción
  • Eliminar traducciones

Esta documentación corresponde a la CLI antigua (v0) y está obsoleta. La CLI actual es la v1. Consulta la documentación de la CLI actual

Añadir idiomas

Añade nuevos idiomas de destino actualizando el array targets en i18n.json y ejecutando la CLI. Para los idiomas nuevos, se generan archivos de traducción completos, mientras que las traducciones existentes no se modifican.

Añadir un idioma#

Actualiza la configuración de i18n.json:

json
{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  }
}

Ejecuta la CLI:

bash
npx lingo.dev@latest run

La CLI crea archivos de traducción completos para cada nuevo idioma:

text
locales/
  en.json    (source - unchanged)
  es.json    (existing - unchanged)
  fr.json    (existing - unchanged)
  de.json    (new - fully translated)

Idiomas existentes y nuevos#

La CLI gestiona de forma distinta los idiomas existentes y los nuevos:

Idiomas existentesIdiomas nuevos
ComportamientoSolo se traducen las claves que faltanSe generan archivos completos desde cero
Contenido existenteSe conservaN/A

Variantes regionales#

La CLI admite variantes regionales de idioma mediante etiquetas BCP 47:

json
{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-MX", "fr-FR", "fr-CA", "pt-BR", "pt-PT"]
  }
}

Cada variante tiene su propio archivo de traducción, con terminología, ortografía y tono adaptados a la región.

Generación por idioma#

Genera traducciones para un idioma concreto sin procesar todos los destinos:

bash
npx lingo.dev@latest run --target-locale de

Esto resulta útil cuando añades un idioma cada vez para hacer una revisión de calidad antes de seguir ampliando.

Eliminar idiomas#

Elimina un idioma del array targets y la CLI dejará de procesarlo. Los archivos existentes no se eliminan; bórralos manualmente si es necesario.

Siguientes pasos#

Traducciones existentes
Intégralo con proyectos que ya tienen traducciones
Procesamiento en paralelo
Procesa varios idiomas a la vez
Proyectos grandes
Estrategias para escalar la localización
i18n.json
Referencia completa de la configuración

¿Te ha resultado útil esta página?

Max PrilutskiyMax Prilutskiy·Actualizado hace 5 días·1 min de lectura