Lockfile da CLI v0
Use a referência de origem legada para compreender as alterações pendentes e recuperar o estado sem ocultar traduções por concluir.
i18n.lock permite à v0 distinguir o texto de origem que não mudou daquele que precisa de tradução. Mantenha-o junto do texto de origem e das traduções aceites a que se refere. Não regista todas as alterações manuais às traduções nem comprova que uma tradução está correta.
O que o ficheiro regista #
Em lingo.dev@0.138.10, o ficheiro usa o formato YAML, com version: 1 e um mapeamento checksums. Cada secção externa contém o hash de um padrão de caminho processado; as respetivas entradas associam chaves de origem a somas de verificação dos valores de origem baseadas em MD5. Deixe a CLI gerir estas entradas, em vez de as criar manualmente.
Quando uma soma de verificação muda, a chave existente passa a ser elegível para tradução. A correspondência entre hashes de valores de origem também pode associar uma chave nova a uma chave removida no mesmo contexto processado, permitindo reutilizar a tradução quando o nome da chave muda. Nenhum destes mecanismos funciona como uma memória de tradução sem restrições entre ficheiros.
Distinguir a tradução da substituição da referência #
| Operação | O que faz |
|---|---|
lingo run | Traduz as diferenças calculadas e atualiza o estado de origem. |
lingo run --force | Volta a gerar os resultados selecionados sem depender do cálculo habitual das diferenças. |
lingo lockfile | Adiciona as secções de estado de origem em falta, sem alterar as que já estão preenchidas. |
lingo lockfile --force | Substitui as somas de verificação de origem com base nos ficheiros atuais, sem traduzir os destinos. |
lingo run --frozen | Verifica a sincronização sem traduzir, mas inicializa primeiro a referência se esta estiver em falta. |
Imagine que o texto em inglês muda depois de a tradução em francês ter sido aceite. Substituir a respetiva soma de verificação com lockfile --force regista o novo texto em inglês como referência, mesmo que o francês ainda transmita o significado anterior. Por isso, a reconstrução não deve ser usada como procedimento habitual para resolver uma falha de sincronização.
As execuções limitadas a um idioma de destino ou a determinadas chaves podem gravar traduções sem atualizar a referência de origem partilhada existente. Uma execução normal posterior pode voltar a processar a alteração de origem e substituir uma correção feita após essa execução de âmbito restrito. Concilie cuidadosamente os resultados dos idiomas em causa antes de atualizar a referência partilhada.
Ao finalizar uma alteração de origem em vários idiomas:
- Mantenha fixa a revisão de origem e preserve
i18n.lockenquanto houver resultados afetados por concluir. Uselingo runpara uma atualização normal de todo o projeto ou as execuções de âmbito restrito descritas na documentação quando os resultados precisarem de ser trabalhados e revistos separadamente. - Verifique os resultados de todos os idiomas abrangidos pela substituição das somas de verificação de origem, incluindo os que não foram alterados pela execução de âmbito restrito mais recente. Resolva as falhas e concilie as correções manuais aceites com esse texto de origem. Se algum resultado ainda estiver desatualizado ou suscitar dúvidas, deixe a referência partilhada pendente.
- Se o trabalho de âmbito restrito tiver deixado a referência existente inalterada e todos os resultados abrangidos já tiverem sido aceites, execute
lingo lockfile --forcea partir da raiz do projeto pretendido. Este comando substitui as somas de verificação de origem sem traduzir, por isso não o use para saltar a revisão anterior nem pressuponha que o último seletor de idioma de destino limita esta substituição. - Verifique as diferenças no Lockfile e faça um commit conjunto da revisão exata de origem, de todas as traduções aceites correspondentes e de
i18n.lock. Uma execução posterior delingo run --frozenpode verificar a sincronização com essa referência consolidada, mas não pode comprovar que as traduções estão atualizadas nem avaliar a sua qualidade.
O modo congelado não é estritamente só de leitura quando i18n.lock está em falta. Pode começar por inicializar as somas de verificação, e a simples presença de chaves de destino não comprova que o conteúdo está atualizado. Estabeleça um par de origem e destino fiável antes de interpretar uma verificação bem-sucedida em modo congelado como prova de sincronização.
Recuperar o estado em falta ou em conflito #
Quando o Lockfile está em falta, a v0 não volta necessariamente a gerar todas as traduções existentes: sem uma soma de verificação anterior, pode manter os respetivos valores. Verifique os pares de origem e destino que suscitem dúvidas antes de aceitar uma referência recém-criada. Traduções existentes explica esse caso de adoção.
Em caso de conflito de integração, concilie primeiro as alterações de origem e de destino de ambos os ramos. Restaure um Lockfile fiável sempre que possível. Se tiver de o reconstruir, reveja os pares de tradução efetivos, pois a reconstrução regista o estado de origem, não se as traduções estão atualizadas.
O procedimento de reparação do YAML legado mantém a última entrada duplicada e comunica as remoções. Isto resolve a duplicação na sintaxe, mas não determina qual dos ramos tem a redação correta. Verifique os valores em conflito antes de fazer um commit do ficheiro reparado juntamente com os resultados aceites.