Pe această pagină
- Context
- Inventarierea template-urilor înaintea conținutului
- Builduri partiționate și capcanele sistemului de fișiere
- Remedieri de performanță, aplicate prin modificarea template-ului și actualizarea întregului corpus
- Setările Cloudflare care au contat
- Detalii despre schemă și SEO
- Captarea leadurilor este partea pe care nu o poți pierde
- Ce am face diferit
- Surse și lecturi suplimentare
- Întrebări frecvente
La această scară, problemele țin mai mult de sistemul de fișiere și de proces decât de Hugo: partiționarea buildului, păstrarea conținutului pus deoparte în afara directorului de conținut montat de Hugo, interdicția de a rula simultan două procese de mutare în același director și tratarea fiecărei remedieri ca pe o modificare de template urmată de o actualizare scriptată la nivelul întregului corpus. Cele mai mari câștiguri de performanță au venit din dimensiunile imaginilor, CSS critic sincron, o imagine LCP care nu se încarcă lazy, un widget de citate amânat cu spațiu rezervat și dezactivarea Cloudflare Email Obfuscation.
Context
Unlimited Charters este deținut de același grup ca WordPressEscape; aceasta a fost migrarea noastră internă de test, realizată cu acces complet la server. Site-ul avea puțin peste jumătate de milion de URL-uri, în principal pagini de locație generate pe baza template-urilor, plus huburi, pagini pentru flotă și un blog. Obiectivul a fost un build Hugo servit ca fișiere statice prin Cloudflare, cu păstrarea fiecărei căi existente.
Inventarierea template-urilor înaintea conținutului
Am început prin a grupa URL-urile după template-ul WordPress care le genera, nu după tiparul URL-ului. Pentru fiecare familie am luat o singură decizie: fie o reconstruim ca layout Hugo, fie servim temporar un snapshot static al rezultatului WordPress. Reconstruirea mai întâi a familiilor cu trafic ridicat și generarea de snapshoturi pentru cazurile atipice ne-a permis să avansăm fără să blocăm proiectul din cauza cozii lungi de pagini personalizate.
O capcană pe care merită să o știi: în WordPress, calea URL nu este întotdeauna slugul post_name. Paginile părinte, regulile personalizate de rescriere și importurile vechi au produs căi care nu corespundeau slugului, așa că a trebuit să preluăm calea din crawl, nu din baza de date.
Builduri partiționate și capcanele sistemului de fișiere
Randarea tuturor paginilor într-o singură rulare era lentă și făcea costisitoare orice modificare minoră. Am partiționat procesul: mutăm fișierele sursă pe care nu le construim într-un director temporar, generăm un subset, îl publicăm, apoi restaurăm fișierele. Patru capcane ne-au consumat timpul:
- Directorul temporar trebuie să fie în afara directorului de conținut montat de Hugo. Dacă se află oriunde sub directorul de conținut montat, Hugo parcurge în continuare fiecare fișier, iar partiționarea nu mai aduce niciun beneficiu.
rsync --exclude=index.htmlexclude toate fișierele index.html, indiferent de nivel, nu doar pe cel din directorul principal. Ancorează tiparul (--exclude=/index.html).- Două procese de mutare concurente în același director îl imbrică. Două procese de restaurare care au rulat simultan au produs aproximativ 367.000 de directoare cu un nivel în plus. Producția a funcționat deoarece servea rezultatul buildului; un singur proces scriptat le-a aplatizat. Un singur proces deține directorul, lucru impus printr-un lock.
mv dir/* target/eșuează la această dimensiune (lista de argumente este prea lungă). Foloseștefind ... -exec mv -t target {} +.
# randarea câtorva pagini fără reconstruirea întregului site
flock /tmp/uc-content.lock bash -c '
mv content/migrated/* ../stash/ # directorul temporar este ÎN AFARA directorului de conținut montat
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/ {} +
'Remedieri de performanță, aplicate prin modificarea template-ului și actualizarea întregului corpus
Fiecare remediere a avut două componente: corectarea template-ului Hugo, astfel încât buildurile viitoare să fie corecte, și actualizarea HTML-ului deja generat, pentru a nu fi nevoie de un rebuild complet înainte de publicare. Cele mai importante au fost:
- Dimensiunile imaginilor. Un template avea valorile
width="1600" height="700"hardcodate, în timp ce CSS-ul folosea un alt raport de aspect. Am corectat problema pe 527.815 pagini. Lățimea și înălțimea trebuie să corespundă raportului de aspect randat; altfel, browserul rezervă un spațiu greșit (optimizarea CLS). - Reguli aspect-ratio contradictorii pentru același selector în două foi de stil; le-am consolidat într-o singură regulă.
- CSS critic în fișierul asincron. Regulile pentru mobil necesare la prima randare se aflau într-o foaie de stil amânată, provocând o rearanjare târzie. Le-am mutat în foaia de stil încărcată sincron.
- Imaginea principală încărcată lazy.
loading="lazy"pe imaginea vizibilă fără derulare întârzia LCP; am înlocuit-o cufetchpriority="high"(optimizarea LCP). - Imaginile LCP supradimensionate au fost înlocuite cu variante mai mici, economisind între 50 și 440 KB pe pagină.
- Widgetul de citate se încarcă la prima interacțiune (cu o soluție de rezervă pe bază de timeout), iar containerul său rezervă 480 px (560 px pe mobil). Înainte, montarea widgetului deplasa pagina, generând un CLS de aproximativ 0,54.
Setările Cloudflare care au contat
- Email Obfuscation dezactivat. Decoderul său parcurge DOM-ul după încărcare și rescrie linkurile de e-mail, ceea ce a apărut ca schimbare de layout. A fost cea mai persistentă sursă de CLS identificată.
- Rocket Loader dezactivat. Reordona scripturile și interfera cu încărcarea amânată.
- Golirea cache-ului după publicare. Cache-urile edge păstrau HTML vechi; golirea cache-ului după cale, după fiecare publicare, a evitat servirea paginilor învechite (documentația Cloudflare despre golirea cache-ului).
- Măsoară producția, nu stagingul. Stagingul, fără aceleași setări Cloudflare, a produs scoruri de laborator care nu corespundeau producției.
Detalii despre schemă și SEO
- Search Console a raportat erori de date structurate deoarece o entitate Service conținea
aggregateRatingșireview. Le-am eliminat în loc să încercăm să le facem valide; markupul trebuie să reflecte conținutul pe care utilizatorii îl pot vedea (recomandări pentru date structurate). - Inițial, articolele de blog erau randate folosind template-ul pentru locații și moșteneau tipul de schemă greșit. Acum, fiecare template își declară propria entitate.
- 35 de căi inconsistente pentru flotă și servicii au primit redirecționări permanente către paginile corecte, imbricate (redirecționări).
- Fișierele media au fost mutate din
/wp-content/uploads/în/uploads/printr-o singură regulă 301; o rularesedparalelă a rescris 528.852 din 528.854 de fișiere în câteva minute. - Yoast a fost eliminat după ce Hugo a început să genereze sitemapul, schema, meta tagurile și robots.txt.
find static-v5 -name '*.html' -print0 \
| xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'Captarea leadurilor este partea pe care nu o poți pierde
Formularul de ofertă este sursa de venit a site-ului, așa că a primit propriile verificări: mount-ul widgetului trebuie să existe în HTML-ul generat pentru fiecare pagină care îl conținea, numele câmpurilor trebuie să corespundă cerințelor endpointului de preluare, iar o publicare care înlocuiește un director nu trebuie să șteargă pagina de ofertă independentă. O trecere în producție care elimină în tăcere captarea leadurilor poate părea reușită după toate metricile SEO, în timp ce compania pierde solicitări.
Ce am face diferit
- Am dezactiva Email Obfuscation înainte de prima măsurare CLS.
- Am partiționa buildul din prima zi.
- Am blocat directorul de conținut din prima zi.
- Am documentat modelul „modificarea template-ului plus actualizarea întregului corpus” înainte de prima remediere, nu după a cincea.
- Am inclus verificarea datelor de teren (CrUX) în lista de verificare pentru lansare, deoarece scorurile de laborator din staging nu reprezintă producția.
Perspectiva de business asupra aceluiași proiect, inclusiv ce am păstrat în WordPress, se găsește în studiul de caz.
Surse și lecturi suplimentare
Documentația principală pe care ne-am bazat pentru acest ghid. Linkurile au fost verificate pe 11 noiembrie 2026.
- Documentația Hugo: început rapid
- Documentația Hugo: gestionarea URL-urilor (permalinks și aliasuri)
- web.dev: optimizarea Cumulative Layout Shift
- web.dev: optimizarea Largest Contentful Paint
- web.dev: Cumulative Layout Shift (CLS)
- Documentația Cloudflare: golirea cache-ului
- Documentația Cloudflare: cache
- Google Search Central: introducere în date structurate
- Google Search Central: redirecționări și Google Search
- Google Search Central: mutarea site-ului cu modificarea URL-urilor
- Documentația Chrome UX Report (CrUX)
Întrebări frecvente
Este vorba despre migrarea unui site al unui client?
Nu. Unlimited Charters este un site soră intern, deținut de același grup ca WordPressEscape. Este propriul nostru caz de test.
Poate Hugo să gestioneze jumătate de milion de pagini?
Da, însă rebuildurile complete sunt suficient de lente încât buildurile partiționate și gestionarea atentă a fișierelor contează. Cele mai multe probleme au ținut de sistemul de fișiere și de proces, nu de erori Hugo.
Ce a cauzat cea mai gravă schimbare de layout?
Montarea widgetului de citate fără spațiu rezervat (aproximativ 0,54 CLS pe paginile hub) și Cloudflare Email Obfuscation, care rescria pagina după încărcare.
Se aplică aceste lecții și site-urilor mici?
Da. Aceleași verificări (paritatea URL-urilor, dimensiunile imaginilor, CSS critic, imagine principală fără lazy loading și widgeturi încărcate amânat) se aplică unui site de 40 de pagini; doar că rulează în câteva minute, nu în câteva ore.
Vezi dacă site-ul tău se califică pentru același tratament
Auditul gratuit de 60 de secunde îți arată scorul PageSpeed real, numărul exact de pagini, problemele SEO și funcționalitățile WordPress care trebuie înlocuite. Apoi WordPressEscape îți reconstruiește site-ul în Hugo, păstrează fiecare URL și îți oferă sursa chiar din prima zi - exact așa cum a fost reconstruit UC.
Scanează gratuit site-ul meu

