Na tej stronie
- Kontekst
- Inwentaryzacja szablonów przed migracją treści
- Kompilacje partycjonowane i pułapki systemu plików
- Optymalizacje wydajności wdrażane jako zmiana szablonu i aktualizacja całego korpusu
- Ustawienia Cloudflare, które miały znaczenie
- Szczegóły dotyczące danych strukturalnych i SEO
- Pozyskiwanie leadów to element, którego nie można utracić
- Co zrobilibyśmy inaczej
- Źródła i dalsza lektura
- Najczęściej zadawane pytania
Przy tej skali problemy dotyczą bardziej systemu plików i organizacji pracy niż samego Hugo: podziału kompilacji, przechowywania odłożonej zawartości poza punktem montowania treści Hugo, bezwzględnego unikania uruchamiania dwóch procesów przenoszenia w tym samym katalogu oraz traktowania każdej poprawki jako zmiany w szablonie połączonej ze skryptową aktualizacją całego zbioru treści. Największą poprawę wydajności przyniosło określenie wymiarów obrazów, synchroniczne ładowanie krytycznego CSS, wyłączenie leniwego ładowania obrazu LCP, odroczone ładowanie widżetu z ofertami przy zarezerwowanym miejscu oraz wyłączenie funkcji Cloudflare Email Obfuscation.
Kontekst
Unlimited Charters należy do tej samej grupy co WordPressEscape; była to nasza własna migracja testowa, przeprowadzona z pełnym dostępem do serwera. Witryna miała nieco ponad pół miliona adresów URL - głównie szablonowych stron lokalizacyjnych, a także hubów, stron floty i bloga. Celem była witryna zbudowana w Hugo i serwowana jako pliki statyczne za pośrednictwem Cloudflare, z zachowaniem wszystkich dotychczasowych ścieżek.
Inwentaryzacja szablonów przed migracją treści
Zaczęliśmy od pogrupowania adresów URL według szablonu WordPress, który je renderował, a nie według wzorca adresu. Dla każdej grupy podjęliśmy jedną decyzję: odtworzyć ją jako layout Hugo albo tymczasowo serwować statyczny zrzut wygenerowany przez WordPress. Odtworzenie w pierwszej kolejności grup o największym ruchu i zapisanie wyjątków w postaci zrzutów pozwoliło kontynuować projekt bez blokowania prac przez długi ogon niestandardowych stron.
Warto pamiętać o jednej pułapce: w WordPress ścieżka URL nie zawsze odpowiada slugowi post_name. Strony nadrzędne, niestandardowe reguły przepisywania adresów i stare importy generowały ścieżki niezgodne ze slugiem, dlatego ścieżkę trzeba było pobierać z crawlowania, a nie z bazy danych.
Kompilacje partycjonowane i pułapki systemu plików
Renderowanie wszystkich stron w jednym przebiegu trwało długo i sprawiało, że każda drobna zmiana była kosztowna. Podzieliliśmy proces na części: przenosiliśmy pliki źródłowe, których akurat nie budowaliśmy, do katalogu tymczasowego, budowaliśmy wybrany podzbiór, wdrażaliśmy go, a następnie przywracaliśmy pliki. Cztery pułapki kosztowały nas czas:
- Katalog tymczasowy musi znajdować się poza zamontowanym katalogiem content Hugo. Jeśli znajduje się gdziekolwiek w zamontowanym katalogu treści, Hugo nadal skanuje każdy plik i partycjonowanie nic nie daje.
rsync --exclude=index.htmlwyklucza każdy plik index.html na każdej głębokości, a nie tylko ten z katalogu głównego. Zakotwicz wzorzec (--exclude=/index.html).- Przenoszenie tego samego katalogu przez dwa równoległe procesy powoduje jego zagnieżdżenie. Dwa procesy przywracające dane jednocześnie utworzyły około 367 000 katalogów zagnieżdżonych o jeden poziom za głęboko. Produkcja działała poprawnie, ponieważ serwowała gotowy output; pojedyncze skryptowane przeniesienie spłaszczyło strukturę. Jeden proces zarządza katalogiem - wymuszamy to za pomocą blokady.
mv dir/* target/nie działa przy tej skali (lista argumentów jest zbyt długa). Użyjfind ... -exec mv -t target {} +.
# renderowanie kilku stron bez przebudowy całości
flock /tmp/uc-content.lock bash -c '
mv content/migrated/* ../stash/ # katalog tymczasowy POZA zamontowanym katalogiem 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/ {} +
'Optymalizacje wydajności wdrażane jako zmiana szablonu i aktualizacja całego korpusu
Każda poprawka miała dwa elementy: korygowaliśmy szablon Hugo, aby kolejne kompilacje były prawidłowe, oraz poprawialiśmy już wygenerowany HTML, żeby wdrożyć zmianę bez pełnej przebudowy. Największe znaczenie miały:
- Wymiary obrazów. Szablon na sztywno ustawiał
width="1600" height="700", podczas gdy CSS wykorzystywał inne proporcje. Poprawiliśmy to na 527 815 stronach. Wartości width/height muszą odpowiadać proporcjom renderowanego obrazu, w przeciwnym razie przeglądarka rezerwuje niewłaściwą przestrzeń (optymalizacja CLS). - Sprzeczne reguły aspect-ratio dla tego samego selektora w dwóch arkuszach stylów; połączyliśmy je w jedną regułę.
- Krytyczny CSS w pliku ładowanym asynchronicznie. Reguły mobilne potrzebne do pierwszego renderowania znajdowały się w odroczonym arkuszu stylów, co powodowało późniejszy ponowny układ strony. Przenieśliśmy je do arkusza ładowanego synchronicznie.
- Lazy loading hero.
loading="lazy"dla obrazu widocznego nad linią załamania opóźniało LCP; zastąpiliśmy je przezfetchpriority="high"(optymalizacja LCP). - Zbyt duże obrazy LCP zastąpiliśmy mniejszymi wariantami, oszczędzając od 50 do 440 KB na stronie.
- Widget wyceny ładuje się przy pierwszej interakcji (z mechanizmem awaryjnym po upływie limitu czasu), a jego kontener rezerwuje 480 px (560 px na urządzeniach mobilnych). Wcześniej jego zamontowanie przesuwało stronę, powodując CLS na poziomie około 0,54.
Ustawienia Cloudflare, które miały znaczenie
- Wyłączone ukrywanie adresów e-mail. Dekoder tej funkcji skanuje DOM po załadowaniu strony i przepisuje odnośniki e-mail, co powodowało przesunięcie układu. Było to najbardziej uporczywe źródło CLS, jakie znaleźliśmy.
- Wyłączony Rocket Loader. Zmieniał kolejność skryptów i zakłócał odroczone ładowanie.
- Czyszczenie cache po wdrożeniu. Cache na brzegu sieci przechowywał stary HTML; czyszczenie go według ścieżki po każdym wdrożeniu zapobiegało serwowaniu nieaktualnych stron (dokumentacja czyszczenia cache Cloudflare).
- Pomiar produkcji, nie środowiska staging. Staging bez tych samych ustawień Cloudflare generował wyniki laboratoryjne, które nie odpowiadały produkcji.
Szczegóły dotyczące danych strukturalnych i SEO
- Search Console zgłaszało błędy danych strukturalnych, ponieważ encja Service zawierała
aggregateRatingireview. Usunęliśmy je, zamiast próbować doprowadzić je do poprawnej walidacji; oznaczenia muszą odzwierciedlać treści widoczne dla użytkowników (wytyczne dotyczące danych strukturalnych). - Wpisy blogowe były początkowo renderowane za pomocą szablonu lokalizacji i dziedziczyły niewłaściwy typ danych strukturalnych. Każdy szablon deklaruje teraz własną encję.
- 35 niespójnych ścieżek floty i usług otrzymało stałe przekierowania do prawidłowych stron zagnieżdżonych (przekierowania).
- Pliki multimedialne przenieśliśmy z
/wp-content/uploads/do/uploads/za pomocą jednej reguły 301; równoległy przebiegsedprzepisał 528 852 z 528 854 plików w kilka minut. - Usunęliśmy Yoast, gdy Hugo zaczęło generować mapę witryny, dane strukturalne, tagi meta i robots.txt.
find static-v5 -name '*.html' -print0 \
| xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'Pozyskiwanie leadów to element, którego nie można utracić
Formularz wyceny generuje przychody witryny, dlatego objęliśmy go osobnymi kontrolami: element widgetu musi znajdować się w wygenerowanym kodzie HTML każdej strony, na której był obecny, nazwy pól muszą odpowiadać wymaganiom endpointu obsługującego zgłoszenia, a wdrożenie zastępujące katalog nie może usuwać samodzielnej strony z formularzem wyceny. Migracja, która po cichu wyłącza pozyskiwanie leadów, może wyglądać na udaną we wszystkich metrykach SEO, podczas gdy firma traci zapytania.
Co zrobilibyśmy inaczej
- Wyłączyć Email Obfuscation przed pierwszym pomiarem CLS.
- Od pierwszego dnia rozdzielić proces budowania.
- Od pierwszego dnia zablokować katalog z treścią.
- Opisać schemat „szablon plus przetwarzanie całego korpusu” przed pierwszą poprawką, a nie dopiero po piątej.
- Dodać kontrolę danych rzeczywistych (CrUX) do checklisty uruchomieniowej, ponieważ wyniki testów laboratoryjnych na środowisku stagingowym nie odzwierciedlają produkcji.
Biznesowe podsumowanie tego samego projektu, w tym informacje o tym, co pozostawiliśmy w WordPress, znajduje się w studium przypadku.
Źródła i dalsza lektura
Podstawowa dokumentacja, na której opieraliśmy się przy tworzeniu tego poradnika. Linki sprawdzono 11 listopada 2026 r.
- Dokumentacja Hugo: szybki start
- Dokumentacja Hugo: zarządzanie adresami URL (permalinki i aliasy)
- web.dev: optymalizacja skumulowanego przesunięcia układu
- web.dev: optymalizacja największego wyrenderowanego elementu treści
- web.dev: skumulowane przesunięcie układu (CLS)
- Cloudflare Docs: czyszczenie pamięci podręcznej
- Cloudflare Docs: pamięć podręczna
- Google Search Central: wprowadzenie do danych strukturalnych
- Google Search Central: przekierowania a wyszukiwarka Google
- Google Search Central: przenoszenie witryny ze zmianą adresów URL
- Dokumentacja Chrome UX Report (CrUX)
Najczęściej zadawane pytania
Czy to migracja strony klienta?
Nie. Unlimited Charters to wewnętrzna siostrzana strona należąca do tej samej grupy co WordPressEscape. To nasz własny przypadek testowy.
Czy Hugo obsługuje pół miliona stron?
Tak, ale pełne przebudowy trwają na tyle długo, że znaczenie mają kompilacje partycjonowane i staranne zarządzanie plikami. Większość problemów wynikała z systemu plików i procesów, a nie z błędów Hugo.
Co spowodowało największe przesunięcie układu?
Największe problemy powodowały widżet z wyceną, który był ładowany bez zarezerwowania miejsca (około 0,54 CLS na stronach hubów), oraz funkcja Cloudflare Email Obfuscation, która modyfikowała stronę po jej załadowaniu.
Czy te wnioski dotyczą również małych stron?
Tak. Te same kontrole (zgodność adresów URL, wymiary obrazów, krytyczny CSS, obraz hero ładowany bez opóźnienia i odroczone widżety) mają zastosowanie do strony liczącej 40 podstron - po prostu wykonują się w kilka minut zamiast w kilka godzin.
Sprawdź, czy Twoja witryna kwalifikuje się do takiej samej optymalizacji
Bezpłatny 60-sekundowy audyt pokaże Twój rzeczywisty wynik PageSpeed, dokładną liczbę stron, braki w SEO oraz funkcje WordPress, które trzeba zastąpić. Następnie WordPressEscape odtworzy Twoją witrynę w Hugo, zachowa wszystkie adresy URL i przekaże Ci kod źródłowy już pierwszego dnia - dokładnie tak, jak odbudowaliśmy UC.
Przeskanuj moją stronę bezpłatnie

