Bu sayfada
- Bağlam
- İçerikten önce şablon envanteri
- Bölümlere ayrılmış derlemeler ve dosya sistemi tuzakları
- Şablon değişikliği ve içerik kümesi taraması olarak uygulanan performans düzeltmeleri
- Fark yaratan Cloudflare ayarları
- Şema ve SEO ayrıntıları
- Kaybedemeyeceğiniz bölüm: potansiyel müşteri toplama
- Farklı yapacağımız şeyler
- Kaynaklar ve ek okuma
- Sıkça sorulan sorular
Bu ölçekteki sorunlar, Hugo'dan çok dosya sistemi ve süreçlerle ilgilidir: derlemeyi bölümlere ayırmak, saklanan içerikleri Hugo'nun content bağlama noktasının dışında tutmak, aynı dizinde iki taşıma işlemini asla aynı anda çalıştırmamak ve her düzeltmeyi bir şablon değişikliğiyle birlikte tüm içerik kümesine uygulanan betik çalıştırması olarak ele almak gerekir. En büyük performans kazanımlarını görsel boyutları, eşzamanlı kritik CSS, lazy yüklenmeyen bir LCP görseli, alanı önceden ayrılmış ertelenmiş bir teklif widget'ı ve Cloudflare Email Obfuscation'ı kapatmak sağladı.
Bağlam
Unlimited Charters, WordPressEscape ile aynı gruba aittir; bu, tam sunucu erişimiyle gerçekleştirdiğimiz kendi test migrasyonumuzdu. Sitede çoğunluğu şablonla oluşturulmuş konum sayfaları olmak üzere yarım milyondan biraz fazla URL'nin yanı sıra merkez sayfaları, filo sayfaları ve bir blog bulunuyordu. Hedef, mevcut tüm yolları koruyarak Cloudflare arkasında statik dosyalar olarak sunulan bir Hugo derlemesiydi.
İçerikten önce şablon envanteri
URL'leri URL desenlerine göre değil, oluşturan WordPress şablonuna göre gruplandırarak başladık. Her grup için tek bir karar verdik: Hugo düzeni olarak yeniden oluşturulacak mı, yoksa şimdilik WordPress çıktısının statik bir anlık görüntüsü mü sunulacak? Yüksek trafikli grupları önce yeniden oluşturmak ve sıra dışı sayfaları anlık görüntü olarak saklamak, uzun kuyruğa kalan özel sayfalar projeyi durdurmadan ilerlememizi sağladı.
Bilinmesinde fayda olan bir ayrıntı: WordPress'te URL yolu her zaman post_name slug'ı değildir. Üst sayfalar, özel yeniden yazma kuralları ve eski içe aktarımlar slug'la eşleşmeyen yollar oluşturdu; bu nedenle yolun veritabanından değil, taramadan alınması gerekti.
Bölümlere ayrılmış derlemeler ve dosya sistemi tuzakları
Tüm sayfaları tek seferde oluşturmak yavaştı ve en küçük değişikliği bile maliyetli hâle getiriyordu. Süreci bölümlere ayırdık: oluşturmadığımız kaynak dosyalarını bir saklama dizinine taşıyor, bir alt küme oluşturuyor, dağıtıyor ve ardından geri yüklüyorduk. Dört tuzak bize zaman kaybettirdi:
- Saklama dizini Hugo'nun content bağlama noktasının dışında olmalı. Bağlı content dizininin altında herhangi bir yerde durursa Hugo yine tüm dosyaları tarar ve bölümleme hiçbir tasarruf sağlamaz.
rsync --exclude=index.htmlher derinlikteki index.html dosyasını hariç tutar; yalnızca en üstteki dosyayı değil. Deseni kök dizine sabitleyin (--exclude=/index.html).- Aynı dizinde çalışan iki eşzamanlı taşıma işlemi dizini iç içe yerleştirir. Birbirleriyle yarışan iki geri yükleme süreci, yaklaşık 367.000 dizinin bir seviye fazla içeriye taşınmasına neden oldu. Üretim ortamı oluşturulmuş çıktıyı sunduğu için sorun yaşanmadı; tek bir betik çalıştırılarak taşınan dizinler düzleştirildi. Dizinin sahibi tek bir süreç olacak şekilde kilit kullanıldı.
mv dir/* target/bu ölçekte başarısız olur (argüman listesi çok uzun). Bunun yerinefind ... -exec mv -t target {} +kullanın.
# her şeyi yeniden oluşturmadan birkaç sayfa oluştur
flock /tmp/uc-content.lock bash -c '
mv content/migrated/* ../stash/ # saklama dizini content bağlama noktasının DIŞINDA
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/ {} +
'Şablon değişikliği ve içerik kümesi taraması olarak uygulanan performans düzeltmeleri
Her düzeltmenin iki ayağı vardı: Gelecekteki derlemelerin doğru olması için Hugo şablonunu düzeltmek ve değişikliği yayınlamak için tam bir yeniden derlemeye ihtiyaç duymamak adına önceden oluşturulmuş HTML'yi yamalamak. En çok fark yaratanlar şunlardı:
- Görsel boyutları. Bir şablon, CSS farklı bir en-boy oranı kullanırken
width="1600" height="700"değerlerini sabitliyordu. 527.815 sayfada düzeltildi. Genişlik ve yükseklik, oluşturulan en-boy oranıyla eşleşmelidir; aksi hâlde tarayıcı yanlış alan ayırır (CLS'yi optimize etme). - Çakışan en-boy oranı kuralları aynı seçici için iki stil sayfasında bulunuyordu; tek bir kuralda birleştirildi.
- Kritik CSS eşzamansız dosyadaydı. İlk görüntüleme için gereken mobil kurallar ertelenmiş bir stil sayfasında yer alıyor ve geç bir yeniden düzenlemeye neden oluyordu. Eşzamanlı stil sayfasına taşındı.
- Lazy yüklenen hero görseli. Ekranın üst kısmındaki görselde bulunan
loading="lazy"LCP'yi geciktiriyordu; yerinefetchpriority="high"kullanıldı (LCP'yi optimize etme). - Gereğinden büyük LCP görselleri daha küçük seçeneklerle değiştirildi ve sayfa başına 50-440 KB tasarruf sağlandı.
- Teklif widget'ı ilk etkileşimde yükleniyor (zaman aşımı için yedek mekanizmayla) ve kapsayıcısı 480 piksel (mobilde 560 piksel) alan ayırıyor. Önceden widget'ın eklenmesi sayfayı yaklaşık 0,54 CLS değeriyle kaydırıyordu.
Fark yaratan Cloudflare ayarları
- Email Obfuscation kapatıldı. Kod çözücüsü yükleme sonrasında DOM'u tarayıp e-posta bağlantılarını yeniden yazıyor ve bu işlem düzen kayması olarak görünüyordu. Karşılaştığımız en kalıcı CLS kaynağı buydu.
- Rocket Loader kapatıldı. Betiklerin sırasını değiştiriyor ve ertelenmiş yüklemeyle çakışıyordu.
- Dağıtımdan sonra önbellek temizlendi. Uç önbellekler eski HTML'yi tutuyordu; her dağıtımdan sonra yolu baz alarak önbelleği temizlemek, eski sayfaların sunulmasını önledi (Cloudflare önbellek temizleme belgeleri).
- Üretim ortamını ölçün, hazırlık ortamını değil. Aynı Cloudflare ayarlarına sahip olmayan hazırlık ortamı, üretimle eşleşmeyen laboratuvar puanları üretiyordu.
Şema ve SEO ayrıntıları
- Search Console, bir Service varlığında
aggregateRatingvereviewbulunduğu için yapılandırılmış veri hataları bildirdi. Geçerli hâle getirmeye çalışmak yerine bunları kaldırdık; işaretleme, kullanıcıların görebildiği içeriği yansıtmalıdır (yapılandırılmış veri yönergeleri). - Blog yazıları başlangıçta konum şablonuyla oluşturuluyor ve yanlış şema türünü devralıyordu. Artık her şablon kendi varlık türünü tanımlıyor.
- Birbiriyle tutarsız 35 filo ve hizmet yolu, doğru iç içe sayfalara kalıcı yönlendirmelerle yönlendirildi (yönlendirmeler).
- Medya
/wp-content/uploads/yolundan/uploads/yoluna tek bir 301 kuralıyla taşındı; eş zamanlı birsedişlemi birkaç dakika içinde 528.854 dosyanın 528.852'sindeki yolu yeniden yazdı. - Hugo site haritasını, şemayı, meta etiketlerini ve robots.txt dosyasını oluşturduktan sonra Yoast kaldırıldı.
find static-v5 -name '*.html' -print0 \
| xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'Kaybedemeyeceğiniz bölüm: potansiyel müşteri toplama
Teklif formu sitenin gelir elde etme biçimi olduğundan kendi kontrollerine sahipti: widget'ın ekleneceği alan, bu alanın bulunduğu her sayfanın oluşturulmuş HTML'sinde yer almalı; alan adları, başvuru uç noktasının beklediği değerlerle eşleşmeli; bir dizini değiştiren dağıtım, bağımsız teklif sayfasını silmemelidir. Potansiyel müşteri toplama özelliğinin sessizce kaybolduğu bir geçiş, tüm SEO metriklerinde başarılı görünürken işletmenin taleplerini kaybetmesine neden olabilir.
Farklı yapacağımız şeyler
- İlk CLS ölçümünden önce Email Obfuscation'ı kapatırdık.
- Derlemeyi ilk günden bölümlere ayırırdık.
- İçerik dizinini ilk günden kilitlerdik.
- Şablon artı içerik kümesi taraması yaklaşımını beşinci düzeltmeden sonra değil, ilk düzeltmeden önce yazılı hâle getirirdik.
- Alan verisi (CrUX) kontrolünü yayına alma kontrol listesine eklerdik; çünkü hazırlık ortamındaki laboratuvar puanları üretimi yansıtmaz.
Aynı projenin, WordPress'te bıraktıklarımızı da içeren işletme perspektifi vaka çalışmasında yer alıyor.
Kaynaklar ve ek okuma
Bu rehber için yararlandığımız temel belgeler. Bağlantılar 11 Kasım 2026'da kontrol edildi.
- Hugo belgeleri: Hızlı başlangıç
- Hugo belgeleri: URL yönetimi (kalıcı bağlantılar ve takma adlar)
- web.dev: Kümülatif Düzen Kaymasını Optimize Etme
- web.dev: En Büyük İçerikli Boyamayı Optimize Etme
- web.dev: Kümülatif Düzen Kayması (CLS)
- Cloudflare Belgeleri: Önbelleği temizleme
- Cloudflare Belgeleri: Önbellek
- Google Search Central: Yapılandırılmış verilere giriş
- Google Search Central: Yönlendirmeler ve Google Arama
- Google Search Central: URL değişiklikleriyle site taşıma
- Chrome UX Report (CrUX) belgeleri
Sıkça sorulan sorular
Bu, bir müşteri migrasyonu mu?
Hayır. Unlimited Charters, WordPressEscape ile aynı gruba ait kurum içi bir kardeş sitedir. Bu, kendi test senaryomuzdur.
Hugo yarım milyon sayfayı kaldırabilir mi?
Evet; ancak tam derlemeler, bölümlere ayrılmış derlemelerin ve dikkatli dosya yönetiminin önemli olacağı kadar yavaştır. Sorunlarımızın çoğu Hugo hatalarından ziyade dosya sistemi ve süreçlerle ilgiliydi.
En büyük düzen kaymasına ne sebep oldu?
Teklif widget'ının önceden alan ayrılmadan eklenmesi (merkez sayfalarda yaklaşık 0,54 CLS) ve Cloudflare Email Obfuscation'ın yükleme sonrasında sayfayı yeniden yazması.
Bu dersler küçük siteler için de geçerli mi?
Evet. Aynı kontroller (URL eşleşmesi, görsel boyutları, kritik CSS, lazy yüklenmeyen hero görseli ve ertelenmiş widget'lar) 40 sayfalık bir site için de geçerlidir; yalnızca saatler yerine dakikalar içinde tamamlanırlar.
Sitenizin aynı uygulamaya uygun olup olmadığını öğrenin
Ücretsiz 60 saniyelik denetim, gerçek PageSpeed puanınızı, kesin sayfa sayınızı, SEO eksiklerinizi ve değiştirmeniz gereken WordPress özelliklerini gösterir. Ardından WordPressEscape, sitenizi Hugo üzerinde yeniden kurar, tüm URL'leri korur ve kaynak kodunu ilk günden size teslim eder - UC'nin yeniden kurulma sürecinde olduğu gibi.
Sitemi ücretsiz tara

