På den här sidan
- Bakgrund
- Inventera mallarna före innehållet
- Partitionerade byggen och filsystemets fallgropar
- Prestandafixar: malländring plus genomgång av hela innehållsmängden
- Cloudflare-inställningar som gjorde skillnad
- Schema- och SEO-detaljer
- Leadgenerering är den del du inte får förlora
- Vad vi skulle göra annorlunda
- Källor och vidare läsning
- Vanliga frågor
I den här skalan handlar problemen mer om filsystem och arbetsprocesser än om Hugo: att dela upp bygget, hålla undanlagt innehåll utanför Hugos innehållsmontering, aldrig köra två flyttprocesser mot samma katalog och behandla varje fix som en malländring plus en skriptad genomgång av hela innehållsmängden. De största prestandavinsterna kom från bilddimensioner, synkron kritisk CSS, en LCP-bild som inte lazy-loadas, en fördröjd offertwidget med reserverat utrymme och att stänga av Cloudflare Email Obfuscation.
Bakgrund
Unlimited Charters ägs av samma koncern som WordPressEscape. Det här var vår egen testmigrering, genomförd med full åtkomst till servern. Webbplatsen hade drygt en halv miljon URL:er, främst mallbaserade lokala sidor samt hubbsidor, flottasidor och en blogg. Målet var ett Hugo-bygge som levereras som statiska filer bakom Cloudflare, där alla befintliga sökvägar bevaras.
Inventera mallarna före innehållet
Vi började med att gruppera URL:erna efter vilken WordPress-mall som renderade dem, inte efter URL-mönster. Varje grupp fick ett beslut: bygg om den som en Hugo-layout eller leverera tills vidare en statisk ögonblicksbild av WordPress-utdata. Genom att bygga om de mest trafikerade grupperna först och skapa ögonblicksbilder av avvikelserna kunde projektet fortsätta utan att fastna i den långa svansen av specialanpassade sidor.
En viktig fallgrop: i WordPress är URL-sökvägen inte alltid samma som sluggen i post_name. Överordnade sidor, anpassade omskrivningsregler och gamla importer skapade sökvägar som inte stämde med sluggen, så sökvägen behövde hämtas från crawlingen, inte från databasen.
Partitionerade byggen och filsystemets fallgropar
Att rendera alla sidor i en enda körning gick långsamt och gjorde varje liten ändring dyr. Vi delade därför upp bygget: flytta källfilerna som inte skulle byggas till en tillfällig lagringsplats, bygg en delmängd, distribuera den och återställ sedan filerna. Fyra fallgropar kostade oss tid:
- Lagringsplatsen måste ligga utanför Hugos innehållsmontering. Om den ligger någonstans under den monterade innehållskatalogen går Hugo fortfarande igenom alla filer, och uppdelningen ger ingen tidsvinst.
rsync --exclude=index.htmlexkluderar alla index.html-filer på alla nivåer, inte bara den översta. Förankra mönstret (--exclude=/index.html).- Två samtidiga flyttprocesser mot samma katalog kapslar in den. Två återställningsprocesser som tävlade med varandra skapade omkring 367 000 kataloger en nivå för djupt. Produktionen fungerade eftersom den levererade det färdigbyggda resultatet; ett enda skriptat flyttsteg plattade ut katalogerna. En process äger katalogen, vilket säkerställs med ett lås.
mv dir/* target/misslyckas i den här storleksordningen (argumentlistan blir för lång). Användfind ... -exec mv -t target {} +.
# rendera ett fåtal sidor utan att bygga om allt
flock /tmp/uc-content.lock bash -c '
mv content/migrated/* ../stash/ # lagra UTANFÖR innehållsmonteringen
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/ {} +
'Prestandafixar: malländring plus genomgång av hela innehållsmängden
Varje fix hade två delar: korrigera Hugo-mallen så att framtida byggen blev rätt och uppdatera den redan byggda HTML-koden så att vi kunde lansera ändringen utan ett fullständigt ombygge. De viktigaste åtgärderna var:
- Bilddimensioner. En mall angav hårdkodat
width="1600" height="700"medan CSS använde ett annat bildförhållande. Det korrigerades på 527 815 sidor. Bredd och höjd måste motsvara det renderade bildförhållandet, annars reserverar webbläsaren fel utrymme (optimera CLS). - Motstridiga regler för bildförhållande fanns för samma selektor i två stilmallar; de slogs ihop till en.
- Kritisk CSS i den asynkrona filen. Mobilregler som behövdes för den första renderingen låg i en fördröjd stilmall och orsakade en sen omlayout. De flyttades till den synkrona stilmallen.
- Lazy-loadad hero-bild.
loading="lazy"på bilden ovanför vecket fördröjde LCP; det ersattes medfetchpriority="high"(optimera LCP). - För stora LCP-bilder byttes mot mindre varianter, vilket sparade 50-440 KB per sida.
- Offertwidgeten laddas vid den första interaktionen (med en reservlösning via timeout), och dess behållare reserverar 480 px (560 px på mobil). Tidigare flyttade monteringen sidan med ett CLS på omkring 0,54.
Cloudflare-inställningar som gjorde skillnad
- Email Obfuscation avstängt. Dess avkodare går igenom DOM-trädet efter laddning och skriver om e-postlänkar, vilket syntes som layoutförskjutning. Det var den mest ihållande CLS-källan vi hittade.
- Rocket Loader avstängt. Funktionen ändrar ordningen på skript och störde den fördröjda laddningen.
- Töm cache efter driftsättning. Edge-cachelagren behöll gammal HTML; genom att tömma cache per sökväg efter varje driftsättning undvek vi att leverera inaktuella sidor (Cloudflares dokumentation om cachetömning).
- Mät i produktion, inte i staging. Staging utan samma Cloudflare-inställningar gav labbresultat som inte stämde med produktionen.
Schema- och SEO-detaljer
- Search Console rapporterade fel i strukturerad data eftersom en Service-entitet innehöll
aggregateRatingochreview. Vi tog bort dem i stället för att försöka få dem att validera; uppmärkningen måste återspegla det innehåll som användarna faktiskt kan se (riktlinjer för strukturerad data). - Blogginlägg renderades först med den lokala mallen och ärvde fel schematyp. Nu deklarerar varje mall sin egen entitet.
- 35 inkonsekventa flott- och tjänstesökvägar fick permanenta omdirigeringar till rätt nästlade sidor (omdirigeringar).
- Media flyttades från
/wp-content/uploads/till/uploads/med en enda 301-regel; en parallellsed-körning skrev om 528 852 av 528 854 filer på några minuter. - Yoast togs bort när Hugo började generera sitemap, schema, metataggar och robots.txt.
find static-v5 -name '*.html' -print0 \
| xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'Leadgenerering är den del du inte får förlora
Offertformuläret är det som genererar intäkter på webbplatsen, så det fick egna kontroller: widgetens monteringspunkt måste finnas i den byggda HTML-koden på alla sidor där den ska visas, fältnamnen måste stämma med det som mottagningsendpointen förväntar sig och en driftsättning som ersätter en katalog får inte ta bort den fristående offert sidan. En övergång där leadgenereringen försvinner kan se lyckad ut enligt alla SEO-mätvärden, samtidigt som verksamheten tappar förfrågningar.
Vad vi skulle göra annorlunda
- Stäng av Email Obfuscation innan den första CLS-mätningen.
- Dela upp bygget redan från dag ett.
- Lås innehållskatalogen redan från dag ett.
- Dokumentera mönstret med malländring plus genomgång av hela innehållsmängden före den första fixen, inte efter den femte.
- Lägg in kontrollen av fältdata (CrUX) i lanseringschecklistan, eftersom labbresultat i staging inte är samma sak som produktion.
Verksamhetsperspektivet på samma projekt, inklusive det vi lät ligga kvar i WordPress, finns i fallstudien.
Källor och vidare läsning
Den primära dokumentation vi använde för den här guiden. Länkarna kontrollerades den 11 november 2026.
- Hugo-dokumentation: snabbstart
- Hugo-dokumentation: URL-hantering (permalänkar och alias)
- web.dev: optimera Cumulative Layout Shift
- web.dev: optimera Largest Contentful Paint
- web.dev: Cumulative Layout Shift (CLS)
- Cloudflare Docs: töm cache
- Cloudflare Docs: cache
- Google Search Central: introduktion till strukturerad data
- Google Search Central: omdirigeringar och Google Search
- Google Search Central: flytt av webbplats med ändrade URL:er
- Dokumentation om Chrome UX Report (CrUX)
Vanliga frågor
Är det här en kundmigrering?
Nej. Unlimited Charters är en intern systersajt som ägs av samma koncern som WordPressEscape. Det är vårt eget testfall.
Klarar Hugo en halv miljon sidor?
Ja, men fullständiga ombyggen går tillräckligt långsamt för att partitionerade byggen och noggrann filhantering ska spela stor roll. De flesta av våra problem handlade mer om filsystem och arbetsprocesser än om buggar i Hugo.
Vad orsakade den värsta layoutförskjutningen?
Offertwidgeten monterades utan reserverat utrymme (omkring 0,54 CLS på hubbsidor), och Cloudflare Email Obfuscation skrev om sidan efter laddningen.
Gäller de här lärdomarna även små webbplatser?
Ja. Samma kontroller (URL-paritet, bilddimensioner, kritisk CSS, hero-bild utan lazy loading och fördröjda widgets) gäller för en webbplats med 40 sidor; de körs bara på minuter i stället för timmar.
Se om din webbplats passar för samma upplägg
Den kostnadsfria 60-sekundersgranskningen visar ditt faktiska PageSpeed-resultat, exakt sidantal, SEO-brister och vilka WordPress-funktioner du behöver ersätta. Därefter bygger WordPressEscape om webbplatsen i Hugo, behåller alla URL:er och lämnar över källkoden dag ett - på samma sätt som UC byggdes om.
Skanna min sajt gratis

