WordPressEscape

Startside / Guide

Værksted

Migrering af 528.854 WordPress-sider til Hugo: Tekniske noter

Dette er arbejdsnoterne fra flytningen af Unlimited Charters, vores interne søstersite, fra WordPress til Hugo i maj 2026. Forretningsopsummeringen findes i casestudiet; her får du den del, der er relevant for den, der skal udføre arbejdet: hvad der gik galt ved en halv million sider, hvilke kommandoer der gav problemer, og hvilke kontroller vi nu kører på alle sites, store som små.

5 min. læsetid 9 sektioner Skabt til at rangere
På denne side
  1. Kontekst
  2. Kortlægning af skabeloner før indholdet
  3. Partitionerede builds og faldgruber i filsystemet
  4. Performanceforbedringer anvendt som skabelonændring plus gennemgang af hele indholdskorpuset
  5. Cloudflare-indstillinger, der gjorde en forskel
  6. Schema- og SEO-detaljer
  7. Leadgenerering er den del, du ikke må miste
  8. Hvad vi ville gøre anderledes
  9. Kilder og videre læsning
  10. Ofte stillede spørgsmål
Kort svar

I denne skala handler problemerne mere om filsystem og processer end om Hugo: partitionering af builds, at holde gemt indhold uden for Hugos content-mount, aldrig at køre to flytteprocesser på samme mappe og at behandle hver rettelse som både en skabelonændring og en scriptet gennemgang af hele indholdskorpuset. De største performanceforbedringer kom fra korrekte billeddimensioner, synkron kritisk CSS, et LCP-billede uden lazy loading, en udskudt tilbudswidget med reserveret plads samt deaktivering af Cloudflare Email Obfuscation.

01

Kontekst

Unlimited Charters ejes af den samme koncern som WordPressEscape, og dette var vores egen testmigrering, udført med fuld serveradgang. Sitet havde lidt over en halv million URL’er, primært skabelonbaserede lokationssider samt hubs, flådesider og en blog. Målet var et Hugo-build, der blev leveret som statiske filer bag Cloudflare, samtidig med at alle eksisterende stier blev bevaret.

02

Kortlægning af skabeloner før indholdet

Vi begyndte med at gruppere URL’er efter den WordPress-skabelon, der genererede dem - ikke efter URL-mønster. Hver gruppe fik én beslutning: skulle den genopbygges som et Hugo-layout, eller skulle der midlertidigt leveres et statisk snapshot af WordPress-outputtet? Ved først at genopbygge grupperne med mest trafik og tage snapshots af særtilfældene kunne projektet fortsætte uden at blive blokeret af den lange hale af specialtilpassede sider.

En vigtig faldgrube: I WordPress er URL-stien ikke altid den samme som sluggen i post_name. Forældresider, brugerdefinerede rewrite-regler og gamle importer skabte stier, der ikke matchede sluggen, så stien skulle hentes fra crawlet - ikke fra databasen.

03

Partitionerede builds og faldgruber i filsystemet

