Lingo clean
Supprimez les entrées obsolètes des catalogues JSONC après avoir vérifié que les messages sources correspondants ne sont plus utilisés.
Lorsqu’un message est retiré du code source, l’extraction marque l’entrée correspondante du catalogue comme orpheline. lingo clean supprime ces entrées sources ainsi que les clés cibles qui ne figurent plus dans l’ensemble des messages sources actifs. La commande modifie les entrées, et non les fichiers de langue entiers, et ne traduit pas les valeurs manquantes.
Vérifiez d’abord que la suppression est justifiée #
Lancez l’extraction et examinez les avertissements ainsi que les entrées orphelines. Un appel dynamique ou déstructuré peut ne plus être reconnu alors que l’application l’utilise toujours. Corrigez ce problème d’extraction plutôt que de supprimer un message encore nécessaire.
Avant le nettoyage, conservez un diff permettant de revenir en arrière. La commande réécrit immédiatement le catalogue source et tous les catalogues JSONC cibles détectés ; elle ne propose ni mode de simulation, ni option de confirmation, ni filtre par langue cible.
lingo clean --source-locale en--source-locale utilise en par défaut. --out prend le pas sur la valeur configurée de i18n.messagesPath, puis sur locales, avec des chemins relatifs à la racine du projet. Le <locale>.jsonc source doit exister et ne pas être vide ; sinon, la commande échoue et demande de lancer d’abord l’extraction.
Finalisez la maintenance des catalogues #
Consultez le nombre de suppressions indiqué pour la source et pour chaque cible, puis examinez le diff. La commande clean ne régénère pas les déclarations TypeScript. Exécutez extract et check avec les mêmes chemins et la même langue source, puis lancez les vérifications de l’application.
Utilisez purge pour supprimer volontairement des fichiers cibles ou une référence de base. Utilisez clean pour supprimer les entrées orphelines des catalogues.