Kolofon: Bu Site Nasıl Çalışıyor

TL;DR — Cloudflare üzerinde statik öncelikli Astro, dinamik bölümler için bilinçli olarak birbirinden ayrılmış iki Worker, gerçek veriler veya açıkça belirtilen bir kullanılamazlık durumu, gerçeği yansıtan durum kodları ve siteyi bir arama sonuçları sayfası gibi giydiren bir tasarım sistemi. Bu, sitenin dönüştüğü edge-SEO vaka çalışmasının yapım öyküsü sayfasıdır.

Bu sayfa nedir (ve ne değildir)

Kolofon, yayımlanmış bir çalışmanın nasıl ortaya çıkarıldığını ve kimlerin katkıda bulunduğunu kayda geçirir; çalışmanın arkasındaki teknolojiyi, sistemleri ve kişileri, tıpkı bir kitabın kolofonunda kullanılan yazı karakterinin ve matbaanın belirtilmesi gibi açıklar. Hukuki veya biyografik ağırlık taşıyan sayfaların yerine geçmez: Hakkımda sayfası kim olduğumu, Gizlilik Politikası hangi verilerin neden toplandığını, Kullanım Koşulları ise siteyi kullanma kurallarını açıklar. Bu sayfa yalnızca sitenin nasıl oluşturulduğunu ve işletildiğini belgeler; aşağıdaki bir iddia bu sayfalardan biriyle örtüşüyorsa yetkili kaynak ilgili sayfadır.

Teknoloji yığını

Bu site, oluşturma zamanında HTML sayfaları üretmek için Astro’nun statik çıktısını kullanır. Bu iddiaya ilişkin kanıt Astro prerenders pages statically by default unless on-demand rendering is enabled. Kapsam: Astro rendering modes used by this site's implementation. Güven düzeyi: yüksek · Doğrulandı: 2026-07-14 Astro: On-demand rendering Statik teslimat çalışma zamanı bağımlılıklarını azaltabilir; ancak SEO sonuçları yine oluşturulan içeriğe, bağlantılara ve teknik yapılandırmaya bağlıdır. Bu iddiaya ilişkin kanıt Static delivery is an implementation choice; search performance still depends on accessible content, links, and other SEO fundamentals. Kapsam: Editorial conclusion combining the site's stack with Google's general SEO guidance; static generation alone does not guarantee rankings. Güven düzeyi: medium · Doğrulandı: 2026-07-14 Google: SEO Starter Guide

• Astro dağıtım sırasında makaleleri, sözlüğü, merkez sayfalarını, araç kabuklarını, yapılandırılmış verileri, arama ve agent dizinlerini ve Markdown karşılıklarını üretir. İçerik bütünü, elle tutulan bir sayfa sayısının anlamlı olamayacağı kadar hızlı değişir.
• Cloudflare Workers Static Assets bu çıktıyı edge üzerinden sunar. Site yapılandırması yalnızca dinamik ve özel işlem gerektiren yolları kod üzerinden yönlendirir; sıradan sayfa ve varlık istekleri Worker hesaplamasına uğramaz. Bu yönlendirme sınırı için doğruluk kaynağı, bu sayfaya kopyalanmış bir liste değil, yapılandırmanın kendisidir.
• site Worker, iletişim, okuyucu soru-cevapları, tepkiler, bülten, arama telemetrisi, uzman katmanı ve site sahibi işlemleri gibi editoryal ve toplulukla ilgili sorumlulukları üstlenir.
• Ayrı olarak dağıtılan product Worker, ücretsiz araçların çalıştırılmasını ve ürün verilerinin kalıcı olarak saklanmasını üstlenir. site Worker ona bir Cloudflare service binding üzerinden erişir; böylece tarayıcılar iki güvenlik ve veri sınırı birleştirilmeden aynı origin’e ait /api/ URL’lerini kullanmaya devam eder.

Bilinçli olarak ayrılmış iki veri düzlemi

