Ignorar claves

Max PrilutskiyCEO y cofundadorActualizado el hace 3 meses · 1 min de lectura

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 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:

json
{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"],
      "ignoredKeys": ["internal/debug", "dev/testData"]
    }
  }
}

Cómo funciona#

Dado este archivo de origen:

json
{
  "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í:

json
{
  "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:

json
{ "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 clavesBloquear claves
Aparece en los archivos de destinoNoSí, con el valor de origen
Caso de usoDepuración, pruebas y contenido internoNombres de marca, IDs técnicos

Siguientes pasos#