Controles de claves y ediciones manuales en CLI v0
Mantén separados los valores controlados por el origen, las traducciones a cargo de personas y las correcciones habituales en los catálogos heredados.
Una corrección manual habitual y una clave preservada tienen ciclos de vida distintos. V0 normalmente conserva un valor de destino existente mientras el origen no cambie. Una clave preservada reserva el valor para su mantenimiento manual, incluso cuando cambia el texto de origen.
Corrige una traducción habitual #
Edita directamente el valor de destino y confirma la redacción aceptada. Si el origen no cambia, el delta habitual puede conservar ese valor. Si cambia la suma de verificación del origen, esa clave puede volver a traducirse; el modo forzado puede reemplazar el valor incluso si el origen no cambia.
Usa esta opción para una corrección cuyo significado deba revisarse cuando cambie el origen. Para el contenido que deba seguir a cargo de personas, elige la preservación y un proceso de revisión de los cambios en el origen.
Define explícitamente quién tiene el control #
| Control | Comportamiento de salida heredado |
|---|---|
lockedKeys | Copia el valor de origen; esto puede sobrescribir una edición del valor de destino. |
ignoredKeys | Excluye el contenido seleccionado de la traducción y de la salida. |
preservedKeys | Inicializa un valor faltante a partir del origen y luego 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 a cargo de personas. Un texto provisional en el idioma de origen que acaba de preservarse aún debe traducirse antes del lanzamiento. Si la aplicación espera una clave ignorada, proporciona un valor alternativo o modifica ese requisito.
Revisa los patrones de control que se superponen en lugar de dar por sentado un orden de prioridad no documentado. Este comportamiento de v0 difiere de los controles actuales de preservación del destino.
Especifica claves anidadas y literales #
Las rutas heredadas usan barras para recorrer la jerarquía. 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 heredadas y deben probarse en el nivel de profundidad previsto. La sintaxis actual con puntos y corchetes no es intercambiable.
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 se mantiene idéntico, un valor de destino existente puede pasar a la clave renombrada sin necesidad de una nueva traducción.
Cambiar tanto la clave como el origen genera trabajo nuevo. Mover contenido entre rutas independientes o usar cadenas idénticas repetidas requiere una revisión; esta coincidencia no funciona como 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 contenido de forma deliberada y Notas para el traductor para ofrecer orientación contextual. Ninguna de estas opciones sustituye la decisión de quién controla un valor de salida.