Referência da CLI v0
Mantenha um projeto i18n.json já instalado, preservando as traduções aceitas e a linha de base do conteúdo de origem.
Este manual aborda o pacote antigo lingo.dev e seu workflow i18n.json/i18n.lock. Os exemplos se limitam a 0.138.10. Mantenha a versão registrada no Lockfile do projeto existente enquanto planeja uma migração; instalar a versão mais recente, que pode mudar, não é uma forma reproduzível de recuperar o projeto.
Para um novo projeto, comece com a CLI atual. Seu workflow de envio e recebimento no servidor segue regras diferentes de estado e seleção.
Como funciona uma execução da v0 instalada #
A configuração do bucket seleciona um analisador e localiza os arquivos de origem e 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 de diferenças compara os valores de origem, os valores de destino existentes e as somas de verificação anteriores da origem para identificar entradas novas, alteradas, removidas ou renomeadas.
O texto selecionado passa por um engine de localização da Lingo.dev ou por um provedor direto configurado. As traduções retornadas são usadas para reconstruir os arquivos de destino ou as seções de idioma de um arquivo compartilhado. Uma tarefa pode gravar resultados com sucesso antes que outra falhe; o projeto como um todo não é uma transação atômica.
Mantenha a linha de base junto com o conteúdo #
Inclua i18n.json, os resultados de tradução aceitos e i18n.lock no mesmo commit. O Lockfile registra o estado da origem, não cada edição no destino ou aprovação de idioma. As execuções comuns atualizam as somas de verificação da origem; execuções limitadas a um idioma de destino ou a determinadas chaves podem gravar resultados sem atualizar a linha de base existente.
A referência do Lockfile explica por que execuções comuns posteriores podem voltar a processar uma alteração na origem após uma execução de escopo limitado. Traduções existentes explica como adotar a ferramenta sem substituir todos os valores já presentes.
Encontre a próxima operação #
Use o procedimento para o primeiro arquivo para reproduzir uma pequena execução legada. Configuração e Formatos mostram o que a geração instalada lê e grava.
No trabalho do dia a dia, Idiomas explica como adicionar um idioma de destino; Controles de chaves diferencia edições comuns de valores sob controle humano; Retradução define o escopo de uma atualização intencional. Monorepos e Processamento paralelo abordam a responsabilidade e a capacidade de processamento, sem presumir que aumentar o número de processos de trabalho elimine os limites do provedor.