Yayın prosedürü

Yerelde çalıştırma

npm install

npm run dev

Tarayıcıda http://localhost:4321/istocpazar2/ adresi açılır.

Yeni sayfa ekleme

Dosyayı oluşturun. src/content/docs/<bolum>/<sayfa>.mdx

Frontmatter yazın. Altı alan zorunludur:

---
title: 'Sayfa başlığı'
description: 'Bir cümlelik açıklama'
kanit: cikarim
guven: orta
tur: harita
faz: faz-1
---

Kenar çubuğuna ekleyin. astro.config.mjs içindeki ilgili gruba slug ekleyin. Bu yapılmazsa içerik kapısı “kenar çubuğunda yok” hatası verir.
Kapıları çalıştırın.
Terminal window
```
npm run verify
```
Sürüm günlüğüne yazın. Anlamlı bir değişikliyse src/content/docs/yayin/surum-gunlugu.mdx güncellenir.

Frontmatter alanları

Alan	İzin verilen değerler
`kanit`	`sistematik-derleme`, `hakemli-arastirma`, `sektor-verisi`, `resmi-kaynak`, `vaka-calismasi`, `operator-beyani`, `uzman-gorusu`, `cikarim`, `spekulasyon`, `karma`
`guven`	`yuksek`, `orta`, `dusuk`
`tur`	`harita`, `oneri`, `karar`, `operasyon`, `referans`
`faz`	`faz-1`, `faz-2`, `her-ikisi`

Diyagram ekleme

Mermaid kullanılmaz. Erişilebilir statik SVG kullanılır:

<Figure title="..." caption="...">
  <svg slot="svg" class="ip-svg" viewBox="0 0 700 300" role="img" aria-labelledby="x">
    ...
  </svg>
  <div slot="alt">Diyagramın tam metinsel karşılığı.</div>
</Figure>

slot="alt" zorunludur; içerik kapısı bunu kontrol eder.

Grafik ekleme

Yalnızca gerçek sayısal veri olduğunda kullanılır. columns ve rows zorunludur; JavaScript çalışmasa da veri okunabilir kalır.

İkon ekleme

Yeni bir Phosphor ikonu gerekiyorsa:

scripts/vendor-icons.mjs içindeki ICONS listesine ikon adını ekleyin.
Kopyalama betiğini çalıştırın:
Terminal window
```
node scripts/vendor-icons.mjs
```
Bileşende kullanın: <PhIcon name="ikon-adi" />

GitHub Pages’e yayın

Yayın otomatiktir. main dalına gönderilen her değişiklik GitHub Actions iş akışını tetikler ve site yeniden yayınlanır.

git add -A && git commit -m "docs: değişiklik açıklaması" && git push

Kapılar yerelde geçmeli. npm run verify yeşil olmadan gönderilmez.
Anlamlı commit mesajı. docs:, fix:, feat: öneki kullanılır.
İş akışı çalışır. GitHub Actions derler ve yayınlar.
Doğrulama. Yayın adresinde değişiklik görülür ve arama çalışır.

Yayın adresi

https://karacaismail.github.io/istocpazar2/

Sorun giderme

Belirti	Sebep	Çözüm
Stil bozuk görünüyor	`base` yolu yanlış	`astro.config.mjs` içinde `base: '/istocpazar2'` doğru mu
Bağlantı 404 veriyor	İç bağlantıda base eksik	Bağlantı `/istocpazar2/...` ile başlamalı
Arama sonuç vermiyor	Pagefind indeksi üretilmemiş	Tam `astro build` çalıştırın
Grafik görünmüyor	JavaScript hatası	Tablo yine de görünmeli; konsolu kontrol edin
İkon hatası	İkon vendor edilmemiş	`node scripts/vendor-icons.mjs`
Derleme YAML hatası	Frontmatter’da tırnak sorunu	Başlıkta iki nokta varsa tırnak içine alın