Op deze pagina
- Context
- Template-inventarisatie vóór de content
- Gepartitioneerde builds en valkuilen van het bestandssysteem
- Performanceverbeteringen, toegepast als templatewijziging én corpusbewerking
- Cloudflare-instellingen die verschil maakten
- Details rond schema en SEO
- Leadgeneratie is het onderdeel dat niet verloren mag gaan
- Wat we anders zouden doen
- Bronnen en meer informatie
- Veelgestelde vragen
Op deze schaal liggen de problemen eerder bij het bestandssysteem en het proces dan bij Hugo: builds opsplitsen, gestashte content buiten Hugo’s content mount houden, nooit twee migratieprocessen op dezelfde directory uitvoeren en elke oplossing behandelen als een templatewijziging plus een gescripte controle over de volledige contentverzameling. De grootste prestatiewinsten kwamen door afbeeldingsafmetingen, synchrone kritieke CSS, een niet-lazy geladen LCP-afbeelding, een uitgestelde quote-widget met gereserveerde ruimte en het uitschakelen van Cloudflare Email Obfuscation.
Context
Unlimited Charters is eigendom van dezelfde groep als WordPressEscape; dit was onze eigen testmigratie, uitgevoerd met volledige servertoegang. De site had iets meer dan een half miljoen URL's, voornamelijk locatiepagina's op basis van templates, aangevuld met hubs, vlootpagina's en een blog. Het doel was een Hugo-build die als statische bestanden achter Cloudflare wordt geserveerd, waarbij elk bestaand pad behouden blijft.
Template-inventarisatie vóór de content
We begonnen met het groeperen van URL's op basis van de WordPress-template waarmee ze werden gegenereerd, niet op basis van het URL-patroon. Voor elke groep namen we één beslissing: opnieuw opbouwen als Hugo-layout, of voorlopig een statische momentopname van de WordPress-uitvoer serveren. Door de drukst bezochte groepen eerst opnieuw op te bouwen en uitzonderingen als momentopname te bewaren, bleef het project vorderen zonder dat we hoefden te wachten op de lange staart van aangepaste pagina's.
Een belangrijk aandachtspunt: op WordPress is het URL-pad niet altijd de slug uit post_name. Bovenliggende pagina's, aangepaste rewrite-regels en oude imports leverden paden op die niet overeenkwamen met de slug. Daarom moest het pad uit de crawl komen en niet uit de database.
Gepartitioneerde builds en valkuilen van het bestandssysteem
Alle pagina's in één keer renderen was traag en maakte elke kleine wijziging kostbaar. Daarom partitioneerden we de builds: de bronbestanden die we niet bouwden tijdelijk verplaatsen, een subset bouwen, die uitrollen en vervolgens terugplaatsen. Vier valkuilen kostten ons tijd:
- De tijdelijke opslag moet buiten Hugo's content-mount staan. Als die zich ergens onder de gemounte contentdirectory bevindt, doorloopt Hugo nog steeds elk bestand en levert partitioneren niets op.
rsync --exclude=index.htmlsluit op elk niveau elke index.html uit, niet alleen de bovenste. Veranker het patroon met--exclude=/index.html.- Twee gelijktijdige verplaatsingen op dezelfde directory nesten de inhoud. Twee restoreprocessen die elkaar inhaalden, produceerden ongeveer 367.000 directories die één niveau te diep stonden. Productie bleef werken omdat daar de gebouwde uitvoer werd geserveerd; één gescript proces heeft ze weer platgeslagen. Eén proces beheert de directory, afgedwongen met een lock.
mv dir/* target/werkt niet bij deze omvang (argumentenlijst te lang). Gebruikfind ... -exec mv -t target {} +.
# een handvol pagina's renderen zonder alles opnieuw te bouwen
flock /tmp/uc-content.lock bash -c '
mv content/migrated/* ../stash/ # stash BUITEN de content-mount
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/ {} +
'Performanceverbeteringen, toegepast als templatewijziging én corpusbewerking
Elke verbetering bestond uit twee delen: de Hugo-template corrigeren zodat toekomstige builds goed waren, en de al gebouwde HTML aanpassen zodat we geen volledige rebuild hoefden uit te voeren om de wijziging uit te rollen. Dit waren de belangrijkste:
- Afmetingen van afbeeldingen. Een template legde
width="1600" height="700"vast, terwijl de CSS een andere beeldverhouding gebruikte. Dit is gecorrigeerd op 527.815 pagina's. De breedte en hoogte moeten overeenkomen met de uiteindelijke beeldverhouding, anders reserveert de browser de verkeerde ruimte (CLS optimaliseren). - Conflicterende regels voor de beeldverhouding stonden voor dezelfde selector in twee stylesheets; die zijn samengevoegd tot één regel.
- Kritieke CSS in het asynchrone bestand. Mobiele regels die nodig waren voor de eerste weergave stonden in een uitgestelde stylesheet, wat een late herindeling veroorzaakte. Ze zijn verplaatst naar de synchrone stylesheet.
- Lazy geladen hero-afbeelding.
loading="lazy"op de afbeelding boven de vouw vertraagde de LCP; dit is vervangen doorfetchpriority="high"(LCP optimaliseren). - Te grote LCP-afbeeldingen zijn vervangen door kleinere varianten, wat per pagina 50 tot 440 KB bespaarde.
- De offertewidget wordt geladen bij de eerste interactie (met een time-out als fallback) en de container reserveert 480 px (560 px op mobiel). Voorheen verschoof de pagina bij het laden ervan met een CLS van ongeveer 0,54.
Cloudflare-instellingen die verschil maakten
- E-mailobfuscatie uitgeschakeld. De decoder doorloopt de DOM na het laden en herschrijft e-maillinks, wat zichtbaar werd als een layoutverschuiving. Dit was de meest hardnekkige bron van CLS die we vonden.
- Rocket Loader uitgeschakeld. Deze functie herschikt scripts en verstoorde het uitgesteld laden.
- Cache legen na elke uitrol. Edge-caches bevatten oude HTML; door na elke uitrol de cache per pad te legen, voorkwamen we dat verouderde pagina's werden geserveerd (Cloudflare-documentatie over het legen van de cache).
- Productie meten, niet staging. Staging zonder dezelfde Cloudflare-instellingen leverde labscores op die niet overeenkwamen met productie.
Details rond schema en SEO
- Search Console rapporteerde fouten in de structured data omdat een Service-entiteit
aggregateRatingenreviewbevatte. We hebben deze verwijderd in plaats van te proberen ze valide te maken; markup moet de content weerspiegelen die gebruikers kunnen zien (richtlijnen voor structured data). - Blogposts werden aanvankelijk met de locatietemplate gerenderd en erfden daardoor het verkeerde schematype. Elke template definieert nu zijn eigen entiteit.
- 35 inconsistente paden voor vloot- en servicepagina's kregen permanente redirects naar de juiste geneste pagina's (redirects).
- Media is verplaatst van
/wp-content/uploads/naar/uploads/met één 301-regel; een parallellesed-bewerking herschreef in enkele minuten 528.852 van de 528.854 bestanden. - Yoast is verwijderd zodra Hugo de sitemap, schema, metatags en robots.txt genereerde.
find static-v5 -name '*.html' -print0 \
| xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'Leadgeneratie is het onderdeel dat niet verloren mag gaan
Het offerteformulier is de manier waarop de site geld oplevert en kreeg daarom eigen controles: de widget moet aanwezig zijn in de gegenereerde HTML van elke pagina waarop deze stond, de veldnamen moeten overeenkomen met wat het intake-endpoint verwacht en een deploy die een directory vervangt, mag de zelfstandige offertepagina niet verwijderen. Een overstap waarbij de leadgeneratie wegvalt, lijkt op alle SEO-metrics stilletjes succesvol, terwijl het bedrijf aanvragen misloopt.
Wat we anders zouden doen
- Schakel Email Obfuscation uit voordat je de eerste CLS-meting uitvoert.
- Splits de build vanaf dag één op.
- Vergrendel de contentdirectory vanaf dag één.
- Leg het patroon van template plus corpus-pass vast vóór de eerste oplossing, niet pas na de vijfde.
- Neem de controle van veldgegevens (CrUX) op in de checklist voor de lancering, want labscores op staging zijn niet hetzelfde als productie.
De zakelijke kant van hetzelfde project, inclusief wat we op WordPress hebben laten staan, vind je in de case study.
Bronnen en meer informatie
De belangrijkste documentatie waarop we ons voor deze handleiding hebben gebaseerd. De links zijn gecontroleerd op 11 november 2026.
- Hugo-documentatie: Snel aan de slag
- Hugo-documentatie: URL-beheer (permalinks en aliassen)
- web.dev: Cumulative Layout Shift optimaliseren
- web.dev: Largest Contentful Paint optimaliseren
- web.dev: Cumulative Layout Shift (CLS)
- Cloudflare Docs: Cache legen
- Cloudflare Docs: Cache
- Google Search Central: Inleiding tot structured data
- Google Search Central: Redirects en Google Search
- Google Search Central: Websites verhuizen met gewijzigde URL's
- Documentatie over het Chrome UX Report (CrUX)
Veelgestelde vragen
Gaat dit om een migratie van een klant?
Nee. Unlimited Charters is een interne zustersite die eigendom is van dezelfde groep als WordPressEscape. Het is onze eigen testcase.
Kan Hugo een half miljoen pagina’s aan?
Ja, maar volledige builds duren lang genoeg dat gepartitioneerde builds en zorgvuldig bestandsbeheer belangrijk zijn. De meeste problemen werden veroorzaakt door het bestandssysteem en processen, niet door bugs in Hugo.
Waardoor ontstond de grootste layoutverschuiving?
Doordat de offertewidget zonder gereserveerde ruimte werd geladen (ongeveer 0,54 CLS op hubpagina’s) en Cloudflare Email Obfuscation de pagina na het laden herschreef.
Gelden deze lessen ook voor kleine sites?
Ja. Dezelfde controles (overeenkomende URL’s, afbeeldingsafmetingen, kritieke CSS, een niet-lazy geladen hero-afbeelding en uitgestelde widgets) zijn ook van toepassing op een site met 40 pagina’s; ze worden alleen in minuten uitgevoerd in plaats van uren.
Bekijk of jouw site in aanmerking komt voor dezelfde aanpak
De gratis audit van 60 seconden toont je echte PageSpeed-score, het exacte aantal pagina’s, SEO-hiaten en de WordPress-functies die vervangen moeten worden. Daarna bouwt WordPressEscape je site opnieuw op met Hugo, behoudt het elke URL en ontvang je vanaf dag één de broncode - precies zoals UC opnieuw is opgebouwd.
Scan mijn site gratis

