JSONC
Traduce catálogos con comentarios que aportan contexto y descubre cuáles se conservan en el resultado traducido.
JSONC te permite mantener cada mensaje junto a su explicación. El controlador de archivos jsonc usa el comentario que precede a una cadena como guía 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 usa 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 eso, cualquier componente que dependa de otros metadatos necesita un mecanismo aparte para conservarlos.
Coloca el contexto junto al valor correspondiente #
Este catálogo explica qué acción le pide realizar al lector la opción “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 el comentario y la cadena 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, el resto de esa línea se usa como indicación. Sin esa marca, se usa todo el comentario, por lo que cualquier comentario no vacío que preceda a una cadena llega al traductor. Si hay varios comentarios antes de una cadena, se usa la última indicación no vacía, incluso si un comentario anterior contiene @context. @orphan señala metadatos del catálogo; aun así, la cadena se puede seleccionar para la traducción de archivos.
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 reconoce @context, @src y @orphan; la extracción usa esos campos para mantener las ubicaciones en el código fuente y marcar los mensajes que ya no se encuentran. Se trata de un flujo de trabajo de gestión de catálogos, independiente de la traducción de cualquier documento JSONC.
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 los volverá a generar.
Configura la traducción de archivos #
La CLI infiere 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 y preservadas, las rutas ignoradas y la inserción del idioma siguen las distinciones del controlador 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 un alcance parcial, en lugar de tratar estas opciones como exclusiones equivalentes.
Verifica las claves y los valores protegidos en el archivo reconstruido y luego carga el archivo de destino con el lector de catálogos de la aplicación. Para 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 verifica las estructuras compatibles de marcadores de posición e ICU, incluidos los argumentos modificados o faltantes. Revisa las advertencias o los errores que se indiquen y luego renderiza la plantilla aceptada con los valores que proporciona tu aplicación. Además de estas verificaciones estructurales, revisa que el contenido conserve el significado y esté completo.