O CLI do Lingo.dev oferece quatro controles por chave que definem como cada chave de tradução se comporta durante o processamento. Cada um tem uma função específica:
| Controle | Campo de configuração | Comportamento |
|---|---|---|
| Bloqueio de chaves | lockedKeys | Copia os valores de origem para todos os idiomas de destino, sem tradução. As chaves aparecem nos arquivos de destino com valores idênticos. |
| Ignorar chaves | ignoredKeys | Exclui as chaves completamente do processamento. Elas não aparecem nos arquivos de destino. |
| Preservação de chaves | preservedKeys | Inicializa as chaves uma única vez a partir da origem e, depois disso, impede atualizações automáticas. Ideal para conteúdo que exige tradução manual. |
| Renomeação de chaves | Automático | Detecta quando uma chave é renomeada e preserva as traduções existentes. Nenhuma configuração é necessária. |
Quando usar cada opção#
Bloqueie uma chave quando o valor precisar permanecer idêntico em todos os idiomas — nomes de marca, identificadores técnicos, valores de configuração:
{ "lockedKeys": ["brand/name", "config/apiUrl"] }Ignore uma chave quando ela não deve aparecer nos arquivos de destino — strings de depuração, flags internas, dados de teste:
{ "ignoredKeys": ["internal/debug", "dev/testData"] }Preserve uma chave quando ela exigir tradução manual — texto jurídico, conteúdo de conformidade, copy de marketing que exige revisão humana:
{ "preservedKeys": ["legal/privacy", "legal/terms"] }A renomeação é automática — o CLI detecta quando uma chave muda, mas o conteúdo continua o mesmo, e mantém a tradução existente sem precisar traduzir de novo.
Notação de caminho de chaves#
Todos os arrays de chaves usam barra (/) para caminhos aninhados e asterisco (*) para curingas:
{
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/privacy/full"]
}Chaves com pontos no nome são tratadas naturalmente — a barra separa os níveis da hierarquia, então modules/ai.translation aponta corretamente para a chave "ai.translation" dentro do objeto "modules".
