WordPressEscape

Etusivu / Opas

Työpöytä

528 854 WordPress-sivun siirtäminen Hugoon: tekniset muistiinpanot

Nämä ovat työmuistiinpanot Unlimited Chartersin, samaan konserniin kuuluvan sisarsivustomme, siirtämisestä WordPressistä Hugoon toukokuussa 2026. Liiketoimintaa käsittelevä yhteenveto löytyy tapaustutkimuksesta; tässä keskitytään siihen, joka työn joutuu tekemään: mikä hajosi puolen miljoonan sivun mittakaavassa, mitkä komennot aiheuttivat ongelmia ja mitkä tarkistukset suoritamme nyt jokaiselle sivustolle koosta riippumatta.

4 minuutin lukeminen 9 osiota Suunniteltu sijoittumaan hakutuloksissa
Tällä sivulla
  1. Taustaa
  2. Mallipohjien kartoitus ennen sisältöä
  3. Osioidut koontiversiot ja tiedostojärjestelmän sudenkuopat
  4. Suorituskykykorjaukset: mallipohjan muutos ja koko sisältöaineiston käsittely
  5. Merkitykselliset Cloudflare-asetukset
  6. Skeema- ja SEO-yksityiskohdat
  7. Liidien kerääminen on osa, jota ei voi menettää
  8. Mitä tekisimme toisin
  9. Lähteet ja lisälukemista
  10. Usein kysytyt kysymykset
Pikavastaus

Tässä mittakaavassa ongelmat liittyvät enemmän tiedostojärjestelmään ja prosesseihin kuin Hugoon: koontiversioiden osiointiin, sisällön säilömiseen Hugo-sisältöhakemiston ulkopuolelle, kahden siirtoprosessin ajamisen estämiseen samassa hakemistossa sekä siihen, että jokainen korjaus käsitellään sekä mallipohjan muutoksena että koko sisältöaineiston kattavana skriptattuna ajona. Suurimmat suorituskykyhyödyt saatiin kuvien mitoista, synkronisesta kriittisestä CSS:stä, LCP-kuvan lazy loadingin poistamisesta, viivästetystä ja tilaa varaavasta tarjouswidgetistä sekä Cloudflare Email Obfuscationin poistamisesta.

01

Taustaa

Unlimited Charters kuuluu samaan konserniin kuin WordPressEscape. Kyseessä oli oma testisiirtomme, joka tehtiin täydellä palvelinkäyttöoikeudella. Sivustolla oli hieman yli puoli miljoonaa URL-osoitetta: pääasiassa mallipohjaisia sijaintisivuja sekä keskussivuja, kalustosivuja ja blogi. Tavoitteena oli Hugolla tuotettu koontiversio, joka tarjoillaan staattisina tiedostoina Cloudflaren takaa ja jossa kaikki nykyiset polut säilytetään.

02

Mallipohjien kartoitus ennen sisältöä

Aloitimme ryhmittelemällä URL-osoitteet niiden WordPress-mallipohjien perusteella, joilla ne renderöitiin, emme URL-kuvioiden mukaan. Jokaiselle ryhmälle tehtiin yksi päätös: rakennetaanko se uudelleen Hugon layoutiksi vai tarjoillaanko WordPressin tulosteesta toistaiseksi staattinen tilannevedos. Suuren liikenteen ryhmien rakentaminen ensin ja poikkeustapausten käsittely tilannevedoksina piti projektin etenemässä ilman, että pitkän hännän mukautetut sivut pysäyttivät työn.

Yksi huomionarvoinen sudenkuoppa: WordPressissä URL-polku ei aina ole post_name-slug. Ylätason sivut, mukautetut uudelleenkirjoitussäännöt ja vanhat tuonnit tuottivat polkuja, jotka eivät vastanneet slugia. Siksi polku piti ottaa indeksoinnista, ei tietokannasta.

03

Osioidut koontiversiot ja tiedostojärjestelmän sudenkuopat

