Eksik bir herkese açık belge, açık bir açıklama göstermeli ve genellikle 404 olan uygun bir HTTP durum kodu döndürmelidir. Mac’te Chrome kullanarak ikisini de kontrol edebilir, uyuşmazlığı belirleyebilir ve yayın sisteminize kesin bir düzeltme iletebilirsiniz.

Bu iş akışı; kılavuz, başvuru notu veya basit yönerge sayfası gibi herkese açık belge sayfalarının bakımını yapanlar içindir. Amaç, istenen adresin, sunucu yanıtının ve gösterilen mesajın birbiriyle tutarlı olmasını sağlamaktır. Aşağıdaki tüm örnek yollar kurgusaldır.

Eksik bir belge hangi yanıtı döndürmeli?

Önce belgenin adresinde ne olması gerektiğine karar verin. Taşınmış bir sayfanın ele alınışı, artık mevcut olmayan bir sayfanınkinden farklıdır. Eksik sayfa tasarımını değiştirmeden önce bu karar tablosunu kullanın.

Belgenin durumu Beklenen yanıt Okurların görmesi gerekenler
İstenen adreste mevcut 200 OK Belgenin tamamı
Açıkça belirlenmiş kalıcı bir karşılığı var 301 yönlendirmesi Yeni adresindeki karşılık belge
Bulunamıyor ve eşdeğer bir karşılığı yok 404 Not Found Yararlı bir eksik belge açıklaması
Bilerek kaldırıldı ve yokluğunun kalıcı olması muhtemel 410 Gone uygundur Açık bir kaldırılma açıklaması ve yararlı gezinme bağlantıları

HTTP, yokluğun geçici mi kalıcı mı olduğunu belirtmeden 404 durumunu tanımlar. Kullanılamaması muhtemelen kalıcı olan bir kaynak için 410 tanımlanır; kalıcılık bilinmiyorsa 404 kullanın. Bu anlamlar RFC 9110, 15.5.5 ve 15.5.11 bölümlerinden gelir.

Google, bir belge taşınmışsa veya açıkça belirlenmiş bir karşılığı varsa kalıcı yönlendirme önerir. Benzer bir karşılığı olmadan kaldırılmışsa Google, 404 veya 410 önerir. Google’ın eksik içerik yanıtlarını çözümleme yönergelerine bakın.

Örneğin, /documents/paper-folding-notes adresinin büyük ölçüde eşdeğer yönergeler içeren /documents/paper-folding-guide adresine taşındığını varsayalım. Bu değişiklik için kalıcı yönlendirme uygundur. Notlar herhangi bir karşılık olmadan kaldırıldıysa eski adreste eksik belge yanıtı vermeye devam edin. Bu sayfada genel belge dizinine bağlantı sunabilirsiniz.

İkna edici bir eksik sayfa tasarımı neden yeterli değildir?

Bir sayfada görünür biçimde Belge bulunamadı yazarken sunucusu 200 döndürebilir. Google bu tür uyuşmazlıklara soft 404 der; boş bir sayfa veya ana içeriği olmayan bir sayfa da bu şekilde sınıflandırılabilir. Google’ın soft 404 hataları açıklamasını okuyun.

Durum kodu, açıklayıcı içerikten ayrı olarak HTTP yanıtının bir parçasıdır. Bu nedenle başlığı değiştirmek veya büyük bir 404 etiketi eklemek yanıt kodunu belirlemez. Sorunun çözüldüğüne karar vermeden önce asıl belge isteğini kontrol edin. RFC 9110, yanıt durum kodlarının rolünü açıklar.

Mac’te belge yanıtını nasıl kontrol edersiniz?

Bu inceleme için Chrome’un yerleşik araçlarını kullanın. Çalıştığını bildiğiniz bir belge adresi ve aynı herkese açık sitede özellikle var olmayan bir yol hazırlayın. Örneğin, eksik yol /documents/missing-paper-example-731 olabilir. Yayımlanmış bir belgesi olmadığını bildiğiniz bir adres seçin.

  1. Herkese açık sayfayı Chrome’da açın.
  2. DevTools’u açmak için Command + Option + I tuşlarına basın.
  3. Network panelini seçin.
  4. DevTools açıkken test adresini adres çubuğuna girip yükleyin.

Chrome, Mac kısayolunu Chrome DevTools’u açma sayfasında belgeliyor. Network paneli genel bakışında açıklandığı üzere, DevTools açıkken ağ etkinliği kaydedilir.

  1. Bu kontrolde tarayıcının önbelleğe alınmış yanıtına güvenmemek için Disable cache seçeneğini işaretleyin.
  2. Yönlendirmeleri izlemek gerekiyorsa Preserve log seçeneğini etkinleştirin.
  3. Test adresini yeniden yükleyin.
  4. Ana belge isteğini seçin, ardından Headers sekmesini açın. General altında istek adresini ve durum kodunu okuyun.

Bu kontroller ve durum bilgisinin yeri, Chrome’un Network özellikleri başvuru belgesinde açıklanmıştır.