Det var langsomt at rendere alle sider i én kørsel, og selv små ændringer blev dyre. Vi partitionerede processen: Flyt kildefilerne, vi ikke byggede, til et midlertidigt lager, byg et udsnit, deploy det, og gendan derefter filerne. Fire faldgruber kostede os tid:

  1. Lageret skal ligge uden for Hugos content-mount. Hvis det ligger et sted under den monterede content-mappe, gennemgår Hugo stadig alle filer, og partitioneringen sparer ingenting.
  2. rsync --exclude=index.html udelukker alle index.html-filer på alle niveauer, ikke kun den øverste. Forankr mønsteret (--exclude=/index.html).
  3. To samtidige flytteprocesser i den samme mappe lægger mapperne ind i hinanden. To gendannelsesprocesser, der kørte samtidig, oprettede omkring 367.000 mapper ét niveau for dybt. Produktionen fungerede, fordi den leverede det byggede output; et enkelt scriptet flyt fladede dem ud igen. Én proces ejer mappen, håndhævet med en lås.
  4. mv dir/* target/ fejler ved denne størrelse (argumentlisten er for lang). Brug find ... -exec mv -t target {} +.
# rendér en håndfuld sider uden at bygge det hele igen
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # lageret ligger UDEN FOR content-mountet
  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/ {} +
'
04

Performanceforbedringer anvendt som skabelonændring plus gennemgang af hele indholdskorpuset

Hver rettelse havde to dele: Ret Hugo-skabelonen, så fremtidige builds blev korrekte, og patch det allerede byggede HTML, så vi ikke behøvede et fuldt rebuild for at udgive ændringen. De vigtigste var:

  • Billeddimensioner. En skabelon havde hardkodet width="1600" height="700", mens CSS’en brugte et andet størrelsesforhold. Det blev rettet på 527.815 sider. Width/height skal matche det rendere­de størrelsesforhold, ellers reserverer browseren den forkerte plads (optimer CLS).
  • Modstridende aspect-ratio-regler på den samme selector i to stylesheets; de blev samlet til én.
  • Kritisk CSS i den asynkrone fil. Mobilregler, der var nødvendige ved første rendering, lå i et udskudt stylesheet og medførte en sen omlayouting. De blev flyttet til det synkrone stylesheet.
  • Lazy-loadet hero-billede. loading="lazy" på billedet over folden forsinkede LCP; det blev erstattet med fetchpriority="high" (optimer LCP).
  • For store LCP-billeder blev erstattet med mindre varianter, hvilket sparede 50 til 440 KB pr. side.
  • Tilbudswidgetten indlæses ved første interaktion (med en timeout-baseret fallback), og dens container reserverer 480 px (560 px på mobil). Før flyttede dens indlæsning siden med en CLS på omkring 0,54.
05

Cloudflare-indstillinger, der gjorde en forskel

  • Email Obfuscation blev slået fra. Dens dekoder gennemgår DOM’en efter indlæsning og omskriver e-maillinks, hvilket viste sig som layout shift. Det var den mest vedvarende CLS-kilde, vi fandt.
  • Rocket Loader blev slået fra. Den ændrer rækkefølgen på scripts og forstyrrede den udskudte indlæsning.
  • Purge efter deploy. Edge-caches indeholdt gammel HTML; ved at purge efter sti efter hvert deploy undgik vi at levere forældede sider (Cloudflares purge-dokumentation).
  • Mål i produktion, ikke staging. Staging uden de samme Cloudflare-indstillinger gav laboratorieresultater, der ikke matchede produktionen.
06

Schema- og SEO-detaljer

  • Search Console rapporterede fejl i strukturerede data, fordi en Service-entitet indeholdt aggregateRating og review. Vi fjernede dem i stedet for at forsøge at få dem valideret; markup skal afspejle det indhold, brugerne kan se (retningslinjer for strukturerede data).
  • Blogindlæg blev oprindeligt rendere­t med lokationsskabelonen og arvede den forkerte schematype. Hver skabelon erklærer nu sin egen entitet.
  • 35 inkonsistente stier til flåde- og servicesider fik permanente redirects til de korrekte indlejrede sider (redirects).
  • Mediefiler blev flyttet fra /wp-content/uploads/ til /uploads/ med én samlet 301-regel; et parallelt sed-kald omskrev 528.852 af 528.854 filer på få minutter.
  • Yoast blev fjernet, da Hugo selv genererede sitemap, schema, metatags og robots.txt.
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

Leadgenerering er den del, du ikke må miste

Tilbudsformularen er sådan, sitet tjener penge på, så den fik sine egne kontroller: Widget-mountet skal findes i det byggede HTML på alle sider, hvor formularen er vist, feltnavnene skal matche det, intake-endpointet forventer, og et deploy, der erstatter en mappe, må ikke slette den selvstændige tilbudsside. En migrering, der i al stilhed fjerner leadgenereringen, kan se vellykket ud på alle SEO-målinger, samtidig med at virksomheden mister henvendelser.

08

Hvad vi ville gøre anderledes

  1. Slå Email Obfuscation fra før den første CLS-måling.
  2. Partitionér buildet fra første dag.
  3. Lås content-mappen fra første dag.
  4. Skriv mønsteret med skabelon plus gennemgang af hele indholdskorpuset ned før den første rettelse - ikke efter den femte.
  5. Tilføj feltdata-kontrollen (CrUX) til lanceringschecklisten, fordi laboratorieresultater på staging ikke er det samme som produktion.

Den forretningsmæssige gennemgang af det samme projekt, herunder hvad vi lod blive på WordPress, findes i casestudiet.

09

Kilder og videre læsning

Ofte stillede spørgsmål

Er dette en kundemigrering?

Nej. Unlimited Charters er et internt søstersite, der ejes af den samme koncern som WordPressEscape. Det er vores eget testtilfælde.

Kan Hugo håndtere en halv million sider?

Ja, men fulde rebuilds er langsomme nok til, at partitionerede builds og omhyggelig filhåndtering gør en forskel. De fleste af vores problemer skyldtes filsystem og processer snarere end fejl i Hugo.

Hvad forårsagede det største layout shift?

Tilbudswidgetten blev indlæst uden reserveret plads (omkring 0,54 CLS på hub-sider), og Cloudflare Email Obfuscation omskrev siden efter indlæsning.

Gælder disse erfaringer også for små sites?

Ja. De samme kontroller (URL-paritet, billeddimensioner, kritisk CSS, hero-billede uden lazy loading og udskudte widgets) gælder for et site med 40 sider; de tager bare minutter i stedet for timer.

Scan mit site gratis

Se, om dit site er egnet til samme behandling

Den gratis 60-sekunders audit viser din reelle PageSpeed-score, det præcise sideantal, SEO-mangler og de WordPress-funktioner, der skal erstattes. Derefter genopbygger WordPressEscape dit site på Hugo, bevarer alle URL’er og giver dig kildekoden fra dag ét - på samme måde som UC blev genopbygget.

Scan mit site gratis
Læs videre
Alle guides33
Relaterede søgningerwordpress til hugo-migrering528.854 sider (intern test)partitioneret hugo-buildcloudflare cls-rettelseoprydning i schemaurl-paritet