Bloqueio de chaves

As chaves bloqueadas são copiadas do ficheiro de origem para todos os ficheiros de destino sem serem traduzidas. O Lingo.dev CLI exclui-as por completo do processo de tradução e preserva os respetivos valores de origem em todos os idiomas.

Configuração#

Adicione lockedKeys a um bucket em i18n.json:

{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"],
      "lockedKeys": ["brand/name", "config/apiUrl", "system/version"]
    }
  }
}

Como funciona#

Dado este ficheiro de origem:

{
  "welcome": "Welcome to our platform",
  "brand": {
    "name": "Lingo.dev"
  },
  "config": {
    "apiUrl": "https://api.example.com"
  }
}

Com "lockedKeys": ["brand/name", "config/apiUrl"], o ficheiro de destino em espanhol fica assim:

{
  "welcome": "Bienvenido a nuestra plataforma",
  "brand": {
    "name": "Lingo.dev"
  },
  "config": {
    "apiUrl": "https://api.example.com"
  }
}

Apenas welcome é traduzido. As chaves bloqueadas mantêm exatamente os valores de origem.

Notação de caminho da chave#

Use a barra (/) para apontar para chaves aninhadas:

{ "lockedKeys": ["system/engine/component"] }

Use o asterisco (*) para corresponder a várias chaves:

{ "lockedKeys": ["navigation/menuItems/*"] }

As chaves com pontos no nome funcionam naturalmente — modules/ai.translation aponta para a chave "ai.translation" dentro de "modules".

Bloqueio de chaves vs. ignorar chaves#

Próximos passos#