Belge isteğini dikkatlice kontrol edin. Günlükte komut dosyaları, stiller ve diğer kaynaklar için istekler de bulunur. Eksik bir destek dosyası, belgenin kendisinin 404 döndürdüğünü kanıtlamaz. Chrome’un istek tablosu HTTP kodunu Status, kaynak kategorisini ise Type sütununda gösterir; Ağ etkinliğini inceleme sayfasına bakın.

Şimdi üç gözlemi karşılaştırın: başlangıçta istenen adres, bu belge için yanıt kodu ve yükleme sonrasında görünen sayfa. Bunları birlikte kaydedin. Gezinme sırasında adres değişiyorsa yalnızca son sayfayı değil, ilk isteği ve hedef adresi de inceleyin.

Gözlemleri düzeltme talebine nasıl dönüştürürsünüz?

Aşağıdaki tanılama tablosu, HTTP anlamları ile Google’ın sorun giderme yönergelerinin pratik bir sentezidir. Bu bir karar yardımcısıdır; ölçülmüş sonuçlar sunmaz.

Gözlemlenen sonuç İncelenecek nokta Beklenen düzeltme
Eksik belge mesajıyla birlikte 200 Eksik yol işleyicisi veya geri dönüş davranışı Açıklamayla birlikte 404 döndürün
Beklenen belge görünürken 404 Mevcut bir yola atanan yanıt Belgeyi 200 ile başarıyla sunun
Genel bir dizine yönlendirme Eşdeğer bir karşılığın bulunup bulunmadığı Eşdeğer belgeye yönlendirin veya eksik sayfa gösterin
Boş ya da tamamlanmamış belgeyle birlikte 200 İçeriğin yüklenmesi ve görüntülenmesi Belge hâlâ mevcutsa amaçlanan içeriği geri yükleyin
Yararlı bir eksik sayfa mesajıyla birlikte 404 Adresin gerçekten mevcut olmaması Amaçlanan davranış buysa bu şekilde çalışmasını sürdürün

Google’ın sorun giderme belgeleri; kullanılamayan belgeleri, taşınmış belgeleri ve hâlâ mevcut olduğu hâlde düzgün yüklenmeyen belgeleri açıkça birbirinden ayırır. Bu ayrım, eksik çalışan bir sayfanın bilerek kaldırılmış gibi değerlendirilmesini önler. Google Arama tarama hatalarını giderme sayfasına bakın.

Somut bir talep için şöyle yazın: “Kurgusal /documents/missing-paper-example-731 yolu için 404 döndürün ve bu adreste özel eksik belge sayfasını gösterin. Mevcut belge yolları başarıyla çalışmaya devam etsin. Kalıcı yönlendirmeleri yalnızca eşdeğer bir karşılık belirlendiğinde uygulayın.” Kontrolünüzde gözlemlediğiniz durum kodunu ve görünen mesajı ekleyin.

Bu talep, yayın sisteminizdeki menü adlarını tahmin etmeden gerekli davranışı tarif eder. Uygulama, yanıtı üreten barındırma yapılandırmasında, uygulama yolunda veya yayın sisteminde yapılmalıdır. Google, HTTP durum kodlarının barındırma sunucusu tarafından üretildiğini HTTP durum kodları belgelerinde açıklar.

Düzenleyici yalnızca sayfa içeriğini değiştirmenize izin veriyorsa ne yapmalısınız?

Metni veya belge meta verilerini değiştiren bir düzenleyici, HTTP yanıtlarını denetlemeyebilir. WHATWG HTML Standardı, http-equiv kullanılarak verilen meta yönergeleri için belirli davranışlar tanımlar; HTTP yanıt durumunu ayarlamak bunların arasında değildir. Bu nedenle http-equiv="status" eklemek, 404 oluşturmak için desteklenen bir yöntem değildir. Bkz. HTML Standardı: Pragma yönergeleri.

Düzenleyicide yanıt denetimleri yoksa barındırma veya uygulama katmanının belgelenmiş eksik sayfa mekanizmasını kullanın. İstenen eksik adreste özel içeriği 404 ile sunup sunmadığını sorun. Yalnızca bir hata sayfası düzeni seçen bir ayar bu soruyu yanıtlamaz; sonucunu tarayıcı iş akışıyla doğrulayın.

Netlify’da statik sayfalar için belgelenmiş bir örnek

Netlify’da mevcut bir statik site için belgelenmiş mekanizma 404.html adlı bir dosyadır. Statik bir dosyaya karşılık gelmeyen başarısız yollar için Netlify bu dosyayı otomatik olarak kullanır. Bu, ön koşulları olan sağlayıcıya özgü bir örnektir: sitenin tamamlanmış çıktılarına erişim ve mevcut bir statik sayfa derlemesi gerekir. Netlify özel 404 işleme yöntemini belgeliyor.

  1. Eksik belge sayfasını oluşturmak için sitenin mevcut sayfa şablonunu kullanın.
  2. Tamamlanmış çıktının yayımlama dizininin kökünde 404.html içerdiğinden emin olun.
  3. Hiçbir önceki yönlendirme kuralının bilinmeyen adresleri başka bir sayfaya göndermediğini kontrol edin.
  4. Güncellenmiş çıktı herkese açık adreste kullanıma sunulduktan sonra hem eksik bir yolu hem de çalışan bir belgeyi inceleyin.

