Comprueba la localización de React durante la revisión de código

Usa la extracción, las comprobaciones de catálogos, TypeScript y la compilación de la aplicación para detectar distintos errores de localización antes de fusionar los cambios.

Un mensaje modificado en React llega a quien lo lee a través del código fuente, la extracción, un catálogo de destino y el cargador de la aplicación. Revisa toda esa cadena, además de la redacción. Una traducción correcta asociada a una identidad desactualizada nunca llega a mostrarse; usar el texto de origen como alternativa puede ocultar una traducción ausente sin que la pantalla deje de ser utilizable.

Este método se aplica al paquete de React actual con catálogos JSONC extraídos mediante la CLI. Combina las comprobaciones de extracción de la CLI con las comprobaciones de compilación y renderizado del propio proyecto.

Revisa primero el cambio en el código fuente #

Lee el nuevo mensaje de origen como una instrucción o una afirmación dirigida a quien usa la aplicación. Después, lee su contexto. «Botón» describe una forma; «Cancelar un pago programado antes de enviarlo» explica la acción cuyo significado debe conservarse. Tanto el texto de origen como el contexto intervienen en la identidad, por lo que cambiar solo el contexto puede requerir una nueva entrada de destino.

Revisa los marcadores de posición como valores cuya función debe mantenerse estable. Quien traduce debe poder cambiar la posición del nombre de una persona o de un importe sin alterar su identidad. Para el texto enriquecido, mantén la navegación y el comportamiento de los componentes en el código y traduce la frase que rodea las etiquetas con nombre. Mensajes y Texto enriquecido detallan las API exactas.

Comprueba la extracción antes de comprobar los destinos #

Desde el directorio del proyecto que quieras comprobar, con la CLI instalada:

sh
lingo extract --check
lingo check

Usa las mismas opciones --src, --source-locale, --out y --types que el comando de extracción del proyecto. El idioma de origen predeterminado es en; la configuración de localización no modifica el valor predeterminado de ese comando. A continuación, ejecuta la comprobación de TypeScript y la compilación de producción del repositorio, incluidas las declaraciones generadas.

Defecto que introducir en un caso de prueba local para la revisiónControl y evidencia esperada
Cambiar un mensaje de origen sin regenerar los catálogos ni las declaraciones.extract --check compara el resultado generado y falla si está desactualizado.
Omitir el contexto obligatorio en un mensaje extraído.check informa del problema de extracción o contexto; revisa el código fuente para corregir el significado.
Dejar una entrada ausente o vacía en un catálogo JSONC de destino existente.check informa de la traducción ausente en el catálogo detectado.
Dejar desactualizadas las declaraciones generadas.La extracción y la comprobación detectan la discrepancia en el resultado generado; TypeScript comprueba por separado su uso en la aplicación.
Provocar un fallo en la importación de un idioma o en la integración con el marco de trabajo.La compilación real de la aplicación debería revelar el fallo de integración.

Usa un caso de prueba local cuando configures estas comprobaciones por primera vez. extract --check finaliza correctamente aunque no encuentre archivos de código fuente, así que confirma que el directorio indicado contiene el código que quieres comprobar. De lo contrario, un resultado satisfactorio puede significar que la comprobación no ha inspeccionado nada.

Comprueba explícitamente la cobertura de los idiomas obligatorios #

Cuando los patrones files de .lingo/config.json coinciden con el catálogo de origen (por ejemplo, locales/en.jsonc), lingo check también exige todos los archivos de idiomas de destino configurados. El patrón que escribe lingo init --yes, locales/en.json, no coincide con un catálogo .jsonc, por lo que con ese patrón solo se ejecutan las comprobaciones de React. Solo informa de claves ausentes en los catálogos JSONC de destino que ya existen. Como parte de la revisión, compara la lista de idiomas obligatorios con los archivos y las importaciones. Elimina temporalmente una entrada de destino en un caso de prueba local para ver cómo se muestra en pantalla el texto de origen usado como alternativa.

Lee pares representativos de mensajes de origen y de destino para comprobar su significado, especialmente las promesas que hayan cambiado y los términos del producto. Una comprobación de coherencia de JSONC sin errores no evalúa ese significado. ARB, XML de Android, los catálogos de Apple y los documentos estáticos requieren su validación nativa, no esta comprobación de cobertura específica de React.

Resuelve las diferencias sin perder el resultado revisado #

Regenera el resultado desactualizado con lingo extract, revisa las entradas añadidas y huérfanas, y traduce los cambios necesarios. Conserva la redacción de destino ya revisada y el archivo de bloqueo de localización. Eliminar entradas huérfanas modifica los catálogos y debe revisarse por separado del cambio en el mensaje de origen.

Decide si las traducciones se incorporan a la rama de origen o mediante una PR de traducción independiente. La guía de CI explica las ventajas y los inconvenientes de cada opción de entrega y las diferencias de la aplicación gestionada. En ambos casos, mantén el permiso para fusionar separado del permiso para ejecutar y de la aceptación del contenido.

Para terminar, carga la pantalla modificada en un idioma de destino con valores representativos. Sigue los enlaces del texto enriquecido, comprueba cómo se usa el texto de origen como alternativa y compara el mensaje mostrado con la acción prevista. La revisión estará completa cuando hayas examinado tanto el recorrido del mensaje en el programa como su redacción.