Agrega un idioma sin volver a traducir todo
Incorpora un nuevo idioma de destino, conserva las traducciones aceptadas y verifica que la aplicación pueda usar los nuevos recursos.
Agregar un idioma implica tres tareas: seleccionarlo para traducir, crear los recursos y hacer que la aplicación los cargue. Agregar una opción de idioma a la interfaz no crea su catálogo. Tener un catálogo traducido no hace que la ruta lo use.
Parte de un contenido de origen que puedas recuperar y de traducciones de destino aceptadas. Registra el idioma previsto, incluida la región o el sistema de escritura cuando sea necesario. pt-BR y pt-PT identifican públicos distintos que pueden tener diferentes requisitos de redacción.
Revisa la estructura y las pautas existentes #
Enumera los patrones de origen, los idiomas de destino actuales y las rutas de salida esperadas. Los archivos de destino separados se pueden agregar de forma independiente; un catálogo de cadenas compartido de Xcode almacena espacios para varios idiomas en un solo archivo, por lo que la existencia del archivo no basta para determinar la cobertura.
Revisa la cobertura de los modelos, la terminología, el registro y la voz para el nuevo público. Reutiliza las pautas de idiomas cercanos solo cuando sean pertinentes. Un término puede mantenerse igual aunque cambien las formas de dirigirse al público. La compatibilidad con idiomas que se escriben de derecha a izquierda también requiere ajustes en la dirección del texto y el diseño de la aplicación, no solo cadenas traducidas.
Agrega el idioma de destino al proyecto actual de la CLI #
Los idiomas de destino actuales de la CLI se obtienen de targetLocales en .lingo/config.json. push no tiene las opciones --target-locale ni --locale. En un monorepositorio, confirma qué configuración de proyecto se selecciona según el directorio de trabajo.
Antes de agregar el idioma de destino, completa con lingo push --wait las actualizaciones habituales del contenido de origen que estén pendientes para los idiomas existentes. Termina la revisión, recupera los archivos de salida y compara esas traducciones con el contenido de origen actual. Mantén fija esa versión del contenido de origen mientras agregas el nuevo idioma.
El proceso de completar archivos faltantes deja intactos los archivos de destino existentes. Cuando crea solo los archivos del nuevo idioma, conserva la versión base existente del contenido de origen para que un envío habitual posterior pueda procesar las modificaciones pendientes para los demás idiomas. Completar primero esas actualizaciones mantiene las traducciones existentes y las nuevas alineadas con la misma versión revisada del contenido de origen.
Luego agrega el idioma de destino a la configuración del proyecto instalado, autenticado y vinculado, y revisa el trabajo previsto para los archivos faltantes:
lingo push --backfill-missing --estimate
lingo push --backfill-missing --waitLa estimación no traduce nada ni crea una tarea, pero sube los archivos que le faltan al servidor para planificar el trabajo. No funciona sin conexión ni garantiza un precio. El proceso de completar archivos faltantes recorre los patrones configurados y crea los archivos de destino que faltan; no agrega claves nuevas a un archivo de destino existente. Una vez que el nuevo idioma esté al día, los cambios habituales posteriores en el contenido de origen usarán lingo push --wait con la versión base guardada.
En los catálogos compartidos de XCStrings, el trabajo se planifica por idioma dentro de un mismo archivo; revisa las nuevas entradas con el flujo de trabajo de iOS.
Si la solicitud debe abarcar un solo idioma, limita targetLocales en una rama controlada o en la configuración de una tarea y luego restablece la lista completa. No agregues la opción de forzar solo para incluir el nuevo idioma: vuelve a traducir los destinos existentes dentro del alcance y puede reemplazar una redacción ya revisada. Envío documenta esas diferencias; la referencia de idiomas de CLI v0 describe las opciones de esa generación anterior.
Establece los mismos límites para un asistente #
Un agente puede revisar la estructura, proponer pautas para el idioma y preparar los cambios de configuración. Especifica si puede modificar archivos locales, la configuración del motor de localización de la organización o ambos. Delegación distingue esas facultades.
Pídele que explique qué modelos principales y de respaldo se aplican, qué pautas son compartidas y cuáles son específicas de cada idioma. Confirma el estado guardado antes de comparar los resultados. Resolución de idioma explica la selección; una preferencia de modelo no es un parámetro de referencia para la calidad lingüística.
Verifica el resultado para el nuevo público #
Compara las rutas devueltas y los cambios con el alcance previsto. Las traducciones de destino ya aceptadas deben permanecer intactas, salvo que una actualización del contenido de origen o una corrección autorizada justifique el cambio. Valida las variables, las variantes de plural y los metadatos del idioma con las herramientas de recursos de la aplicación.
Carga contenido representativo en el nuevo idioma. Revisa el comportamiento de respaldo, el desbordamiento y la dirección del texto, además del significado. Conserva la versión del contenido de origen y el resultado para la medición antes de ampliar la cobertura.
Al quitar un idioma de la configuración, deja de seleccionarse para trabajos nuevos; sus recursos y rutas en tiempo de ejecución no se eliminan. Decide esos cambios por separado, especialmente cuando un catálogo compartido contiene el contenido de origen y varios idiomas.