Referência da CLI v0

Mantenha um projeto i18n.json instalado, preservando as traduções aceites e o estado de referência do conteúdo de origem.

Este manual abrange o pacote antigo lingo.dev e o respetivo workflow i18n.json/i18n.lock. Os exemplos aplicam-se apenas a 0.138.10. Mantenha a versão registada no Lockfile do projeto existente enquanto planeia uma migração; instalar a versão mais recente, que pode mudar, não permite uma recuperação reprodutível.

Para um novo projeto, comece pela CLI atual. O seu workflow de envio e obtenção do lado do servidor segue regras diferentes de estado e seleção.

Como funciona uma execução com a v0 instalada #

A configuração do bucket seleciona um analisador e identifica os ficheiros de origem e de destino, expandindo [locale] quando necessário. O analisador extrai o conteúdo e separa os valores reconhecidos como não traduzíveis. O cálculo das diferenças compara os valores de origem, os destinos existentes e as somas de verificação anteriores do conteúdo de origem para identificar entradas novas, alteradas, removidas ou cujo nome tenha mudado.

O texto selecionado passa por um motor de localização da Lingo.dev ou por um fornecedor direto configurado. As traduções devolvidas são usadas para reconstruir os ficheiros de destino ou as secções por idioma de um ficheiro partilhado. Algumas tarefas podem gravar resultados com sucesso antes de outra falhar; o projeto no seu todo não constitui uma transação atómica.

Mantenha o estado de referência junto do conteúdo #

Inclua i18n.json, os resultados de tradução aceites e i18n.lock no mesmo commit. O Lockfile regista o estado do conteúdo de origem, não cada edição de uma tradução ou aprovação de um idioma. As execuções normais atualizam as somas de verificação do conteúdo de origem; as execuções limitadas a um idioma de destino ou a determinadas chaves podem gravar resultados sem atualizar o estado de referência existente.

A referência do Lockfile explica por que motivo uma execução normal posterior pode voltar a processar uma alteração do conteúdo de origem após uma execução de âmbito limitado. Traduções existentes explica como adotar a ferramenta sem substituir todos os valores existentes.

Encontre a próxima operação #

Siga o procedimento para o primeiro ficheiro para reproduzir uma pequena execução da versão antiga. Configuração e Formatos indicam o que a geração instalada lê e escreve.

Para o trabalho do dia a dia, Idiomas explica como adicionar um idioma de destino; Controlos de chaves distingue as edições normais dos valores sob controlo humano; Retradução define o âmbito de uma atualização intencional. Monorepositórios e Processamento paralelo abordam a responsabilidade e a capacidade de processamento, sem pressupor que aumentar o número de processos de trabalho elimina os limites do fornecedor.