Recupere uma execução de localização interrompida
Descubra o que a execução enviada realmente concluiu, recupere os resultados disponíveis e preserve as correções locais enquanto resolve o restante.
Fechar o terminal durante lingo push --wait não interrompe, por si só, o processamento no servidor. A tradução pode continuar em andamento, estar aguardando revisão ou já ter sido concluída. Verifique o estado da execução antes de enviar o mesmo conteúdo novamente.
Este guia parte de um trabalho já enviado. Para fazer uma nova correção, use uma atualização com escopo definido. Para manter as traduções de destino aceitas mesmo após alterações comuns, consulte as orientações de preservação.
Preserve as evidências e o estado local #
Anote o ID da execução exibido, a revisão do conteúdo de origem, os arquivos e idiomas selecionados e o último estado conhecido. Preserve o estado da execução no checkout, o Lockfile e todas as edições locais nas traduções de destino. Excluir esses registros antes da recuperação pode eliminar informações necessárias para recuperar o trabalho.
Se a execução foi enviada para dois idiomas de destino, investigue cada um deles. Não presuma que o fechamento do terminal interrompeu ambos no mesmo ponto.
Verifique a recuperação dos resultados antes de recomeçar #
No checkout usado para o envio, use a execução registrada:
lingo pull --dry-runIsso verifica quais gravações seriam feitas localmente, sem alterar os arquivos. A operação pode consultar o andamento de trabalhos ainda não concluídos e informar se há uma revisão pendente, uma falha ou resultados disponíveis. O comando Pull grava cada documento quando todos os seus idiomas estão concluídos e mantém intactos os documentos que aguardam revisão humana; execute-o novamente quando os revisores terminarem. Resolva as revisões necessárias no workflow correspondente, em vez de reenviar o conteúdo de origem repetidamente.
Quando os resultados estiverem prontos, verifique os conflitos e faça a recuperação:
lingo pullO comando Pull usa o estado registrado localmente; ele não busca execuções arbitrárias de outra máquina. Use o controle de versão para receber traduções cujos commits foram feitos em outro lugar. A referência do estado da execução e a documentação de Pull detalham os arquivos e as regras de conflito da CLI instalada.
Tente novamente com push após uma falha #
Depois de corrigir a causa informada, repita o comando push original, com os mesmos argumentos, no checkout usado para o envio. Para uma atualização comum do conteúdo de origem:
lingo push --waitSe os resultados do push anterior ainda não foram coletados e a solicitação não mudou, o comando push reutiliza o envio anterior em vez de enviar o mesmo trabalho duas vezes. Se o trabalho ainda estiver em execução, a conexão com ele será restabelecida; se estiver concluído, os resultados serão coletados; se tiver falhado, ele será substituído por um novo trabalho, com um novo ID. Os documentos coletados antes da falha já estão registrados no Lockfile, então a nova tentativa solicita apenas o trabalho que ainda falta ou foi alterado.
Após a nova tentativa, confira os resultados de cada destino e os arquivos recuperados e identifique o que ainda falta. Antes de preencher arquivos de destino ausentes em um projeto existente, conclua, recupere e verifique as atualizações comuns do conteúdo de origem para os destinos existentes. Mantenha essa revisão do conteúdo de origem fixa enquanto preenche os arquivos ausentes com lingo push --backfill-missing --wait; Adicionar um idioma explica a sequência. Já as chaves alteradas em arquivos existentes exigem a atualização adequada: comum ou com escopo definido.
Escolha a correção de acordo com a falha #
Um registro local ausente não é o mesmo que uma execução com falha no servidor. Conteúdo inválido exige correção; autorização recusada exige acesso; e uma revisão pendente exige uma decisão. Se a resposta da rede for inconclusiva, verifique se o servidor aceitou o trabalho antes de fazer outro envio.
Não altere o conteúdo de origem apenas para tentar novamente uma execução que falhou. Guarde o ID da execução anterior e confirme que o novo ID de trabalho exibido é diferente. O procedimento de recuperação da CLI explica como verificar os resultados e acionar o suporte caso o mesmo trabalho com falha seja retornado.
Se houver resultados parciais, preserve as traduções de destino concluídas com sucesso e revisadas e liste separadamente os destinos que falharam. Se for necessária uma nova execução, registre por que ela dá continuidade à anterior ou a substitui e qual revisão do conteúdo de origem utiliza. Isso evita que um resultado tardio seja confundido com o resultado atual.
Concilie as divergências locais #
O comando Pull pode se recusar a substituir uma tradução de destino que tenha sido alterada desde a versão registrada. Compare a edição local e o resultado recebido com suas respectivas revisões do conteúdo de origem. Depois, faça uma revisão para escolher a redação a ser aceita.
lingo pull --force ignora essa proteção e sobrescreve as traduções de destino divergentes. Antes de prosseguir, salve o trabalho local e decida conscientemente se deseja substituí-lo. Em catálogos compartilhados, proteja o arquivo inteiro, incluindo o conteúdo de origem e os idiomas que não foram alterados.
Finalize com resultados prontos para uso #
Compare os caminhos recuperados, os idiomas, as variáveis e as diferenças entre as versões. Carregue o resultado no aplicativo ou renderizador correspondente e confira o sentido do conteúdo. Um arquivo pode estar disponível para recuperação sem ter sido aprovado para uso.
Mantenha o ID da execução recuperada, a revisão aceita, o Lockfile e as traduções de destino como a próxima base de referência. A recuperação só está concluída quando todas as falhas restantes estão identificadas e o resultado aceito corresponde ao conteúdo de origem pretendido — não apenas quando um comando termina com sucesso.