Agregar idiomas

Max PrilutskiyCEO y cofundadorActualizado el hace 3 meses · 1 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

Agrega nuevos idiomas de destino actualizando el arreglo 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.

Agregar un idioma#

Actualiza la configuración de tu 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 idioma nuevo:

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

Idiomas existentes vs. idiomas nuevos#

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

Idiomas existentesIdiomas nuevos
ComportamientoSolo se traducen las claves faltantesSe 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 recibe un archivo de traducción independiente, con terminología, ortografía y tono adecuados para su región.

Generación puntual#

Genera traducciones para un idioma específico sin procesar todos los targets:

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

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

Eliminar idiomas#

Quita un idioma del arreglo targets y la CLI dejará de procesarlo. Los archivos existentes no se eliminan; bórralos manualmente si hace falta.

Siguientes pasos#