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:
{
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
}
}Ejecuta la CLI:
npx lingo.dev@latest runLa CLI crea archivos de traducción completos para cada idioma nuevo:
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 existentes | Idiomas nuevos | |
|---|---|---|
| Comportamiento | Solo se traducen las claves faltantes | Se generan archivos completos desde cero |
| Contenido existente | Se conserva | N/A |
Variantes regionales#
La CLI admite variantes regionales de idioma mediante etiquetas BCP 47:
{
"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:
npx lingo.dev@latest run --target-locale deEsto 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.
