Controles de chaves e edições manuais na CLI v0
Diferencie valores controlados pela origem, traduções mantidas por pessoas e correções comuns em catálogos legados.
Uma correção manual comum e uma chave preservada têm ciclos de vida diferentes. A v0 normalmente mantém o valor de destino existente enquanto o conteúdo de origem não muda. Já uma chave preservada reserva o valor para manutenção humana, mesmo quando o texto de origem muda.
Corrigir uma tradução comum #
Edite o valor de destino diretamente e faça o commit do texto aprovado. Se o conteúdo de origem não mudar, o delta comum poderá manter esse valor. Uma alteração na soma de verificação do conteúdo de origem torna a chave elegível para tradução novamente, e o modo forçado pode substituir o valor mesmo que a origem não tenha mudado.
Use essa abordagem para correções cujo significado deva ser reavaliado quando o conteúdo de origem mudar. Para conteúdo que precisa continuar sob responsabilidade humana, opte pela preservação e defina um processo para revisar as alterações na origem.
Definir explicitamente a responsabilidade #
| Controle | Comportamento da saída legada |
|---|---|
lockedKeys | Copia o valor de origem; isso pode sobrescrever uma edição no destino. |
ignoredKeys | Exclui o conteúdo selecionado da tradução e da saída. |
preservedKeys | Preenche um valor ausente com o valor de origem e, depois, mantém o valor de destino para manutenção humana. |
{
"buckets": {
"json": {
"include": ["locales/[locale].json"],
"lockedKeys": ["brand/name"],
"ignoredKeys": ["internal/*"],
"preservedKeys": ["legal/terms"]
}
}
}Neste caso, o nome da marca permanece idêntico, as entradas internas desaparecem e os termos jurídicos continuam sob responsabilidade humana. Um texto provisório no idioma de origem que acaba de ser preservado ainda precisa ser traduzido antes do lançamento. Se a aplicação espera encontrar uma chave ignorada, forneça uma alternativa ou ajuste a aplicação para não depender dessa chave.
Verifique os padrões de controle que se sobrepõem, em vez de presumir uma ordem de precedência não documentada. Esse comportamento da v0 é diferente do funcionamento dos controles atuais de preservação do destino.
Referenciar chaves aninhadas e literais #
Os caminhos legados usam barras para percorrer a estrutura. brand/name seleciona name dentro de brand; modules/ai.translation seleciona uma chave literal com pontos dentro de modules. Os curingas seguem o mecanismo de correspondência legado e devem ser testados no nível de profundidade desejado. A sintaxe atual com pontos e colchetes não é intercambiável com a legada.
Reutilizar ao renomear #
O delta antigo pode associar o hash do valor de origem de uma nova chave ao hash anterior de uma chave removida, dentro do mesmo contexto de caminho processado. Se o texto permanecer idêntico, o valor de destino existente poderá ser transferido para a chave renomeada sem uma nova tradução.
Alterar tanto a chave quanto o conteúdo de origem gera novo trabalho. Mover conteúdo entre caminhos independentes ou usar textos idênticos repetidos exige verificação; essa correspondência não funciona como uma memória de tradução irrestrita. As identidades JSON atuais são baseadas em caminhos e não herdam esse comportamento.
Use Retradução para substituições intencionais e Notas para o tradutor para orientações de contexto. Nenhuma dessas opções substitui a decisão sobre quem é responsável por um valor de saída.