Yapılandırma Kılavuzu

Shevky, derleme başlangıcı sırasında base/src/config.js'de config.load() aracılığıyla src/site.json okur. Tüm yapılandırma alanlarında yerleşik geri dönüş varsayılanları bulunur.

Temel İlkeler

site.json değerini geçerli JSON olarak tutun (sondaki virgül yok, yorum yok).
Yalnızca varsayılanlara güvenmek yerine açık değerleri tercih edin.
Eklenti ayarlarını global config ile karıştırılmadan pluginConfigs içine yerleştirin.
Eklenti paket adlarını plugins içine koyun.

Yüksek Etkili Bölümler

`identity`

Meta etiketler, RSS, site haritası ve robot oluşturmada kullanılan kanonik site meta verilerini kontrol eder.

Anahtar alanlar: author, email, url, themeColor, social.

Önemli: identity.url RSS yayınlarında, site haritasında, robots.txt'de ve OG meta verilerinde standart URL'leri yönlendirir. Dağıtım için oluşturmadan önce bunu üretim URL'nize ayarlayın.

`content`

Dil davranışını ve içerik listelerini kontrol eder.

Anahtar alanlar:

languages.default, languages.supported, languages.canonical - çok dilli yönlendirme
pagination.pageSize, pagination.segment - sayfalandırmayı listeleme
collections - etiketler/kategoriler/seriler için özel koleksiyon tanımları

`build`

Çıkış davranışını kontrol eder:

minify - HTML/CSS/JS küçültmeyi etkinleştirir
debug - ayrıntılı derleme günlüğe kaydetmeyi ve yüklerde hata ayıklamayı etkinleştirir
pageBufferLimit - temizlemeden önce bellekte tutulan sayfalar (varsayılan: 20)
outputAliases - derleme sonrası yol eşlemeleri (örneğin, ~/404/ -> ~/404.html)

`plugins`

Eklenti paketi adlarını tam olarak npm'de kurulu olduğu şekilde listeleyin:

"plugins": [
  "@shevky/plugin-robots-txt",
  "@shevky/plugin-tailwindcss"
]

`pluginConfigs`

Eklentinin name alanıyla anahtarlanan eklenti çalışma zamanı ayarlarını saklayın (npm paket adı değil, çalışma zamanı adı):

"pluginConfigs": {
  "shevky-rss": { "feedFilename": "feed.xml" },
  "shevky-open-graph": { "siteName": "My Site" }
}

Güvenli Değişim İş Akışı

src/site.json'yi düzenleyin.
npm run build komutunu çalıştırın.
dist/ çıktısını inceleyin ve günlükleri oluşturun.
npm run dev komutunu çalıştırın ve tarayıcıdaki sayfaları doğrulayın.

Yaygın Hatalar

Hata	Sonuç	Düzelt
`pluginConfigs` eklentisi var ancak `plugins[]`'de eksik	Yapılandırma göz ardı edilir; eklenti asla yüklenmiyor	Her iki yere de ekle
`plugins[]`'da yanlış paket adı	Eklenti yükleme uyarısı; inşaat onsuz devam ediyor	Tam npm paket adını kullanın
Yanlış `identity.url`	Yanlış standart/site haritası/yayın/OG URL'leri	Gerçek üretim URL'sine ayarla
Eşleşmeyen `pluginConfigs` anahtarı	Eklenti `null` yapılandırmasını okuyor	Anahtar, eklentinin `name` dışa aktarımıyla eşleşmelidir

İlgili

Yapılandırma Referansı - alan bazında tam referans
CLI Kullanımı