Statik Site Oluşturucular
Hugo, Jekyll, Eleventy, Hexo, Gatsby ve Astro’nun her sayfayı önceden statik HTML’e dönüştürerek Google’ın JS oluşturma kuyruğunu nasıl devre dışı bıraktığı ve içeriği ilk istekte dizine eklenebilir kıldığı.
Bu sayfada 1 kanıt sinyali
- İlgili canlı araç Raw vs. Rendered HTML Checker
Statik site oluşturucu (SSG), her sayfayı derleme zamanında tamamlanmış HTML’e dönüştürür. Böylece tarayıcı istemeden önce içerik ham HTML’de hazırdır; JavaScript oluşturma kuyruğu veya Wave 2 gecikmesi yoktur ve içerik hemen dizine eklenebilir. İstemci taraflı çatılara göre temel SEO avantajı budur. Hugo, Jekyll, Eleventy, Hexo, Gatsby ve Astro bu özelliği paylaşır; dil, tarayıcıya gönderdikleri JS miktarı ve yerleşik görsel/site haritası araçları değişir. Asıl sorun derleme güncelliğidir: statik site yalnızca son derlemesi kadar günceldir; içerik değişikliklerinin arama motorlarına ulaşması için yeniden oluşturulup dağıtılması gerekir. Bu siteyi ve patrickstox.com’u tam da bu nedenlerle Astro ile kurdum.
Kısa özet — Statik site oluşturucu, sitenizin tamamını önceden düz HTML dosyalarına dönüştürür. Böylece Google geldiğinde içerik sayfada hazırdır; JavaScript’in çalışmasını beklemek gerekmez. SEO açısından mümkün olan en kolay kurulum budur. Dezavantajı ise sitenin yalnızca yeniden oluşturulduğunda güncellenmesidir.
Statik site oluşturucu nedir?
JavaScript kaynaklı SEO sorunlarının çoğu tek bir soruya dayanır: Tarayıcı sayfayı aldığında içerik gerçekten sayfada mı, yoksa ancak betikler çalıştıktan sonra mı görünür? Statik site oluşturucu (SSG) bu sorunu bütünüyle devre dışı bırakır.
SSG; genellikle Markdown ile yazılan içeriğinizi ve şablonlarınızı alır, bilgisayarınızda veya bir derleme sunucusunda her sayfayı ziyaret edilmeden önce tamamlanmış bir HTML dosyasına dönüştürür. Ardından bu düz HTML dosyalarını bir barındırma hizmetine yüklersiniz. Google, Bing veya bir okuyucu sayfayı istediğinde ilk istekte eksiksiz HTML alır. Bu iddiaya ilişkin kanıt A static site generator builds source content and templates into static files before requests are served. Kapsam: Hugo as a representative static site generator. Güven düzeyi: yüksek · Doğrulandı: Hugo documentation
Bunu, sunucunun neredeyse boş bir kabuk gönderdiği ve tarayıcının sayfayı sonradan oluşturduğu tipik JavaScript uygulamasıyla karşılaştırın. SSG’de tarayıcının oluşturacağı bir şey yoktur; iş zaten bitmiştir.
SEO için neden harikadır?
- İçerik ham HTML’dedir. Google’ın metninizi ve bağlantılarınızı görebilmesi için ayrıca bir oluşturma adımının başarıyla tamamlanması gerekmez.
- Hızlıdır. Düz HTML dosyaları hızlı yüklenir; bu da Core Web Vitals’a yardımcı olur.
- Bozulabilecek daha az parça vardır. Daha az hareketli parça, içeriğin arama sonuçlarından kaybolabileceği daha az yol demektir.
En yaygın seçenekler
En sık duyacağınız altı seçenek şunlardır: Hugo, Jekyll, Eleventy, Hexo, Gatsby ve Astro. Hepsi statik HTML üretir; geliştirildikleri dil ve tarayıcıya gönderdikleri ek JavaScript miktarı (varsa) bakımından ayrılır. Her birinin ayrıntılı rehberi bu sayfanın altında bağlantılıdır.
Dikkat edilmesi gereken tek nokta
Statik site bir anlık görüntüdür. Son oluşturulduğu anda geçerli olanı gösterir. Bir fiyatı değiştirir, yazım hatasını düzeltir veya yazı yayımlar ve yeniden oluşturup dağıtmayı unutursanız, arama motorları eski sürümü görmeye devam eder. Bu yüzden SSG kullanımındaki temel disiplin, değişikliklerin yeni bir derlemeyi tetiklemesini sağlamaktır. Bu iddiaya ilişkin kanıt Changes to a statically generated site require a new build and deployment before the generated output changes. Kapsam: Astro static builds as a representative SSG workflow. Güven düzeyi: yüksek · Doğrulandı: Astro: Deploy your site
Teknik sürümü; SSG’lerin istemci taraflı çatılardan ve meta çatılardan farkını, altı seçeneğin yan yana karşılaştırmasını ve derleme güncelliği tuzağının ayrıntılarını mı istiyorsunuz? Gelişmiş sekmesine geçin.
Kısa özet — SSG her rotayı derleme zamanında statik HTML’e önceden dönüştürür; dolayısıyla içerik ilk tarayıcı isteğinden önce yanıtta bulunur. Web Rendering Service, oluşturma kuyruğu veya “Wave 2” gecikmesi yoktur. Bu, bir siteye sağlayabileceğiniz en büyük dizine eklenebilirlik avantajıdır. SSG’ler, sayfayı tarayıcıda oluşturan CSR çatılarından ve her istekte sunucu tarafında oluşturabilen meta çatılardan ayrılır. Bu kümedeki Hugo, Jekyll, Eleventy, Hexo, Gatsby ve Astro statik HTML sunar; dil, JS yükü ve yerleşik site haritası/görsel araçları değişir. Asıl hata modu oluşturma değil, derleme güncelliğidir: statik site yalnızca son derlemesi kadar günceldir. Değişen içerik yeni derlemeyi tetiklemezse arama motorlarına sessizce eski HTML sunulur. Bu siteyi tam da bu ödünleşimler nedeniyle Astro ile çalıştırıyorum.
“Statik” gerçekte ne demektir?
Statik site oluşturucu, içerik ve şablonlarınızı bir derleme adımından geçirerek tamamlanmış HTML, CSS ve varlıklardan oluşan bir klasör çıkarır. SEO açısından kritik nokta HTML’in ne zaman üretildiğidir: her istek için veya tarayıcıda değil, derleme zamanında, bir kez ve herkes için. Google’ın JavaScript rehberi tarama, oluşturma ve dizine eklemeyi ayrı işleme aşamaları olarak tanımlar. SSG, HTML zaten tamamlanmış olduğundan ürettiği içerik için istemci taraflı oluşturmayı kritik yoldan çıkarır. Bu iddiaya ilişkin kanıt Google processes JavaScript through crawling, rendering, and indexing, while pre-rendered HTML is present before client execution. Kapsam: Google Search JavaScript processing; indexing is not guaranteed. Güven düzeyi: yüksek · Doğrulandı: Google: JavaScript SEO basics
Statik sitelerin dizine eklenmek için mümkün olan en güvenli mimari olmasının nedeni budur. İçerik yanıtın ilk baytında bulunur. Ham ve oluşturulmuş HTML arasında eşlik boşluğu yoktur; oluşturucunun başarılı olmasına bağımlılık veya durum tutmayan Chrome’a özgü tuhaflıklar için tasarım yapma gereği kalmaz.
SSG, istemci taraflı oluşturma ve meta çatılar
Üç mimari, HTML’in ortaya çıktığı üç farklı an:
- Statik site üretimi (SSG). HTML herhangi bir istek gelmeden önce derleme zamanında bir kez oluşturulur. Düz dosyalar olarak, çoğu zaman CDN’den sunulur. İçerik ham HTML’dedir. Hugo, Jekyll, Eleventy ve Hexo ile varsayılan statik modlarında Gatsby ve Astro böyledir.
- İstemci taraflı oluşturma (CSR). Sunucu asgari bir kabuk gönderir; JavaScript sayfayı tarayıcıda istek/çalışma zamanında oluşturur. İçerik, oluşturmanın başarılı olmasına bağlıdır. Varsayılan CSR kullanan React veya Vue SPA buna örnektir ve SEO için en riskli kurulumdur (bkz. JavaScript SEO).
- Meta çatılar (SSR / hibrit). Next.js, Nuxt ve SvelteKit gibi çatılar HTML’i sunucuda her istek için oluşturabilir (SSR), bazı rotaları önceden oluşturabilir (SSG) veya ikisini karıştırabilir. İçerik HTML’dedir; ancak istek sırasında üretildiğinden saf SSG’de olmayan sunucu maliyeti ve gecikme eklenir.
Sınırlar yer yer bulanıklaşır: Gatsby ve Astro bileşen tabanlı oldukları ve düz dosyadan fazlasını yapabildikleri için bazen meta çatı sayılır. Ancak temel kullanım biçimlerinde statik oluşturucudurlar ve SEO açısından böyle değerlendirilmelidir. Önemli zihinsel model şudur: HTML ne kadar erken hazır olursa tarayıcı görmeden önce o kadar az şey ters gidebilir. En erken seçenek SSG’dir.
Altı oluşturucunun karşılaştırması
Altısının da çıktısı dizine eklenebilir statik HTML’dir. SEO kararını gerçekten etkileyen eksenlerde farkları şöyledir:
| Oluşturucu | Dil / geliştirildiği ortam | Tarayıcıya giden JS | Site haritası | Görsel optimizasyonu | En uygun kullanım |
|---|---|---|---|---|---|
| Hugo | Go | Varsayılan olarak yok | Yerleşik (sitemap.xml otomatik üretilir) | Yerleşik görsel işleme (boyutlandırma, WebP) | Hızlı derleme isteyen büyük içerik siteleri |
| Jekyll | Ruby | Varsayılan olarak yok | Eklenti (jekyll-sitemap) | Eklentiler (jekyll-picture-tag vb.) | GitHub Pages blogları; özgün SSG |
| Eleventy (11ty) | JavaScript (Node) | Varsayılan olarak yok | Şablon/eklenti (siz üretirsiniz) | Eklenti (@11ty/eleventy-img) | Sıfır JS çıktısı ve esneklik isteyen JS geliştiricileri |
| Hexo | JavaScript (Node) | Varsayılan olarak yok (temaya bağlı) | Eklenti (hexo-generator-sitemap) | Eklentiler | Özellikle Node/Asya ekosistemindeki bloglar |
| Gatsby | JavaScript / React | React paketi (hydrate eder) | Eklenti (gatsby-plugin-sitemap) | Yerleşik (gatsby-plugin-image, güçlü) | Veri odaklı statik site isteyen React ekipleri |
| Astro | JS/TS, herhangi bir UI çatısı | Varsayılan olarak yok (yalnızca adalar) | Resmî (@astrojs/sitemap) | Yerleşik (astro:assets) | JS vergisi olmadan bileşen isteyen içerik siteleri |
Tablodan özellikle çıkarılması gereken birkaç nokta:
- JS yükü, SEO’ya komşu temel ayrıştırıcıdır. Hugo, Jekyll, Eleventy ve Hexo siz eklemedikçe neredeyse hiç JavaScript göndermez. Gatsby, istemcide tam bir React paketini yeniden işler; HTML statik olduğu için yine dizine eklenebilir ama diğerlerinde olmayan bir Core Web Vitals maliyeti taşır. Astro, adalar mimarisiyle ortada durur: varsayılan çıktı statik HTML’dir ve JavaScript yalnızca ihtiyaç duyan etkileşimli bileşenlere (“adalara”) gider.
- Derleme hızı ölçeğe göre farklılaşır. Hugo (Go) çok hızlı olmasıyla tanınır ve on binlerce sayfayı rahatlıkla işler. Node tabanlı oluşturucular büyük ölçekte daha yavaştır; Gatsby’nin derleme süreleri tarihsel olarak en büyük şikâyet konusudur.
- Site haritaları ve görsel optimizasyonu hemen her yerde büyük ölçüde çözülmüştür; Hugo ve Astro kutudan çıktığı hâliyle daha fazlasını sunarken Jekyll/Eleventy/Hexo bakımlı eklentilere dayanır.
- Gatsby’nin yayın temposu belirgin biçimde yavaşladı. Proje arşivlenmedi ve hâlâ yamalar yayımlıyor; ancak Temmuz 2026 itibarıyla GitHub deposunda son 90 günde yalnızca birkaç commit ve şubat ayından beri tek bir küçük sürüm görülüyor. Bugün bir oluşturucu seçiyorsanız hydration/CWV maliyetinin yanında daha etkin geliştirilen bir seçeneğe karşı bunu da tartın.
Bu siteyi neden Astro ile kurdum?
Bu siteyi ve patrickstox.com’u Astro ile kurdum; gerekçem bu sayfanın özetiyle aynıdır. Gerçek bileşenlerle Markdown/MDX kullanmak istedim ama bunu elde etmek için her sayfada JavaScript vergisi ödemek istemedim. Astro varsayılan olarak istemci tarafında sıfır JS gönderir: okuduğunuz sayfalar statik HTML olarak sunulur, yalnızca lens sekmeleri ve test gibi az sayıdaki etkileşimli parça JavaScript yükler. Böylece bileşen tabanlı yazım deneyiminden vazgeçmeden klasik SSG’nin dizine eklenebilirliğini ve iyi Core Web Vitals değerlerini elde ederim. Etkileşimsiz dev bir içerik kümesinde aşırı hızlı derleme gerekse Hugo; React veri katmanı gerekse Gatsby açık seçim olurdu. Az sayıda etkileşimli ayrıntı içeren bu yoğun içerik sitesi için doğru ödünleşim Astro’dur.
Tek gerçek sorun: derleme güncelliği
Yukarıdakilerin hepsi avantajdı. İnsanları yakalayan sorun şudur:
Statik site yalnızca son derlemesi kadar günceldir. HTML, derleme zamanında dondurulmuş bir anlık görüntüdür. Bir fiyatı değiştirin, bilgiyi düzeltin, yazı yayımlayın veya başlık etiketini güncelleyin: yeniden oluşturup dağıtana kadar bunların hiçbiri arama motorlarına ulaşmaz. Her istekte sayfayı veritabanından kuran canlı sunucu olmadığı için değişikliği otomatik alacak bir mekanizma da yoktur. Bu iddiaya ilişkin kanıt Static build output remains a snapshot until the project is rebuilt and redeployed. Kapsam: Astro static build workflow as a representative example. Güven düzeyi: yüksek · Doğrulandı: Astro: Build and deploy
Uygulamada bunun anlamı şudur:
- İçerik düzenlemeleri derlemeyi tetiklemelidir. Headless CMS veya Git kullanıyorsanız yayımlama işleminin dağıtımı başlatması için webhook kurun. Yalnızca elle çalışan derleme süreci, eski fiyatların ve “hayalet” 404s sayfalarının dizine sızma yoludur.
- Sık değişen veriler zordur. Stok, fiyat ve canlı sayaçlar siz yeniden derleyebildiğinizden hızlı değişiyorsa statik kopya geride kalır. Artımlı derlemeler, planlı yeniden derlemeler veya değişken rotalarda SSR/ISR kullanan hibrit meta çatı burada işe yarar.
- Zamana duyarlı sayfalar bir ritim gerektirir. “Bugünün fırsatları” derleme zamanında sabitleniyorsa derleme en az günlük çalışmalıdır; aksi hâlde sayfa yanlış bilgi verir.
Bunların hiçbiri vazgeçme nedeni değildir; mesele disiplindir. SSG’lerin SEO için harika olmasının nedeni (HTML’in önceden kararlaştırılması), içerik değiştiğinde onu yeniden kararlaştırma konusunda bilinçli davranmanızın da nedenidir.
Sonraki durak: statik site oluşturucular kümesi
Bu merkez haritadır. Aşağıdaki her oluşturucunun dilini, JS yükünü, site haritası/görsel araçlarını, çatıya özgü SEO sorunlarını ve derlemeleri güncel tutma yöntemlerini anlatan ayrı bir ayrıntılı rehberi vardır:
- Hugo SEO — Go tabanlı, sıfır JS ve çok hızlı derleme; otomatik site haritası, yerleşik görsel işleme ve dev içerik kümelerinin yönetimi.
- Jekyll SEO — özgün SSG ve GitHub Pages varsayılanı;
jekyll-seo-tag,jekyll-sitemapve GitHub Pages’teki eklenti sınırlaması. - Eleventy (11ty) SEO — JavaScript tabanlı, sıfır JS çıktısı; şablonlardan site haritası üretme ve duyarlı görseller için
eleventy-img. - Hexo SEO — Node blog oluşturucusu; site haritası/akış eklentileri, tema JS’i ve kalıcı bağlantı/kanonik düzeni.
- Gatsby SEO — React tabanlı statik üretim; hydration/CWV ödünleşimi,
gatsby-plugin-image,gatsby-plugin-sitemapve derleme zamanında veri alma. - Astro SEO — varsayılan sıfır JS, adalar mimarisi,
@astrojs/sitemap,astro:assets, View Transitions ve Server Islands geri dönüş davranışı.
Yukarıdaki her konu bu merkezin altında yer alır ve kenar çubuğunda da bulunur.
Daha geniş bağlam; Google’ın JavaScript’i nasıl oluşturduğu, eşlik ve etkileşim hata biçimleri ile JS gerektiğinde seçilecek oluşturma modu için üst JavaScript SEO merkezine bakın.
Yapay zekâ özeti
Gelişmiş sürümün kısa özeti:
- SSG her sayfayı derleme zamanında statik HTML’e önceden dönüştürür; içerik ilk tarayıcı isteğinden önce yanıtta bulunur. Arama motorunun ikinci bir JavaScript oluşturma aşamasını beklemesi gerekmez. Bu, dizine eklenebilirlik için en güvenli mimaridir.
- HTML’in oluşma zamanına göre üç mimari: SSG (derleme zamanı, en güvenli), CSR (çalışma zamanında tarayıcı, en riskli), meta çatı/SSR (sunucuda her istek için; içerik vardır ama gecikme/maliyet getirir).
- Altı oluşturucunun tamamı dizine eklenebilir statik HTML sunar. Dil, JS yükü ve yerleşik site haritası/görsel araçları değişir:
- Hugo (Go) — sıfır JS, en hızlı derlemeler, yerleşik site haritası ve görsel işleme.
- Jekyll (Ruby) — sıfır JS, GitHub Pages varsayılanı, eklenti tabanlı.
- Eleventy (Node) — sıfır JS, esnek, eklenti tabanlı.
- Hexo (Node) — varsayılan sıfır JS, blog odaklı, eklenti tabanlı.
- Gatsby (React) — React paketini hydrate eder (CWV maliyeti), güçlü görsel araçları vardır; ancak yayın temposu 2026 ortası itibarıyla belirgin biçimde yavaşlamıştır.
- Astro (herhangi bir çatı) — adalar sayesinde varsayılan sıfır JS, resmî site haritası ve
astro:assets.
- SEO’ya komşu ayrıştırıcı JS yüküdür: Gatsby React paketi taşır; Astro adaları yalnızca gereken yere JS gönderir; diğerleri varsayılan sıfır JS’dir.
- Patrick bu siteyi ve patrickstox.com’u Astro ile kurdu: JS vergisi olmadan bileşenler, statik HTML ve iyi Core Web Vitals.
- Tek gerçek sorun derleme güncelliğidir: statik site yalnızca son derlemesi kadar günceldir. İçerik düzenlemelerini yeniden derleme webhook’una bağlayın; hızlı değişen verilerde artımlı/planlı derleme veya hibrit SSR/ISR rotası kullanın.
Resmî belgeler
Arama motorlarından ve her oluşturucudan birincil kaynak belgeler.
Arama motorları — oluşturma ve statik HTML
- JavaScript SEO temellerini anlama — statik derlemenin içerik için atlamanızı sağladığı tarama → oluşturma → dizine ekleme aşamaları.
- Google Arama’nın Çalışma Şekline İlişkin Ayrıntılı Rehber — oluşturmanın konumu ve önceden oluşturulmuş HTML’in neden en düşük riskli seçenek olduğu.
Oluşturucular
- Hugo belgeleri — ayrıca site haritası şablonu ve görsel işleme belgeleri.
- Jekyll belgeleri — ayrıca jekyll-seo-tag ve jekyll-sitemap.
- Eleventy (11ty) belgeleri — ayrıca eleventy-img.
- Hexo belgeleri — ayrıca hexo-generator-sitemap eklentisi.
- Gatsby belgeleri — ayrıca gatsby-plugin-image ve gatsby-plugin-sitemap.
- Astro belgeleri — ayrıca @astrojs/sitemap ve astro:assets / görseller.
Kaynaktan alıntılar
Google’ın ve oluşturucuların kendi ekiplerinin kayda geçmiş açıklamaları ile kendi yazımdan bir not.
Google — oluşturma ayrı bir adımdır
- “During the crawl, Google renders the page and runs any JavaScript it finds using a recent version of Chrome.” (çeviri: “Tarama sırasında Google, Chrome’un güncel bir sürümünü kullanarak sayfayı oluşturur ve bulduğu JavaScript’i çalıştırır.”) — SSG’nin tamamlanmış HTML sunarak kritik yoldan çıkardığı adım. Alıntıya git
- “Rendering is important because websites often rely on JavaScript to bring content to the page, and without rendering Google might not see that content.” (çeviri: “Web siteleri içeriği sayfaya getirmek için çoğu zaman JavaScript’e dayandığından oluşturma önemlidir; Google oluşturma olmadan bu içeriği göremeyebilir.”) — başka deyişle içerik statik HTML’deyse oluşturma görünürlüğe mal olamaz. Alıntıya git
Astro — varsayılan olarak statik
- “By default, Astro pages, routes, and API endpoints will be pre-rendered at build time as static pages. However, you can choose to render some or all of your routes on demand by a server when a route is requested.” (çeviri: “Astro sayfaları, rotaları ve API uç noktaları varsayılan olarak derleme zamanında statik sayfalar biçiminde önceden oluşturulur. Bununla birlikte bir rota istendiğinde rotalarınızın bir kısmını veya tamamını sunucuda isteğe bağlı oluşturmayı seçebilirsiniz.”) Alıntıya git
Hugo — hız
- Hugo kendisini “the world’s fastest framework for building websites” (çeviri: “web siteleri oluşturmak için dünyanın en hızlı çatısı”) olarak tanıtır; bu, büyük içerik ölçeğinde önemli olan derleme hızı avantajıdır. Kaynak
Patrick Stox (kendi çalışmam — JavaScript SEO: A Definitive Guide)
- “Any kind of SSR, static rendering, and prerendering setup is going to be fine for search engines.” (çeviri: “Her tür SSR, statik oluşturma ve önceden oluşturma kurulumu arama motorları için sorunsuz olacaktır.”) — statik üretim bu yelpazenin düşük riskli ucudur.
Statik site SEO kontrol listesi
SSG kurulumunuzun arama dostu olduğunu ve güncel kaldığını doğrulamak için hızlı kontrol:
- Önemli içerik yalnızca JS çalıştıktan sonra değil, Kaynağı Görüntüle bölümündeki ham HTML’de bulunuyor; SSG’nin amacı budur.
- Her derlemede XML site haritası üretiliyor ve Google Search Console ile Bing Webmaster Tools’a gönderiliyor.
- Her sayfada derleme zamanında üretilen benzersiz
<title>ve meta açıklama var. - Kanonik etiketler canlı nihai URL’leri gösteriyor; localhost veya önizleme alan adını göstermiyor.
- Görseller derleme zamanında optimize ediliyor (duyarlı boyutlar, modern biçimler).
- İstemci taraflı JavaScript, birincil içeriği etkileşimin arkasına saklamıyor.
- JS/CSS varlıkları
robots.txtile engellenmiyor. - İçerik düzenlemeleri yeniden derleme ve dağıtımı tetikliyor; CMS/Git webhook’u dağıtımı otomatik başlatıyor.
- Zamana duyarlı veya sık değişen sayfalar planlı yeniden derleme ritmine sahip ya da statik yerine SSR/ISR ile sunuluyor.
- Önceki derlemedeki eski URL’ler yetim statik dosya olarak kalmıyor; çıktı dizini temizleniyor veya kaldırmalar işlenerek silinen sayfalar 404 ya da 410 döndürüyor.
- Dağıtılan derleme en güncel içerikle eşleşiyor; yakın zamanda değişen bir sayfa yalnızca yerelde değil üretimde de kontrol ediliyor.
Statik site oluşturucular — kopya kâğıdı
Altı seçeneğe hızlı bakış
| Oluşturucu | Dil | Tarayıcıya giden JS | Site haritası | En uygun kullanım |
|---|---|---|---|---|
| Hugo | Go | Yok | Yerleşik | Dev siteler, en hızlı derlemeler |
| Jekyll | Ruby | Yok | Eklenti | GitHub Pages blogları |
| Eleventy | Node | Yok | Şablon/eklenti | Esnek, sıfır JS çıktısı |
| Hexo | Node | Yok* | Eklenti | Node ekosistemi blogları |
| Gatsby | React | React paketi | Eklenti | React/veri odaklı siteler |
| Astro | Herhangi biri | Yok (adalar) | Resmî | İçerik ve hafif etkileşim |
HTML ne zaman oluşur (ve neden önemlidir)?
| Mimari | HTML’in üretildiği an | SEO riski |
|---|---|---|
| SSG (statik) | Derleme zamanında, bir kez | En düşük — içerik ham HTML’de |
| SSR / meta çatı | Her istekte, sunucuda | Düşük — içerik var, ancak sunucu maliyeti/gecikmesi de var |
| CSR (SPA) | Çalışma zamanında, tarayıcıda | En yüksek — oluşturmaya bağlı |
Hızlı bilgiler
- SSG = kritik yolda Web Rendering Service yok → içerik için “Wave 2” gecikmesi yok.
- Gatsby React paketini hydrate eder (CWV maliyeti); Astro yalnızca adalar için JS gönderir; Hugo/Jekyll/Eleventy/Hexo varsayılan olarak sıfır JS’dir.
- Gatsby’nin yayın temposu 2026 ortası itibarıyla yavaşladı; yeni projeyi ona bağlamadan önce GitHub etkinliğini kontrol edin.
- Hugo (Go) büyük ölçekte hız şampiyonudur.
- Tek tuzak derleme güncelliğidir: statik site son derlemesini gösterir. İçerik düzenlemelerini yeniden derleme webhook’una bağlayın.
- Hızla değişen veriler (fiyat, stok) → artımlı/planlı derlemeler veya hibrit SSR/ISR.
Hangi oluşturma yolu uygun?
Statik site yaklaşımını seçin
Derle → dağıt → doğrula çerçevesi
- Derle: amaçlanan rotaları listeleyin; eksiksiz HTML, meta veriler, kanonikler ve yapılandırılmış veri üretin.
- Dağıt: HTML, varlıklar, site haritaları ve yönlendirmeler eşzamanlı kalsın diye yeni çıktıyı atomik olarak yayımlayın.
- Doğrula: kaynak HTML’i ve üretim yanıtını, derlemeyi tetikleyen içerik sürümüyle karşılaştırın.
Statik HTML oluşturma bağımlılığını çözer; eski derlemeleri, eksik rotaları, bozuk dağıtım hook’larını veya kaynak HTML’e hiç ulaşmayan istemci taraflı meta verileri çözmez.
Temel içeriğin kaynak HTML’de bulunup bulunmadığını kontrol edin
curl -sS https://example.com/page/ | grep -F 'Expected visible heading'
Bir URL listesi için üretim rotası eksikse veya başlığı yoksa CI’ı başarısız kılın:
while IFS= read -r url; do html=$(curl -fsSL "$url") || { echo "FETCH FAIL $url"; continue; }; printf '%s' "$html" | grep -qi '<title>[^<]' || echo "TITLE FAIL $url"; done < urls.txtOluşturulmuş sayfanın başlığını, kanoniğini ve ana başlığını karşılaştırmak için bunu DevTools Console’da çalıştırın:
({title: document.title, canonical: document.querySelector('link[rel="canonical"]')?.href, h1: document.querySelector('h1')?.textContent.trim()});
Statik çıktı araçları
- Ham ve Oluşturulmuş HTML Denetleyicisi, önemli içerik ve head sinyallerinin ilk HTML’de zaten bulunup bulunmadığını gösterir.
- HTTP Durum Denetleyicisi, üretilen rotaları, yönlendirmeleri ve eksik sayfaları toplu denetler.
- HTTP Üstbilgi Denetleyicisi, yönlendirmeler boyunca önbellekleme ve dağıtım üstbilgilerini inceler.
- Hangi rotaların başarıyla üretildiği konusunda doğru kaynak, çatının derleme günlüğü ve dağıtım manifestidir.
Statik dağıtımın çalıştığını kanıtlayın
Kaynak HTML testi
Çalıştırılacak test: temsili üretim URL’lerini curl veya Render Gap ile alın. Beklenen sonuç: birincil içerik, başlık, kanonik ve bağlantılar ham HTML’de görünür. Hata yorumu: rota istemci tarafında oluşturuluyor ya da derleme veriyi atladı. İzleme aralığı: dağıtımdan hemen sonra. Geri alma tetikleyicisi: önemli şablonların kaynak HTML’i boş veya eksik yayımlanır.
Yayın güncelliği testi
Çalıştırılacak test: kontrollü bir içerik değişikliği yayımlayın; CMS zaman damgasını, derleme günlüğünü, dağıtım çıktısını ve canlı HTML’i karşılaştırın. Beklenen sonuç: değişiklik tek bir başarılı derlemeyi tetikler ve üretime ulaşır. Hata yorumu: webhook, derleme, önbellek veya dağıtım zinciri eskidir. İzleme aralığı: olağan yayın SLA’sı. Geri alma tetikleyicisi: üretimde eski HTML ile yeni meta veriler veya varlıklar karışır.
Rota eksiksizliği testi
Çalıştırılacak test: amaçlanan kanonik URL’leri üretilen/dağıtılan rotalarla karşılaştırın ve durumları toplu denetleyin. Beklenen sonuç: amaçlanan her rota planlanan durumunu döndürür. Hata yorumu: dinamik yol keşfi veya derleme yapılandırması bazı rotaları atladı. İzleme aralığı: her derleme. Geri alma tetikleyicisi: kanonik sayfalar 404s hâline gelir veya beklenmedik biçimde yönlendirilir.
Kendinizi sınayın: Statik site oluşturucular
Statik site oluşturucuların SEO için neden kolay mod olduğu ve yine de sizi tökezletebilecek tek nokta üzerine beş kısa soru. Her biri için bir yanıt seçip kontrol edin.
Zaman ayırmaya değer kaynaklar
İlgili yazılarım
- JavaScript SEO: A Definitive Guide — oluşturma, DOM eşliği ve statik/önceden oluşturulmuş çıktının neden risk yelpazesinin düşük ucunda olduğu.
- The Beginner’s Guide to Technical SEO — oluşturma mimarisinin daha geniş teknik SEO çerçevesindeki yeri.
Konuşmalarım
- How Search Works (SlideShare) — tarama, oluşturma, dizine ekleme ve sıralamaya ilişkin anlatımım. (Her zamanki uyarım geçerlidir: “This is my understanding of systems… not going to be 100% complete or accurate.” (çeviri: “Bu, sistemleri benim anladığım biçimiyle anlatıyor… %100 eksiksiz veya doğru olmayacak.”))
Sektörden kaynaklar
- web.dev — Rendering on the Web — Chrome ekibinin SSG, SSR ve CSR ile bunların ödünleşimlerini anlatan temel rehberi.
- Google Search Central — JavaScript SEO temelleri — statik derlemenin içerik için atlamanızı sağladığı tarama → oluşturma → dizine ekleme aşamaları.
- Jamstack — statik site oluşturucuların motoru olduğu mimari hareket ve oluşturucular dizini.
- Astro — Why Astro? — “statik HTML, varsayılan sıfır JS, etkileşim için adalar” modelinin en açık anlatımı.
- Hugo — büyük içerik ölçeğinde derleme hızı etrafında geliştirilen Go tabanlı oluşturucu.
- Smashing Magazine — statik site oluşturucu içerikleri — SSG seçimi ve kullanımı üzerine uygulayıcı yazıları.
Değişiklik günlüğü
20 Eyl 2026 tarihinde güncellendi.
Editoryal özet ve kaydedilen değişiklik ayrıntıları.Özet
İçe aktarılan değişiklik geçmişindeki İngilizce kalıntılar çevrildi ve yinelenen oluşturma açıklaması doğal Türkçeyle ayrıştırıldı.
Değişiklik ayrıntıları
-
Kaynak geçmişinin anlamı, teknik adlar ve yayın ile ana dil incelemesi kapıları korunarak görünür yerelleştirme tamamlandı.
Tam karşılaştırma kullanılamıyor — bu sürüm için önceki anlık görüntü arşivlenmemiş.
8 Eyl 2026 tarihinde güncellendi.
Editoryal özet ve kaydedilen değişiklik ayrıntıları.Özet
Created a source-locked localized article candidate; local revision numbering starts at ordinal 1.
Değişiklik ayrıntıları
-
Materialized translated blocks while preserving source history as provenance.
Tam karşılaştırma kullanılamıyor — bu sürüm için önceki anlık görüntü arşivlenmemiş.
8 Eyl 2026 tarihinde güncellendi.
Editoryal özet ve kaydedilen değişiklik ayrıntıları.Özet
Applied a source-locked machine translation pass while preserving localized lineage.
Değişiklik ayrıntıları
-
Materialized translated blocks while preserving source history as provenance.
Tam karşılaştırma kullanılamıyor — bu sürüm için önceki anlık görüntü arşivlenmemiş.
19 Tem 2026 tarihinde güncellendi.
Editoryal özet ve kaydedilen değişiklik ayrıntıları.Özet
Oluşturucu sürümleri ve listesi npm ile GitHub sürüm verilerine göre doğrulandı; canlı belgelerde artık bulunmayan Astro alıntısı doğru ifadeyle değiştirildi ve Gatsby’nin belirgin biçimde yavaşlayan 2026 yayın temposu karşılaştırma tablosundaki önerinin yanında tarihli not olarak eklendi.
Değişiklik ayrıntıları
-
Önce
Astro'nun why-astro sayfasındaki, sitenin tamamının derleme sırasında statik HTML'e dönüştürüldüğünü ve varsayılan olarak son sayfadaki tüm JavaScript'in kaldırıldığını söyleyen, artık canlı sayfada bulunmayan alıntı.SonraAstro'nun isteğe bağlı oluşturma rehberindeki, statik ön oluşturmanın hâlâ varsayılan olduğunu doğrulayan güncel birebir alıntı ve çalışan #:~:text= parçasıyla değiştirildi. -
Advanced oluşturucu karşılaştırmasına ve kısa başvuru notuna, Gatsby'nin GitHub yayın temposunun 2026'da belirgin biçimde yavaşladığını belirten bir cümle eklendi; Şubat'tan beri tek küçük sürüm, 2025'te ise bir dizi yama yayımlandığı için bugün oluşturucu seçerken bu durum dikkate alınmalıdır.
Tam karşılaştırma kullanılamıyor — bu sürüm için önceki anlık görüntü arşivlenmemiş.