Recuperar uma execução de localização interrompida
Verifique o que a execução submetida concluiu efetivamente, obtenha os resultados recuperáveis e preserve as correções locais enquanto resolve o que falta.
Fechar o terminal durante lingo push --wait não interrompe, por si só, o trabalho no servidor. A tradução pode ainda estar em curso, a aguardar revisão ou já concluída. Verifique o estado antes de voltar a submeter o mesmo conteúdo.
Este guia parte de trabalho já submetido. Para uma nova correção, utilize uma atualização de âmbito limitado. Para manter as traduções de destino aceites após alterações normais, consulte as orientações de preservação.
Guarde os registos e o estado local #
Registe o ID da execução apresentado, a revisão do conteúdo de origem, os ficheiros e idiomas selecionados e o último estado conhecido. Preserve o estado da execução no checkout, o Lockfile e quaisquer alterações locais às traduções de destino. Eliminar primeiro estes registos pode apagar as informações necessárias para recuperar o trabalho.
Numa execução submetida para dois idiomas de destino, verifique cada destino em vez de assumir que o fecho do terminal interrompeu ambos no mesmo ponto.
Verifique os resultados recuperáveis antes de recomeçar #
A partir do checkout usado para a submissão, utilize a execução aí registada:
lingo pull --dry-runEsta operação verifica o que seria gravado localmente, sem alterar ficheiros. Pode consultar periodicamente o trabalho ainda por concluir e indicar se está a aguardar revisão, se falhou ou se há resultados disponíveis. O comando pull grava cada documento quando todos os seus idiomas estão concluídos e deixa intactos os documentos que aguardam revisão humana; execute-o novamente quando os revisores terminarem. Trate da revisão necessária no respetivo workflow, em vez de voltar a submeter repetidamente o conteúdo de origem.
Quando os resultados estiverem prontos, verifique os conflitos e, em seguida, obtenha-os:
lingo pullO comando pull utiliza o estado registado localmente; não procura execuções arbitrárias de outra máquina. Obtenha através do controlo de versões as traduções guardadas em commits noutro local. A referência do estado da execução e a página Pull explicam exatamente quais os ficheiros e as regras de conflito usados pela CLI instalada.
Volte a tentar o trabalho que falhou com push #
Depois de corrigir a causa indicada, repita o push original com os mesmos argumentos a partir do checkout usado para a submissão. Para uma atualização normal do conteúdo de origem:
lingo push --waitSe os resultados do push anterior ainda não tiverem sido recolhidos e o pedido se mantiver inalterado, o comando push reutiliza esse pedido em vez de submeter o mesmo trabalho duas vezes. Se uma tarefa ainda estiver em execução, a ligação é restabelecida; se estiver concluída, os resultados são recolhidos; se tiver falhado, é substituída por uma nova tarefa com um novo ID. Os documentos recolhidos antes de uma falha já estão registados no Lockfile, pelo que a nova tentativa pede apenas o trabalho que ainda falta ou que foi alterado.
Após a nova tentativa, verifique os resultados de cada destino e os ficheiros obtidos e identifique o que falta. Antes de preencher os ficheiros de destino em falta num projeto existente, conclua as atualizações normais do conteúdo de origem para os destinos existentes, obtenha os resultados e verifique-os. Mantenha essa revisão do conteúdo de origem inalterada enquanto preenche os ficheiros em falta com lingo push --backfill-missing --wait; Adicionar um idioma explica a sequência. Já as chaves alteradas em ficheiros existentes exigem a atualização normal ou de âmbito limitado adequada.
Adeque a correção à falha #
Um registo local em falta não é o mesmo que uma execução que falhou no servidor. Conteúdo inválido exige correção, uma autorização recusada exige acesso e uma espera por revisão exige uma decisão. Se a resposta da rede for inconclusiva, verifique se o servidor aceitou o trabalho antes de voltar a submetê-lo.
Não altere o conteúdo de origem apenas para voltar a tentar uma execução que falhou. Guarde o ID da execução anterior e confirme que o novo ID de tarefa apresentado é diferente. O procedimento de recuperação da CLI explica como verificar os resultados e recorrer ao suporte caso seja devolvida a mesma tarefa que falhou.
Se os resultados forem parciais, preserve as traduções de destino concluídas com êxito e revistas e liste separadamente os destinos que falharam. Se for necessária uma nova execução, registe por que motivo dá seguimento à anterior ou a substitui e que revisão do conteúdo de origem utiliza. Isto evita que um resultado tardio seja confundido com o resultado atual.
Resolva as divergências locais #
O comando pull pode recusar a substituição de um ficheiro de destino alterado desde a versão registada. Compare a alteração local e o resultado recebido com as respetivas revisões do conteúdo de origem e, em seguida, escolha a redação a aceitar através da revisão.
lingo pull --force ignora essa proteção e substitui os ficheiros de destino divergentes. Antes de prosseguir, guarde o trabalho local e decida conscientemente se pretende substituí-lo. No caso de catálogos partilhados, proteja o ficheiro inteiro, incluindo o conteúdo de origem e os idiomas não alterados.
Conclua com resultados utilizáveis #
Compare os caminhos dos ficheiros obtidos, os idiomas, as variáveis e as diferenças. Carregue o resultado na respetiva aplicação ou no motor de renderização e verifique o sentido do conteúdo. Um ficheiro pode estar disponível para obtenção sem estar aprovado para utilização.
Guarde o ID da execução recuperada, a revisão aceite, o Lockfile e os ficheiros de destino como nova base de referência. A recuperação está concluída quando a situação de todas as falhas restantes está esclarecida e o resultado aceite corresponde ao conteúdo de origem pretendido, não apenas quando um comando termina com êxito.