Preservación de claves
Obsoleto
Esta documentación cubre el CLI heredado (v0). La versión actual del CLI es la v1. Ver la documentación actual de CLI
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"] }