Migration du blog de WordPress vers Hugo

Ça y est le blog est live avec Hugo et j’écris le premier post en markdown.

Le chemin a été long, mais parce que j’ai geeké d’une nouvelle manière … bon on est en 2026 vous avez déjà deviné : oui l’IA est derrière tout ça !

Tout a commencé par une question à Gemini : porter le blog de WordPress vers un site statique utilisant un générateur en Go… puis on a commencé à coder à coups de copier-coller : la conf et les templates Hugo, un premier Docker Compose avec un dump de la db de WordPress pour récupérer le contenu. L’idée c’était de coder un outil en Go qui ferait la conversion, ainsi tant que le rendu n’était pas satisfaisant je pouvais tout effacer et relancer l’import des posts.

Après beaucoup de réticence j’ai installé opencode mais pas sans l’enfermer dans un Docker. Puis j’ai découvert greywall, pi.dev et développer AI-Cabin mais ma plongée vers l’IA c’est une autre histoire, revenons au blog.

Donc je disais, ce portage a été fait avec l’assistance d’IA de plus en plus performante, mais toutefois limitées car pour garder le contrôle sur mes données j’ai pas ouvert de comptes chez les grands acteurs. J’ai utilisé Gemini car j’ai déjà un compte Google et c’est un blog qui est déjà public, ensuite je suis passé aux modèles de Scaleway.

Les 3 gros éléments de ce portage :

  • un importer : code en Go qui utilise sqlc pour lire la db et html-to-markdown/v2 pour transformer le (pseudo) html de WordPress en fichiers markdown.
  • une conf Hugo multilingue
    • et là, la feature que je n’avais jamais finalisée : le truc qui marchottait avec gengo et que j’ai pas fini sur polylang : la vue agrégée multilingue était enfin possible ! une langue virtuelle all dans la config Hugo et une duplication virtuelle du contenu français ou anglais vers cette ‘dimension’ telle que définie depuis Hugo v0.156.
  • enfin un outil de comparaison du rendu Hugo contre une capture wget du WordPress (avec plein de règles de tolérance pour les trucs que j’ai choisis de changer)

Les grandes fonctionnalités :

  • import reproductible et assez fidèle malgré une conversion en markdown
    • grâce à un plugin sur html-to-md qu’il faudra que je publie rapidement : parce que le html de WordPress a pas mal de dingueries :
      • on pense déjà au saut de lignes qui font des paragraphes (wpautop)
      • les smileys
      • les conversions typographiques (ex les jolis guillemets)
  • import des commentaires (en statique car bon c’était désactivé depuis longtemps … merci les spammers)
  • préservation des URI parce que « Cool URIs don’t change » — j’en parlais déjà en 2010 — en configurant Hugo pour reproduire en partie la structure de WordPress, le reste à coups de redirects générés.

Voilà, c’est live, je vais pouvoir virer PHP du server, un peu moins de stress vis-à-vis des failles 😅