Lockfile da CLI v0
Use a linha de base legada do conteúdo de origem para entender as alterações pendentes e recuperar o estado sem ocultar traduções inacabadas.
i18n.lock permite que a v0 diferencie o conteúdo de origem que não mudou do texto que precisa de tradução. Mantenha o arquivo junto ao conteúdo de origem e às traduções aceitas que ele descreve. Ele não registra todas as edições humanas nas traduções nem comprova que uma tradução está correta.
O que o arquivo registra #
Em lingo.dev@0.138.10, o arquivo está em YAML, com version: 1 e um mapeamento checksums. Cada seção externa armazena o hash de um padrão de caminho processado; suas entradas associam as chaves de origem a somas de verificação dos valores de origem baseadas em MD5. Deixe a CLI gerenciar essas entradas em vez de criá-las manualmente.
Quando uma soma de verificação muda, uma chave existente passa a ser elegível para tradução. Hashes idênticos de valores de origem também podem associar uma nova chave a uma chave removida no mesmo contexto processado, permitindo reaproveitar a tradução em caso de renomeação. Nenhum desses mecanismos funciona como uma memória de tradução irrestrita entre arquivos.
Diferencie a tradução da substituição da linha de base #
| Operação | O que faz |
|---|---|
lingo run | Traduz as diferenças calculadas e atualiza o estado do conteúdo de origem. |
lingo run --force | Gera novamente a saída selecionada sem depender do cálculo habitual de diferenças. |
lingo lockfile | Adiciona as seções ausentes do estado do conteúdo de origem, sem alterar as já preenchidas. |
lingo lockfile --force | Substitui as somas de verificação do conteúdo de origem com base nos arquivos atuais, sem traduzir o conteúdo de destino. |
lingo run --frozen | Verifica a sincronização sem traduzir, mas primeiro inicializa a linha de base caso ela esteja ausente. |
Suponha que o conteúdo em inglês mude depois que uma tradução em francês tenha sido aceita. Substituir a soma de verificação com lockfile --force registra o novo conteúdo em inglês como linha de base, mesmo que a tradução em francês ainda expresse o significado antigo. Por isso, reconstruir a linha de base não deve ser uma prática rotineira para resolver falhas de sincronização.
Execuções limitadas a um idioma de destino ou a determinadas chaves podem gravar traduções sem atualizar a linha de base compartilhada já existente do conteúdo de origem. Uma execução normal posterior pode processar novamente a alteração no conteúdo de origem e substituir uma correção feita após a execução limitada. Concilie com cuidado as saídas dos idiomas envolvidos antes de atualizar a linha de base compartilhada.
Ao consolidar uma alteração no conteúdo de origem em vários idiomas:
- Mantenha fixa a revisão do conteúdo de origem e preserve
i18n.lockenquanto alguma saída afetada estiver inacabada. Uselingo runpara uma atualização normal de todo o projeto ou as execuções com escopo limitado documentadas quando as saídas precisarem de trabalho e revisão separados. - Inspecione a saída de cada idioma abrangido pela substituição das somas de verificação do conteúdo de origem, inclusive as saídas que não foram alteradas pela execução com escopo limitado mais recente. Resolva as falhas e concilie as correções manuais aceitas com esse conteúdo de origem. Se alguma saída ainda estiver desatualizada ou houver dúvidas sobre ela, deixe a linha de base compartilhada pendente.
- Se o trabalho com escopo limitado não alterou a linha de base existente e todas as saídas abrangidas já foram aceitas, execute
lingo lockfile --forcea partir da raiz do projeto desejado. Esse comando substitui as somas de verificação do conteúdo de origem sem traduzir. Portanto, não o use para pular a revisão anterior nem presuma que o último seletor de idioma de destino limita essa substituição. - Inspecione as diferenças no Lockfile e faça um único commit com a revisão exata do conteúdo de origem, todas as traduções aceitas correspondentes e
i18n.lock. Uma execução posterior delingo run --frozenpode verificar a sincronização com essa linha de base consolidada, mas não comprova que as traduções estão atualizadas nem atesta sua qualidade.
O modo congelado não funciona estritamente como somente leitura quando i18n.lock está ausente. Ele pode inicializar as somas de verificação primeiro, e a presença de chaves no destino, por si só, não comprova que o conteúdo está atualizado. Estabeleça um par confiável de conteúdo de origem e tradução antes de interpretar uma verificação bem-sucedida no modo congelado como evidência de sincronização.
Recupere um estado ausente ou em conflito #
Quando o Lockfile está ausente, a v0 não gera necessariamente de novo todas as traduções existentes: sem uma soma de verificação anterior, ela pode manter os valores dessas traduções. Inspecione os pares de conteúdo de origem e tradução sobre os quais houver dúvidas antes de aceitar uma linha de base recém-criada. Traduções existentes aborda esse caso de adoção.
Em caso de conflito de mesclagem, primeiro concilie as alterações no conteúdo de origem e nas traduções das duas ramificações. Restaure um Lockfile confiável sempre que possível. Se precisar reconstruí-lo, revise os pares reais de conteúdo de origem e tradução, pois a reconstrução registra o estado do conteúdo de origem, não se as traduções estão atualizadas.
O procedimento de reparo do YAML legado mantém a última entrada duplicada e informa as remoções. Isso resolve a duplicação na sintaxe, mas não determina qual redação das ramificações está correta. Inspecione os valores em conflito antes de fazer o commit do arquivo reparado junto com as saídas aceitas.