\nModern web projelerinde i\u00e7erik y\u00f6netimi, projenizin ba\u015far\u0131s\u0131 i\u00e7in kritik bir rol oynar. Sanity gibi servis tabanl\u0131 headless CMS \u00e7\u00f6z\u00fcmleri ba\u015flang\u0131\u00e7ta b\u00fcy\u00fck kolayl\u0131k sa\u011flarken, baz\u0131 durumlarda daha fazla kontrol, \u00f6zelle\u015ftirme veya kendi sunucular\u0131n\u0131zda bar\u0131nd\u0131rma ihtiyac\u0131 do\u011fabilir. \u0130\u015fte bu noktada, a\u00e7\u0131k kaynakl\u0131 ve self-host edilebilir bir alternatif olan Strapi’ye ge\u00e7i\u015f yapmak cazip bir se\u00e7enek haline gelebilir. Bu kapsaml\u0131 rehber, mevcut Sanity projenizi Strapi’ye nas\u0131l ta\u015f\u0131yaca\u011f\u0131n\u0131z\u0131 ad\u0131m ad\u0131m a\u00e7\u0131klayacak, veri ta\u015f\u0131ma, i\u00e7erik modelleme ve ba\u015far\u0131l\u0131 entegrasyon i\u00e7in size detayl\u0131 bir yol haritas\u0131 sunacak.\n<\/p>\n
\nG\u00fcn\u00fcm\u00fcz\u00fcn dijital d\u00fcnyas\u0131nda, h\u0131zla de\u011fi\u015fen ihtiya\u00e7lar ve artan beklentiler, \u015firketleri ve geli\u015ftiricileri esnek i\u00e7erik y\u00f6netim sistemleri (CMS) kullanmaya itmektedir. Headless CMS \u00e7\u00f6z\u00fcmleri, i\u00e7erik \u00fcretimi ile sunumunu ay\u0131rarak bu esnekli\u011fi sunar. Sanity.io, kullan\u0131c\u0131 dostu aray\u00fcz\u00fc, g\u00fc\u00e7l\u00fc GROQ\/GraphQL API’leri ve ger\u00e7ek zamanl\u0131 i\u015fbirli\u011fi yetenekleriyle \u00f6ne \u00e7\u0131kan pop\u00fcler bir SaaS (Hizmet Olarak Yaz\u0131l\u0131m) tabanl\u0131 headless CMS’tir. Ancak, her SaaS \u00e7\u00f6z\u00fcm\u00fcnde oldu\u011fu gibi, Sanity’nin de kendine \u00f6zg\u00fc limitasyonlar\u0131 bulunur. Projeniz b\u00fcy\u00fcd\u00fck\u00e7e, maliyetler, veri egemenli\u011fi, \u00f6zelle\u015ftirme derinli\u011fi veya altyap\u0131 \u00fczerindeki tam kontrol arzusu gibi fakt\u00f6rler, sizi farkl\u0131 bir y\u00f6ne bakmaya itebilir.\n<\/p>\n
\nStrapi ise, Node.js tabanl\u0131, a\u00e7\u0131k kaynakl\u0131 ve kendini bar\u0131nd\u0131r\u0131labilen (self-hostable) bir headless CMS olarak, bu noktada g\u00fc\u00e7l\u00fc bir alternatif sunar. Strapi’ye ge\u00e7i\u015f karar\u0131, genellikle uzun vadeli stratejik bir ad\u0131m olarak de\u011ferlendirilir ve a\u015fa\u011f\u0131daki nedenlere dayanabilir:\n<\/p>\n
\nBu rehber, Sanity’den Strapi’ye ge\u00e7i\u015fin nedenlerini detayl\u0131 bir \u015fekilde anlaman\u0131z\u0131n yan\u0131 s\u0131ra, bu karma\u015f\u0131k s\u00fcreci ad\u0131m ad\u0131m nas\u0131l y\u00f6netece\u011finizi pratik \u00f6rneklerle g\u00f6sterecektir. Ge\u00e7i\u015f s\u00fcreci, dikkatli planlama ve teknik bilgi gerektirir, ancak do\u011fru yakla\u015f\u0131mla projelerinize yeni bir soluk getirebilir ve gelecekteki b\u00fcy\u00fcme i\u00e7in sa\u011flam bir temel olu\u015fturabilir.\n<\/p>\n
\nSanity’den Strapi’ye ge\u00e7i\u015f yapmadan \u00f6nce, her iki headless CMS’in temel \u00f6zelliklerini, g\u00fc\u00e7l\u00fc ve zay\u0131f y\u00f6nlerini anlamak, ge\u00e7i\u015f stratejinizi belirlemede size yard\u0131mc\u0131 olacakt\u0131r. Bu b\u00f6l\u00fcm, her iki platforma genel bir bak\u0131\u015f sunarak, aralar\u0131ndaki temel farklar\u0131 ve ge\u00e7i\u015f karar\u0131n\u0131n hangi durumlarda mant\u0131kl\u0131 oldu\u011funu a\u00e7\u0131klayacakt\u0131r.\n<\/p>\n
\nSanity.io, “i\u00e7erik bir veridir” felsefesi \u00fczerine kurulu, ger\u00e7ek zamanl\u0131 i\u015fbirli\u011fi yeteneklerine sahip, bulut tabanl\u0131 bir headless CMS’tir. Geli\u015ftiricilerin ve i\u00e7erik \u00fcreticilerinin yap\u0131land\u0131r\u0131lm\u0131\u015f i\u00e7eri\u011fi kolayca olu\u015fturmas\u0131n\u0131, y\u00f6netmesini ve da\u011f\u0131tmas\u0131n\u0131 sa\u011flar. Sanity’nin en belirgin \u00f6zellikleri \u015funlard\u0131r:\n<\/p>\n
\nSanity’nin tercih edilme nedenleri aras\u0131nda h\u0131zl\u0131 kurulum, bak\u0131m y\u00fck\u00fcn\u00fcn olmamas\u0131 (SaaS oldu\u011fu i\u00e7in), g\u00fc\u00e7l\u00fc API’leri ve geli\u015ftirici dostu yap\u0131s\u0131 say\u0131labilir. Ancak, SaaS tabanl\u0131 olmas\u0131 nedeniyle platforma ba\u011f\u0131ml\u0131l\u0131k, kullan\u0131m artt\u0131k\u00e7a artan maliyetler ve baz\u0131 derin \u00f6zelle\u015ftirme k\u0131s\u0131tlamalar\u0131 dezavantajlar\u0131 aras\u0131ndad\u0131r.\n<\/p>\n
\nStrapi, geli\u015ftiricilere kendi altyap\u0131lar\u0131 \u00fczerinde tam kontrol sa\u011flayan, a\u00e7\u0131k kaynakl\u0131, Node.js tabanl\u0131, API odakl\u0131 bir headless CMS’tir. “Ba\u015fka bir Node.js projesi olu\u015fturmaktan daha h\u0131zl\u0131” slogan\u0131yla yola \u00e7\u0131kan Strapi, i\u00e7erik modelleme, API olu\u015fturma ve medya y\u00f6netimi gibi temel headless CMS i\u015flevlerini sunar. Temel \u00f6zellikleri:\n<\/p>\n
\nStrapi’nin pop\u00fclaritesi, sundu\u011fu kontrol, esneklik ve a\u00e7\u0131k kaynak felsefesinden gelir. Ba\u015flang\u0131\u00e7taki kurulum ve altyap\u0131 y\u00f6netimi ek bir \u00e7aba gerektirse de, uzun vadede maliyet avantaj\u0131 ve \u00f6zelle\u015ftirme yetenekleri sayesinde bir\u00e7ok proje i\u00e7in tercih sebebi olur. \u00d6zellikle GDPR veya di\u011fer veri koruma d\u00fczenlemeleri gibi belirli uyumluluk gereksinimleri olan kurumlar i\u00e7in Strapi ideal bir \u00e7\u00f6z\u00fcm olabilir.\n<\/p>\n
\n\u00d6zetle, Sanity h\u0131zl\u0131 ba\u015flang\u0131\u00e7lar ve bak\u0131m gerektirmeyen bir SaaS deneyimi sunarken, Strapi maksimum kontrol, \u00f6zelle\u015ftirme ve maliyet verimlili\u011fi arayanlar i\u00e7in g\u00fc\u00e7l\u00fc bir platformdur. Ge\u00e7i\u015f karar\u0131, projenizin mevcut ve gelecekteki ihtiya\u00e7lar\u0131na, b\u00fct\u00e7esine ve teknik ekibinizin yeteneklerine g\u00f6re dikkatlice de\u011ferlendirilmelidir.\n<\/p>\n
\nSanity’den Strapi’ye ge\u00e7i\u015fin en kritik ve teknik k\u0131sm\u0131, mevcut verilerinizi g\u00fcvenli ve do\u011fru bir \u015fekilde yeni platforma ta\u015f\u0131makt\u0131r. Bu b\u00f6l\u00fcm, ad\u0131m ad\u0131m bir rehber sunarak, bu s\u00fcreci sorunsuz bir \u015fekilde tamamlaman\u0131za yard\u0131mc\u0131 olacak ve olas\u0131 zorluklara kar\u015f\u0131 \u00e7\u00f6z\u00fcmler \u00f6nerecektir.\n<\/p>\n
\nGe\u00e7i\u015f s\u00fcrecinin ilk ad\u0131m\u0131, Sanity’deki mevcut t\u00fcm verilerinizi d\u0131\u015fa aktarmakt\u0131r. Sanity CLI (Komut Sat\u0131r\u0131 Aray\u00fcz\u00fc) bu i\u015flemi olduk\u00e7a basit hale getirir.\n<\/p>\n
\nSanity CLI’yi zaten y\u00fckl\u00fc de\u011filse, a\u015fa\u011f\u0131daki komutla y\u00fckleyebilirsiniz:\n<\/p>\n
\nnpm install -g @sanity\/cli\n<\/pre>\n<\/code><\/p>\n
\nArd\u0131ndan, projenizin k\u00f6k dizininde veya herhangi bir yerden a\u015fa\u011f\u0131daki komutu kullanarak verilerinizi d\u0131\u015fa aktarabilirsiniz. Bu komut, belirtilen dataset'teki t\u00fcm d\u00f6k\u00fcmanlar\u0131 NDJSON (New-line Delimited JSON) format\u0131nda s\u0131k\u0131\u015ft\u0131r\u0131lm\u0131\u015f bir tar.gz dosyas\u0131na kaydeder.\n<\/p>\n
\nsanity dataset export production sanity-export.tar.gz --raw\n<\/pre>\n<\/code><\/p>\n
\nBu komuttaki production<\/code> varsay\u0131lan dataset ad\u0131d\u0131r. Farkl\u0131 bir dataset kullan\u0131yorsan\u0131z, o dataset ad\u0131n\u0131 belirtmeniz gerekir. --raw<\/code> bayra\u011f\u0131, meta verileri de dahil olmak \u00fczere t\u00fcm ham verinin d\u0131\u015fa aktar\u0131lmas\u0131n\u0131 sa\u011flar. D\u0131\u015fa aktarma tamamland\u0131\u011f\u0131nda, sanity-export.tar.gz<\/code> adl\u0131 bir dosya olu\u015fturulacakt\u0131r. Bu dosyay\u0131 a\u00e7t\u0131\u011f\u0131n\u0131zda, her sat\u0131r\u0131n bir Sanity d\u00f6k\u00fcman\u0131 oldu\u011fu .ndjson<\/code> uzant\u0131l\u0131 bir dosya bulacaks\u0131n\u0131z. Bu dosya, Strapi'ye aktaraca\u011f\u0131m\u0131z ana veri kayna\u011f\u0131m\u0131z olacak.\n<\/p>\nAd\u0131m 2: Yeni Bir Strapi Projesi Kurma<\/h3>\n
\nVerileriniz haz\u0131r oldu\u011funda, bir sonraki ad\u0131m yeni bir Strapi projesi kurmakt\u0131r. Strapi, Node.js tabanl\u0131 oldu\u011fu i\u00e7in bilgisayar\u0131n\u0131zda Node.js ve npm (veya Yarn) kurulu olmal\u0131d\u0131r.\n<\/p>\n
\nA\u015fa\u011f\u0131daki komutla h\u0131zl\u0131ca yeni bir Strapi projesi olu\u015fturabilirsiniz:\n<\/p>\n
\nnpx create-strapi-app@latest my-strapi-project --quickstart\n<\/pre>\n<\/code><\/p>\n
\nmy-strapi-project<\/code> yerine projenizin ad\u0131n\u0131 yazabilirsiniz. --quickstart<\/code> bayra\u011f\u0131, varsay\u0131lan olarak SQLite veritaban\u0131 ile h\u0131zl\u0131 bir kurulum yapar. E\u011fer PostgreSQL, MySQL veya MongoDB gibi farkl\u0131 bir veritaban\u0131 kullanmak istiyorsan\u0131z, --quickstart<\/code> bayra\u011f\u0131n\u0131 kald\u0131rabilir ve kurulum s\u0131ras\u0131nda veritaban\u0131 se\u00e7iminizi yapabilirsiniz. Kurulum tamamland\u0131\u011f\u0131nda, Strapi otomatik olarak taray\u0131c\u0131n\u0131zda y\u00f6netici panelini a\u00e7acak ve ilk y\u00f6netici hesab\u0131n\u0131z\u0131 olu\u015fturman\u0131z\u0131 isteyecektir. Bu ad\u0131mlar\u0131 tamamlayarak Strapi'yi kullan\u0131ma haz\u0131r hale getirin.\n<\/p>\nAd\u0131m 3: Strapi \u0130\u00e7erik T\u00fcrlerini (Content Types) Olu\u015fturma<\/h3>\n
\nSanity'deki her _type<\/code> (\u00f6rne\u011fin, \"post\", \"author\", \"category\") Strapi'de bir \u0130\u00e7erik T\u00fcr\u00fc'ne (Content Type) kar\u015f\u0131l\u0131k gelir. Verilerinizi aktarmadan \u00f6nce, bu i\u00e7erik t\u00fcrlerini Strapi'de olu\u015fturman\u0131z gerekmektedir. Strapi'nin y\u00f6netici paneli \u00fczerinden \"Content-Type Builder\" kullanarak bu i\u015flemi g\u00f6rsel olarak yapabilirsiniz.\n<\/p>\n\nSanity schemas\u0131n\u0131 dikkatlice inceleyin ve her bir alan\u0131n (field) t\u00fcr\u00fcn\u00fc (string, boolean, number, image, reference, array, portable text vb.) Strapi'deki kar\u015f\u0131l\u0131\u011f\u0131na e\u015fle\u015ftirin.\n<\/p>\n
\n- \n Metin Alanlar\u0131:<\/strong> Sanity'deki
string<\/code>, text<\/code> alanlar\u0131 Strapi'de Text<\/code> veya Rich Text<\/code> (Markdown\/Lexical) olarak e\u015fle\u015ftirilir.\n <\/li>\n- \n Say\u0131sal Alanlar:<\/strong> Sanity'deki
number<\/code> alanlar\u0131 Strapi'de Number<\/code> olarak e\u015fle\u015ftirilir.\n <\/li>\n- \n Boolean Alanlar:<\/strong> Sanity'deki
boolean<\/code> alanlar\u0131 Strapi'de Boolean<\/code> olarak e\u015fle\u015ftirilir.\n <\/li>\n- \n Tarih Alanlar\u0131:<\/strong> Sanity'deki
datetime<\/code> veya date<\/code> alanlar\u0131 Strapi'de Date<\/code> veya DateTime<\/code> olarak e\u015fle\u015ftirilir.\n <\/li>\n- \n G\u00f6rsel ve Medya Varl\u0131klar\u0131:<\/strong> Sanity'deki
image<\/code> t\u00fcrleri Strapi'de Media<\/code> t\u00fcr\u00fcne kar\u015f\u0131l\u0131k gelir.\n <\/li>\n- \n \u0130li\u015fkiler (References):<\/strong> Sanity'deki
reference<\/code> alanlar\u0131, Strapi'de Relation<\/code> (\u0130li\u015fki) alanlar\u0131na kar\u015f\u0131l\u0131k gelir. \u00d6rne\u011fin, bir \"Post\"un bir \"Author\"a referans\u0131, Strapi'de \"Post\" i\u00e7erik t\u00fcr\u00fcnde \"Author\" ile tek-\u00e7ok ili\u015fki (many-to-one) olarak tan\u0131mlanabilir.\n <\/li>\n- \n Portable Text:<\/strong> Sanity'nin Portable Text yap\u0131s\u0131 Strapi'de do\u011frudan bir kar\u015f\u0131l\u0131\u011fa sahip de\u011fildir. Genellikle Strapi'nin
Rich Text<\/code> alan\u0131 (Markdown veya Lexical edit\u00f6r) kullan\u0131l\u0131r. Bu, Sanity Portable Text verilerini Markdown veya HTML format\u0131na d\u00f6n\u00fc\u015ft\u00fcrmeniz gerekti\u011fi anlam\u0131na gelir. Bu d\u00f6n\u00fc\u015f\u00fcm i\u00e7in \u00f6zel bir script yazman\u0131z gerekecektir.\n <\/li>\n<\/ul>\n\nHer i\u00e7erik t\u00fcr\u00fcn\u00fc ve alan\u0131n\u0131 dikkatlice tan\u0131mlad\u0131ktan sonra, Strapi, veritaban\u0131n\u0131zda ilgili tablolar\u0131 ve API u\u00e7 noktalar\u0131n\u0131 otomatik olarak olu\u015fturacakt\u0131r.\n<\/p>\n
Ad\u0131m 4: Verileri Strapi'ye Aktarma Script'i Geli\u015ftirme<\/h3>\n
\nBu ad\u0131m, ge\u00e7i\u015fin en karma\u015f\u0131k k\u0131sm\u0131d\u0131r. Sanity'den d\u0131\u015fa aktard\u0131\u011f\u0131n\u0131z NDJSON dosyas\u0131n\u0131 okuyacak ve her bir d\u00f6k\u00fcman\u0131 Strapi API'sine g\u00f6ndererek yeni i\u00e7erikler olu\u015fturacak bir Node.js scripti yazman\u0131z gerekecek.\n<\/p>\n
\n\u00d6ncelikle, Strapi'nizin API'sine eri\u015fmek i\u00e7in bir API Token olu\u015fturman\u0131z gerekecektir. Strapi Admin panelinde \"Settings\" -> \"API Tokens\" b\u00f6l\u00fcm\u00fcne giderek tam eri\u015fim (Full Access) iznine sahip bir token olu\u015fturun.\n<\/p>\n
\nA\u015fa\u011f\u0131daki \u00f6rnek, Sanity verilerini okuyup temel metin alanlar\u0131n\u0131 Strapi'ye nas\u0131l aktaraca\u011f\u0131n\u0131 g\u00f6steren basit bir Node.js scriptidir. Bu script'i projenizin ihtiya\u00e7lar\u0131na g\u00f6re uyarlaman\u0131z gerekmektedir.\n<\/p>\n
\nconst fs = require('fs');\nconst path = require('path');\nconst axios = require('axios');\nconst readline = require('readline');\nconst tar = require('tar'); \/\/ Tar dosyas\u0131n\u0131 a\u00e7mak i\u00e7in\n\nconst strapiApiUrl = 'http:\/\/localhost:1337\/api'; \/\/ Kendi Strapi API URL'nizi girin\nconst sanityExportFilePath = 'sanity-export.tar.gz'; \/\/ Sanity export dosyan\u0131z\u0131n yolu\nconst ndjsonExtractedPath = 'sanity-export.ndjson'; \/\/ \u00c7\u0131kar\u0131lacak NDJSON dosyas\u0131n\u0131n ad\u0131\n\nasync function extractTarGz() {\n console.log('Sanity export dosyas\u0131n\u0131 \u00e7\u0131kar\u0131l\u0131yor...');\n await tar.x({\n file: sanityExportFilePath,\n C: path.dirname(ndjsonExtractedPath) \/\/ Ayn\u0131 dizine \u00e7\u0131kar\n });\n console.log('Sanity export dosyas\u0131 ba\u015far\u0131yla \u00e7\u0131kar\u0131ld\u0131.');\n \/\/ Tar dosyas\u0131ndan \u00e7\u0131kar\u0131lan .ndjson dosyas\u0131n\u0131n ger\u00e7ek ad\u0131n\u0131 bulmam\u0131z gerekebilir\n \/\/ Genellikle 'export.ndjson' veya benzeri bir isimle \u00e7\u0131kar.\n \/\/ Varsay\u0131lan olarak export.ndjson ad\u0131yla \u00e7\u0131kt\u0131\u011f\u0131n\u0131 varsayal\u0131m\n return path.join(path.dirname(ndjsonExtractedPath), 'export.ndjson'); \n}\n\nasync function importData() {\n const finalNdjsonPath = await extractTarGz();\n\n const strapiAuthToken = 'YOUR_STRAPI_ADMIN_API_TOKEN'; \/\/ Strapi admin panelinden alaca\u011f\u0131n\u0131z API Token\n const headers = {\n 'Content-Type': 'application\/json',\n 'Authorization': Bearer ${strapiAuthToken}<\/code>\n };\n\n const fileStream = fs.createReadStream(finalNdjsonPath);\n const rl = readline.createInterface({\n input: fileStream,\n crlfDelay: Infinity\n });\n\n console.log('Veri i\u00e7e aktarma s\u00fcreci ba\u015flat\u0131l\u0131yor...');\n\n for await (const line of rl) {\n if (!line.trim()) continue; \/\/ Bo\u015f sat\u0131rlar\u0131 atla\n try {\n const sanityDoc = JSON.parse(line);\n\n \/\/ Sanity \"_type\" alan\u0131n\u0131 Strapi i\u00e7erik t\u00fcr\u00fc ad\u0131yla e\u015fle\u015ftirin\n let strapiContentType = '';\n let isDraft = sanityDoc._id.startsWith('drafts.');\n\n if (sanityDoc._type === 'post') {\n strapiContentType = 'posts';\n } else if (sanityDoc._type === 'author') {\n strapiContentType = 'authors';\n } else if (sanityDoc._type === 'category') {\n strapiContentType = 'categories';\n }\n \/\/ Di\u011fer i\u00e7erik t\u00fcrleri i\u00e7in else if bloklar\u0131 ekleyin\n \/\/ \u00d6rne\u011fin: else if (sanityDoc._type === 'product') { strapiContentType = 'products'; }\n\n \/\/ Taslaklar\u0131 atla veya farkl\u0131 ele al\n if (isDraft) {\n console.log(Skipping draft document: ${sanityDoc._id}<\/code>);\n continue;\n }\n\n if (strapiContentType) {\n const strapiData = {\n data: {\n \/\/ Sanity alanlar\u0131n\u0131 Strapi alanlar\u0131na e\u015fle\u015ftirin\n \/\/ Portable Text d\u00f6n\u00fc\u015f\u00fcm\u00fc i\u00e7in \u00f6rnek:\n \/\/ body: convertPortableTextToMarkdown(sanityDoc.body),\n title: sanityDoc.title,\n slug: sanityDoc.slug?.current,\n \/\/ Di\u011fer alanlar\u0131 buraya ekleyin. \u0130li\u015fkiler ve medya varl\u0131klar\u0131 sonraki ad\u0131mlarda ele al\u0131nacak.\n \/\/ \u00d6rnek: description: sanityDoc.description,\n \/\/ publishedAt: sanityDoc.publishedAt,\n \/\/ Sanity'deki \"_createdAt\" ve \"_updatedAt\" alanlar\u0131n\u0131 Strapi'ye ta\u015f\u0131yabiliriz.\n publishedAt: sanityDoc._createdAt || new Date().toISOString(), \/\/ Varsay\u0131lan olarak olu\u015fturulma tarihi\n createdAt: sanityDoc._createdAt,\n updatedAt: sanityDoc._updatedAt,\n sanityId: sanityDoc._id \/\/ Orjinal Sanity ID'sini saklamak faydal\u0131 olabilir\n }\n };\n\n console.log(Importing ${sanityDoc._id} (${sanityDoc._type}) to ${strapiContentType}...<\/code>);\n await axios.post(${strapiApiUrl}\/${strapiContentType}<\/code>, strapiData, { headers });\n console.log(Successfully imported ${sanityDoc._id}<\/code>);\n } else {\n console.warn(No mapping found for Sanity type: ${sanityDoc._type}. Skipping.<\/code>);\n }\n } catch (error) {\n console.error(Error processing line: ${line}<\/code>, error.response ? error.response.data : error.message);\n }\n }\n console.log('Veri i\u00e7e aktarma s\u00fcreci tamamland\u0131.');\n}\n\n\/\/ Portable Text'i Markdown'a d\u00f6n\u00fc\u015ft\u00fcrmek i\u00e7in basit bir \u00f6rnek (ger\u00e7ek bir k\u00fct\u00fcphane kullan\u0131n)\nfunction convertPortableTextToMarkdown(portableText) {\n if (!portableText) return '';\n \/\/ Bu k\u0131s\u0131m karma\u015f\u0131k olabilir ve kapsaml\u0131 bir k\u00fct\u00fcphane gerektirir.\n \/\/ \u00d6rnek olarak sadece paragraflar\u0131 birle\u015ftiriyoruz.\n return portableText.map(block => {\n if (block._type === 'block' && block.children) {\n return block.children.map(span => span.text).join('');\n }\n return '';\n }).join('\\n\\n');\n}\n\nimportData().catch(console.error);\n<\/pre>\n<\/code><\/p>\n
Uzman \u0130pucu: Sanity'nin Portable Text yap\u0131s\u0131n\u0131 Strapi'nin Rich Text (Markdown\/Lexical) alan\u0131na d\u00f6n\u00fc\u015ft\u00fcrmek i\u00e7in \u00f6zel bir parser yazman\u0131z veya @sanity\/block-content-to-markdown<\/code> gibi k\u00fct\u00fcphaneleri kullanman\u0131z gerekebilir. Bu, i\u00e7eri\u011fin do\u011fru formatta aktar\u0131lmas\u0131 i\u00e7in kritik \u00f6neme sahiptir.<\/div>\nAd\u0131m 5: G\u00f6r\u00fcnt\u00fc ve Di\u011fer Medya Varl\u0131klar\u0131n\u0131 Ta\u015f\u0131ma<\/h3>\n
\nG\u00f6r\u00fcnt\u00fc ve di\u011fer medya varl\u0131klar\u0131n\u0131n ta\u015f\u0131nmas\u0131, genellikle iki a\u015famal\u0131 bir s\u00fcre\u00e7tir:\n<\/p>\n
\n- \n Sanity CDN'inden Varl\u0131klar\u0131 \u0130ndirme:<\/strong> Sanity'den d\u0131\u015fa aktar\u0131lan verilerdeki g\u00f6rsel referanslar\u0131n\u0131 kullanarak (genellikle bir asset ID i\u00e7erirler), bu g\u00f6rselleri Sanity'nin CDN'inden programatik olarak indirmeniz gerekir.\n <\/li>\n
- \n Strapi'ye Y\u00fckleme:<\/strong> \u0130ndirilen g\u00f6rselleri Strapi'nin medya k\u00fct\u00fcphanesine y\u00fcklemek i\u00e7in Strapi'nin upload API'sini kullan\u0131n. Bu s\u0131rada, g\u00f6rsellerin orijinal dosya adlar\u0131n\u0131 ve meta verilerini korumaya \u00e7al\u0131\u015f\u0131n.\n <\/li>\n<\/ol>\n
\nBu i\u015flem i\u00e7in ayr\u0131 bir script yazman\u0131z veya ana aktarma scriptinize entegre etmeniz gerekebilir. Strapi'nin \/api\/upload<\/code> u\u00e7 noktas\u0131na multipart\/form-data<\/code> iste\u011fi g\u00f6ndererek dosyalar\u0131 y\u00fckleyebilirsiniz. Y\u00fckleme sonras\u0131 Strapi, size bir dosya nesnesi d\u00f6nd\u00fcrecektir. Bu nesnedeki ID'yi, i\u00e7eriklerinizdeki g\u00f6rsel referanslar\u0131n\u0131 g\u00fcncellemek i\u00e7in kullanacaks\u0131n\u0131z.\n<\/p>\nAd\u0131m 6: \u0130li\u015fkileri ve Referanslar\u0131 G\u00fcncelleme<\/h3>\n
\nSanity ve Strapi, d\u00f6k\u00fcmanlar aras\u0131ndaki ili\u015fkileri farkl\u0131 \u015fekillerde y\u00f6netir. Sanity, referanslar\u0131 _ref<\/code> alanlar\u0131 arac\u0131l\u0131\u011f\u0131yla d\u00f6k\u00fcman ID'leri \u00fczerinden kurarken, Strapi kendi i\u00e7 ID'lerini kullan\u0131r. Bu nedenle, verileri aktar\u0131rken eski Sanity ID'leri ile yeni Strapi ID'leri aras\u0131nda bir e\u015fle\u015fme (mapping) olu\u015fturman\u0131z gerekmektedir.\n<\/p>\n\n- \n \u0130lk Ge\u00e7i\u015f (Basit Veriler):<\/strong> \u0130lk olarak, ili\u015fki i\u00e7ermeyen temel metin ve say\u0131sal verileri Strapi'ye aktar\u0131n. Bu s\u0131rada, her bir aktar\u0131lan Sanity d\u00f6k\u00fcman\u0131n\u0131n orijinal Sanity
_id<\/code>'sini ve Strapi taraf\u0131ndan atanan yeni id<\/code>'sini bir e\u015fleme tablosunda (\u00f6rne\u011fin, bir JavaScript objesi veya Map yap\u0131s\u0131) saklay\u0131n. Bu e\u015fle\u015fmeyi, olu\u015fturdu\u011funuz i\u00e7erik t\u00fcr\u00fcne sanityId<\/code> gibi \u00f6zel bir alan ekleyerek de kal\u0131c\u0131 hale getirebilirsiniz.\n <\/li>\n- \n \u0130kinci Ge\u00e7i\u015f (\u0130li\u015fkiler):<\/strong> T\u00fcm temel veriler aktar\u0131ld\u0131ktan sonra, ikinci bir script \u00e7al\u0131\u015ft\u0131r\u0131n. Bu script, daha \u00f6nce kaydedilen e\u015fleme tablosunu kullanarak Sanity d\u00f6k\u00fcmanlar\u0131ndaki
_ref<\/code> alanlar\u0131n\u0131 bulacak ve bunlar\u0131 ilgili Strapi i\u00e7erik t\u00fcr\u00fcn\u00fcn yeni ID'leriyle g\u00fcncelleyecektir. \u00d6rne\u011fin, bir \"Post\"un \"Author\" referans\u0131n\u0131 g\u00fcncellemek i\u00e7in, \"Post\" i\u00e7eri\u011fini Strapi API'si \u00fczerinden GET ile \u00e7ekip, \"author\" alan\u0131ndaki eski Sanity ID'sini yeni Strapi Author ID'si ile de\u011fi\u015ftirip, ard\u0131ndan PUT iste\u011fi ile g\u00fcncellemeyi yapmal\u0131s\u0131n\u0131z.\n <\/li>\n<\/ol>\n\nBu ad\u0131m, veri b\u00fct\u00fcnl\u00fc\u011f\u00fcn\u00fc sa\u011flamak i\u00e7in \u00e7ok \u00f6nemlidir ve genellikle en \u00e7ok dikkat gerektiren k\u0131s\u0131md\u0131r. \u0130li\u015fkilerin karma\u015f\u0131kl\u0131\u011f\u0131na ba\u011fl\u0131 olarak, bu script'i iteratif olarak geli\u015ftirmeniz gerekebilir.\n<\/p>\n
Geli\u015fmi\u015f Ge\u00e7i\u015f Stratejileri ve \u0130pu\u00e7lar\u0131<\/h2>\n
\nGe\u00e7i\u015f s\u00fcreci yaln\u0131zca temel veri aktar\u0131m\u0131ndan ibaret de\u011fildir. B\u00fcy\u00fck projeler ve \u00f6zel gereksinimler i\u00e7in a\u015fa\u011f\u0131daki geli\u015fmi\u015f stratejileri ve ipu\u00e7lar\u0131n\u0131 g\u00f6z \u00f6n\u00fcnde bulundurman\u0131z, s\u00fcreci daha verimli ve sorunsuz hale getirecektir.\n<\/p>\n
B\u00fcy\u00fck Veri Setleri \u0130\u00e7in Optimizasyon<\/h3>\n
\nOn binlerce veya y\u00fcz binlerce d\u00f6k\u00fcman\u0131n bulundu\u011fu projelerde, veri aktar\u0131m\u0131n\u0131 tek seferde yapmak hem performans sorunlar\u0131na yol a\u00e7abilir hem de hatalar\u0131n tespitini zorla\u015ft\u0131rabilir.\n<\/p>\n
\n- \n Toplu \u0130\u015fleme (Batch Processing):<\/strong> Verileri k\u00fc\u00e7\u00fck partiler halinde (\u00f6rne\u011fin, 100 veya 500 d\u00f6k\u00fcmanl\u0131k gruplar halinde) i\u015fleyin. Bu, bellek t\u00fcketimini azalt\u0131r ve API rate limitlerine tak\u0131lma olas\u0131l\u0131\u011f\u0131n\u0131 d\u00fc\u015f\u00fcr\u00fcr. Her toplu i\u015fleme sonras\u0131 bir mola vermek veya ilerlemeyi kaydetmek faydal\u0131 olabilir.\n <\/li>\n
- \n API Rate Limiting:<\/strong> Strapi veya kulland\u0131\u011f\u0131n\u0131z bulut sa\u011flay\u0131c\u0131s\u0131n\u0131n (g\u00f6r\u00fcnt\u00fc y\u00fcklemeleri i\u00e7in) API \u00e7a\u011fr\u0131 limitleri olabilir. Script'inize bir gecikme (delay) mekanizmas\u0131 ekleyerek API \u00e7a\u011fr\u0131lar\u0131n\u0131 yava\u015flat\u0131n ve limitlerin a\u015f\u0131lmas\u0131n\u0131 \u00f6nleyin.\n <\/li>\n
- \n Do\u011frudan Veritaban\u0131 Ge\u00e7i\u015fleri:<\/strong> E\u011fer teknik ekibiniz veritaban\u0131 y\u00f6netimi konusunda deneyimliyse, Strapi'nin kulland\u0131\u011f\u0131 veritaban\u0131na (PostgreSQL, MySQL vb.) do\u011frudan SQL sorgular\u0131 veya NoSQL komutlar\u0131 arac\u0131l\u0131\u011f\u0131yla veri aktarmak daha h\u0131zl\u0131 olabilir. Ancak bu y\u00f6ntem, Strapi'nin ORM (Object-Relational Mapping) yap\u0131s\u0131n\u0131 ve i\u00e7 ili\u015fkilerini do\u011fru bir \u015fekilde taklit etmeyi gerektirir, bu da daha riskli olabilir. Bu yolu se\u00e7erseniz, Strapi'nin i\u00e7erik modelleme mant\u0131\u011f\u0131n\u0131 ve veritaban\u0131 \u015femas\u0131n\u0131 derinlemesine anlaman\u0131z gerekir.\n <\/li>\n
- \n Hata Y\u00f6netimi ve Yeniden Deneme Mekanizmalar\u0131:<\/strong> B\u00fcy\u00fck aktar\u0131mlarda hatalar ka\u00e7\u0131n\u0131lmazd\u0131r. Script'inizin ba\u015far\u0131s\u0131z olan kay\u0131tlar\u0131 loglamas\u0131n\u0131 ve belirli bir strateji dahilinde (\u00f6rne\u011fin, belirli bir s\u00fcre sonra tekrar deneme) yeniden i\u015flemeye \u00e7al\u0131\u015fmas\u0131n\u0131 sa\u011flay\u0131n.\n <\/li>\n<\/ul>\n
\u00d6zel Alanlar ve Plugin Entegrasyonu<\/h3>\n
\nSanity'deki baz\u0131 \u00f6zel alanlar veya pluginler, Strapi'de do\u011frudan bir kar\u015f\u0131l\u0131\u011fa sahip olmayabilir. Bu gibi durumlarda:\n<\/p>\n
\n- \n \u00d6zel Alanlar Geli\u015ftirme:<\/strong> Strapi, \u00f6zel alanlar (Custom Fields) olu\u015fturman\u0131za olanak tan\u0131r. Sanity'deki karma\u015f\u0131k veri yap\u0131lar\u0131n\u0131 veya benzersiz alan t\u00fcrlerini taklit etmek i\u00e7in kendi \u00f6zel alanlar\u0131n\u0131z\u0131 geli\u015ftirerek Strapi y\u00f6netici panelini geni\u015fletebilirsiniz.\n <\/li>\n
- \n Plugin Geli\u015ftirme\/Kullanma:<\/strong> Sanity'deki bir \u00f6zelli\u011fin (\u00f6rne\u011fin, bir \u00f6zel entegrasyon veya i\u00e7erik d\u00fczenleme arac\u0131) Strapi'de kar\u015f\u0131l\u0131\u011f\u0131 yoksa, mevcut bir Strapi plugin'ini kullanabilir veya kendi plugin'inizi geli\u015ftirebilirsiniz. Strapi'nin plugin sistemi olduk\u00e7a esnektir.\n <\/li>\n
- \n Frontend Taraf\u0131nda \u00c7\u00f6z\u00fcmler:<\/strong> Baz\u0131 durumlarda, Sanity'deki bir \u00f6zellik (\u00f6rne\u011fin, bir sunum format\u0131), Strapi'ye ham veri olarak aktar\u0131labilir ve bu verinin i\u015flenmesi veya g\u00f6r\u00fcnt\u00fclenmesi frontend uygulamas\u0131na b\u0131rak\u0131labilir.\n <\/li>\n<\/ul>\n
Ge\u00e7i\u015f Sonras\u0131 Do\u011frulama ve Test<\/h3>\n
\nVeri aktar\u0131m\u0131 tamamland\u0131ktan sonra, yeni Strapi kurulumunuzun do\u011fru \u00e7al\u0131\u015ft\u0131\u011f\u0131ndan ve t\u00fcm verilerin eksiksiz ve do\u011fru bir \u015fekilde aktar\u0131ld\u0131\u011f\u0131ndan emin olmak i\u00e7in kapsaml\u0131 bir do\u011frulama ve test s\u00fcreci \u015fartt\u0131r.\n<\/p>\n
\n- \n Veri Tutarl\u0131l\u0131\u011f\u0131 Kontrolleri:<\/strong> Rastgele se\u00e7ilmi\u015f i\u00e7erik \u00f6rneklerini hem Sanity'de hem de Strapi'de kar\u015f\u0131la\u015ft\u0131r\u0131n. \u00d6zellikle ili\u015fkilerin, g\u00f6rsellerin ve zengin metin alanlar\u0131n\u0131n do\u011fru aktar\u0131ld\u0131\u011f\u0131ndan emin olun. Sanity'deki toplam d\u00f6k\u00fcman say\u0131s\u0131 ile Strapi'deki toplam giri\u015f say\u0131s\u0131n\u0131n e\u015fle\u015fip e\u015fle\u015fmedi\u011fini kontrol edin.\n <\/li>\n
- \n API Testleri:<\/strong> Strapi'nin REST ve\/veya GraphQL API'leri \u00fczerinden i\u00e7eriklere eri\u015fmeyi deneyin. Sorgular\u0131n beklendi\u011fi gibi \u00e7al\u0131\u015ft\u0131\u011f\u0131ndan ve do\u011fru verileri d\u00f6nd\u00fcrd\u00fc\u011f\u00fcnden emin olun.\n <\/li>\n
- \n Frontend Entegrasyon Testleri:<\/strong> Frontend uygulaman\u0131z\u0131 yeni Strapi API'sine ba\u011flayarak t\u00fcm sayfalar\u0131n, bile\u015fenlerin ve i\u015flevlerin d\u00fczg\u00fcn \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 test edin. \u00d6zellikle dinamik olarak y\u00fcklenen i\u00e7eriklerin (blog yaz\u0131lar\u0131, \u00fcr\u00fcn listeleri, kullan\u0131c\u0131 profilleri vb.) sorunsuz bir \u015fekilde g\u00f6r\u00fcnt\u00fclendi\u011finden emin olun.\n <\/li>\n
- \n Performans Testleri:<\/strong> Strapi'nin y\u00fck alt\u0131nda nas\u0131l performans g\u00f6sterdi\u011fini de\u011ferlendirin. Veritaban\u0131 sorgular\u0131n\u0131 optimize etmek veya \u00f6nbellekleme mekanizmalar\u0131 kurmak gerekebilir.\n <\/li>\n<\/ul>\n
Mobil Uyumlu Tasar\u0131m ve API Eri\u015fimi<\/h3>\n
\nStrapi, API odakl\u0131 bir CMS oldu\u011fu i\u00e7in, frontend uygulaman\u0131z\u0131n mobil uyumlulu\u011fu Strapi'den ba\u011f\u0131ms\u0131z olarak geli\u015ftirilir. Ancak Strapi'nin sundu\u011fu esnek API'ler, farkl\u0131 cihazlar ve ekran boyutlar\u0131 i\u00e7in optimize edilmi\u015f i\u00e7erik sunman\u0131za olanak tan\u0131r.\n<\/p>\n
\n- \n Duyarl\u0131 \u0130\u00e7erik:<\/strong> Strapi'nin medya k\u00fct\u00fcphanesi, g\u00f6rsellerin farkl\u0131 boyutlarda optimize edilmi\u015f versiyonlar\u0131n\u0131 sunabilir. Frontend uygulaman\u0131zda
<\/code> etiketi veya CSS media query<\/code>'leri kullanarak, cihaz\u0131n \u00f6zelliklerine g\u00f6re en uygun g\u00f6rselleri y\u00fckleyebilirsiniz.\n <\/li>\n- \n API S\u00fcr\u00fcmleme:<\/strong> Frontend'lerinizin farkl\u0131 mobil ve web platformlar\u0131nda farkl\u0131 ihtiya\u00e7lar\u0131 varsa, Strapi'nin API'sini s\u00fcr\u00fcmleyerek (\u00f6rne\u011fin,
\/api\/v1<\/code>, \/api\/v2<\/code>) uyumlulu\u011fu s\u00fcrd\u00fcrebilirsiniz.\n <\/li>\n<\/ul>\n\nMobil uyumlu HTML \u00fcretmek do\u011frudan Strapi'nin g\u00f6revi olmasa da, Strapi'den gelen veriyi kullanarak frontend taraf\u0131nda duyarl\u0131 tasar\u0131m prensiplerini uygulaman\u0131z \u00f6nemlidir. A\u015fa\u011f\u0131daki CSS \u00f6rne\u011fi, web sitenizde duyarl\u0131 g\u00f6rseller ve i\u00e7erik b\u00f6l\u00fcmleri olu\u015fturmak i\u00e7in tipik bir yakla\u015f\u0131m\u0131 g\u00f6stermektedir:\n<\/p>\n
\n