Las claves ignoradas se excluyen por completo del proceso de traducción. No aparecen en los archivos de destino: la CLI las omite durante la detección de contenido y nunca las envía al backend de traducción.
Configuración#
Agrega ignoredKeys a un bucket en i18n.json:
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"ignoredKeys": ["internal/debug", "dev/testData"]
}
}
}Cómo funciona#
Dado este archivo de origen:
{
"welcome": "Welcome to our platform",
"internal": {
"debug": "Debug mode enabled",
"testData": "Sample test content"
}
}Con "ignoredKeys": ["internal/debug", "internal/testData"], el archivo de destino en español queda así:
{
"welcome": "Bienvenido a nuestra plataforma"
}Toda la sección internal no aparece en el archivo de destino.
Notación de ruta de claves#
Usa barra diagonal (/) para claves anidadas y asterisco (*) para comodines:
{ "ignoredKeys": ["internal/*", "dev/settings"] }Las claves que contienen puntos funcionan de forma natural: dev/api.mock apunta a "api.mock" dentro de "dev".
Ignorar claves vs. Bloquear claves#
| Ignorar claves | Bloquear claves | |
|---|---|---|
| Aparece en los archivos de destino | No | Sí, con el valor de origen |
| Caso de uso | Depuración, pruebas y contenido interno | Nombres de marca, IDs técnicos |