site Worker ile product Worker’ın her birinin kendine ait bir D1 veritabanı ve KV namespace’i vardır; ikisi bir Cloudflare service binding üzerinden bağlanır. Site D1 topluluk ve editoryal kayıtları; product D1 ise araç kullanımı, puanlamalar, hata bildirimleri, özellik talepleri, araştırma işleri ve izleme verilerini içerir. KV, kapsamı sınırlandırılmış önbellekler ve yedek sayaçlar için kullanılır.

R2 de kullanım amacına göre ayrılmıştır. Site medya bucket’ı uzman fotoğraflarını ve sesli yanıtları barındırır. Siteye ve ürüne ait özel yedekleme bucket’ları, farklı zamanlamalarla gerçekleştirilen planlı D1 dışa aktarımlarını alır; saklama ve sistem sağlığı bilgileri site sahibi işlemlerinde gösterilir. product Worker ayrıca sınırlandırılmış Workers AI ve Browser Rendering kullanımlarına, yerel rate-limit binding’lerine ve tarayıcıyla oluşturma bütçesini koordine eden bir Durable Object’e sahiptir. Gerekli binding’leri kullanılamayan veya bütçesi tükenen özellikler, uydurma çıktı üretmek yerine açıkça kullanılamaz durumda olduklarını bildirir.

Bu bölümde bilinçli olarak yer verilmeyenler şunlardır: binding adları, bucket tanımlayıcıları, veritabanı şemaları, kimlik bilgileri, dahili endpoint’ler ve yedekleme zamanlamaları. Her hizmetin kamuya açık amacını belirtmek siteyi anlamaya yardımcı olur; özel topolojisini açıklamaksa çoğunlukla yalnızca saldırganların işini kolaylaştırır. Bu nedenle söz konusu bilgiler gözden kaçtıkları için değil, politika gereği kamuya açık sayfanın dışında tutulur.

Statik öncelikli yaklaşım neden yalnızca bir barındırma tercihi değil, aynı zamanda bir SEO yaklaşımıdır?

Dizine eklenebilen her editoryal sayfa, gerçek bir durum koduyla birlikte tamamen oluşturulmuş bir HTML belgesi olarak sunulur. Etkileşimli araçların sonuçları tarayıcıda çalıştırılabilir veya bir Worker çağırabilir; ancak aracın amacının ve kullanım talimatlarının mevcut olması istemci tarafında oluşturma işlemine bağlı değildir. 404 sayfası gerçekten 404, silinen sayfalar gerçekten 410 döndürebilir; /coffee ise bir çaydanlık kahve demleyemeyeceği için gerçekten 418 döndürür. Bir siteyi kullanıcılar için elverişli kılan uptime ve TTFB özellikleri, tarayıcıların siteyi düşük maliyetle taramasını sağlayan özelliklerle aynıdır.

Veri dürüstlüğü kuralı

Ziyaretçilere gösterilen üretim metrikleri, açıkça belirlenmiş kaynaklardan gelir: kelime sayısı ve okuma süresi makale gövdesinden, tepki sayıları D1’den, bot tarama verileri Cloudflare’ın zone analytics verilerinden, size ait Core Web Vitals değerleri ise tarayıcınızdaki PerformanceObserver aracılığıyla alınır. Bir araç, çıktısını açıklamak amacıyla örnek veya fixture sunabilir; ancak bunlar etiketlenir ve canlı ölçüm olarak gösterilmez. Kullanılamayan bir kimlik bilgisi gerektiren ya da bütçesi tükenmiş özellikler, üretim verilerini sessizce uydurmak yerine bu durumu bildirir veya etkilenen sonucu gizler.

Editoryal köken

İçerik sistemi, AI kökenini dekoratif bir unsur değil, inceleme durumu olarak ele alır. Tamamen AI tarafından oluşturulan bir makale, makale düzeyinde bir etiket taşır. Daha önce incelenmiş bir metne sonradan uygulanan AI geçişi tüm makaleyi kapsamıyorsa yalnızca değiştirdiği lensi veya lensleri yeniden etiketler. AI revizyon metadatası, geçişi ve tarihini kaydeder. Herhangi bir AI etiketi kaldığı sürece makale, metni Patrick’e atfetmek yerine AI yazarlığını gösterir ve toplu içerik sayımlarına ya da site genelindeki ilgili toplam hesaplarına dahil edilmez. Etiketi yalnızca insan incelemesi veya insan tarafından yapılan revizyon kaldırabilir; başka bir AI geçişi kaldıramaz.

