Atualize uma chave ou um termo com segurança

Traduza novamente uma parte selecionada, preserve o conteúdo ao redor e confira tanto a correção pretendida quanto o que permaneceu inalterado.

Uma correção pontual dá certo quando atende a dois critérios: o conteúdo selecionado melhora e o conteúdo já aceito que não tem relação com a correção permanece intacto. Salve a tradução existente e a revisão correspondente do texto-fonte para conferir ambos.

Use este guia para uma chave ou um termo específico. Para alterações comuns no texto-fonte, consulte preservação durante atualizações. Para trabalhos já enviados, confira o estado de recuperação antes de solicitar mais.

Inclua conteúdo adjacente já aceito na comparação #

Um catálogo de exemplo poderia conter:

json
{
  "account": {
    "invitation": "Approval is required before access is granted.",
    "support": "Contact support"
  }
}

Suponha que apenas a redação da tradução de account.invitation precise de correção. Salve a tradução e a revisão do texto-fonte, incluindo a redação já aceita de account.support que você quer manter.

Escolha como corrigir a redação #

Para uma correção pontual e exata, edite diretamente o valor da tradução, confira o resultado na aplicação e faça o commit do catálogo revisado. Atualizações comuns do texto-fonte podem preservar essa edição enquanto o texto-fonte da mensagem permanecer inalterado.

Para gerar novamente, primeiro forneça ao processo de tradução as informações necessárias para produzir um resultado diferente. Adicione um termo aprovado ao glossário do engine, corrija uma instrução recorrente nas regras ou esclareça o contexto JSONC de uma mensagem. Depois, atualize as chaves afetadas. Gerar novamente sem alterar o texto-fonte nem as orientações pode produzir a mesma redação.

Delimite o sentido do termo antes de selecionar as mensagens #

Defina o significado do termo antes de selecionar as mensagens. Por exemplo, o “workspace” de um produto pode ser uma área de projeto compartilhada, enquanto outro trecho descreve um espaço de trabalho físico. Registre no glossário o sentido pretendido no produto e o termo de destino aprovado pela equipe. Depois, selecione apenas as mensagens que usam esse sentido. Limites dos termos aprofunda essa decisão.

Selecione uma chave de destino existente com a CLI #

Em um projeto configurado que usa esse arquivo-fonte JSON em locales/en/account.json:

bash
lingo push "locales/en/account.json" --key "account.invitation" --wait

Para JSON, --key gera novamente as unidades selecionadas mesmo quando o texto-fonte permanece inalterado. Isso atualiza essas chaves em cada idioma configurado que já tenha um arquivo de destino, mesclando os novos valores nesse arquivo.

Salve as correções existentes antes de atualizar: a tradução capturada por esse push pode ser substituída nas chaves selecionadas. Para detectar edições na tradução feitas após o envio, omita --wait e confira lingo pull --dry-run antes de coletar os resultados. Consulte Classificação de edições locais no pull para saber como lidar com conflitos.

Uma atualização de chaves mantém inalterada a versão de referência do texto-fonte completo, independentemente de os resultados serem coletados por push --wait ou por um pull separado. Assim, as edições comuns pendentes no texto-fonte continuam sendo enviadas em um push comum posterior.

Os padrões de chave aceitam chaves exatas, prefixos de objetos e curingas * que correspondem a segmentos inteiros. auth.login pode incluir auth.login.title sem corresponder a auth.login_url. Coloque os curingas entre aspas e repita --key para especificar vários padrões.

JSONC, TypeScript e PHP têm o mesmo comportamento de atualização com escopo delimitado. YAML e YAML com idiomas na raiz podem preservar as traduções selecionadas que não mudaram; edite a tradução diretamente para uma correção exata ou salve as traduções já aceitas antes de gerar novamente o arquivo inteiro. Escopos da CLI lista o comportamento de cada formato e define como escrever as chaves.

Encontre as chaves ou os arquivos afetados por um termo #

Encontre as mensagens de origem que usam o sentido pretendido do termo e confira o contexto de cada uma. Selecione as chaves compatíveis dessas mensagens com --key, usando o comando acima. Para formatos que exigem gerar novamente o arquivo inteiro, salve as traduções já aceitas e atualize os arquivos-fonte afetados, por exemplo:

sh
lingo push 'docs/en/workspaces.md' --force --wait

Use um caminho de origem já selecionado na sua configuração. Isso substitui as traduções desse arquivo para os idiomas de destino configurados. Compare a mensagem ou o arquivo reescrito por inteiro, incluindo o texto ao redor do termo.

Verifique a alteração, a preservação e o uso #

Compare cada caminho de destino alterado com a versão salva. No exemplo, o convite deve manter a exigência de aprovação antes do acesso, e a mensagem de suporte deve corresponder à versão de referência já aceita. Se houver conteúdo adjacente ausente ou reescritas inesperadas, confira o escopo e a versão de referência antes de aceitar o resultado.

Confira as variáveis e os controles de chave: o bloqueio copia o texto-fonte, a preservação mantém um valor de destino e a opção de ignorar remove o conteúdo da saída de um formato compatível.

Carregue a saída no ambiente de execução que a utiliza. Para documentos, confira o trecho alterado, os links e os componentes. Resolva os conflitos de pull antes de substituir edições locais e, depois, faça o commit das traduções aceitas com a revisão do texto-fonte e o Lockfile.