Añadir idiomas

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

Obsoleto

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

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#