Bu kural, etiketsiz metnin hatasız olduğunu belgelemez. Yazarlık, inceleme durumu ve kamuya açık sayıların, bir insanın denetlediği içeriğin kapsamını sessizce olduğundan fazla göstermesini önler. Kullanım Koşulları okuyucuya yönelik sınırı belirtir; repository’deki ortak etiket helper’ı ise aynı kuralın tüm tüketicilerde uygulanmasını sağlar.

Agent’lar için açık arayüzler

Yapay zekâ tarayıcıları herkesle aynı oluşturulmuş HTML’yi kullanabilir, ancak artık sayfayı taramaları gerekmez. Yayımlanan her makalenin oluşturulmuş bir index.md karşılığı ve bir “Copy as Markdown” denetimi vardır. /llms.txt içerik bütününe yönlendirir, /llms-full.txt toplu Markdown sunar, /agent-index.json kamuya açık erişim bütününün tamamını açıklar ve /content-graph.json bunun iç bağlantı grafiğini yayımlar. Hız sınırı uygulanan, salt okunur bir MCP sunucusu içerik araması, makale erişimi, taksonomi ve kapsamı sınırlandırılmış küçük bir tanılama araçları grubu sunar. Güncel liste ve bağlantı talimatları Yapay zekâ aracıları için sayfasındadır. Bunların hiçbiri dizine eklenme, alıntılanma veya sıralama garantisi olarak sunulmaz — bu bir SEO iddiası değil, kararlı bir erişim sözleşmesidir.

Etkin olmayan özellik, Cloudflare’ın Markdown for Agents hizmeti aracılığıyla aynı URL üzerinde Accept: text/markdown content negotiation yapılmasıdır. Açık Markdown URL’leri şu anda kararlı ve kamuya açık sözleşmeyi oluşturur. Content negotiation daha sonra etkinleştirilirse ikinci bir editoryal kopya yaratmak yerine aynı oluşturulmuş kaynağın önünde çalışabilir.

Araçlar ve uzman incelemesi

Ücretsiz SEO araçları, tarayıcıda yerel olarak çalışan ayrıştırıcılardan, doğrulayıcılardan ve hesaplayıcılardan; sınırlandırılmış canlı fetch işlemlerine, rendering karşılaştırmalarına, field data sorgularına ve AI destekli işlemlere kadar uzanır. Bir aracın birden fazla arayüzü olduğunda ortak kural registry’leri, tarayıcı, Worker, toplu işlem ve MCP sonuçlarının birbiriyle uyumlu kalmasını sağlar.

Kamuya açık uzman paneli, makaleleri belirli pasajlara sabitlenmiş tartışmalara dönüştürür. Doğrulanmış uzmanlar kararlı paragraf ID’lerine not ekleyebilir ve soruları yanıtlayabilir; güvenilir katkılar doğrudan yayımlanırken diğerleri moderasyona alınır. Yayımlanan notlar ve yanıtlar, dizine eklenemeyen ve sonradan yüklenen bir eklenti olarak bırakılmak yerine makale çıktısına ve yapılandırılmış verilerine işlenir.

Arama odaklı tasarım sistemi

Site, içinde var olduğu ortamın görünümünü benimser: ana sayfa akışı, içerik merkezi ve site araması; yeşil breadcrumb, mavi başlık ve snippet içeren SERP sonuçları biçiminde oluşturulur. Makalelerde kendilerine gönderme yapan bir “In search results” önizlemesi bulunur, TL;DR bölümleri featured snippet’ler gibi biçimlendirilir ve okuyucu soru-cevapları People Also Ask bölümleri gibi açılıp kapanır. Beş skin (Clean, Magazine, Neo-Brutalist, Punk, Cyberpunk), radius, border, shadow ve type gibi CSS custom properties aracılığıyla her şeyin görünümünü değiştirir; böylece token’lara göre bir kez yazılan bileşen beşinde de çalışır.

