WordPressEscape

Domů / Průvodce

Dílna

Migrace 528 854 stránek WordPressu do Hugo: Poznámky z implementace

Toto jsou pracovní poznámky z migrace našeho sesterského webu Unlimited Charters z WordPressu do Hugo, která proběhla v květnu 2026. Obchodní shrnutí najdete v případové studii; zde se věnujeme tomu, co potřebuje vědět každý, kdo musí migraci skutečně provést: co se pokazilo u půl milionu stránek, které příkazy nás potrápily a jaké kontroly nyní spouštíme na každém webu, ať už je malý, nebo velký.

Čtení na 6 min 9 sekcí Vytvořeno pro dobré pozice ve vyhledávání
Na této stránce
  1. Kontext
  2. Inventura šablon před obsahem
  3. Dělená sestavení a nástrahy souborového systému
  4. Opravy výkonu jako změna šablony a průchod celým obsahem
  5. Nastavení Cloudflare, která měla význam
  6. Strukturovaná data a SEO
  7. Zachycení kontaktů je část, o kterou nesmíte přijít
  8. Co bychom dnes udělali jinak
  9. Zdroje a další čtení
  10. Často kladené otázky
Rychlá odpověď

V tomto měřítku jsou problémy spíše otázkou souborového systému a procesu než samotného Hugo: dělení sestavení, uchovávání odloženého obsahu mimo adresář content připojený k Hugo, nikdy nespouštět dva přesuny nad stejným adresářem a každou opravu řešit jako změnu šablony doplněnou o skriptovaný průchod celým obsahem. Největší zlepšení výkonu přinesly rozměry obrázků, synchronní kritické CSS, obrázek LCP bez lazy-loadingu, odložený widget s nabídkou a vyhrazeným prostorem a vypnutí funkce Cloudflare Email Obfuscation.

01

Kontext

Unlimited Charters vlastní stejná skupina jako WordPressEscape; šlo o naši vlastní testovací migraci s plným přístupem k serveru. Web měl něco přes půl milionu URL, převážně šablonové stránky lokalit, dále tematické huby, stránky s flotilou a blog. Cílem bylo sestavení v Hugo, poskytované jako statické soubory za Cloudflare, při zachování všech stávajících cest.

02

Inventura šablon před obsahem

Začali jsme seskupením URL podle šablony WordPressu, která je vykreslovala, nikoli podle vzoru URL. Pro každou skupinu jsme přijali jedno rozhodnutí: buď ji znovu sestavit jako rozvržení v Hugo, nebo zatím poskytovat statický snímek výstupu WordPressu. Přestavba nejnavštěvovanějších skupin jako první a vytváření snímků pro nestandardní stránky nám umožnily pokračovat bez čekání na dlouhý seznam vlastních stránek.

Jedna důležitá záludnost: ve WordPressu cesta URL nemusí vždy odpovídat slugu post_name. Nadřazené stránky, vlastní pravidla pro přepis URL a staré importy vytvořily cesty, které se slugem neshodovaly, takže cestu bylo nutné získat z crawlování, nikoli z databáze.

03

Dělená sestavení a nástrahy souborového systému

