{"id":35656,"date":"2025-12-02T09:01:07","date_gmt":"2025-12-02T06:01:07","guid":{"rendered":"https:\/\/fatihsoysal.com\/blog\/qwikte-bos-sitemap-xml-sorununa-kesin-cozum-rehberi\/"},"modified":"2025-12-02T09:01:07","modified_gmt":"2025-12-02T06:01:07","slug":"qwikte-bos-sitemap-xml-sorununa-kesin-cozum-rehberi","status":"publish","type":"post","link":"https:\/\/fatihsoysal.com\/blog\/qwikte-bos-sitemap-xml-sorununa-kesin-cozum-rehberi\/","title":{"rendered":"Qwik’te Bo\u015f Sitemap.xml Sorununa Kesin \u00c7\u00f6z\u00fcm Rehberi"},"content":{"rendered":"

<\/p>\n

Qwik uygulaman\u0131zda sitemap.xml dosyas\u0131n\u0131n neden bo\u015f kald\u0131\u011f\u0131n\u0131 merak m\u0131 ediyorsunuz? Arama motorlar\u0131n\u0131n sitenizi do\u011fru \u015fekilde dizine ekleyememesinin \u00f6n\u00fcne ge\u00e7mek ve SEO performans\u0131n\u0131z\u0131 art\u0131rmak i\u00e7in bu kapsaml\u0131 rehberi inceleyin. Qwik projelerinizde bo\u015f sitemap sorununu ad\u0131m ad\u0131m \u00e7\u00f6zecek ve sitenizin g\u00f6r\u00fcn\u00fcrl\u00fc\u011f\u00fcn\u00fc en \u00fcst d\u00fczeye \u00e7\u0131karacak pratik y\u00f6ntemleri ke\u015ffedin.<\/p>\n

Web sitenizin arama motorlar\u0131 taraf\u0131ndan kolayca ke\u015ffedilmesi ve do\u011fru \u015fekilde dizine eklenmesi, \u00e7evrimi\u00e7i ba\u015far\u0131n\u0131z i\u00e7in kritik \u00f6neme sahiptir. Bu s\u00fcre\u00e7te en temel ara\u00e7lardan biri ku\u015fkusuz sitemap.xml dosyas\u0131d\u0131r. Ancak modern web geli\u015ftirme \u00e7er\u00e7eveleri, \u00f6zellikle de Qwik gibi performans odakl\u0131 ve sunucu taraf\u0131 olu\u015fturmay\u0131 (SSR) veya statik site \u00fcretimini (SSG) yo\u011fun olarak kullanan yap\u0131lar, sitemap olu\u015fturma s\u00fcre\u00e7lerinde kendine \u00f6zg\u00fc zorluklar bar\u0131nd\u0131rabilir. \u0130lk olarak, bu temel kavramlar\u0131 daha yak\u0131ndan inceleyelim.<\/p>\n

Peki, nedir bu Qwik? Qwik, JavaScript’i minimum d\u00fczeyde g\u00f6ndererek inan\u0131lmaz h\u0131zl\u0131 y\u00fckleme s\u00fcreleri sunan, performansa odakl\u0131 bir web framework’\u00fcd\u00fcr. \u00d6zellikle “Resumability” (devam edebilirlik) \u00f6zelli\u011fi sayesinde, sunucuda olu\u015fturulan HTML’in istemci taraf\u0131nda neredeyse s\u0131f\u0131r JavaScript ile interaktif hale gelmesini sa\u011flar. Bu, \u00f6zellikle b\u00fcy\u00fck ve i\u00e7erik a\u00e7\u0131s\u0131ndan zengin web siteleri i\u00e7in ciddi bir avantaj sunar. Qwik’in mimarisi, statik sayfalar\u0131n h\u0131zl\u0131 bir \u015fekilde servis edilmesini ve gerekti\u011finde dinamik etkile\u015fimlerin y\u00fcklenmesini kolayla\u015ft\u0131r\u0131r. Bu ba\u011flamda, Qwik ile olu\u015fturulan bir web sitesinin arama motorlar\u0131 i\u00e7in optimize edilmesi, \u00f6zellikle de sitemap.xml dosyas\u0131n\u0131n do\u011fru bir \u015fekilde \u00fcretilmesi, b\u00fcy\u00fck \u00f6nem ta\u015f\u0131maktad\u0131r.<\/p>\n

Sitemap.xml ise, bir web sitesindeki t\u00fcm \u00f6nemli URL’leri listeleyen XML format\u0131nda bir dosyad\u0131r. Amac\u0131, arama motoru taray\u0131c\u0131lar\u0131n\u0131n (\u00f6rne\u011fin Googlebot) sitenizdeki t\u00fcm sayfalar\u0131 ke\u015ffetmesine yard\u0131mc\u0131 olmakt\u0131r. \u00d6zellikle yeni, b\u00fcy\u00fck, karma\u015f\u0131k veya iyi dahili ba\u011flant\u0131lar\u0131 olmayan siteler i\u00e7in sitemap.xml hayati bir ara\u00e7t\u0131r. Bu dosya, sadece URL’leri listelemekle kalmaz, ayn\u0131 zamanda her URL i\u00e7in son de\u011fi\u015ftirilme tarihi (lastmod<\/code>), de\u011fi\u015fiklik s\u0131kl\u0131\u011f\u0131 (changefreq<\/code>) ve \u00f6ncelik (priority<\/code>) gibi meta verileri de i\u00e7erebilir. Arama motorlar\u0131 bu bilgileri kullanarak sitenizin i\u00e7eri\u011fini daha verimli bir \u015fekilde tarar ve dizine ekler. Dolay\u0131s\u0131yla, bo\u015f veya eksik bir sitemap.xml dosyas\u0131, sitenizin arama motorlar\u0131ndaki g\u00f6r\u00fcn\u00fcrl\u00fc\u011f\u00fcn\u00fc do\u011frudan olumsuz etkileyebilir.<\/p>\n

Qwik uygulamalar\u0131nda bo\u015f sitemap olu\u015fmas\u0131n\u0131n temel nedenleri genellikle framework’\u00fcn statik veya sunucu taraf\u0131 derleme s\u00fcre\u00e7leriyle ilgilidir. Geli\u015ftirme ortam\u0131nda her \u015fey yolunda g\u00f6r\u00fcnse de, \u00fcretim derlemesi s\u0131ras\u0131nda sitemap dosyas\u0131n\u0131 olu\u015fturan betiklerin do\u011fru tetiklenmemesi veya dinamik rota bilgilerinin eksik toplanmas\u0131 yayg\u0131n senaryolard\u0131r. Bu durum, \u00f6zellikle qwik-city<\/code> gibi Qwik’in router ve meta veri y\u00f6neticisi k\u00fct\u00fcphanesi kullan\u0131l\u0131rken ortaya \u00e7\u0131kabilir. Yap\u0131land\u0131rma hatalar\u0131, veri eksikli\u011fi veya derleme s\u00fcrecindeki bir aksakl\u0131k, nihai sitemap.xml<\/code> dosyas\u0131n\u0131n beklendi\u011fi gibi t\u00fcm URL’leri i\u00e7ermemesine, hatta tamamen bo\u015f kalmas\u0131na neden olabilir. Bu nedenle, Qwik projelerinde sitemap olu\u015fturma s\u00fcrecini dikkatlice y\u00f6netmek, SEO stratejisinin ayr\u0131lmaz bir par\u00e7as\u0131d\u0131r.<\/p>\n

Qwik Uygulamalar\u0131nda Bo\u015f Sitemap Neden Ortaya \u00c7\u0131kar?<\/h3>\n

Qwik projelerinde kar\u015f\u0131la\u015f\u0131lan “bo\u015f sitemap.xml” sorunu, geli\u015ftiriciler i\u00e7in kafa kar\u0131\u015ft\u0131r\u0131c\u0131 olabilir. Genellikle bu durum, geli\u015ftirme ortam\u0131nda \u00e7al\u0131\u015f\u0131rken her \u015feyin kusursuz g\u00f6r\u00fcnmesi ancak \u00fcretim (production) ortam\u0131na ge\u00e7ildi\u011finde beklenmedik bir \u015fekilde sitemap dosyas\u0131n\u0131n ya hi\u00e7 olu\u015fmamas\u0131 ya da i\u00e7eri\u011finin bo\u015f kalmas\u0131yla ortaya \u00e7\u0131kar. Bu sorun, sitenizin arama motorlar\u0131ndaki g\u00f6r\u00fcn\u00fcrl\u00fc\u011f\u00fcn\u00fc do\u011frudan etkiler ve SEO performans\u0131n\u0131z\u0131 ciddi \u015fekilde baltalayabilir. Bu b\u00f6l\u00fcmde, Qwik uygulamalar\u0131nda bo\u015f sitemap sorununa yol a\u00e7an yayg\u0131n senaryolar\u0131 ve vaka analizlerini ele alaca\u011f\u0131z.<\/p>\n

Yayg\u0131n Senaryolar ve Temel Nedenler:<\/strong><\/p>\n

    \n
  1. Geli\u015ftirme Ortam\u0131 ve \u00dcretim Ortam\u0131 Farkl\u0131l\u0131klar\u0131:<\/strong> Geli\u015ftirme sunucusu genellikle dinamik i\u00e7eri\u011fi an\u0131nda i\u015flerken, \u00fcretim derlemesi (qwik build<\/code>) statik \u00e7\u0131kt\u0131lar\u0131 \u00f6nceden olu\u015fturur. E\u011fer sitemap olu\u015fturma mant\u0131\u011f\u0131n\u0131z, sadece \u00e7al\u0131\u015fma zaman\u0131nda eri\u015filebilen verilere veya dinamik dosya sistemine ba\u011f\u0131ml\u0131ysa, derleme s\u0131ras\u0131nda bu bilgiler eksik kalabilir. Bu durum, \u00f6zellikle dinamik rotalar\u0131n veya API \u00e7a\u011fr\u0131lar\u0131ndan gelen verilerin sitemap’e dahil edilmesinde sorun yaratabilir.<\/li>\n
  2. qwik-city<\/code> Yap\u0131land\u0131rmas\u0131n\u0131n Eksikli\u011fi veya Yanl\u0131\u015f Kullan\u0131m\u0131:<\/strong> Qwik-City, Qwik uygulamalar\u0131 i\u00e7in g\u00fc\u00e7l\u00fc bir y\u00f6nlendirme ve meta veri y\u00f6netimi k\u00fct\u00fcphanesidir. Otomatik sitemap olu\u015fturma yetene\u011fine sahiptir. Ancak, bu \u00f6zelli\u011fin do\u011fru \u015fekilde yap\u0131land\u0131r\u0131lmamas\u0131 veya projenizin mimarisine uygun olarak kullan\u0131lmamas\u0131, bo\u015f sitemap’lere yol a\u00e7abilir. \u00d6rne\u011fin, Qwik-City’nin sitemap olu\u015fturucusunun rotalar\u0131 do\u011fru bir \u015fekilde tarayamamas\u0131 veya d\u0131\u015far\u0131dan gelen verileri entegre edememesi gibi durumlar g\u00f6zlemlenebilir.<\/li>\n
  3. Dinamik \u0130\u00e7eriklerin Sitemap’e Dahil Edilememesi:<\/strong> Blog g\u00f6nderileri, \u00fcr\u00fcn sayfalar\u0131 veya kullan\u0131c\u0131 profilleri gibi veritaban\u0131ndan veya harici bir API’den gelen i\u00e7erikler, statik olarak \u00f6nceden bilinmez. E\u011fer sitemap olu\u015fturma s\u00fcreciniz bu dinamik verileri \u00e7ekip derleme zaman\u0131nda sitemap’e eklemek i\u00e7in gerekli mekanizmalara sahip de\u011filse, bu sayfalar sitemap’te yer almayacak ve bo\u015f bir \u00e7\u0131kt\u0131 elde edilecektir.<\/li>\n
  4. Derleme Hatalar\u0131 veya Betiklerin \u00c7al\u0131\u015fmamas\u0131:<\/strong> Bazen, sitemap’i olu\u015fturan betiklerdeki k\u00fc\u00e7\u00fck bir hata veya derleme s\u00fcrecindeki bir sorun, beti\u011fin d\u00fczg\u00fcn bir \u015fekilde \u00e7al\u0131\u015fmamas\u0131na neden olabilir. Bu durum, sitemap dosyas\u0131n\u0131n hi\u00e7 olu\u015fturulmamas\u0131 veya i\u00e7eri\u011finin bo\u015f kalmas\u0131yla sonu\u00e7lan\u0131r. Konsol \u00e7\u0131kt\u0131lar\u0131n\u0131 dikkatlice incelemek bu t\u00fcr sorunlar\u0131 erken te\u015fhis etmenizi sa\u011flayabilir.<\/li>\n<\/ol>\n

    Vaka Analizi 1: Yanl\u0131\u015f qwik-city<\/code> Yap\u0131land\u0131rmas\u0131<\/strong><\/p>\n

    Bir e-ticaret sitesi, \u00fcr\u00fcnlerini Qwik ile yeniden in\u015fa etmeye karar verdi. Site, Qwik-City’nin y\u00f6nlendirme \u00f6zelliklerini yo\u011fun bir \u015fekilde kullan\u0131yordu. Ancak, \u00fcretim derlemesi sonras\u0131 kontrol edildi\u011finde, sitemap.xml dosyas\u0131n\u0131n sadece ana sayfay\u0131 i\u00e7erdi\u011fi, binlerce \u00fcr\u00fcn sayfas\u0131n\u0131n ise eksik oldu\u011fu fark edildi. Sorun incelendi\u011finde, qwik-city-sitemap<\/code> eklentisinin vite.config.ts<\/code> dosyas\u0131na eklenmesine ra\u011fmen, dinamik rota olu\u015fturma stratejisinin sitemap’e \u00f6zel bir loader<\/code> fonksiyonu ile beslenmedi\u011fi anla\u015f\u0131ld\u0131. qwik-city-sitemap<\/code> varsay\u0131lan olarak yaln\u0131zca dosya tabanl\u0131 rotalar\u0131 tarayabilir. Dinamik rotalar i\u00e7in ekstra yap\u0131land\u0131rma gereklidir. Bu eksiklik, sitemap’in bo\u015f veya eksik kalmas\u0131na yol a\u00e7m\u0131\u015ft\u0131.<\/p>\n

    Vaka Analizi 2: API Verilerine Ba\u011f\u0131ml\u0131 Dinamik Blog Yaz\u0131lar\u0131<\/strong><\/p>\n

    Bir ba\u015fka Qwik projesinde, i\u00e7erikler ayr\u0131 bir Headless CMS’den (API arac\u0131l\u0131\u011f\u0131yla) \u00e7ekilen bir blog platformu geli\u015ftiriliyordu. Geli\u015ftirme s\u0131ras\u0131nda blog yaz\u0131lar\u0131 sorunsuz bir \u015fekilde g\u00f6sterilirken, \u00fcretim sitemap’i tamamen bo\u015f \u00e7\u0131kt\u0131. Bunun nedeni, sitemap olu\u015fturma beti\u011finin derleme an\u0131nda Headless CMS API’sine bir HTTP iste\u011fi g\u00f6ndermemesiydi. Sitemap, sadece dosya sisteminde bulunan statik rotalar\u0131 i\u00e7eriyordu. \u00c7\u00f6z\u00fcm olarak, derleme \u00f6ncesi bir ad\u0131mda veya sitemap olu\u015fturma s\u00fcrecinin bir par\u00e7as\u0131 olarak, Headless CMS’den t\u00fcm blog yaz\u0131s\u0131 slug’lar\u0131n\u0131 (URL yolu) \u00e7eken ve bunlar\u0131 sitemap’e manuel olarak ekleyen bir betik yaz\u0131lmas\u0131 gerekti. Bu, Qwik’in SSG yetenekleriyle birle\u015ferek dinamik i\u00e7eriklerin de sitemap’e dahil edilmesini sa\u011flad\u0131.<\/p>\n

    Bo\u015f sitemap sorununu \u00e7\u00f6zmek i\u00e7in \u00f6ncelikle sorunun k\u00f6k nedenini do\u011fru bir \u015fekilde te\u015fhis etmek b\u00fcy\u00fck \u00f6nem ta\u015f\u0131r. Yukar\u0131daki senaryolar, bu t\u00fcr sorunlar\u0131n nas\u0131l ortaya \u00e7\u0131kabilece\u011fine dair size bir fikir vermektedir. Bir sonraki b\u00f6l\u00fcmde, Qwik’te sitemap.xml dosyas\u0131n\u0131 do\u011fru bir \u015fekilde olu\u015fturmak ve optimize etmek i\u00e7in ad\u0131m ad\u0131m pratik \u00e7\u00f6z\u00fcmleri inceleyece\u011fiz.<\/p>\n

    Qwik’te Sitemap.xml Olu\u015fturma ve Optimize Etme Ad\u0131mlar\u0131 Nelerdir?<\/h2>\n

    Qwik uygulaman\u0131z i\u00e7in bo\u015f sitemap.xml sorununu \u00e7\u00f6zmek ve arama motorlar\u0131 i\u00e7in sitenizi optimize etmek, do\u011fru ad\u0131mlar\u0131 takip ederek olduk\u00e7a kolayla\u015fabilir. Qwik-City ile entegre bir \u015fekilde \u00e7al\u0131\u015fan sitemap olu\u015fturma mekanizmalar\u0131 sayesinde, bu s\u00fcreci otomatikle\u015ftirmek ve hem statik hem de dinamik rotalar\u0131n\u0131z\u0131 sitemap’e dahil etmek m\u00fcmk\u00fcnd\u00fcr. \u0130\u015fte ad\u0131m ad\u0131m izlemeniz gereken y\u00f6ntemler ve kod \u00f6rnekleri:<\/p>\n

    Qwik-City ile Otomatik Sitemap Olu\u015fturma Nas\u0131l Yap\u0131l\u0131r?<\/h3>\n

    Qwik-City, rota tabanl\u0131 dosya sistemini kullanarak sitemap olu\u015fturma yetene\u011fine sahiptir. \u0130lk olarak, projenizde Qwik-City’nin kurulu ve yap\u0131land\u0131r\u0131lm\u0131\u015f oldu\u011fundan emin olun. Daha sonra, vite.config.ts<\/code> dosyan\u0131za qwik-city-sitemap<\/code> eklentisini eklemeniz gerekecektir. Bu eklenti, derleme s\u0131ras\u0131nda projenizdeki t\u00fcm sayfalar\u0131 tarayarak otomatik olarak bir sitemap.xml dosyas\u0131 olu\u015fturur.<\/p>\n

    \n\/\/ vite.config.ts\nimport { defineConfig } from 'vite';\nimport { qwikVite } from '@builder.io\/qwik\/optimizer';\nimport { qwikCity } from '@builder.io\/qwik-city\/vite';\nimport { qwikCitySitemap } from '@builder.io\/qwik-city\/vite'; \/\/ Sitemap eklentisini import edin\n\nexport default defineConfig(() => {\n  return {\n    plugins: [\n      qwikCity(),\n      qwikVite(),\n      qwikCitySitemap({ \/\/ Sitemap eklentisini yap\u0131land\u0131r\u0131n\n        baseUrl: 'https:\/\/www.example.com\/', \/\/ Sitenizin canl\u0131 URL'si\n      }),\n    ],\n    \/\/ Di\u011fer Vite yap\u0131land\u0131rmalar\u0131n\u0131z...\n  };\n});\n    <\/pre>\n
    <\/code><\/p>\n
    Yukar\u0131daki kod blo\u011fu, qwikCitySitemap<\/code> eklentisini nas\u0131l entegre edece\u011finizi g\u00f6sterir. baseUrl<\/code> parametresi, sitemap'teki t\u00fcm URL'lerin \u00f6n eki olarak kullan\u0131lacak sitenizin ana URL'sini belirtir. Bu ad\u0131m, sitemap'inizin do\u011fru URL'lerle olu\u015fturulmas\u0131n\u0131 sa\u011flamak i\u00e7in hayati \u00f6nem ta\u015f\u0131r. E\u011fer bu baseUrl<\/code> do\u011fru ayarlanmazsa, sitemap'inizdeki URL'ler yerel bir geli\u015ftirme ortam\u0131 adresini g\u00f6sterebilir veya hi\u00e7 olu\u015fmayabilir, bu da arama motorlar\u0131 i\u00e7in sorun te\u015fkil eder.<\/p>\n
    Statik Rotalar \u0130\u00e7in Sitemap Olu\u015fturma:<\/strong><\/p>\n
    Qwik-City, dosya tabanl\u0131 rotalar\u0131n\u0131z\u0131 (\u00f6rne\u011fin, src\/routes\/hakkimizda\/index.tsx<\/code> veya src\/routes\/iletisim\/index.tsx<\/code> gibi) otomatik olarak alg\u0131lar ve sitemap'e ekler. Yukar\u0131daki yap\u0131land\u0131rma ile bu t\u00fcr statik sayfalar\u0131n\u0131z\u0131n sorunsuz bir \u015fekilde sitemap'te yer ald\u0131\u011f\u0131n\u0131 g\u00f6receksiniz. Bu, Qwik'in statik i\u00e7erik \u00fcretme yetene\u011finin do\u011fal bir uzant\u0131s\u0131d\u0131r.<\/p>\n
    Dinamik Rotalar\u0131 Sitemap'e Dahil Etme Stratejileri:<\/strong><\/p>\n
    Qwik uygulamalar\u0131nda dinamik rotalar, genellikle src\/routes\/blog\/[slug]\/index.tsx<\/code> gibi bir yap\u0131ya sahiptir ve veritaban\u0131ndan veya harici bir API'den gelen verilere g\u00f6re i\u00e7erik olu\u015fturur. Bu t\u00fcr rotalar\u0131n sitemap'e dahil edilmesi biraz daha \u00f6zel bir yakla\u015f\u0131m gerektirir. qwik-city-sitemap<\/code> eklentisi, dinamik rotalar i\u00e7in bir get=\"paths\"<\/code> metodu arac\u0131l\u0131\u011f\u0131yla \u00f6zel yollar sa\u011flaman\u0131za olanak tan\u0131r. Bu, Qwik'in loader<\/code> fonksiyonlar\u0131na benzer bir mant\u0131kla \u00e7al\u0131\u015f\u0131r.<\/p>\n
    Dinamik rotalar\u0131 sitemap'e dahil etmek i\u00e7in, genellikle bir paths.ts<\/code> dosyas\u0131 olu\u015fturman\u0131z gerekir. Bu dosya, sitemap olu\u015fturucunun dinamik rotalar i\u00e7in hangi yollar\u0131 (slug'lar\u0131) kullanaca\u011f\u0131n\u0131 belirten bir dizi d\u00f6nd\u00fcr\u00fcr. \u00d6rne\u011fin, bir blog yaz\u0131s\u0131 siteniz varsa ve yaz\u0131lar bir veritaban\u0131ndan geliyorsa, paths.ts<\/code> dosyan\u0131z a\u015fa\u011f\u0131daki gibi g\u00f6r\u00fcnebilir:<\/p>\n
    \n\/\/ src\/routes\/blog\/[slug]\/paths.ts\nimport type { StaticGenerateHandler } from '@builder.io\/qwik-city';\n\nexport const onStaticGenerate: StaticGenerateHandler = async () => {\n  \/\/ Veritaban\u0131ndan veya API'den t\u00fcm blog yaz\u0131lar\u0131n\u0131 \u00e7ekin\n  \/\/ \u00d6rnek: Ger\u00e7ek bir veritaban\u0131 sorgusu veya API \u00e7a\u011fr\u0131s\u0131 burada yer alacak\n  const blogPosts = [\n    { slug: 'qwik-nedir' },\n    { slug: 'sitemap-optimiasyonu' },\n    { slug: 'performans-ipuclari' },\n  ];\n\n  return {\n    params: blogPosts.map((post) => ({ slug: post.slug })),\n  };\n};\n    <\/pre>\n
    <\/code><\/p>\n
    Bu onStaticGenerate<\/code> fonksiyonu, derleme s\u0131ras\u0131nda Qwik-City'ye \/blog\/qwik-nedir<\/code>, \/blog\/sitemap-optimiasyonu<\/code> gibi dinamik rotalar\u0131n var oldu\u011funu bildirir. Qwik-City bu bilgileri kullanarak hem sayfalar\u0131n \u00f6nceden olu\u015fturulmas\u0131n\u0131 (SSG) sa\u011flar hem de sitemap.xml dosyas\u0131na bu URL'leri ekler. Bu sayede, dinamik i\u00e7erikleriniz de arama motorlar\u0131 taraf\u0131ndan ke\u015ffedilebilir hale gelir.<\/p>\n
    \n        Uzman \u0130pucu: Dinamik i\u00e7erikleriniz i\u00e7in onStaticGenerate<\/code> i\u00e7inde yapt\u0131\u011f\u0131n\u0131z veri \u00e7ekme i\u015flemlerinin h\u0131zl\u0131 ve verimli oldu\u011fundan emin olun. Derleme s\u00fcresini uzatmamak i\u00e7in gereksiz yere b\u00fcy\u00fck veri setleri \u00e7ekmekten veya pahal\u0131 i\u015flemleri tekrarlamaktan ka\u00e7\u0131n\u0131n. \u00d6nbellekleme stratejilerini de\u011ferlendirmek faydal\u0131 olabilir.\n    <\/div>\n
    Bu ad\u0131mlar\u0131 uygulayarak Qwik uygulaman\u0131z\u0131n sitemap.xml dosyas\u0131n\u0131 ba\u015far\u0131yla olu\u015fturabilir ve i\u00e7eriklerinizi arama motorlar\u0131 i\u00e7in daha eri\u015filebilir hale getirebilirsiniz. Unutmay\u0131n, do\u011fru yap\u0131land\u0131rma ve dinamik i\u00e7eriklerin entegrasyonu, bo\u015f sitemap sorununu tamamen ortadan kald\u0131rman\u0131n anahtar\u0131d\u0131r.<\/p>\n
    Dinamik Rotalar ve Veritaban\u0131 \u0130\u00e7eriklerini Sitemap'e Nas\u0131l Dahil Ederiz?<\/h3>\n
    Qwik uygulamalar\u0131nda dinamik rotalar ve veritaban\u0131ndan beslenen i\u00e7erikler, genellikle sitemap olu\u015fturma s\u00fcrecinin en zorlu k\u0131sm\u0131n\u0131 olu\u015fturur. \u00c7\u00fcnk\u00fc bu i\u00e7erikler derleme zaman\u0131nda statik olarak tan\u0131mlanmam\u0131\u015f, \u00e7al\u0131\u015fma zaman\u0131nda bir kaynaktan (API, veritaban\u0131 vb.) \u00e7ekilen verilerle olu\u015fturulur. Ancak Qwik-City'nin g\u00fc\u00e7l\u00fc onStaticGenerate<\/code> (statik \u00fcretim i\u015fleyici) mekanizmas\u0131 sayesinde bu zorlu\u011fun \u00fcstesinden gelmek m\u00fcmk\u00fcnd\u00fcr. \u0130\u015fte bu s\u00fcreci nas\u0131l y\u00f6netece\u011finize dair detayl\u0131 bir rehber ve kod \u00f6rnekleri.<\/p>\n
    API \u00c7a\u011fr\u0131lar\u0131 ile Veri \u00c7ekme ve Sitemap'e Ekleme:<\/strong><\/p>\n
    Dinamik rotalar\u0131n sitemap'e dahil edilmesinin temel prensibi, derleme an\u0131nda (veya statik \u00fcretim a\u015famas\u0131nda) ilgili t\u00fcm dinamik yollar\u0131 (URL slug'lar\u0131n\u0131) programatik olarak belirlemektir. Bunun i\u00e7in genellikle bir API u\u00e7 noktas\u0131na veya do\u011frudan bir veritaban\u0131na sorgu yapman\u0131z gerekir. Diyelim ki bir blog siteniz var ve t\u00fcm blog yaz\u0131lar\u0131 bir REST API \u00fczerinden geliyor. src\/routes\/blog\/[slug]\/paths.ts<\/code> dosyan\u0131zda bu API'yi \u00e7a\u011f\u0131rarak t\u00fcm blog yaz\u0131lar\u0131n\u0131 \u00e7ekip, bunlar\u0131n slug'lar\u0131n\u0131 d\u00f6nd\u00fcren bir fonksiyon yazman\u0131z gerekir:<\/p>\n
    \n\/\/ src\/routes\/blog\/[slug]\/paths.ts\nimport type { StaticGenerateHandler } from '@builder.io\/qwik-city';\nimport fetch from 'node-fetch'; \/\/ Sunucu taraf\u0131nda fetch kullanmak i\u00e7in\n\ninterface BlogPost {\n  id: string;\n  slug: string;\n  updatedAt: string; \/\/ lastmod i\u00e7in kullan\u0131labilir\n}\n\nexport const onStaticGenerate: StaticGenerateHandler = async () => {\n  \/\/ Harici bir API'den blog yaz\u0131lar\u0131n\u0131 \u00e7ekme\n  const response = await fetch('https:\/\/api.your-blog.com\/posts');\n  const posts: BlogPost[] = await response.json();\n\n  \/\/ Her post i\u00e7in bir 'param' nesnesi olu\u015ftur\n  \/\/ 'params' anahtar\u0131 alt\u0131ndaki dizi, dinamik rotan\u0131n her bir parametresi i\u00e7in de\u011ferleri tutar.\n  \/\/ Bu durumda, [slug] dinamik rotas\u0131 i\u00e7in 'slug' de\u011feri\n  const params = posts.map((post) => ({ slug: post.slug }));\n\n  \/\/ Sitemap'e \u00f6zel meta veriler eklemek isterseniz, 'data' \u00f6zelli\u011fini kullanabilirsiniz\n  \/\/ \u00d6rne\u011fin, her sayfan\u0131n lastmod tarihini eklemek i\u00e7in:\n  const data = posts.map((post) => ({\n    slug: post.slug,\n    lastmod: post.updatedAt \/\/ Blog yaz\u0131s\u0131n\u0131n son g\u00fcncellenme tarihi\n  }));\n\n  return {\n    params,\n    \/\/ data: data, \/\/ \u0130ste\u011fe ba\u011fl\u0131 olarak, sitemap'te daha fazla detay sa\u011flamak i\u00e7in kullan\u0131labilir.\n  };\n};\n    <\/pre>\n
    <\/code><\/p>\n
    Bu kod blo\u011fu, onStaticGenerate<\/code> fonksiyonu i\u00e7inde nas\u0131l bir harici API \u00e7a\u011fr\u0131s\u0131 yap\u0131ld\u0131\u011f\u0131n\u0131 ve \u00e7ekilen verilerle dinamik rotalar i\u00e7in params<\/code> dizisinin nas\u0131l olu\u015fturuldu\u011funu g\u00f6sterir. qwik-city-sitemap<\/code> eklentisi, bu params<\/code> dizisini okuyarak her bir dinamik rotay\u0131 sitemap.xml dosyas\u0131na ekleyecektir. Ayr\u0131ca, lastmod<\/code> gibi ek meta verileri de data<\/code> \u00f6zelli\u011fi arac\u0131l\u0131\u011f\u0131yla iletebilirsiniz, b\u00f6ylece sitemap'iniz daha zengin bilgiler i\u00e7erir. Bu, arama motorlar\u0131n\u0131n i\u00e7eri\u011finizdeki de\u011fi\u015fiklikleri daha h\u0131zl\u0131 alg\u0131lamas\u0131na yard\u0131mc\u0131 olur.<\/p>\n
    Veritaban\u0131 Tabanl\u0131 \u0130\u00e7erikler \u0130\u00e7in \u00d6zel Sitemap \u00dcretimi:<\/strong><\/p>\n
    E\u011fer i\u00e7erikleriniz do\u011frudan bir veritaban\u0131nda (\u00f6rne\u011fin MongoDB, PostgreSQL) tutuluyorsa, onStaticGenerate<\/code> fonksiyonu i\u00e7inde veritaban\u0131 ba\u011flant\u0131s\u0131 kurup sorgulama yapman\u0131z gerekecektir. Bu durumda, sunucu ortam\u0131nda \u00e7al\u0131\u015faca\u011f\u0131n\u0131z i\u00e7in veritaban\u0131 s\u00fcr\u00fcc\u00fclerini (driver) do\u011fru bir \u015fekilde import etti\u011finizden ve kimlik bilgilerini g\u00fcvenli bir \u015fekilde y\u00f6netti\u011finizden emin olun.<\/p>\n
    \n\/\/ src\/routes\/urunler\/[productId]\/paths.ts\nimport type { StaticGenerateHandler } from '@builder.io\/qwik-city';\n\/\/ import { connectToDatabase } from '~\/server\/db'; \/\/ Kendi veritaban\u0131 ba\u011flant\u0131 fonksiyonunuz\n\ninterface Product {\n  id: string;\n  slug: string;\n  updated_at: string;\n}\n\nexport const onStaticGenerate: StaticGenerateHandler = async () => {\n  \/\/ Ger\u00e7ek bir veritaban\u0131 ba\u011flant\u0131s\u0131 ve sorgusu burada yer alacak\n  \/\/ const db = await connectToDatabase();\n  \/\/ const products: Product[] = await db.collection('products').find({}).toArray();\n\n  \/\/ \u00d6rnek veri (ger\u00e7ek uygulamada veritaban\u0131ndan \u00e7ekilecektir)\n  const products: Product[] = [\n    { id: '1', slug: 'akilli-telefon', updated_at: '2023-10-26T10:00:00Z' },\n    { id: '2', slug: 'kablosuz-kulaklik', updated_at: '2023-10-25T14:30:00Z' },\n  ];\n\n  const params = products.map((product) => ({ productId: product.slug }));\n\n  \/\/ Sitemap i\u00e7in lastmod verisi ekleme\n  const data = products.map((product) => ({\n    productId: product.slug,\n    lastmod: product.updated_at\n  }));\n\n  return {\n    params,\n    data,\n  };\n};\n    <\/pre>\n
    <\/code><\/p>\n
    Bu \u00f6rnek, bir veritaban\u0131ndan \u00fcr\u00fcn bilgilerini \u00e7ekip [productId]<\/code> dinamik rotas\u0131 i\u00e7in nas\u0131l params<\/code> olu\u015fturulaca\u011f\u0131n\u0131 g\u00f6sterir. Veritaban\u0131 sorgusu, statik derleme s\u0131ras\u0131nda \u00e7al\u0131\u015facak ve t\u00fcm \u00fcr\u00fcn sayfalar\u0131n\u0131n URL'lerini sitemap'e dahil edecektir. Bu teknik, b\u00fcy\u00fck \u00f6l\u00e7ekli ve dinamik i\u00e7erikli Qwik uygulamalar\u0131 i\u00e7in vazge\u00e7ilmezdir.<\/p>\n
    \n        Uzman \u0130pucu: onStaticGenerate<\/code> fonksiyonu i\u00e7inde kulland\u0131\u011f\u0131n\u0131z API anahtarlar\u0131 veya veritaban\u0131 kimlik bilgileri gibi hassas verileri do\u011frudan koda yazmaktan ka\u00e7\u0131n\u0131n. Bunlar\u0131 ortam de\u011fi\u015fkenleri (environment variables) arac\u0131l\u0131\u011f\u0131yla g\u00fcvenli bir \u015fekilde y\u00f6netin. Qwik ve Vite, bu t\u00fcr de\u011fi\u015fkenleri import.meta.env<\/code> \u00fczerinden eri\u015filebilir k\u0131lar.\n    <\/div>\n
    Bu y\u00f6ntemlerle, Qwik uygulaman\u0131z\u0131n dinamik rotalar\u0131n\u0131 ve veritaban\u0131 i\u00e7eriklerini sitemap.xml dosyas\u0131na ba\u015far\u0131yla entegre edebilirsiniz. Bu, sadece bo\u015f sitemap sorununu \u00e7\u00f6zmekle kalmaz, ayn\u0131 zamanda sitenizin SEO performans\u0131n\u0131 da \u00f6nemli \u00f6l\u00e7\u00fcde art\u0131r\u0131r, \u00e7\u00fcnk\u00fc arama motorlar\u0131 t\u00fcm \u00f6nemli i\u00e7eriklerinizi ke\u015ffedebilir ve dizine ekleyebilir.<\/p>\n
    Performans ve SEO \u0130\u00e7in Sitemap.xml Optimizasyon \u0130pu\u00e7lar\u0131 Nelerdir?<\/h2>\n
    Qwik uygulaman\u0131z i\u00e7in sitemap.xml dosyas\u0131n\u0131 ba\u015far\u0131yla olu\u015fturduktan sonra, s\u0131ra geldi bu sitemap'i daha da optimize etmeye. Sadece bir sitemap'e sahip olmak yeterli de\u011fildir; arama motorlar\u0131n\u0131n sitenizi en verimli \u015fekilde taramas\u0131n\u0131 sa\u011flamak i\u00e7in belirli optimizasyon tekniklerini uygulamak gereklidir. Bu b\u00f6l\u00fcmde, sitemap'inizi hem performans hem de SEO a\u00e7\u0131s\u0131ndan en \u00fcst d\u00fczeye \u00e7\u0131karacak ileri d\u00fczey ipu\u00e7lar\u0131n\u0131 ve p\u00fcf noktalar\u0131n\u0131 ele alaca\u011f\u0131z.<\/p>\n
    Sitemap Boyutland\u0131rma ve B\u00f6lme (Sitemap Index):<\/strong><\/p>\n
    Google ve di\u011fer arama motorlar\u0131, tek bir sitemap dosyas\u0131nda en fazla 50.000 URL veya 50MB (s\u0131k\u0131\u015ft\u0131r\u0131lmam\u0131\u015f) boyut s\u0131n\u0131r\u0131 belirlemi\u015ftir. E\u011fer siteniz bu limitleri a\u015facak kadar \u00e7ok sayfaya sahipse, sitemap'inizi birden fazla dosyaya b\u00f6lmeniz gereklidir. Bu durumda, bir \"sitemap indeksi\" dosyas\u0131 olu\u015fturursunuz. Sitemap indeksi, di\u011fer sitemap dosyalar\u0131n\u0131 listeleyen bir ana sitemap dosyas\u0131d\u0131r. Qwik-City, qwikCitySitemap<\/code> eklentisi arac\u0131l\u0131\u011f\u0131yla bu durumu otomatik olarak y\u00f6netebilir veya manuel olarak yap\u0131land\u0131rabilirsiniz.<\/p>\n
    \n\/\/ vite.config.ts'deki qwikCitySitemap yap\u0131land\u0131rmas\u0131na ekleyebilirsiniz\nqwikCitySitemap({\n  baseUrl: 'https:\/\/www.example.com\/',\n  \/\/ sitemap'i b\u00f6lme \u00f6zelli\u011fi\n  \/\/ S\u0131n\u0131r a\u015f\u0131ld\u0131\u011f\u0131nda birden fazla sitemap dosyas\u0131 olu\u015fturulacakt\u0131r.\n  maxItems: 45000, \/\/ \u00d6rne\u011fin, 45.000 URL'den sonra yeni bir sitemap dosyas\u0131 olu\u015ftur\n});\n    <\/pre>\n
    <\/code><\/p>\n
    Bu, sitenizin \u00f6l\u00e7e\u011fi b\u00fcy\u00fcd\u00fck\u00e7e arama motorlar\u0131n\u0131n t\u00fcm URL'lerinizi verimli bir \u015fekilde taramas\u0131n\u0131 garanti eder. \u00d6rne\u011fin, sitemap.xml<\/code> yerine sitemap_0.xml<\/code>, sitemap_1.xml<\/code> gibi dosyalar olu\u015furken, ana dizinde sitemap.xml<\/code> ad\u0131nda bir indeks dosyas\u0131 bunlar\u0131n hepsini listeleyecektir.<\/p>\n
    changefreq<\/code>, priority<\/code> ve lastmod<\/code> Kullan\u0131m\u0131:<\/strong><\/p>\n
    Sitemap protokol\u00fc, her URL i\u00e7in iste\u011fe ba\u011fl\u0131 olarak <\/code>, <\/code> ve <\/code> etiketlerini kullanman\u0131za olanak tan\u0131r:<\/p>\n