Añadir y gestionar idiomas en CLI v0

Selecciona la variante lingüística que necesitas, añade un idioma de destino en la versión antigua y comprueba el comportamiento de su archivo y de 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 necesita tu público y comprueba que la configuración, los nombres de archivo, el motor de procesamiento y la aplicación la utilicen de forma coherente.

Añadir un idioma de destino #

Para añadir alemán a las traducciones ya disponibles en español y francés, 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 sustituye la lista de idiomas de destino para esta ejecución y permite seleccionar un idioma que no figure en la configuración. Añádelo a la configuración para futuras ejecuciones. Un patrón de archivos separados locales/[locale].json genera locales/de.json; revisa los valores y carga ese archivo en la aplicación antes de habilitar el alemán para tu público.

Si el idioma de destino aún no existe, necesita todas las claves seleccionadas. Si ya existe, normalmente conserva los valores actuales y completa las claves que faltan, aunque los cambios en el contenido de origen pueden exigir una nueva traducción. Evita combinar la incorporación de un idioma por primera vez con una traducción forzada de amplio alcance 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 sumas 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 definitivamente.

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 con una región especificada 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 necesitar distinciones de sistema de escritura o región, como zh-Hans o zh-TW.

Consulta 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 motores de procesamiento acepten la combinación ni que ofrezcan traducciones de calidad. Comprueba la combinación elegida con una ejecución a pequeña escala antes de ampliar su alcance, en lugar de basarte en una cifra histórica de idiomas.

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

El procesamiento de la versión antigua normaliza varias grafías específicas de cada plataforma para las solicitudes a la API. Los archivos pueden seguir necesitando guiones bajos o la nomenclatura de recursos de Android. Utiliza el ajuste del delimitador y la organización del formato, y comprueba después la ubicación real de los archivos generados.

La traducción no establece dir, no invierte los controles ni añade rutas. El árabe, el hebreo, el persa y el urdu suelen necesitar una presentación de derecha a izquierda (RTL); comprueba la interfaz que utiliza 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 impide 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 es lo mismo que eliminar un idioma de la configuración.