Traducir un archivo JSON

Por qué los archivos de idioma se rompen tan fácil

Un desarrollador exporta en.json, se lo entrega a un traductor y tres días después recibe un archivo donde alguien, con buena intención, renombró una clave anidada o reordenó un arreglo porque así sonaba más natural. La aplicación falla por una clave faltante y nadie lo nota hasta que una pantalla aparece en blanco en producción. translate.json evita eso por completo tratando las claves como identificadores inmutables y los valores como lo único elegible para traducir: la estructura que usted envía es exactamente la que recibe de vuelta.

Cómo decide qué traducir

Los valores de tipo cadena se traducen. Los números, los booleanos, los valores null y los arreglos de valores que no son cadenas pasan sin cambios, porque un timeout de 3000 milisegundos significa lo mismo en cualquier idioma. Los objetos anidados se recorren de forma recursiva, así que un archivo de idioma con secciones para botones, errores y textos de bienvenida recibe traducción en cada rama sin aplanar la estructura que su aplicación necesita para buscar las cadenas.

Los marcadores de posición quedan intactos

La mayoría de los frameworks de i18n incrustan variables dentro de las cadenas, cosas como {{username}} o %s, y una traducción que las altera rompe la aplicación al momento de mostrarla, no al momento de traducirla, lo que hace el error mucho más difícil de rastrear. El endpoint reconoce la sintaxis de interpolación más común y la conserva en su lugar, moviendo solo el idioma que la rodea y dejando los marcadores de variable exactamente donde el framework los espera.

Cómo encaja en un flujo de lanzamiento

Internacionalizar solía significar entregar una hoja de cálculo entre ingeniería y un proveedor de traducción, con una reimportación manual y una revisión de control de calidad para atrapar lo que quedara descuadrado en el camino. Un paso de integración continua que envía el archivo de idioma base en cada fusión a main y reescribe cada idioma traducido automáticamente cierra ese ciclo, porque la respuesta refleja exactamente la estructura de claves de entrada, así que un validador de esquema JSON puede confirmar que nada se movió antes de que el archivo llegue a una compilación. Cobrar por clave en lugar de por archivo hace que un proyecto con un archivo de idioma modesto de 40 claves pague una fracción de lo que paga un panel de administración con 2000 claves, manteniendo el costo proporcional al trabajo real de traducción en lugar de un cargo plano por archivo.