Preservar traduções revistas durante as atualizações

Mantenha juntas as versões de referência do texto de origem e da tradução aceite, escolha o modo de atualização adequado e verifique exatamente o que mudou.

Uma tradução aceite representa trabalho que merece ser preservado. Quando uma mensagem de origem muda, as mensagens adjacentes podem continuar corretas. A reutilização permite mantê-las, desde que o workflow receba as versões de referência adequadas e aplique o comportamento de combinação pretendido.

O termo «incremental», por si só, não descreve essa proteção. Guarde o texto de origem anterior e a tradução aceite, escolha o contrato de atualização de quem faz a chamada e examine as diferenças reais. Para corrigir um erro conhecido na tradução, use atualizações de uma única chave; se o trabalho submetido tiver sido interrompido, comece pela recuperação.

Registar o que deve mudar e o que deve ser preservado #

Considere este exemplo de texto de origem:

json
{
  "retention": "Reports remain available for 30 days.",
  "support": "Contact support",
  "productName": "ExampleApp"
}

A pessoa responsável pelo texto de origem altera o período de retenção para 60 dias. Preserve o texto de origem anterior, o novo texto de origem e a tradução revista. O período indicado na tradução tem de mudar; a formulação aceite de support deve manter-se. Manter productName idêntico ao texto de origem é um requisito diferente de preservar uma expressão já revista na tradução.

Guarde a revisão mais recente da tradução aceite, incluindo as alterações locais feitas desde a transferência e a respetiva justificação. A versão de referência no servidor e a tradução na árvore de trabalho podem já não ter o mesmo conteúdo.

Usar o planeamento incremental normal para alterações no texto de origem #

Na CLI atual, a operação normal lingo push --wait usa o estado registado do texto de origem e as traduções para planear as alterações. Mantenha a configuração, o texto de origem, as traduções aceites e .lingo/lock.json sob controlo de versões. Eliminar o Lockfile altera o planeamento; não é uma simples atualização sem consequências.

--backfill-missing preenche os ficheiros de tradução em falta, mas não todas as chaves em falta ou alteradas nos ficheiros existentes. Os padrões de origem posicionais usam um planeamento de âmbito delimitado, com um comportamento de reutilização diferente. --force regenera as traduções selecionadas em ficheiros separados e pode substituir texto aceite; os catálogos XCStrings partilhados podem continuar a reutilizar as traduções incorporadas. Consulte a referência de Push para escolher a opção adequada antes de pedir a substituição.

Verifique o âmbito e, se for útil, obtenha uma estimativa antes de executar a operação em larga escala. Depois de obter os resultados, compare o valor alterado e os valores aceites adjacentes. Confirme o que foi preservado com base no resultado, não no rótulo da execução.

Distinguir o bloqueio do texto de origem da preservação da tradução #

Uma chave bloqueada, quando suportada, copia o texto de origem para a tradução. Uma chave preservada mantém um valor de tradução existente. Assim, bloquear uma mensagem em francês já revista pode substituí-la pelo texto em inglês; não protege a formulação em francês.

Os controlos de chaves são específicos de cada formato. Excluir uma chave do resultado é uma operação diferente. Um valor cujos factos no texto de origem tenham mudado não deve ser preservado incondicionalmente, pois isso pode manter um significado desatualizado.

Conciliar as correções locais ao obter os resultados #

Guarde as correções existentes antes de submeter uma atualização. A versão exata da tradução capturada pelo push pode ser substituída no âmbito dessa atualização. Para detetar alterações feitas após a submissão, omita --wait e examine lingo pull --dry-run. O pull compara as traduções locais com a tradução capturada e os hashes registados, podendo recusar a substituição de alterações posteriores; a transferência direta a partir de push --wait não faz esta nova verificação.

Em caso de conflito, compare a correção local, a tradução registada e o resultado recebido com as revisões relevantes do texto de origem. Se uma correção continuar válida, preserve-a através do processo normal de revisão. Use lingo pull --force apenas depois de guardar o trabalho local e de optar deliberadamente pela substituição. Forçar a operação contorna a proteção; não escolhe a formulação correta.

No caso de catálogos Apple partilhados, preserve o ficheiro completo e verifique os idiomas que não foram alterados. Não elimine um ficheiro que contenha o texto de origem e vários idiomas como se fosse apenas um ficheiro de tradução descartável.

Aceitar a nova versão de referência após a verificação #

Neste exemplo, confirme que a nova tradução indica 60 dias, que o valor de support foi preservado e que productName tem o comportamento pretendido. Verifique as variáveis e a estrutura no ambiente de execução que as utiliza. A comparação identifica as alterações; a revisão linguística determina se a nova afirmação está correta.

Guarde a tradução aceite juntamente com a respetiva revisão do texto de origem como próxima versão de referência. Se a correção justificar uma alteração às orientações futuras, tome essa decisão separadamente, ao nível do glossário ou das regras, em vez de presumir que uma única alteração aceite ensina uma nova política ao motor de localização.