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 #

ControleComportamento da saída legada
lockedKeysCopia o valor de origem; isso pode sobrescrever uma edição no destino.
ignoredKeysExclui o conteúdo selecionado da tradução e da saída.
preservedKeysPreenche um valor ausente com o valor de origem e, depois, mantém o valor de destino para manutenção humana.
json
{
  "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.