Lingo clean
Remova entradas obsoletas dos catálogos JSONC depois de confirmar que as respetivas mensagens de origem já não são utilizadas.
Quando uma mensagem é removida do código-fonte, a extração assinala a respetiva entrada no catálogo como órfã. lingo clean remove essas entradas de origem e as chaves de destino que já não constam do conjunto ativo de mensagens de origem. Altera entradas, não ficheiros de idioma inteiros, e não traduz valores em falta.
Confirme primeiro a remoção #
Execute a extração e analise os avisos e as entradas órfãs. Uma chamada dinâmica ou com desestruturação pode deixar de ser reconhecida, mesmo que a aplicação continue a utilizá-la. Corrija esse problema de extração em vez de eliminar uma mensagem necessária.
Antes da limpeza, guarde um registo das diferenças que permita reverter as alterações. O comando reescreve imediatamente o catálogo JSONC de origem e todos os catálogos JSONC de destino encontrados; não existe modo de simulação, opção de confirmação nem filtro por idioma de destino.
lingo clean --source-locale en--source-locale utiliza en por predefinição. --out tem precedência sobre o valor configurado em i18n.messagesPath e, depois, sobre locales, com caminhos relativos à raiz do projeto. O <locale>.jsonc de origem tem de existir e não pode estar vazio; caso contrário, o comando falha e indica que deve executar primeiro a extração.
Conclua a manutenção dos catálogos #
Consulte o número de remoções apresentado para a origem e para cada destino e, em seguida, analise as diferenças. O comando clean não volta a gerar as declarações TypeScript. Execute extract e check com os mesmos caminhos e o mesmo idioma de origem e, depois, execute as verificações da aplicação.
Utilize purge para eliminar intencionalmente ficheiros de destino ou a versão de referência. Utilize clean para remover entradas órfãs do catálogo.