Las claves preservadas se inicializan una sola vez con los valores de origen y luego quedan protegidas contra actualizaciones automáticas. CLI nunca las sobrescribe: funcionan como marcadores de posición para contenido que requiere traducción manual, como texto legal, copy de cumplimiento o slogans de marketing.
Configuración#
Agrega preservedKeys a un bucket en i18n.json:
json
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"preservedKeys": ["legal/privacy", "legal/terms"]
}
}
}Cómo funciona#
Dado este archivo de origen:
json
{
"welcome": "Welcome to our platform",
"legal": {
"privacy": "We respect your privacy and protect your data.",
"terms": "By using this service, you agree to our terms."
}
}En la primera ejecución, CLI copia las claves preservadas tal cual mientras traduce todo lo demás:
json
// locales/es.json (first run)
{
"welcome": "Bienvenido a nuestra plataforma",
"legal": {
"privacy": "We respect your privacy and protect your data.",
"terms": "By using this service, you agree to our terms."
}
}Después de traducir manualmente la sección legal, las siguientes ejecuciones de CLI mantienen intactas tus traducciones.
Preservación de claves vs. bloqueo de claves#
| Preservación de claves | Bloqueo de claves | |
|---|---|---|
| Valor inicial | Valor de origen como marcador de posición | Valor de origen (siempre) |
| Ediciones manuales | Se preservan permanentemente | Se sobrescriben con el origen en cada ejecución |
| Caso de uso | Texto legal, cumplimiento y traducción manual | Nombres de marca, IDs técnicos |
Notación de rutas de claves#
Usa barra diagonal (/) para claves anidadas y asterisco (*) para comodines:
json
{ "preservedKeys": ["legal/*", "marketing/tagline"] }