Atualizar uma única chave ou termo em segurança

Volte a traduzir uma parte selecionada, preserve o conteúdo adjacente e verifique tanto a correção pretendida como o conteúdo que se manteve inalterado.

Uma correção pontual é bem-sucedida quando cumpre dois objetivos: melhorar o conteúdo selecionado e manter intacto o restante conteúdo aceite. Guarde a tradução existente e a respetiva revisão do texto de origem para poder verificar ambos.

Use este guia para uma chave ou um termo conhecido. Para alterações normais ao texto de origem, consulte preservação durante as atualizações. Se o trabalho já tiver sido submetido, verifique o respetivo estado de recuperação antes de pedir mais.

Incluir conteúdo adjacente aceite na comparação #

Um catálogo de exemplo pode 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 precisa de ser corrigida. Guarde a tradução e a revisão do texto de origem, incluindo a redação aceite de account.support que pretende manter.

Escolher como corrigir a redação #

Para uma correção pontual e exata, edite diretamente o valor da tradução, verifique-o na aplicação e registe o catálogo revisto no controlo de versões. As atualizações normais do texto de origem podem preservar essa edição enquanto o texto de origem da mensagem se mantiver inalterado.

Para voltar a gerar a tradução, comece por fornecer as informações necessárias para obter um resultado diferente. Adicione um termo aprovado ao glossário do motor, corrija uma instrução recorrente nas suas regras ou clarifique o contexto JSONC de uma mensagem. Em seguida, atualize as chaves afetadas. Voltar a gerar a tradução sem alterar o texto de origem nem as orientações pode produzir a mesma redação.

Delimitar o significado do termo antes da seleção #

Defina o significado do termo antes de selecionar as mensagens. Por exemplo, o «workspace» de um produto pode designar uma área de projeto partilhada, enquanto outra passagem descreve um espaço de trabalho físico. Registe no glossário o significado pretendido no contexto do produto e o termo de destino aprovado pela equipa. Depois, selecione apenas as mensagens que usam o termo nesse sentido. Limites dos termos aprofunda esta decisão.

Selecionar uma chave de destino existente com a CLI #

Num projeto configurado que utilize esse ficheiro de origem JSON em locales/en/account.json:

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

No caso de JSON, --key volta a gerar as unidades selecionadas mesmo que o texto de origem não tenha sido alterado. Atualiza essas chaves em cada idioma configurado que já tenha um ficheiro de destino, integrando os novos valores nesse ficheiro.

Guarde as correções existentes antes de atualizar: a tradução capturada por este push pode ser substituída nas chaves selecionadas. Para detetar edições à tradução feitas após a submissão, omita --wait e verifique lingo pull --dry-run antes de recolher os resultados. Consulte Classificação de edições locais do pull para saber como lidar com conflitos.

A atualização de chaves mantém inalterada a versão de referência de todo o conteúdo de origem, quer os resultados sejam recolhidos por push --wait ou por um pull separado. Assim, as alterações normais pendentes no texto de origem continuam a ser incluídas num push simples posterior.

Os padrões de chaves permitem usar chaves exatas, prefixos de objetos e carateres universais * que abrangem segmentos inteiros. auth.login pode incluir auth.login.title sem corresponder a auth.login_url. Coloque os carateres universais entre aspas e repita --key para indicar os vários padrões pretendidos.

JSONC, TypeScript e PHP têm o mesmo comportamento de atualização com âmbito limitado. YAML e YAML com idiomas na raiz podem conservar as traduções selecionadas sem as alterar; para uma correção exata, edite diretamente a tradução ou guarde as traduções aceites antes de voltar a gerar o ficheiro completo. Âmbitos da CLI apresenta o comportamento de cada formato e define como escrever as chaves.

Encontrar as chaves ou os ficheiros afetados por um termo #

Encontre as mensagens de origem que usam o termo no sentido pretendido e verifique o respetivo contexto. Selecione as chaves suportadas dessas mensagens com --key, utilizando o comando acima. Nos formatos que exigem a regeneração do ficheiro completo, guarde as traduções aceites e atualize os ficheiros de origem afetados, por exemplo:

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

Use um caminho de origem já selecionado na configuração. Esta operação substitui as traduções desse ficheiro nos idiomas de destino configurados. Compare a mensagem ou o ficheiro reescrito na íntegra, incluindo o texto em redor do termo.

Verificar as alterações, a preservação e a utilização #

Compare cada caminho de destino alterado com a versão guardada. No exemplo, o convite tem de manter a exigência de aprovação antes do acesso e a mensagem de apoio tem de corresponder à versão de referência aceite. Se faltar conteúdo adjacente ou surgirem reformulações inesperadas, verifique o âmbito e a versão de referência antes de aceitar o resultado.

Verifique as variáveis e os controlos de chaves: o bloqueio copia o texto de origem, a preservação mantém um valor de destino e a opção de ignorar remove o conteúdo do resultado nos formatos que a suportam.

Carregue o resultado no ambiente de execução que o utiliza. No caso de documentos, verifique a passagem alterada, as ligações e os componentes. Resolva os conflitos do pull antes de substituir edições locais. Em seguida, registe no controlo de versões as traduções aceites, juntamente com a respetiva revisão do texto de origem e o Lockfile.