Next.js App Router projelerinde mutlak canonical URL, çift yönlü hreflang, global dil yakalayıcıları, x-default ve sitemap tutarlılığı için uygulamalı denetim rehberi.
Okuduklarınızı güvenli bir denemeye dönüştürün
Gerçek veriye geçmeden önce sentetik bir örnekle adımları tamamlayın. İşaretler yalnızca bu sekmede tutulur.
Hreflang’ın çözdüğü problem
Hreflang bir sıralama kısayolu değil, aynı içeriğin dil veya bölge varyantlarını eşleyen bir yönlendirme sinyalidir. Google sayfanın dilini metinden anlar; hreflang ise hangi URL’nin hangi kullanıcıya sunulmasının daha uygun olduğunu belirtir. Türkçe ana sayfa ile İngilizce eşinin yalnızca menü metnini değil, asıl içeriği de çevirmesi gerekir.
Her kümede tüm sayfalar kendisini ve diğer varyantları listelemelidir. Türkçe sayfa İngilizceye işaret ederken İngilizce sayfa Türkçeye dönmüyorsa geri dönüş bağlantısı eksiktir ve küme yok sayılabilir. Bu nedenle etiketleri sayfa içinde elle çoğaltmak yerine ortak rota fonksiyonundan üretmek daha güvenlidir.
- Her sayfada self-reference bulunmalı.
- Dil çiftleri karşılıklı olmalı.
- URL’ler HTTPS dâhil tam nitelikli olmalı.
- Yalnızca gerçekten eşdeğer içerikler aynı kümeye alınmalı.
Global İngilizce ve x-default kararı
Yalnızca ABD’ye özgü fiyat, mevzuat veya teslimat içeriği yoksa genel İngilizce sayfa için en-US yerine en yakalayıcısı daha geniş ve doğru bir tanımdır. Bölgesel en-US sinyali korunacaksa aynı URL için genel en alternatifi de sunulabilir; böylece Birleşik Krallık, Kanada, Hindistan veya başka bir bölgedeki İngilizce kullanıcılar kapsamsız kalmaz.
x-default, desteklenmeyen dil ayarları için varsayılan hedefi anlatır. Dil seçici sayfanız yoksa küresel olarak anlaşılabilir İngilizce sürümü kullanmak mantıklı olabilir. Bu karar otomatik yönlendirme değildir; kullanıcı her zaman görünür dil bağlantısıyla diğer sürüme geçebilmelidir.
- Dil ile ülkeyi gereksiz yere eşitlemeyin.
- x-default hedefini bilinçli ve tutarlı seçin.
- IP tabanlı zorunlu yönlendirmeden kaçının.
- Dil değiştiricide gerçek, taranabilir bağlantı kullanın.
Canonical ile hreflang aynı işi yapmaz
Canonical, indeks için tercih edilen URL’yi bildirir; hreflang ise farklı dil URL’lerinin eşdeğerliğini açıklar. Türkçe sayfanın canonical etiketi kendisine, İngilizce sayfanın canonical etiketi yine kendisine gitmelidir. Tüm dilleri tek bir canonical URL’ye bağlamak, İngilizce sayfayı kopya gibi göstermeye çalışır ve hreflang amacını bozar.
Statik export ve trailingSlash kullanılan projelerde canonical URL’nin yönlendirme yapan ara adresi değil son HTTPS adresini göstermesi gerekir. Sorgu parametresi, hash, büyük-küçük harf ve sondaki eğik çizgi politikası metadata, Open Graph, breadcrumb ve sitemap boyunca aynı olmalıdır.
App Router’da tek kaynaklı uygulama
Next.js metadataBase göreli URL’leri çözebilir; yine de büyük bir i18n sitesinde canonical ve languages değerlerini ortak bir yardımcıyla üretmek denetimi kolaylaştırır. Yardımcı fonksiyon Türkçe ve İngilizce yolu alıp final, mutlak URL’leri; tr, en, bölgesel alias ve x-default değerlerini aynı anda döndürebilir.
Dinamik araç ve makale sayfalarında generateMetadata rota parametresinden aynı slug’ı kullanmalıdır. Sitemap de aynı toolPath veya postPath fonksiyonunu çağırırsa yeni içerik eklendiğinde HTML etiketleri ile XML alternates birbirinden kopmaz.
- Rota eşlemesini tek modülde tutun.
- Canonical ve Open Graph URL’sini aynı final adresinden üretin.
- Sitemap alternates değerlerini aynı yardımcıdan alın.
- Yeni slug ekleyen otomatik testte iki dil rotasını da doğrulayın.
Yayın öncesi ve sonrası doğrulama
Production build çıktısında canonical ve tüm hreflang bağlantılarını gerçek HTML üzerinden inceleyin. Her href’in 200 yanıt veren final URL’ye gittiğini, sayfanın doğru lang değerini taşıdığını ve alternatiflerin karşılıklı olduğunu kontrol edin. Yalnızca React bileşenine bakmak, metadata birleştirme veya export davranışını kaçırabilir.
Yayın sonrasında Search Console URL Denetimi ile Google’ın seçtiği canonical adresi izleyin. Hreflang değişiklikleri anında sonuç vermez; yeniden tarama ve küme değerlendirmesi zaman alabilir. Başarıyı yalnızca gösterim artışıyla değil, yanlış dilde açılan açılış sayfalarının ve dil değiştirme ihtiyacının azalmasıyla da ölçün.
Kaynaklar ve doğrulama
Bu rehber hazırlanırken aşağıdaki birincil ve resmî belgeler kontrol edildi. Bağlantıların güncel sürüm ve değişiklik tarihlerini ayrıca inceleyin.
Rehberi tekrarlanabilir bir kontrole dönüştürün
“Next.js Hreflang ve Canonical Rehberi: Türkiye’den Globale Açılmak” için aşağıdaki 3 araçlık kontrol planını kullanın. Hedef: Next.js App Router projelerinde mutlak canonical URL, çift yönlü hreflang, global dil yakalayıcıları, x-default ve sitemap tutarlılığı için uygulamalı denetim rehberi. Gerçek veri yerine güvenli bir örnekle başlayın; her adımın beklenen sonucunu ve kabul kararını kaydedin.
Meta Etiket / Favicon Üretici
- Hazırlık
- Site başlığı, açıklaması ve mutlak canonical URL'yi girin. Meta Etiket / Favicon Üretici için beklenen biçim: Meta Etiket / Favicon Üretici için başlangıç girdisi: desteklenen türde, boyut sınırını aşmayan yerel dosya veya dosyalar. Araç bu girdiyi “SEO, Open Graph, Twitter Card ve favicon etiketlerini tek bir güvenli HTML bloğunda üretin” amacıyla kullanır..
- Uygulama
- Sosyal görsel ile favicon adreslerini ekleyip canlı önizleme ve uyarıları inceleyin. Meta Etiket / Favicon Üretici, şu yöntemi uygular: Meta Etiket / Favicon Üretici, “SEO, Open Graph, Twitter Card ve favicon etiketlerini tek bir güvenli HTML bloğunda üretin” hedefi için şu açıklanabilir yöntemi uygular: dosya tarayıcı belleğinde okunur; özgün dosya değiştirilmeden yeni çıktı üretilir.
- Kabul kontrolü
- HTML veya Next.js taslağını kopyalayın; Search Console ve platform doğrulayıcılarında ayrıca test edin. Meta Etiket / Favicon Üretici kabul ölçütü: Meta Etiket / Favicon Üretici sonucunu kabul etmeden önce özgün dosyanın korunması; çıktı açılabilirliği, beklenen sayfa/kare sayısı, boyut ve görünür kalitenin kontrolü kontrolünü tamamlayın; beklenen amaç “SEO, Open Graph, Twitter Card ve favicon etiketlerini tek bir güvenli HTML bloğunda üretin” olmalıdır..
- Beklenen çıktı
- Meta Etiket / Favicon Üretici tamamlandığında indirilebilir yeni dosya, boyut/biçim ölçümleri ve işlem sınırı sunar; bu çıktı “SEO, Open Graph, Twitter Card ve favicon etiketlerini tek bir güvenli HTML bloğunda üretin” ihtiyacına göre düzenlenir.. SEO, Open Graph, Twitter Card ve favicon etiketlerini tek bir güvenli HTML bloğunda üretin.
URL Kodlayıcı ve Çözücü
- Hazırlık
- URL bileşenini girin. URL Kodlayıcı ve Çözücü için beklenen biçim: URL Kodlayıcı ve Çözücü için başlangıç girdisi: araçta istenen URL, HTTP başlığı, cURL komutu, API veya web yapılandırması. Araç bu girdiyi “Sorgu değerlerini güvenli URL bileşenlerine dönüştürün” amacıyla kullanır..
- Uygulama
- Kodla veya çöz seçeneğini seçin. URL Kodlayıcı ve Çözücü, şu yöntemi uygular: URL Kodlayıcı ve Çözücü, “Sorgu değerlerini güvenli URL bileşenlerine dönüştürün” hedefi için şu açıklanabilir yöntemi uygular: girdi ağ isteği yapılmadan ayrıştırılır; bileşenler ve riskli varsayımlar ayrı gösterilir.
- Kabul kontrolü
- Sonucu gerçek bağlantıda kullanmadan önce doğrulayın. URL Kodlayıcı ve Çözücü kabul ölçütü: URL Kodlayıcı ve Çözücü sonucunu kabul etmeden önce çıktının yetkili test ortamında, güncel standart ve gerçek sunucu davranışıyla karşılaştırılması kontrolünü tamamlayın; beklenen amaç “Sorgu değerlerini güvenli URL bileşenlerine dönüştürün” olmalıdır..
- Beklenen çıktı
- URL Kodlayıcı ve Çözücü tamamlandığında normalize edilmiş web yapılandırması, bileşen envanteri ve uygulanabilir inceleme notları sunar; bu çıktı “Sorgu değerlerini güvenli URL bileşenlerine dönüştürün” ihtiyacına göre düzenlenir.. Sorgu değerlerini güvenli URL bileşenlerine dönüştürün.
Markdown Önizleyici
- Hazırlık
- Markdown metnini sol alana yazın veya yapıştırın. Markdown Önizleyici için beklenen biçim: Markdown Önizleyici için başlangıç girdisi: amaç ve hedef dil korunarak düzenlenecek veya karşılaştırılacak düz metin. Araç bu girdiyi “Markdown metnini güvenli HTML önizlemesi ve kopyalanabilir kodla birlikte görün” amacıyla kullanır..
- Uygulama
- Sağdaki canlı önizlemeyi ve HTML kodunu kontrol edin. Markdown Önizleyici, şu yöntemi uygular: Markdown Önizleyici, “Markdown metnini güvenli HTML önizlemesi ve kopyalanabilir kodla birlikte görün” hedefi için şu açıklanabilir yöntemi uygular: unicode, satır ve kelime sınırları korunarak deterministik metin kuralları uygulanır.
- Kabul kontrolü
- Üretilen HTML'i kopyalayın veya dosya olarak indirin. Markdown Önizleyici kabul ölçütü: Markdown Önizleyici sonucunu kabul etmeden önce anlamı değiştiren cümleler, özel adlar, sayılar, noktalama ve çok dilli karakterlerin önce/sonra karşılaştırması kontrolünü tamamlayın; beklenen amaç “Markdown metnini güvenli HTML önizlemesi ve kopyalanabilir kodla birlikte görün” olmalıdır..
- Beklenen çıktı
- Markdown Önizleyici tamamlandığında düzenlenmiş metin, değişiklik özeti ve ölçülebilir dil/yapı göstergeleri sunar; bu çıktı “Markdown metnini güvenli HTML önizlemesi ve kopyalanabilir kodla birlikte görün” ihtiyacına göre düzenlenir.. Markdown metnini güvenli HTML önizlemesi ve kopyalanabilir kodla birlikte görün.
Meta Etiket / Favicon Üretici için şu sınır geçerlidir: Meta Etiket / Favicon Üretici için kullanım sınırı: Şema, kodlama ve veri kaybı varsayımlarını hedef sistemde doğrulayın. Bu koşul karşılanmıyorsa çıktıyı zincirin sonraki adımına aktarmayın.
“Next.js Hreflang ve Canonical Rehberi: Türkiye’den Globale Açılmak” kaydında hassas içeriği değil; araç adını, seçilen ayarı, tarayıcı sürümünü ve “Yeni sayfa SEO başlangıcı: Meta Etiket / Favicon Üretici ile yerel analiz” için kabul/red gerekçesini tutun. Böylece kontrol gerçek veriyi çoğaltmadan tekrarlanabilir.
İçerik, görünür ByteQuant ürün davranışı ve varsa listelenen birincil kaynaklarla karşılaştırılarak hazırlanır. Genel bilgilendirmedir; hukuki veya güvenlik danışmanlığı değildir.