Vykreslování všech stránek v jediném běhu bylo pomalé a každou drobnou změnu prodražovalo. Obsah jsme proto rozdělili: zdrojové soubory, které jsme právě nesestavovali, jsme přesunuli do odkládacího adresáře, sestavili podmnožinu, nasadili ji a obsah obnovili. Čas nás stály čtyři nástrahy:

  1. Odkládací adresář musí být mimo adresář content připojený k Hugo. Pokud se nachází kdekoli pod připojeným adresářem content, Hugo stále prochází všechny soubory a dělení nepřináší žádnou úsporu.
  2. rsync --exclude=index.html vyloučí každý index.html ve všech úrovních, nejen ten v kořenovém adresáři. Vzor proto ukotvěte (--exclude=/index.html).
  3. Dva souběžné procesy přesouvající obsah ve stejném adresáři ho vnoří. Dva procesy obnovy, které závodily mezi sebou, vytvořily přibližně 367 000 adresářů o jednu úroveň hlouběji, než měly být. Produkce fungovala, protože poskytovala již sestavený výstup; jediný skriptovaný přesun adresáře srovnal. Vlastnictví adresáře má vždy pouze jeden proces, což vynucujeme zámkem.
  4. mv dir/* target/ při této velikosti selže (seznam argumentů je příliš dlouhý). Použijte find ... -exec mv -t target {} +.
# vykreslení několika stránek bez opětovného sestavení všeho
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # odkládací adresář MIMO adresáře content
  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

Opravy výkonu jako změna šablony a průchod celým obsahem

Každá oprava měla dvě části: upravit šablonu Hugo tak, aby byly správné i budoucí buildy, a opravit již sestavené HTML, abychom nemuseli kvůli nasazení čekat na kompletní rebuild. Největší dopad měly tyto změny:

  • Rozměry obrázků. Šablona natvrdo nastavovala width="1600" height="700", zatímco CSS používalo jiný poměr stran. Opravili jsme to na 527 815 stránkách. Šířka a výška musí odpovídat vykreslenému poměru stran, jinak prohlížeč vyhradí nesprávné místo (optimalizace CLS).
  • Konfliktní pravidla aspect-ratio pro stejný selektor ve dvou šablonách stylů; sjednotili jsme je do jednoho pravidla.
  • Kritické CSS v asynchronním souboru. Mobilní pravidla potřebná pro první vykreslení byla v odložené šabloně stylů, což způsobovalo pozdní přeskupení rozvržení. Přesunuli jsme je do synchronně načítané šablony stylů.
  • Hero obrázek s lazy-loadingem. Atribut loading="lazy" u obrázku nad přehybem oddaloval LCP; nahradili jsme ho atributem fetchpriority="high" (optimalizace LCP).
  • Příliš velké obrázky LCP jsme nahradili menšími variantami, čímž jsme ušetřili 50 až 440 KB na stránku.
  • Widget s nabídkou se načítá až při první interakci (s časovým limitem jako záložním řešením) a jeho kontejner rezervuje 480 px (na mobilu 560 px). Předtím jeho vložení posouvalo stránku a způsobovalo CLS přibližně 0,54.
05

Nastavení Cloudflare, která měla význam

  • Email Obfuscation vypnuto. Jeho dekodér po načtení prochází DOM a přepisuje e-mailové odkazy, což se projevilo posunem rozvržení. Šlo o nejvytrvalejší zdroj CLS, který jsme našli.
  • Rocket Loader vypnuto. Měnil pořadí skriptů a narušoval odložené načítání.
  • Vymazání cache po nasazení. Okrajové cache obsahovaly staré HTML; vymazání podle cesty po každém nasazení zabránilo zobrazování zastaralých stránek (dokumentace k vymazání cache Cloudflare).
  • Měřte produkci, ne staging. Staging bez stejného nastavení Cloudflare poskytoval laboratorní skóre, které neodpovídalo produkci.
06

Strukturovaná data a SEO

  • Search Console hlásila chyby strukturovaných dat, protože entita Service obsahovala aggregateRating a review. Odstranili jsme je, místo abychom se snažili dosáhnout jejich validace; značky musí odpovídat obsahu, který uživatelé skutečně vidí (pokyny ke strukturovaným datům).
  • Blogové články se původně vykreslovaly pomocí šablony lokalit a přebíraly nesprávný typ strukturovaných dat. Nyní každá šablona deklaruje vlastní entitu.
  • 35 nekonzistentních cest flotil a služeb jsme trvale přesměrovali na správné vnořené stránky (přesměrování).
  • Média jsme přesunuli z /wp-content/uploads/ do /uploads/ pomocí jediného pravidla 301; paralelní průchod pomocí sed přepsal během několika minut 528 852 z 528 854 souborů.
  • Yoast jsme odstranili poté, co Hugo začalo generovat sitemapu, strukturovaná data, meta tagy a robots.txt.
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

Zachycení kontaktů je část, o kterou nesmíte přijít

Formulář s nabídkou je zdrojem příjmů webu, proto jsme pro něj zavedli vlastní kontroly: na každé stránce, která ho obsahuje, musí být ve výsledném HTML přítomný kontejner widgetu, názvy polí musí odpovídat tomu, co očekává endpoint pro příjem dat, a nasazení, které nahrazuje celý adresář, nesmí smazat samostatnou stránku s nabídkou. Přechod, při kterém se nepozorovaně ztratí sběr kontaktů, může na všech SEO metrikách vypadat úspěšně, zatímco firmě mizí poptávky.

08

Co bychom dnes udělali jinak

  1. Email Obfuscation bychom vypnuli ještě před prvním měřením CLS.
  2. Sestavení bychom rozdělili hned od prvního dne.
  3. Adresář content bychom uzamkli hned od prvního dne.
  4. Postup „změna šablony plus průchod celým obsahem“ bychom si sepsali ještě před první opravou, ne až po páté.
  5. Kontrolu dat z reálného provozu (CrUX) bychom zařadili do checklistu před spuštěním, protože laboratorní skóre ze stagingu neodráží produkci.

Obchodní pohled na stejný projekt včetně toho, co jsme ponechali ve WordPressu, najdete v případové studii.

09

Zdroje a další čtení

Často kladené otázky

Jde o migraci pro zákazníka?

Ne. Unlimited Charters je interní sesterský web vlastněný stejnou skupinou jako WordPressEscape. Jde o náš vlastní testovací případ.

Zvládne Hugo půl milionu stránek?

Ano, ale kompletní rebuildy jsou natolik pomalé, že záleží na dělených sestaveních a pečlivé práci se soubory. Většinu problémů nezpůsobily chyby v Hugo, ale souborový systém a proces migrace.

Co způsobilo největší posun rozvržení?

Widget s nabídkou, který se vkládal bez vyhrazeného prostoru (na stránkách hubů způsoboval CLS přibližně 0,54), a Cloudflare Email Obfuscation, který po načtení přepisoval stránku.

Platí tyto poznatky i pro malé weby?

Ano. Stejné kontroly (shoda URL, rozměry obrázků, kritické CSS, hero obrázek bez lazy-loadingu a odložené widgety) platí i pro web se 40 stránkami; jen se provedou během minut místo hodin.

Proveďte bezplatnou kontrolu mého webu

Zjistěte, zda lze váš web optimalizovat stejným způsobem

Bezplatný audit za 60 sekund ukáže skutečné skóre PageSpeed, přesný počet stránek, nedostatky v SEO a funkce WordPressu, které je potřeba nahradit. WordPressEscape pak váš web znovu sestaví v Hugo, zachová všechny URL a hned první den vám předá zdrojové soubory - stejně jako při přestavbě webu UC.

Proveďte bezplatnou kontrolu mého webu
Pokračovat ve čtení
Všechny průvodce33
Související vyhledávánímigrace z wordpressu do hugo528 854 stránek (interní test)dělené sestavení v hugooprava cls v cloudflareúklid strukturovaných datshoda url