Ignorar chaves

Max PrilutskiyCEO e cofundadorAtualizado em: há 3 meses · 1 min de leitura

Obsoleto

Esta documentação cobre o CLI legado (v0). O CLI atual é o v1. Veja a documentação atual da CLI

As chaves ignoradas são totalmente excluídas do processamento de tradução. Elas não aparecem nos arquivos de destino — a CLI as pula durante a detecção de conteúdo e nunca as envia para o backend de tradução.

Configuração#

Adicione ignoredKeys a um bucket em i18n.json:

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

Como funciona#

Dado este arquivo de origem:

json
{
  "welcome": "Welcome to our platform",
  "internal": {
    "debug": "Debug mode enabled",
    "testData": "Sample test content"
  }
}

Com "ignoredKeys": ["internal/debug", "internal/testData"], o arquivo de destino em espanhol fica assim:

json
{
  "welcome": "Bienvenido a nuestra plataforma"
}

Toda a seção internal fica ausente do arquivo de destino.

Notação de caminho de chave#

Use barra (/) para chaves aninhadas e asterisco (*) como curinga:

json
{ "ignoredKeys": ["internal/*", "dev/settings"] }

Chaves que contêm pontos funcionam normalmente — dev/api.mock aponta para "api.mock" dentro de "dev".

Ignorar chaves vs. Bloquear chaves#

Ignorar chavesBloquear chaves
Aparece nos arquivos de destinoNãoSim — com o valor de origem
Caso de usoDepuração, testes, conteúdo internoNomes de marca, IDs técnicos

Próximos passos#