Gestion des tags dans Docusaurus

Plus de 200 articles plus tard, mon site Docusaurus a accumulé un joli chaos de tags. Trop de tags similaires, des majuscules incohérentes, du singulier contre du pluriel... Des tags avec un ou deux articles seulement. Et ainsi de suite.

Dans cet article, je partage un script Python que j'ai écrit pour automatiser la gestion des tags : en supprimer certains, en fusionner d'autres et nettoyer les incohérences.

C'est quasi impossible à faire à la main quand vous avez des centaines de fichiers Markdown. En plus, le faire manuellement risque de casser le formatage du frontmatter YAML.

Voir les suggestions​

Une seule commande liste tous les tags et signale les doublons probables :

$ make tags-manager ARGS="list"▋

La solution : un gestionnaire de tags intelligent​

Je voulais un outil capable de faire trois choses :

1. Lister tous les tags par fréquence.
2. Suggérer des optimisations (trouver les doublons ou les variations singulier/pluriel).
3. Renommer ou supprimer des tags sans rien casser.

Suggestions intelligentes​

La partie la plus sympa du script, ce sont les « suggestions d'optimisation ». Il compare chaque tag à tous les autres pour repérer les doublons potentiels.

Il cherche :

• Les variations de casse : GitHub contre github.
• Les pluriels : snippet contre snippets.
• Les sous-chaînes : visual studio code contre vscode.

Ça m'aide à repérer le bazar dont je ne soupçonnais même pas l'existence.

Comment l'exécuter (Docker d'abord)​

Comme toujours, je ne veux pas polluer ma machine hôte avec des dépendances Python. Je lance ce script avec Docker — exactement comme le vérificateur d'images décrit dans Quelques vérifications sur les images de votre site Docusaurus.

J'ai une cible Makefile prête, mais en gros, elle exécute une commande comme celle-ci :

$ docker run -it --rm -v .:/app -w /app --entrypoint /bin/sh python:3.14-slim -c "pip install --root-user-action=ignore oyaml python-frontmatter >/dev/null && python .scripts/tags-manager.py list"▋

Mais bon, cette commande est franchement difficile à retenir, donc j'utilise plutôt une cible Makefile :

Le script​

Voici le script Python complet. Il utilise argparse pour gérer les arguments en ligne de commande et python-frontmatter pour analyser les fichiers.

D'autres exemples​

Renommer un tag :

Si, en parcourant la liste des tags, je vois que j'ai un tag snippets et un tag snippet, je vais les fusionner comme ceci :

$ make tags-manager ARGS="rename snippets,snippet"▋

Supprimer un tag :

Je peux aussi constater qu'un tag précis n'apporte rien ; pour le supprimer, je lance quelque chose comme ça :

$ make tags-manager ARGS="delete draft"▋

Conclusion​

Garder un blog organisé est un travail permanent. Avec ce script, je peux auditer mes tags rapidement et m'assurer que Docusaurus ne devienne pas docusaurus ou DocuSaurus avec le temps.

N'hésitez pas à récupérer le script et à l'adapter à votre propre générateur de site statique !