Netlify, statik dosya ve son eksik sayfa işleme adımına geçmeden önce yönlendirme işlemlerini yaptığı için yönlendirme kontrolü önemlidir. Daha önce ele alınan bir istek bu son işleyiciye ulaşmaz. İstek Zinciri belgelerinde bu sıra açıklanır. Bu örnek bir düzeltme yolunu tarif eder; herhangi bir sitenin değiştirildiğini belirtmez.

Tarayıcı yönlendirmeli uygulamaların sınırları

Bazı uygulamalar, bir belgenin mevcut olmadığını ancak JavaScript çalıştıktan sonra anlar. Google, istemci taraflı yönlendirmede anlamlı durum kodları kullanmanın pratik olmayabileceğini kabul eder. Belgelenmiş alternatifleri, sunucusu 404 döndüren bir adrese JavaScript yönlendirmesi yapmak veya hata sayfasına noindex meta verisini eklemektir. Bkz. Google’ın JavaScript SEO yönergeleri.

Bu alternatiflerin sonuçları farklıdır. Yönlendirme, gerçek bir eksik sayfa yanıtı veren yeni bir adrese ulaşır. Meta veri yaklaşımı, özgün HTTP durumunu değiştirmeden dizine ekleme işlemini etkiler. Özgün belge adresini koruyup orada 404 döndürmek gerekiyorsa barındırma veya uygulama yanıtı bu davranışı desteklemelidir.

Eksik belge sayfasında ne yazmalı?

Bu belge bulunamadı. gibi kısa ve açık bir mesaj kullanın. Ardından tek bir yararlı sonraki adım sunun: belge dizinine veya doğrulanmış başka bir gezinme hedefine bağlantı verin. Sitenin tanıdık gezinme öğelerini ve görünümünü koruyun. Google, özel eksik sayfalar için açık bir dil, tutarlı bir tasarım ve yararlı bağlantılar önerir.

Kurgusal kâğıt katlama örneği için uygun bir metin şöyle olabilir: Bu kâğıt katlama belgesini bulamadık. Başka bir kılavuz seçmek için belge dizinine göz atın. Bir belgenin kalıcı olarak kaldırıldığını yalnızca bu biliniyorsa belirtin. Her eksik adresi hemen başka bir yere göndermek yerine açıklamayı görünür tutun.

Yanıtla sayfanın birbiriyle uyuştuğunu nasıl doğrularsınız?

Küçük bir karşılaştırma kümesiyle incelemeyi tekrarlayın. Aşağıdaki beklenen sonuçlar örnek kabul ölçütleridir; bildirilmiş test sonuçları değildir.

Test durumu Beklenen yanıt ve sayfa
Çalıştığı bilinen belge Belgenin tamamıyla birlikte 200
Bilerek mevcut olmayan yol Eksik belge açıklamasıyla birlikte 404
Karşılığı olmayan kaldırılmış belge Doğru bir açıklamayla 404 veya uygun olduğunda 410
Eşdeğer bir karşılığı olan taşınmış belge Kalıcı yönlendirme, ardından karşılık belgenin başarılı yanıtı

Her adresi doğrudan girip yeniden yükleyerek, normalde sayfa içi gezinmeyle ulaşılan belgeler de dâhil olmak üzere yeniden test edin. Bu, yeni bir belge isteğinin aldığı yanıtı kontrol eder. Başarılı bir hedefin gezinme sırasında daha önce alınan hatalı yanıtı gizlememesi için adresi, kodu ve görünür sonucu birlikte kaydedin.

Eski bir sonuç sürüyorsa tarayıcı önbelleğini diğer önbelleklerden ayırın. Chrome’un önbelleğini devre dışı bırakmak tarayıcı önbelleğini etkiler. HTTP önbelleğe alma, 404 gibi olumsuz yanıtları da saklayabilir; bu nedenle güncelliğini yitirmiş bir eksik yanıt için yayın sisteminin belgelenmiş önbellek davranışını kontrol etmek gerekebilir. RFC 9111, önbelleğe alınabilir olumsuz sonuçları açıklar.

Google Arama açısından gerçek bir eksik yanıtın öngörülen bir sonucu vardır: Google, 404 veya 410 döndüren URL’leri dizine eklemez ve bu yanıtlar işlendikçe daha önce dizine eklenmiş URL’leri kaldırır. Başarılı bir 200 yanıtı da dizine eklenmeyi garanti etmez. Bkz. HTTP durum kodlarının Google tarayıcılarını nasıl etkilediği.

Her test edilen adres tutarlı bir sonuç verdiğinde işi tamamlayın: mevcut belgeler başarıyla yüklenir, taşınmış belgeler karşılıklarına gider ve mevcut olmayan belgeler yararlı gezinme bağlantıları içeren uygun bir eksik yanıt döndürür. Böylece Mac’inizde uygulanabilir ve tekrarlanabilir bir yayın kontrolünüz olur.

Kaynaklar