Controlos de chaves e edições manuais na CLI v0

Distinga os valores controlados pela origem, as traduções geridas por pessoas e as correções comuns nos catálogos legados.

Uma correção manual comum e uma chave preservada têm ciclos de vida diferentes. A v0 mantém normalmente um valor de destino existente enquanto a origem não mudar. Uma chave preservada reserva o valor para manutenção humana, mesmo que o texto de origem mude.

Corrigir uma tradução comum #

Edite diretamente o valor de destino e guarde a redação aprovada num commit. Se a origem não tiver mudado, o delta normal pode manter esse valor. Uma alteração à soma de verificação da origem torna a chave novamente elegível para tradução, e o modo forçado pode substituir o valor mesmo que a origem não tenha mudado.

Use esta opção para correções cujo significado deva ser reavaliado quando a origem mudar. Para conteúdo que deva continuar sob gestão humana, opte pela preservação e defina um processo de revisão das alterações à origem.

Definir explicitamente quem gere os valores #

ControloComportamento da saída no sistema legado
lockedKeysCopia o valor de origem, podendo substituir uma edição no destino.
ignoredKeysExclui o conteúdo selecionado da tradução e da saída.
preservedKeysPreenche um valor em falta a partir da origem e mantém depois 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 mantém-se inalterado, as entradas internas desaparecem e os termos jurídicos continuam sob gestão humana. Um marcador de posição no idioma de origem que tenha acabado de ser preservado continua a precisar de tradução antes do lançamento. Se a aplicação esperar uma chave ignorada, forneça uma alternativa ou altere esse requisito.

Analise os padrões de controlo que se sobrepõem, em vez de assumir uma ordem de precedência não documentada. Este comportamento da v0 difere do dos controlos atuais de preservação do destino.

Referenciar chaves aninhadas e literais #

Os caminhos legados usam barras para percorrer a hierarquia. brand/name seleciona name dentro de brand; modules/ai.translation seleciona uma chave literal com pontos dentro de modules. Os carateres universais seguem as regras de correspondência legadas e devem ser testados ao nível de profundidade pretendido. A sintaxe atual com pontos e parênteses retos não é equivalente a esta.

Reutilizar ao mudar o nome #

O delta antigo pode fazer corresponder o hash do valor de origem de uma nova chave ao hash anterior de uma chave removida, no contexto do mesmo caminho processado. Se o texto se mantiver igual, um valor de destino existente pode ser transferido para a chave com o novo nome, sem necessidade de uma nova tradução.

Alterar tanto a chave como a origem cria novo trabalho. A transferência entre caminhos independentes ou a utilização repetida de cadeias de texto idênticas exige uma análise; esta correspondência não funciona como uma memória de tradução sem restrições. As identidades JSON atuais baseiam-se em caminhos e não herdam este comportamento.

Use Retradução para uma substituição deliberada e Notas para tradutores para orientações de contexto. Nenhuma destas opções dispensa a decisão sobre quem gere um valor de saída.