Controles de claves y cambios manuales en CLI v0
Distingue entre los valores controlados por el origen, las traducciones gestionadas por personas y las correcciones normales en los catálogos antiguos.
Una corrección manual normal y una clave preservada tienen una vigencia distinta. V0 suele conservar el valor de destino existente mientras no cambie el origen. Una clave preservada reserva el valor para su mantenimiento manual, incluso cuando cambia el texto de origen.
Corrige una traducción normal #
Edita directamente el valor de destino y confirma los cambios con la redacción aprobada. Si el origen no ha cambiado, el delta normal puede conservarla. Cuando cambia la suma de comprobación del origen, esa clave puede volver a traducirse; el modo forzado puede reemplazarla incluso si el origen no ha cambiado.
Usa este método para las correcciones cuyo significado deba reconsiderarse cuando cambie el origen. Si el contenido debe seguir bajo control humano, opta por la preservación y establece un proceso para revisar los cambios en el origen.
Asigna explícitamente quién tiene el control #
| Control | Comportamiento de salida de la versión antigua |
|---|---|
lockedKeys | Copia el valor de origen; puede sobrescribir un cambio en el destino. |
ignoredKeys | Excluye el contenido seleccionado de la traducción y de la salida. |
preservedKeys | Inicializa un valor ausente a partir del origen y después conserva el valor de destino para su mantenimiento manual. |
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/terms"]
}
}
}Aquí, el nombre de la marca se mantiene idéntico, las entradas internas desaparecen y los términos legales siguen bajo control humano. Un texto provisional en el idioma de origen que se acaba de preservar aún debe traducirse antes de la publicación. Si la aplicación espera encontrar una clave ignorada, proporciona un valor alternativo o modifica la aplicación para que deje de esperarla.
Revisa los patrones de control que se solapan en lugar de asumir un orden de prioridad no documentado. Este comportamiento de v0 difiere del de los controles actuales de preservación del destino.
Gestiona las claves anidadas y literales #
Las rutas de la versión antigua usan barras para recorrer los niveles. brand/name selecciona name dentro de brand; modules/ai.translation selecciona una clave literal que contiene puntos dentro de modules. Los comodines siguen las reglas de coincidencia de la versión antigua y deben probarse en el nivel de profundidad previsto. La sintaxis actual con puntos y corchetes no es intercambiable con la antigua.
Reutiliza al cambiar el nombre #
El delta antiguo puede hacer coincidir el hash del valor de origen de una clave nueva con el hash anterior de una clave eliminada dentro del mismo contexto de ruta procesada. Si el texto sigue siendo idéntico, un valor de destino existente puede trasladarse a la clave renombrada sin necesidad de una nueva traducción.
Cambiar tanto la clave como el origen genera trabajo nuevo. Los traslados entre rutas independientes o el uso de cadenas idénticas repetidas requieren revisión: este mecanismo de coincidencia no es una memoria de traducción sin restricciones. Las identidades JSON actuales se basan en rutas y no heredan este comportamiento.
Usa Retraducción para reemplazar una traducción de forma deliberada y Notas para el traductor para aportar contexto. Ninguna de estas opciones sustituye la decisión de quién controla un valor de salida.