JSONC
Traduce catálogos con comentarios que aportan contexto y conoce cuáles se conservan en el archivo traducido.
JSONC te permite mantener juntos cada mensaje y su explicación. El procesador de archivos jsonc interpreta el comentario que precede a una cadena como una indicación para traducirla y traduce los valores de cadena anidados siguiendo las mismas rutas que JSON.
Mantén esos comentarios en el catálogo de origen. El archivo de destino reconstruido utiliza una sangría de dos espacios y termina con un salto de línea. Conserva las marcas @orphan en las mismas entradas que el original y elimina todos los demás comentarios. Por tanto, cualquier componente que dependa de otros metadatos necesitará otra forma de conservarlos.
Coloca el contexto junto al valor al que se refiere #
Este catálogo explica qué se pide hacer a quien lee «Atrás»:
{
/* @context Button that returns to the previous checkout step */
"back": "Back",
"product": "Acme",
}El comentario se aplica al siguiente valor de cadena, no a todos los descendientes del objeto que lo contiene. Si entre ambos aparece un número, un booleano o un valor nulo, se descarta la indicación pendiente. Coloca el comentario justo antes de la cadena que describe y protege los identificadores fijos con los controles de la interfaz seleccionada.
Con @context, la indicación abarca el resto de esa línea. Sin él, todo el comentario se utiliza como indicación, de modo que cualquier comentario no vacío situado antes de una cadena llega al traductor. Si varios comentarios preceden a una cadena, se utiliza la última indicación no vacía, aunque un comentario anterior contenga @context. @orphan señala los metadatos del catálogo; la cadena sigue pudiendo seleccionarse para la traducción del archivo.
Traducción de archivos y catálogos de React #
La extracción de catálogos de React genera catálogos JSONC planos con metadatos asociados a las entradas. Su lector interpreta @context, @src y @orphan; el proceso de extracción utiliza esos campos para mantener las ubicaciones en el código fuente y marcar los mensajes que ya no se encuentran. Es un flujo de trabajo de gestión de catálogos, distinto de la traducción de un documento JSONC cualquiera.
Consulta Catálogos y tipos de React para mantener los mensajes extraídos. No elimines los metadatos del catálogo de origen dando por hecho que la traducción general de archivos volverá a generarlos en el archivo de salida.
Configura la traducción de archivos #
La CLI deduce jsonc a partir de .jsonc; la GitHub App acepta el tipo de archivo configurado. Selecciona las rutas de origen y destino en Configuración de la CLI o Configuración de GitHub.
Conserva los valores adecuados #
La comparación incremental, las rutas bloqueadas, preservadas e ignoradas y la inyección del idioma siguen las mismas distinciones que el procesador de archivos JSON. Bloquear copia los datos de origen; preservar conserva los datos de destino; ignorar elimina una ruta. Consulta JSON para conocer el orden de prioridad y las consecuencias de aplicar estas opciones a un ámbito parcial, en lugar de tratarlas como exclusiones intercambiables.
Comprueba las claves y los valores protegidos en el archivo reconstruido y, después, carga el archivo de destino con el lector de catálogos de la aplicación. En los catálogos de React, mantén los metadatos de origen disponibles para la extracción: el archivo de destino traducido conserva @orphan, pero no @context ni @src.
El flujo de trabajo de traducción comprueba las estructuras compatibles de marcadores de posición y de ICU, incluidos los argumentos modificados o ausentes. Examina las advertencias o los errores notificados y, después, renderiza la plantilla aceptada con los valores que proporciona tu aplicación. Además de realizar estas comprobaciones estructurales, revisa el significado y comprueba que no falte nada.