Sur cette page
- Contexte
- Inventaire des templates avant le contenu
- Builds partitionnés et pièges du système de fichiers
- Corrections de performance : modification du template puis passe sur l’ensemble du corpus
- Réglages Cloudflare qui ont fait la différence
- Détails liés au schéma et au SEO
- La capture des prospects est la partie que vous ne pouvez pas perdre
- Ce que nous ferions différemment
- Sources et lectures complémentaires
- Questions fréquemment posées
À cette échelle, les difficultés relèvent davantage du système de fichiers et des processus que de Hugo : partitionner les builds, conserver le contenu mis de côté en dehors du point de montage du contenu de Hugo, ne jamais lancer deux opérations de déplacement sur le même dossier et traiter chaque correction comme une modification de template suivie d’une passe automatisée sur l’ensemble du corpus. Les gains de performance les plus importants sont venus des dimensions d’image, du CSS critique chargé de manière synchrone, d’une image LCP non différée, d’un widget de devis différé avec un espace réservé et de la désactivation de Cloudflare Email Obfuscation.
Contexte
Unlimited Charters appartient au même groupe que WordPressEscape ; il s’agissait de notre propre migration test, réalisée avec un accès complet au serveur. Le site comptait un peu plus d’un demi-million d’URL, principalement des pages de localisation générées à partir de templates, ainsi que des pages de hubs, de flotte et de blog. L’objectif était de produire un site Hugo servi sous forme de fichiers statiques derrière Cloudflare, tout en conservant chaque chemin existant.
Inventaire des templates avant le contenu
Nous avons commencé par regrouper les URL selon le template WordPress qui les générait, et non selon leur structure. Pour chaque famille, nous avons pris une décision : la reconstruire avec un layout Hugo ou, dans un premier temps, servir une copie statique du rendu WordPress. Reconstruire en priorité les familles à fort trafic et générer des copies statiques pour les cas particuliers nous a permis d’avancer sans bloquer sur la longue traîne des pages personnalisées.
Un piège à connaître : avec WordPress, le chemin d’une URL ne correspond pas toujours au slug post_name. Les pages parentes, les règles de réécriture personnalisées et les anciennes importations produisaient des chemins différents du slug. Le chemin devait donc provenir du crawl, et non de la base de données.
Builds partitionnés et pièges du système de fichiers
Générer toutes les pages en une seule fois était lent et rendait chaque petite modification coûteuse. Nous avons donc partitionné le processus : déplacer les fichiers source que nous ne construisions pas vers un dossier de réserve, générer un sous-ensemble, le déployer, puis restaurer les fichiers. Quatre pièges nous ont fait perdre du temps :
- Le dossier de réserve doit se trouver en dehors du point de montage du contenu de Hugo. S’il se trouve n’importe où sous le répertoire de contenu monté, Hugo parcourt quand même chaque fichier et le partitionnement ne sert plus à rien.
rsync --exclude=index.htmlexclut tous les fichiers index.html à tous les niveaux, et pas uniquement celui du niveau supérieur. Ancrez le motif (--exclude=/index.html).- Deux opérations de déplacement simultanées sur le même dossier l’imbriquent. Deux processus de restauration lancés en parallèle ont créé environ 367 000 répertoires avec un niveau d’imbrication en trop. La production fonctionnait, car elle servait le résultat déjà généré ; un déplacement automatisé unique a aplati l’arborescence. Un seul processus doit gérer le répertoire, ce qui est garanti par un verrou.
mv dir/* target/échoue à cette échelle (liste d’arguments trop longue). Utilisezfind ... -exec mv -t target {} +.
# générer quelques pages sans tout reconstruire
flock /tmp/uc-content.lock bash -c '
mv content/migrated/* ../stash/ # réserve EN DEHORS du point de montage du contenu
for s in $(cat targets.txt); do mv ../stash/$s content/migrated/; done
hugo --minify -d ../staged
find ../stash -mindepth 1 -maxdepth 1 -exec mv -t content/migrated/ {} +
'Corrections de performance : modification du template puis passe sur l’ensemble du corpus
Chaque correction comportait deux volets : corriger le template Hugo pour que les prochains builds soient justes, puis modifier le HTML déjà généré afin de pouvoir la déployer sans reconstruction complète. Les corrections les plus importantes ont été les suivantes :
- Dimensions des images. Un template définissait en dur
width="1600" height="700", alors que le CSS utilisait un autre ratio. La correction a été appliquée à 527 815 pages. La largeur et la hauteur doivent correspondre au ratio réellement affiché, faute de quoi le navigateur réserve un espace incorrect (optimiser le CLS). - Règles aspect-ratio contradictoires sur le même sélecteur dans deux feuilles de style ; elles ont été regroupées en une seule règle.
- CSS critique dans le fichier asynchrone. Les règles mobiles nécessaires au premier affichage se trouvaient dans une feuille de style différée, ce qui provoquait une nouvelle mise en page tardive. Elles ont été déplacées dans la feuille de style synchrone.
- Image principale chargée en différé. L’attribut
loading="lazy"sur l’image visible au-dessus de la ligne de flottaison retardait le LCP ; il a été remplacé parfetchpriority="high"(optimiser le LCP). - Images LCP surdimensionnées remplacées par des variantes plus petites, avec une économie de 50 à 440 Ko par page.
- Widget de devis chargé lors de la première interaction (avec un délai de secours), tandis que son conteneur réserve 480 px (560 px sur mobile). Auparavant, son insertion déplaçait la page et générait un CLS d’environ 0,54.
Réglages Cloudflare qui ont fait la différence
- Email Obfuscation désactivé. Son décodeur parcourt le DOM après le chargement et réécrit les liens e-mail, ce qui provoquait un déplacement de la mise en page. C’était la source de CLS la plus persistante que nous ayons trouvée.
- Rocket Loader désactivé. Il réordonnait les scripts et perturbait leur chargement différé.
- Vidage du cache après chaque déploiement. Les caches périphériques conservaient l’ancien HTML ; un vidage par chemin après chaque déploiement évitait de servir des pages obsolètes (documentation Cloudflare sur le vidage du cache).
- Mesurer la production, pas la préproduction. La préproduction, avec des réglages Cloudflare différents, produisait des scores de laboratoire qui ne correspondaient pas à ceux de la production.
Détails liés au schéma et au SEO
- Search Console signalait des erreurs de données structurées, car une entité Service contenait
aggregateRatingetreview. Nous les avons supprimés au lieu d’essayer de les faire valider ; le balisage doit refléter le contenu visible par les utilisateurs (consignes sur les données structurées). - Les articles de blog étaient initialement générés avec le template de localisation et héritaient du mauvais type de schéma. Chaque template déclare désormais sa propre entité.
- 35 chemins de flotte et de services incohérents redirigent désormais de manière permanente vers les pages imbriquées correctes (redirections).
- Les médias ont été déplacés de
/wp-content/uploads/vers/uploads/au moyen d’une seule règle 301 ; une passesedparallèle a réécrit 528 852 fichiers sur 528 854 en quelques minutes. - Yoast a été supprimé une fois que Hugo a généré le sitemap, le schéma, les balises meta et le fichier robots.txt.
find static-v5 -name '*.html' -print0 \
| xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'La capture des prospects est la partie que vous ne pouvez pas perdre
Le formulaire de devis permet au site de générer ses revenus ; il a donc fait l’objet de contrôles spécifiques : le point d’insertion du widget doit être présent dans le HTML généré de chaque page qui l’utilisait, les noms des champs doivent correspondre à ceux attendus par le point d’accès de collecte et un déploiement qui remplace un répertoire ne doit pas supprimer la page de devis autonome. Une bascule qui désactive silencieusement la capture des prospects peut sembler réussie sur tous les indicateurs SEO, alors que l’entreprise perd des demandes.
Ce que nous ferions différemment
- Désactiver Email Obfuscation avant la première mesure du CLS.
- Partitionner le build dès le premier jour.
- Verrouiller le répertoire de contenu dès le premier jour.
- Documenter le principe « modification du template puis passe sur le corpus » avant la première correction, et non après la cinquième.
- Ajouter le contrôle des données de terrain (CrUX) à la checklist de lancement, car les scores de laboratoire en préproduction ne reflètent pas ceux de la production.
La présentation métier du même projet, notamment ce que nous avons laissé sur WordPress, figure dans l’étude de cas.
Sources et lectures complémentaires
Documentation principale consultée pour ce guide. Les liens ont été vérifiés le 11 novembre 2026.
- Documentation Hugo : démarrage rapide
- Documentation Hugo : gestion des URL (permalinks et alias)
- web.dev : optimiser le Cumulative Layout Shift
- web.dev : optimiser le Largest Contentful Paint
- web.dev : Cumulative Layout Shift (CLS)
- Documentation Cloudflare : vider le cache
- Documentation Cloudflare : cache
- Google Search Central : introduction aux données structurées
- Google Search Central : redirections et recherche Google
- Google Search Central : migration de site avec modification des URL
- Documentation Chrome UX Report (CrUX)
Questions fréquemment posées
S’agit-il d’une migration client ?
Non. Unlimited Charters est un site sœur interne appartenant au même groupe que WordPressEscape. Il s’agit de notre propre cas test.
Hugo peut-il gérer un demi-million de pages ?
Oui, mais les reconstructions complètes sont suffisamment lentes pour que le partitionnement des builds et une gestion rigoureuse des fichiers soient indispensables. La plupart de nos problèmes concernaient le système de fichiers et les processus, plutôt que des bugs de Hugo.
Qu’est-ce qui a provoqué le déplacement de mise en page le plus important ?
L’insertion du widget de devis sans espace réservé (environ 0,54 de CLS sur les pages de hubs) et la réécriture de la page par Cloudflare Email Obfuscation après son chargement.
Ces enseignements s’appliquent-ils aux petits sites ?
Oui. Les mêmes contrôles (parité des URL, dimensions des images, CSS critique, image principale non différée, widgets différés) s’appliquent à un site de 40 pages ; ils s’exécutent simplement en quelques minutes au lieu de plusieurs heures.
Vérifiez si votre site peut bénéficier du même traitement
L’audit gratuit de 60 secondes affiche votre véritable score PageSpeed, le nombre exact de pages, les lacunes SEO et les fonctionnalités WordPress à remplacer. WordPressEscape reconstruit ensuite votre site avec Hugo, conserve toutes vos URL et vous remet le code source dès le premier jour - exactement comme pour la reconstruction d’UC.
Analysez mon site gratuitement