Kaikkien sivujen renderöinti yhtenä ajona oli hidasta ja teki jokaisesta pienestä muutoksesta kalliin. Osioimme työn: siirsimme rakennettavan osion ulkopuoliset lähdetiedostot säilöön, rakensimme osajoukon, julkaisimme sen ja palautimme tiedostot. Neljä sudenkuoppaa vei aikaa:

  1. Säilön on sijaittava Hugo-sisältöhakemiston ulkopuolella. Jos se sijaitsee missä tahansa liitetyn sisältöhakemiston alla, Hugo käy edelleen läpi kaikki tiedostot eikä osioinnista ole hyötyä.
  2. rsync --exclude=index.html sulkee pois kaikki index.html-tiedostot kaikilla hakemistotasoilla, ei vain ylintä tiedostoa. Rajaa kuvio juureen (--exclude=/index.html).
  3. Kaksi samanaikaista siirtoprosessia samassa hakemistossa sisäkkäistää sen. Kaksi toisiaan vastaan kilpaillutta palautusprosessia tuotti noin 367 000 hakemistoa yhden tason liian syvälle. Tuotantoympäristö toimi, koska se tarjoili valmiin koontituloksen; yksi skriptattu siirto palautti hakemistot oikealle tasolle. Hakemistolla saa olla vain yksi omistava prosessi, mikä varmistetaan lukituksella.
  4. mv dir/* target/ epäonnistuu tässä koossa (argumenttilista on liian pitkä). Käytä komentoa find ... -exec mv -t target {} +.
# renderöi kourallinen sivuja rakentamatta kaikkea uudelleen
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # säilö Hugo-sisältöhakemiston ULKOPUOLELLE
  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

Suorituskykykorjaukset: mallipohjan muutos ja koko sisältöaineiston käsittely

Jokaisessa korjauksessa oli kaksi osaa: korjasimme Hugo-mallipohjan, jotta tulevat koontiversiot olisivat oikein, ja päivitimme jo rakennetun HTML:n, jotta korjaus voitiin julkaista ilman täyttä uudelleenrakennusta. Tärkeimmät korjaukset olivat:

  • Kuvien mitat. Mallipohjassa oli kiinteästi määritetty width="1600" height="700", vaikka CSS käytti eri kuvasuhdetta. Korjasimme tämän 527 815 sivulla. Leveyden ja korkeuden on vastattava renderöityä kuvasuhdetta, muuten selain varaa väärän määrän tilaa (CLS:n optimointi).
  • Ristiriitaiset kuvasuhdesäännöt samalle valitsimelle kahdessa tyylitiedostossa; yhdistimme säännöt yhdeksi.
  • Kriittinen CSS asynkronisessa tiedostossa. Ensimmäiseen piirtoon tarvittavat mobiilisäännöt olivat viivästetyssä tyylitiedostossa, mikä aiheutti myöhäisen uudelleenladonnan. Siirsimme ne synkroniseen tyylitiedostoon.
  • Lazy loadingilla ladattu hero-kuva. Sivun yläosassa näkyvän kuvan loading="lazy" viivästytti LCP:tä; korvasimme sen määrityksellä fetchpriority="high" (LCP:n optimointi).
  • Liian suuret LCP-kuvat vaihdettiin pienempiin versioihin, mikä säästi sivua kohden 50-440 kilotavua.
  • Tarjouswidget ladataan ensimmäisen vuorovaikutuksen yhteydessä (aikakatkaisulle on vararatkaisu), ja sen säilö varaa 480 pikseliä tilaa (mobiilissa 560 pikseliä). Aiemmin sen latautuminen siirsi sivua noin 0,54 CLS-arvon verran.
05

Merkitykselliset Cloudflare-asetukset

  • Email Obfuscation pois käytöstä. Sen purkaja käy DOM-puun läpi latauksen jälkeen ja kirjoittaa sähköpostilinkit uudelleen, mikä näkyi layoutin siirtymänä. Se oli sitkein löytämämme CLS:n lähde.
  • Rocket Loader pois käytöstä. Se järjesteli skriptejä uudelleen ja häiritsi viivästettyä latausta.
  • Välimuistin tyhjennys julkaisun jälkeen. Reunavälimuistit säilyttivät vanhaa HTML:ää; polkukohtainen tyhjennys jokaisen julkaisun jälkeen esti vanhojen sivujen tarjoilun (Cloudflaren välimuistin tyhjennysohjeet).
  • Mittaa tuotantoa, älä testiympäristöä. Testiympäristö, jossa ei ollut samoja Cloudflare-asetuksia, tuotti laboratoriotuloksia, jotka eivät vastanneet tuotantoa.
06

Skeema- ja SEO-yksityiskohdat

  • Search Console ilmoitti rakenteisen datan virheistä, koska Service-entiteetillä oli aggregateRating- ja review-ominaisuudet. Poistimme ne sen sijaan, että olisimme yrittäneet saada niitä validoitumaan; merkintöjen on vastattava sisältöä, jonka käyttäjät voivat nähdä (rakenteisen datan ohjeet).
  • Blogikirjoitukset renderöitiin aluksi sijaintisivujen mallipohjalla, joten ne perivät väärän skeematyypin. Nyt jokainen mallipohja määrittelee oman entiteettinsä.
  • 35 epäjohdonmukaista kalusto- ja palvelupolkua ohjattiin pysyvillä uudelleenohjauksilla oikeille sisäkkäisille sivuille (uudelleenohjaukset).
  • Media siirrettiin polusta /wp-content/uploads/ polkuun /uploads/ yhdellä 301-säännöllä; rinnakkainen sed-ajo kirjoitti muutamassa minuutissa polun uusiksi 528 852 tiedostossa 528 854:stä.
  • Yoast poistettiin, kun Hugo alkoi tuottaa sivustokartan, skeeman, metatunnisteet ja robots.txt-tiedoston.
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

Liidien kerääminen on osa, jota ei voi menettää

Tarjouslomake tuottaa sivustolle liikevaihtoa, joten sille tehtiin omat tarkistukset: widgetin kiinnityskohdan on oltava mukana jokaisen sitä käyttäneen sivun rakennetussa HTML:ssä, kenttänimien on vastattava vastaanottavan rajapinnan odotuksia ja hakemiston korvaava julkaisu ei saa poistaa erillistä tarjoussivua. Jos liidien kerääminen katoaa käyttöönotossa, kaikki näyttää SEO-mittareilla onnistuneelta samalla kun liiketoiminta menettää yhteydenottopyyntöjä.

08

Mitä tekisimme toisin

  1. Poistaisimme Email Obfuscationin käytöstä ennen ensimmäistä CLS-mittausta.
  2. Osioisimme koontiversion heti ensimmäisestä päivästä lähtien.
  3. Lukitsisimme sisältöhakemiston heti ensimmäisestä päivästä lähtien.
  4. Kirjaisimme mallipohjan ja koko sisältöaineiston käsittelyn yhdistelmän ylös ennen ensimmäistä korjausta, emme vasta viidennen jälkeen.
  5. Lisäisimme kenttädatatarkistuksen (CrUX) julkaisun tarkistuslistaan, koska testiympäristön laboratoriotulokset eivät vastaa tuotantoa.

Saman projektin liiketoimintanäkökulma, mukaan lukien se, minkä jätimme WordPressiin, löytyy tapaustutkimuksesta.

09

Lähteet ja lisälukemista

Usein kysytyt kysymykset

Onko kyseessä asiakassiirto?

Ei. Unlimited Charters on samaan konserniin kuin WordPressEscape kuuluva sisäinen sisarsivusto. Kyseessä on oma testitapauksemme.

Käsitteleekö Hugo puoli miljoonaa sivua?

Kyllä, mutta täydet uudelleenrakennukset ovat riittävän hitaita, joten osioidut koontiversiot ja huolellinen tiedostojen käsittely ovat tärkeitä. Suurin osa ongelmistamme liittyi tiedostojärjestelmään ja prosesseihin, ei Hugon virheisiin.

Mikä aiheutti pahimman layoutin siirtymän?

Tarjouswidgetin latautuminen ilman sille varattua tilaa (keskussivuilla CLS oli noin 0,54) sekä Cloudflare Email Obfuscationin sivulle latauksen jälkeen tekemät muutokset.

Soveltuvatko nämä opit pienille sivustoille?

Kyllä. Samat tarkistukset (URL-osoitteiden vastaavuus, kuvien mitat, kriittinen CSS, lazy loadingia käyttämätön hero-kuva ja viivästetyt widgetit) soveltuvat 40-sivuiselle sivustolle; ne vain valmistuvat minuuteissa tuntien sijaan.

Skannaa sivustoni ilmaiseksi

Katso, soveltuuko sivustosi samaan käsittelyyn

Ilmainen 60 sekunnin auditointi näyttää todellisen PageSpeed-pisteesi, tarkan sivumäärän, SEO-puutteet ja WordPress-ominaisuudet, joille tarvitset korvaavan ratkaisun. Sen jälkeen WordPressEscape rakentaa sivustosi uudelleen Hugolla, säilyttää kaikki URL-osoitteet ja luovuttaa lähdekoodin käyttöösi heti ensimmäisenä päivänä - aivan kuten UC:n tapauksessa.

Skannaa sivustoni ilmaiseksi
Jatka lukemista
Kaikki oppaat33
Aiheeseen liittyvät hautwordpress - hugo-siirto528 854 sivua (sisäinen testi)Hugon osioitu koontiversioCloudflare CLS-korjausskeeman siivousURL-osoitteiden vastaavuus