Migration de Pelican à Hugo

En 2015 je migrais ce blog de Tumblr à Pelican. Onze ans après cette migration Tumblr → Pelican, je passe cette fois de Pelican à Hugo. Voici pourquoi et, surtout, comment sans rien casser.

Pourquoi changer

Pelican m’a bien servi une décennie. Mais avec le temps, chaque publication traînait sa part de friction : un virtualenv Python à réveiller, des bricolages de locale pour avoir mes dates en français, du CSS minifié à la main… Rien de bloquant, mais de l’agacement qui s’accumule. Hugo répond exactement à ça : un seul binaire sans dépendance (fini le venv et les pip install qui cassent), des builds quasi instantanés même sur cent articles, un pipeline d’assets intégré, et des taxonomies natives pour les tags.

Garder les URLs

Le vrai risque d’une migration, ce n’est pas le contenu — c’est de changer les URLs. Pour deux raisons : le référencement, et surtout mes commentaires. J’utilise utterances, qui indexe chaque fil de discussion par l’URL de la page ; si une URL change, les commentaires existants se détachent.

Il fallait donc que Hugo produise exactement les mêmes chemins que Pelican, du type /2015-11-15-configurer-un-serveur-mail.html. La recette dans hugo.toml :

uglyURLs = true

[permalinks]
  posts = "/:slug/"
  tags  = "/tag/:slug/"

Combiné à un slug explicite dans chaque article, on retombe sur le /slug.html à la racine. Un seul article m’a résisté : celui dont le slug contenait des parenthèses (…-3p-(usg)), que Hugo « nettoyait » ; un url: forcé dans son en-tête a réglé le cas. Au final, les 103 articles ont gardé leur URL au caractère près, accents compris. Les pages de tags retombent sur /tags.html et /tag/x.html comme avant, et le flux Atom reste à /feeds/all.atom.xml pour ne pas perdre les abonnés.

Côté contenu, le corps des articles étant déjà en Markdown, il migre tel quel — titres, tableaux, images, blocs de code. Seul l’en-tête change de format : les Title: / Date: de Pelican deviennent du YAML entre ---. Un petit script Python a fait les 103 d’un coup, avec un piège au passage — un titre contenait un # échappé en \# par Pelican, refusé par le YAML de Hugo, qu’il a fallu nettoyer. Il ne restait plus qu’à reporter mon thème dans les layouts Hugo, à l’identique.

Publier

Je n’ai pas changé ma façon de publier : je build en local et je commite la sortie, signée. Simplement, la commande d’avant — un make qui réveillait Python — est devenue hugo.

Même blog, même allure, mêmes URLs, mêmes commentaires, mais un seul binaire à la place de tout un environnement Python. Le blog change encore de moteur sans que ça se voie de l’extérieur : c’est exactement ce qu’on demande à une migration.

Commentaires