For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/web/blog-content.md (or send Accept: text/markdown).
Blog makaleleri yazmak
Çalışan kategoriler ve rehber bağlantılarıyla yerel, tipli makaleler yayınlayın.
Kurulum ve yapılandırma
Herhangi bir adımdan önce, Başlamadan önce ve Terminal temelleri bölümlerini okuyun. Bu talimatlar, supastack monorepo'nun tamamını VS Kodunda açtığınızı varsayar; kök package.json dosyası depo kökünü işaretler. pnpm komutlarında çalışma alanı paketi bir uygulama veya paylaşılan kod klasörüdür; Üründe çalışma alanı, ekibin veri taşıyıcısı ve güvenlik sınırıdır. corepack pnpm --filter ... komutlar kökünden çalıştırılırken monorepodan bir paket seçer. Yalnızca senkronize edilmiş bir mobil veya masaüstü klasörü açtıysanız, Web arka ucunu, Docker kurulumunu veya kök komut dosyalarını içermez: arka ucu bu monorepodan veya erişilebilir bir barındırılan sunucudan çalıştırın ve platform klasörünün kendi komut dosyalarını kullanın. Ortam değişkeni, yerel bir .env dosyasında veya barındırma kontrol panelinizde depolanan adlandırılmış bir ayardır; İlgili uygulamayı değiştirdikten sonra yeniden başlatın ve sunucu sırlarını NEXT_PUBLIC_ ve EXPO_PUBLIC_ değerlerinin dışında tutun.
1. VS Code'da apps/web/src/resources/content.ts'yi açın ve yakındaki bir makalenin tamamını başlangıç noktanız olarak kopyalayın; makale kopyası yayınlama kontrol panelinde değil, depoda bulunur.
2. Makaleye yeni bir bilgi, başlık, kategori, tarih, bölümler ve mevcut bir kılavuz bilgisi verin.
3. Depo kökünden corepack pnpm --filter @supastack/web dev'yi çalıştırın ve http://localhost:3000/blog/<your-slug>. Beklenen'i açın: URL'yi paylaşmadan önce makale ve ilgili kılavuz bağlantısı yerel olarak yüklenir.
Blog içeriği src/resources/content.ts ve blog-posts.ts'de saklanır. Bu, veri havuzu tarafından yönetilen içeriktir; CMS yayınlama hizmeti yoktur. Her Gönderinin benzersiz bir bilgi, başlık, açıklama, kategori, tarih, ilgili kılavuz ve bölümlere ihtiyacı vardır.
{
slug: 'your-article',
title: 'A specific reader question',
category: 'Guides',
date: '2026-09-07',
guide: 'web/local-setup',
sections: [{ id: 'start', title: 'Start here', paragraphs: ['Your original text.'] }]
}Kopyalanacak komutlar
Bir komutun hangi klasörde çalıştığını görmek için yorumları takip edin. İki terminal etiketlenmişse, iki terminal penceresi açın ve ikincisini kullanırken ilk komutu çalışır durumda tutun.
corepack pnpm --filter @supastack/web dev
# Replace <your-slug> with the article slug:
# http://localhost:3000/blog/<your-slug>
corepack pnpm test -- apps/web/src/resources/content.test.tsUygulama iş akışı
Kalan tip alanları için eksiksiz bir mevcut Post nesnesini izleyin. Paylaşılan URL'ler çalışmaya devam etsin diye yayınlandıktan sonra slug'ı sabit tutun. Başlıklar, içindekiler tablosu ve bağlantı noktaları için benzersiz bölüm kimlikleri gerektirir.
Kategoriler makale kataloğundan türer. Dizin URL tabanlı filtreleme kullanır ve makale rotaları içerikten meta veri üretir. guide değeri mevcut bir dokümantasyon slug'ıyla eşleşmelidir; ilgili içerik faydalı bir sonraki adıma yönlendirmelidir.
Doğrulama ve sorun giderme
Makale 404 döndürürse, bilgisinin benzersiz olup olmadığını ve apps/web/src/resources/content.ts.'deki makale listesine eklendiğini kontrol edin. İçindekiler tablosu hiçbir yere atlamıyorsa, her bölüme benzersiz bir kimlik verin. İçerik doğrulama hatalarını görmek için corepack pnpm test -- apps/web/src/resources/content.test.ts'yi kökten çalıştırın.
İçerik testlerini çalıştırın, makale rotasını açın, ilgili rehberini izleyin ve filtrelenmiş dizini kontrol edin. Tarihleri ve iddiaları kaynak malzemeyle doğrulayın. Yer tutucu bağlantılar yayınlamayın ya da bir entegrasyonun makalede göründüğü için doğrulandığını iddia etmeyin.