BoumTAC

BoumWave : Mon générateur de blog qui fait juste ce qu'il faut

Publié le 2 novembre 2025

Il y a quelques mois, j'ai décidé de démarrer ce blog. Rien de fancy, juste un endroit pour écrire mes pensées en Markdown et les publier en HTML. Simple, non ? C'est ce que je croyais.

Hugo et le piège de la complexité

J'étais parti sur Hugo. Tout le monde en parle, c'est rapide, c'est moderne. J'ai téléchargé l'outil, j'ai commencé à explorer les thèmes disponibles. Et là, premier problème : ils sont tous moches. Pas juste "pas mon style", vraiment moches. Pourquoi ? Parce que Hugo existe depuis longtemps, et la plupart des thèmes ont été créés il y a des années, dans une autre ère du web.

Bon, pas grave, je me suis dit que j'allais prendre un thème correct et l'améliorer. C'est là que j'ai découvert le vrai problème : l'outil est complexe. Il y a des templates partout, dans tous les sens, avec une logique de répertoires qui m'échappait. Je voulais juste modifier quelques trucs, virer les features inutiles — les tags, la pagination, la recherche, tous ces trucs d'un ancien temps — mais c'était un parcours du combattant.

J'ai passé du temps à essayer de comprendre comment désactiver des fonctionnalités dont je n'avais pas besoin. À ce moment-là, je me suis arrêté net et je me suis posé la question : pourquoi je me prends la tête comme ça ?

Le déclic : arrêter de réfléchir, agir simple

Mon besoin était ridicule de simplicité : prendre un fichier Markdown, le transformer en HTML avec mon template, et générer les métadonnées SEO automatiquement. Point. Pas de pagination, pas de tags, pas de recherche. Juste un article qui devient une page.

Je me suis dit : "J'ai juste à faire mon template HTML, insérer le contenu à chaque fois via un script Python, et c'est réglé."

C'est exactement ce que j'ai fait. J'ai créé un script maison qui prenait mon Markdown, générait le HTML, et voilà. Ça marchait. Puis j'ai réalisé qu'il manquait l'ajout automatique des balises meta (Open Graph, Twitter Cards, JSON-LD). Je les ai ajoutées. Ensuite, j'ai voulu que le lien de l'article s'insère automatiquement dans mon index.html . Je l'ai fait. Puis j'ai rajouté le support multilingue parce que j'écris parfois en anglais. Et pour finir, j'ai ajouté la génération automatique du sitemap.

À chaque fois, j'ajoutais juste ce dont j'avais besoin. Rien de plus. Et à un moment, je me suis rendu compte que j'avais un truc super pratique entre les mains.

De code maison à projet open source

En voyant mon code prendre forme, je me suis dit que ça pouvait servir à d'autres personnes. Des gens qui, comme moi, en avaient marre de la complexité inutile des générateurs de site statique modernes. Des gens qui voulaient juste écrire et publier, sans passer une soirée à apprendre un outil juste pour faire un truc aussi basique.

J'ai donc décidé de le mettre au propre et d'en faire un projet open source : BoumWave .

La philosophie est simple : faire une seule chose, et la faire bien . BoumWave génère du HTML à partir de Markdown. Point. Le design, ça vous regarde. Pas de système de "thèmes" imposés, vous faites ce que vous voulez avec votre HTML et CSS. Le but d'un générateur, c'est de générer le HTML en se basant sur l'article Markdown. Le reste — l'apparence, les fonctionnalités supplémentaires — est totalement séparé et c'est vous qui décidez.

Pourquoi BoumWave existe

Je pense qu'on a tendance à chercher des solutions complètes avant même de savoir ce dont on a vraiment besoin. Les outils comme Hugo ou Jekyll sont devenus overkill avec le temps.

BoumWave, c'est le retour à l'essentiel. Pas de courbe d'apprentissage, pas de documentation de 200 pages à lire, pas de magie cachée. Vous avez un fichier de config boumwave.toml où tout est expliqué dedans. Vous générez un fichier Markdown, vous lancez une commande, vous obtenez votre HTML avec toutes les métadonnées SEO. C'est tout.

J'utilise BoumWave pour faire tourner ce blog. C'est rapide, léger, et transparent.

Pour ceux qui veulent essayer

Si l'approche vous intéresse, voici comment BoumWave fonctionne concrètement.

Installation : bash uv add boumwave

Les quatre commandes :

  • bw init : Crée le fichier de configuration TOML
  • bw scaffold : Crée la structure de base basée sur la configuration TOML
  • bw new_post <titre> : Crée un nouveau fichier Markdown avec le frontmatter
  • bw generate <titre> : Génère le HTML à partir de vos fichiers Markdown

Configuration : Tout se passe dans un seul fichier boumwave.toml . Vous définissez les noms de vos templates HTML, vos URLs et c'est réglé. Le multilinguisme est natif : vous écrivez en plusieurs langues et BoumWave génère les pages correspondantes.

Design : Vous faites ce que vous voulez. BoumWave ne touche pas à votre CSS, ne vous impose pas de structure. Vous avez le contrôle total sur l'apparence de votre site. Il n'y a que 3 templates :

  • votre page index.html qui est votre page d'accueil. Elle vous regarde, vous en faites ce que vous voulez.
  • La page post.html qui est votre template pour insérer les articles. Vous créez votre propre design et les articles seront insérés dedans.
  • Et pour finir, la page link.html qui est le code qui sera inséré dans votre index.html pour chaque nouveau lien.

Si vous en avez marre de la complexité et que vous voulez juste écrire et publier, essayez BoumWave . C'est exactement ce qu'il vous faut. Rien de plus, rien de moins.