Agregar y administrar idiomas en CLI v0

Selecciona la variante de idioma que necesitas, agrega un idioma de destino en la versión heredada y verifica su comportamiento en los archivos y la aplicación.

En v0, locale.source indica el idioma original y locale.targets selecciona los idiomas de destino para las traducciones recurrentes. Elige la variante que necesitan tus lectores y comprueba que la configuración, los nombres de archivo, el backend y la aplicación la usen de forma consistente.

Agregar un idioma de destino #

Para agregar alemán a los idiomas español y francés ya disponibles, edita i18n.json:

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

Ejecuta el binario de v0 instalado para ese idioma de destino:

sh
lingo run --target-locale de

La opción reemplaza la lista de destinos para esta ejecución y permite seleccionar un idioma que no esté en la configuración. Agrégalo a la configuración para futuras ejecuciones. El patrón de archivos separados locales/[locale].json escribe locales/de.json; revisa los valores y carga ese archivo en la aplicación antes de habilitar el alemán para tus lectores.

Un idioma de destino que aún no existe necesita todas las claves seleccionadas. Si ya existe, normalmente conserva los valores actuales y completa las claves faltantes, aunque los cambios en el contenido de origen pueden requerir una nueva traducción. Evita combinar la incorporación de un idioma por primera vez con un forzado de alcance amplio si los demás idiomas ya aceptados deben permanecer sin cambios.

Limitar una ejecución a un idioma de destino no actualiza la referencia existente de la suma de comprobación del contenido de origen. Una ejecución normal posterior puede volver a procesar el contenido de origen modificado, así que consulta las reglas de resolución antes de dar por hecho que una revisión de alcance limitado lo resuelve de forma permanente.

Usar la región y el sistema de escritura cuando sean relevantes #

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

Los idiomas que especifican una región permiten distinguir las convenciones solicitadas: color/colour en inglés, ordenador/computadora en español y trem/comboio en portugués muestran por qué elegir solo el idioma puede no ser suficiente. El uso sigue dependiendo del contexto; una etiqueta no garantiza que todas las expresiones generadas sean adecuadas para el público. El chino también puede requerir distinciones de sistema de escritura o región, como zh-Hans o zh-TW.

Revisa las listas de la versión que tienes instalada:

sh
lingo show locale sources
lingo show locale targets

Estas listas no garantizan que todos los backends acepten los idiomas ni que ofrezcan traducciones de calidad. Verifica el par elegido con una ejecución pequeña antes de ampliar su uso, en lugar de basarte en un recuento histórico de idiomas.

Separar la identidad del idioma de la organización de los archivos #

El procesamiento de la versión heredada normaliza varias formas de escribir los códigos de idioma según la plataforma para las solicitudes a la API. Los archivos pueden seguir requiriendo guiones bajos o nombres de recursos de Android. Usa la configuración del delimitador y la organización del formato, y luego revisa la ubicación real de los archivos de salida.

La traducción no establece dir, no invierte la disposición de los controles ni agrega enrutamiento. El árabe, el hebreo, el persa y el urdu suelen requerir una presentación de derecha a izquierda (RTL); revisa la interfaz que usa el contenido, incluidos los números e identificadores integrados. La aplicación debe reconocer el nuevo idioma, además de cargar su contenido.

Eliminar un idioma de destino #

Eliminar un código de locale.targets evita que se seleccione en futuras ejecuciones. Los archivos existentes se conservan. Decide por separado si quieres conservarlos, dejar de servirlos o eliminarlos. Purgar es una operación destructiva y puede seleccionar contenido de origen; no equivale a eliminar un idioma de la configuración.