Verifica la localización de React en la revisión de código
Usa la extracción, las verificaciones de catálogos, TypeScript y la compilación de la aplicación para detectar distintos problemas de localización antes de fusionar los cambios.
Un mensaje modificado en React llega a quienes lo leen 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 con una identidad desactualizada nunca se muestra; usar el texto de origen como alternativa puede ocultar una traducción faltante 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 verificaciones de extracción de la CLI con las verificaciones de compilación y renderizado del propio proyecto.
Inspecciona primero el cambio en el código fuente #
Lee el nuevo mensaje de origen como una instrucción o 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 con un propósito estable. Quien traduce debe poder cambiar el orden del nombre de una persona o de un importe sin alterar su identidad. En el texto enriquecido, mantén la navegación y el comportamiento de los componentes en el código y traduce la oración que rodea las etiquetas con nombre. Mensajes y Texto enriquecido detallan las API exactas.
Verifica la extracción antes de revisar los catálogos de destino #
Desde el directorio del proyecto que corresponda, con la CLI instalada:
lingo extract --check
lingo checkUsa 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 cambia ese valor predeterminado del comando. Después, ejecuta la verificación de TypeScript y la compilación de producción del repositorio, incluidas las declaraciones generadas.
| Defecto que se debe introducir en un caso de prueba local para revisión | Control y evidencia esperada |
|---|---|
| Cambia un mensaje de origen sin regenerar los catálogos ni las declaraciones. | extract --check compara el contenido generado y falla si está desactualizado. |
| Omite el contexto obligatorio en un mensaje extraído. | check informa del problema de extracción o contexto; inspecciona el código fuente para corregir el significado. |
| Deja una entrada faltante o vacía en un catálogo JSONC de destino existente. | check informa de la traducción faltante en el catálogo detectado. |
| Deja desactualizadas las declaraciones generadas. | La extracción y la verificación detectan la discrepancia en el contenido generado; TypeScript verifica por separado su uso en la aplicación. |
| Provoca un error 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 error de integración. |
Usa un caso de prueba local cuando configures estas verificaciones por primera vez. extract --check se completa correctamente incluso si no encuentra archivos de código fuente, así que confirma que el directorio indicado contiene el código que quieres verificar. De lo contrario, un resultado exitoso puede significar que la verificación no inspeccionó nada.
Verifica explícitamente la cobertura de los idiomas requeridos #
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 el archivo de cada idioma de destino configurado. 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 verificaciones de React. Solo informa de claves faltantes en los catálogos JSONC de destino existentes. Como parte de la revisión, compara la lista de idiomas requeridos con los archivos y las importaciones. Elimina temporalmente una entrada de destino en un caso de prueba local para ver cómo aparece en pantalla el texto de origen cuando se usa como alternativa.
Lee pares representativos de textos de origen y destino para comprobar su significado, en especial cuando cambien las promesas o los términos del producto. Una verificación de coherencia de JSONC sin errores no evalúa ese significado. Los archivos ARB, el XML de Android, los catálogos de Apple y los documentos estáticos requieren su validación nativa, no esta verificación de cobertura específica de React.
Resuelve las diferencias sin destruir el contenido revisado #
Regenera el contenido desactualizado con lingo extract, inspecciona las entradas agregadas y huérfanas, y traduce los cambios necesarios. Conserva la redacción de destino revisada y el 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 llegarán a la rama de origen o mediante una PR de traducción independiente. La guía de CI explica las ventajas y desventajas de cada modalidad de entrega y las diferencias de la App administrada. En ambos casos, mantén el permiso para fusionar separado del permiso de ejecución 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, inspecciona cómo se usa el texto de origen como alternativa y compara el mensaje mostrado con la acción prevista. La revisión está completa cuando se han examinado tanto el recorrido del mensaje dentro del programa como su redacción.