- Konu sahibi
- #1
Node.js ile sitemap oluşturmanın en basit yolu, sitenizdeki herkese açık ve kanonik sayfa adreslerini XML biçiminde üretip
Sitemap, arama motorlarına sitenizde taranmasını istediğiniz URL'leri bildiren XML dosyasıdır. Her sayfa
Sitemap'e genellikle şu sayfalar eklenir:
Aşağıdaki dosyayı
Çalıştırmak için terminalde şu komutu kullanın:
Beklenen çıktı buna benzer olmalıdır:
Ardından proje klasöründe
Veritabanından URL üretirken yalnızca yayın durumundaki kayıtları seçin. Silinmiş veya taslak içerikler listeye girerse sitemap, ziyaretçiye açılmayan adresleri bildirmiş olur.
Tek sitemap için 50.000 URL ve sıkıştırılmamış 50 MB sınırını gözetin. Bu örnek sitemap’i her çalıştırmada dosyanın üzerine yazar. İçerik değiştikçe build sürecinde yeniden çalıştırın veya veritabanı tabanlı üretimde kontrollü bir önbellekleme mekanizması kullanın. Sitemap, sayfaların indeksleneceğini garanti etmez; yalnızca keşfedilebilir URL'lerin düzenli biçimde bildirilmesini sağlar.
Temel sayfa sitemap'i yalnızca sayfa URL'lerini içerebilir. Görsel veya video keşfi özel metadata gerektiriyorsa bunu ayrı bir sitemap yaklaşımıyla tasarlamak daha uygundur; normal sayfa adreslerini bu nedenle kaldırmayın.
Örnek URL’leri çözüp fragmenti kaldırdıktan sonra tekilleştirir ve site dışına çıkan adresi reddeder. Ancak /urun ile /urun/ adreslerinin aynı sayfa olup olmadığını kendiliğinden bilmez. Gerçek kanonik adres kararını uygulamanızın yönlendirme ve canonical politikasından alın.
sitemap.xml dosyasına yazmaktır. Aşağıdaki örnek harici paket kullanmadan çalışır; URL listesini düzenleyip dosyayı projenizin public veya statik dosya klasörüne koyabilirsiniz.Sitemap nasıl çalışır?
Sitemap, arama motorlarına sitenizde taranmasını istediğiniz URL'leri bildiren XML dosyasıdır. Her sayfa
<url>, adres ise <loc> etiketi içinde yer alır. Adreslerin tam URL olması, yani alan adıyla birlikte yazılması gerekir.Sitemap'e genellikle şu sayfalar eklenir:
- Yayınlanmış ve herkese açık içerikler
- Kanonik ürün, kategori veya makale sayfaları
- Giriş gerektirmeyen kalıcı sayfalar
Çalıştırılabilir Node.js örneği
Aşağıdaki dosyayı
generate-sitemap.cjs adıyla kaydedin. example.com alan adını kendi alan adınızla, URL listesini de uygulamanızdaki gerçek rotalarla değiştirin. .cjs uzantısı, proje module modunda olsa da bu require örneğini CommonJS olarak çalıştırır; adresler kurgusaldır.
Kod:
const fs = require('node:fs');
const baseUrl = 'https://example.com';
const paths = [
'/',
'/hakkimizda',
'/blog/node-js-sitemap-olusturma',
'/iletisim'
];
function escapeXml(value) {
return value
.replace(/&/g, '&')
.replace(/</g, '<')
.replace(/>/g, '>')
.replace(/"/g, '"')
.replace(/'/g, ''');
}
const urls = [...new Set(paths.map((path) => {
const url = new URL(path, baseUrl);
url.hash = '';
if (url.origin !== new URL(baseUrl).origin) {
throw new Error('URL site dışına çıkıyor: ' + url.href);
}
if (!['http:', 'https:'].includes(url.protocol)) {
throw new Error(`Desteklenmeyen protokol: ${url.href}`);
}
return url.href;
}))];
const entries = urls
.map((url) => ` <url>\n <loc>${escapeXml(url)}</loc>\n </url>`)
.join('\n');
const sitemap = `<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
${entries}
</urlset>
`;
fs.writeFileSync('sitemap.xml', sitemap, 'utf8');
console.log(`${urls.length} URL sitemap.xml dosyasına yazıldı.`);Çalıştırmak için terminalde şu komutu kullanın:
Kod:
node generate-sitemap.cjsBeklenen çıktı buna benzer olmalıdır:
Kod:
4 URL sitemap.xml dosyasına yazıldı.Ardından proje klasöründe
sitemap.xml oluşur. Dosyanın içeriğinde kök <urlset> elementi ve her adres için bir <url> elementi bulunmalıdır. XML dosyasını tarayıcıda açtığınızda ham XML veya tarayıcının biçimlendirdiği XML görünümüyle karşılaşmanız normaldir.Uygulama kararları
| Durum | Uygulama | Neden |
|---|---|---|
| Küçük ve sabit site | Dosyayı build sırasında üretin | Gereksiz sunucu işlemi oluşmaz |
| İçerikler veritabanından geliyorsa | URL listesini sorgudan oluşturun | Yeni içerikler otomatik dahil edilir |
| Dinamik rotalar çok fazlaysa | Parçalı üretim ve önbellek kullanın | Her istekte pahalı sorguyu önlersiniz |
| Birden fazla sitemap gerekiyorsa | Ayrı dosyalar ve bir sitemap index kullanın | Yönetimi ve hata ayıklamayı kolaylaştırır |
Yayına alma ve kontrol
- Üretilen
sitemap.xmldosyasını sitenin herkese açık kök dizinine veya seçtiğiniz sabit dosya dizinine taşıyın. - Tarayıcıda alan adınızın sitemap dosyasını açarak HTTP hata kodu, XML biçimi ve URL listesini kontrol edin.
- Her
<loc>değerinin gerçek, erişilebilir ve tercih edilen URL olduğundan emin olun. - Uygulamanızda statik dosyalar için uygun
application/xmliçerik türünün döndürüldüğünü kontrol edin. - Sitemap adresini robots.txt içindeki
Sitemap:satırıyla ve kullandığınız arama motoru araçlarıyla bildirin.
& karakteri, eksik kapanış etiketi veya bozuk URL vardır. Örnekteki escapeXml fonksiyonu bu tür karakter sorunlarını azaltır; ancak URL listesinin doğruluğunu yine sizin kontrol etmeniz gerekir.Tek sitemap için 50.000 URL ve sıkıştırılmamış 50 MB sınırını gözetin. Bu örnek sitemap’i her çalıştırmada dosyanın üzerine yazar. İçerik değiştikçe build sürecinde yeniden çalıştırın veya veritabanı tabanlı üretimde kontrollü bir önbellekleme mekanizması kullanın. Sitemap, sayfaların indeksleneceğini garanti etmez; yalnızca keşfedilebilir URL'lerin düzenli biçimde bildirilmesini sağlar.
Sık sorulan sorular
Sitemap'e görsel ve video adresleri eklenmeli mi?
Temel sayfa sitemap'i yalnızca sayfa URL'lerini içerebilir. Görsel veya video keşfi özel metadata gerektiriyorsa bunu ayrı bir sitemap yaklaşımıyla tasarlamak daha uygundur; normal sayfa adreslerini bu nedenle kaldırmayın.
Aynı sayfa farklı yollarla listeye girerse ne olur?
Örnek URL’leri çözüp fragmenti kaldırdıktan sonra tekilleştirir ve site dışına çıkan adresi reddeder. Ancak /urun ile /urun/ adreslerinin aynı sayfa olup olmadığını kendiliğinden bilmez. Gerçek kanonik adres kararını uygulamanızın yönlendirme ve canonical politikasından alın.