Performans bütçesi

Fontlar, geçiş sırasında sayfa düzeninin kaymaması için size-adjusted fallback’lerle Astro’nun Fonts API’si üzerinden yüklenir; yalnızca olağan LCP öğesinin arkasındaki display typeface önceden yüklenir. Üçüncü taraf embed’leri ve SEO-data sekmesinde sitenin kendi /api/* çağrıları, yalnızca sekme açıldığında lazy-load edilir. Speculation Rules, Chromium’da imleçle üzerine gelinen aynı siteye ait bağlantıları prerender eder. Her makalenin health strip bölümündeki Core Web Vitals chip’leri bunun kanıtıdır; oturumunuza ait gerçek değerleri gösterir.

Katkıda bulunanlar ve kaynaklar

• Site sahibi ve yazar: Patrick Stox bu siteyi yazar ve sürdürür; özgeçmiş bilgileri Hakkımda sayfasındadır.
• Framework ve platform: build işlemi için Astro; runtime ve veri katmanı için Cloudflare Workers, D1, KV ve R2.
• Agent protokolü: yukarıda açıklanan MCP server için Model Context Protocol specification.
• Katkıda bulunanlar: uzman panelindeki doğrulanmış uzmanlar, makale pasajlarına notlar ve yanıtlar ekler; yayımlanan katkılarda adları belirtilir.
• Bu sayfanın kaynakları: dağıtımdaki davranışlara ilişkin iddialar bu repository’nin kaynak kodu ve yapılandırmasıyla; platform davranışlarına ilişkin iddialar ise sayfa boyunca bağlantı verilen resmi Astro ve Cloudflare belgeleriyle karşılaştırılarak doğrulanır. Burada bir teknolojinin adını belirtmek, olgusal bir katkı kaydıdır; destek beyanı veya belirli bir SEO sonucu iddiası değildir.

Bu sayfa güncelliğini yitirmeye bırakılmaz; canlı repository ve güncel platform belgeleriyle düzenli olarak karşılaştırılıp incelenir. Aşağıdaki updated tarihi, bu tür son incelemenin tarihini gösterir.

Easter egg’ler işlevsel birer yapı taşıdır

/robots.txt, aynı anda hem geçerli bir robots.txt dosyası hem de bir web sayfası olan tek bir dosyadır (label üzerinde content negotiation, byte düzeyinde özdeş gövde). Konsolda bir easter egg vardır. /coffee, çalışan bir HTCPCP gösterimidir. Bunların her biri, kullandığı mekanizmayı öğretmek için vardır; bu da sitenin temel tezinin küçük ölçekteki bir örneğidir.

TL;DR — Siteyi açık sınırları koruyarak işletin: statik HTML varsayılan teslim yolu, dinamik işler doğru Worker ve veri düzleminde, eksik bağımlılıklar dürüst bir durumda ve crawler, ajan, köken ile performans sözleşmeleri eşitlenmiş olmalıdır.

Statik ve dinamik yüzeyleri ayrı yayınlayın

Statik çıktı herkese açık tabandır. Tam HTML’yi ve sıradan varlıkların yanlışlıkla Worker çalıştırmadığını doğrulayın. Editoryal ve topluluk Site Worker’a, araç yürütme ve ürün verileri Product Worker’a aittir; service binding arayüz olarak kalır.

Veri ve açıklama sınırlarını koruyun

Site ve ürün için D1, KV ve yedek yollarını ayrı, uzman medyasını amaçlanan R2 alanında tutun. Herkese açık amacı açıklarken kimlik bilgilerini, özel binding adlarını, tanımlayıcıları, şemaları, iç endpoint’leri veya zamanlamaları açığa çıkarmayın.

Dürüstlüğü yayın özelliği olarak test edin

Ziyaretçinin gördüğü her değerin kaynağını belirleyin. Canlı metrikler belirtilen üretimden gelir, örnekler etiketli kalır, kullanılamayan bağımlılık veya bütçe açık bir durum gösterir. Geçerli sayfaları, 404’leri, gerektiğinde 410’ları ve yalnızca /coffee için amaçlanan 418’i gerçek HTTP ile test edin.

Erişim ve kökeni eşitleyin

Yalnızca HTML değişikliği yeterli değildir. Markdown ikizini, ajan dizinlerini, içerik grafiğini, yapılandırılmış veriyi ve salt okunur MCP’yi birlikte doğrulayın. İnsan incelemesine kadar AI etiketlerini ve revizyon meta verilerini koruyun.

Operatör kontrol listesi

• Varlık ve sorumlu Worker yönlendirmesini doğrulayın.
• Service binding üzerinden same-origin /api/ yolunu test edin.
• Açık kullanılamaz durumlarını tetikleyin.
• HTML, Markdown, dizinler, grafik ve yapılandırılmış veriyi karşılaştırın.
• Core Web Vitals ile font, embed, API ve prerender bütçelerini kontrol edin.
• Kapsam değişirse About, Privacy ve Terms sayfalarını yeniden inceleyin.

• Kapsam: Hakkımda, Gizlilik ve Kullanım Koşulları sayfalarından ayrı bir yapım ve katkı kaydıdır; örtüşen iddialarda söz konusu sayfalar yetkili kaynak olmaya devam eder.
• Teknoloji yığını: Cloudflare Workers Static Assets tarafından sunulan statik Astro build’i; sıradan statik trafik Worker hesaplamasına uğramaz.
• Runtime ayrımı: site Worker editoryal ve topluluk API’lerini üstlenir; ürün yollarını service binding üzerinden ayrı dağıtılan product Worker’a devreder.
• Veri katmanı: site ve ürün için ayrı D1/KV depoları; uzman medyası ve özel planlı yedeklemeler için R2; ürün tarafında sınırlandırılmış Workers AI, Browser Rendering ve rate-limit binding’leri ile bir Durable Object.
• SEO özellikleri: tamamen oluşturulmuş editoryal HTML, gerçeği yansıtan durum kodları (gerçek 404/410/418), Speculation Rules ile prerender ve makale başına JSON-LD; etkileşimli araç sonuçları tarayıcı veya Worker üzerinde çalıştırılabilir.
• Veri dürüstlüğü: üretim metriklerinde gerçek kaynak belirtilir; örnekler etiketlenir ve kullanılamayan canlı özellikler üretim sonuçları uydurmak yerine bu durumu açıkça gösterir.
• Editoryal köken: AI tarafından oluşturulan veya revize edilen metin, insan incelemesine kadar etiketli kalır; etiketli olduğu sürece AI yazarlığını gösterir ve bu inceleme durumundayken toplu içerik sayılarına dahil edilmez.
• Agent erişimi: HTML’nin yanı sıra makale başına Markdown, toplu ve yapılandırılmış dizinler, içerik grafiği ve salt okunur bir MCP server. Aynı URL üzerinde Markdown content negotiation etkin değildir.
• Kamuya açık sistemler: ücretsiz araç platformu ile kararlı makale pasajlarına eklenen ve moderasyondan geçen uzman notları ve yanıtları.
• Tasarım: token’larla yönetilen beş skin’e sahip, arama odaklı motif (SERP biçimli akışlar, featured snippet tarzı TL;DR bölümleri ve PAA tarzı soru-cevaplar).
• Performans: size-adjusted font fallback’leri, yalnızca LCP için preload, lazy-load edilen üçüncü taraf embed’leri ve her oturumun görünür CWV chip’leri.
• Açıklama sınırı: hizmetlerin kamuya açık amaçlarını (D1, KV, R2, service binding’ler, MCP) yayımlar; binding adlarını, bucket tanımlayıcılarını, şemaları, kimlik bilgilerini veya yedekleme zamanlamalarını yayımlamaz.
• Katkılar: site sahibi ve yazar olarak Patrick Stox, platform olarak Astro ve Cloudflare, agent erişimi için Model Context Protocol specification ve notlar ile yanıtlar ekleyen doğrulanmış uzmanlar.

Değişiklik günlüğü