Ticaret İstatistik

İstanbul Ticaret Üniversitesi İstatistik Bölümü öğrencileri için hazırlanan açık kaynak yardımcı doküman sitesi. Ders notları, topluluk etkinlikleri, podcast bölümleri ve blog yazıları tek bir yerden ulaşılabilecek şekilde derlenmiştir.

Üretim adresi: ticaretistatistik.com

İçindekiler

1. Proje hakkında
2. Teknoloji yığını
3. Gereksinimler
4. Kurulum
5. Geliştirme
6. Proje yapısı
7. İçerik ekleme
8. Tasarım sistemi
9. Katkıda bulunanlar
10. Katkıda bulunma rehberi
11. Lisans

Proje hakkında

Site; ders dokümantasyonu, blog yazıları, podcast arşivi, topluluk etkinlikleri ve Not Hesaplayıcı (hesapla.ticaretistatistik.com) gibi yardımcı araçlara tek bir editoryal çatı altından erişim sağlar. Tüm içerikler Markdown / MDX ile yazılmıştır ve topluluk üyelerinin katkısına açıktır.

Teknoloji yığını

• Docusaurus 3.10 (classic preset) — içerik yönetimi, docs + blog rotaları
• React 18 — sayfa bileşenleri
• Inter + Fraunces + JetBrains Mono — editoryal tipografi (Google Fonts üzerinden)
• KaTeX (remark-math + rehype-katex) — matematiksel gösterim
• Swiper + react-player — video carouselleri
• react-icons — feature kartları ve CTA ikonları

Gereksinimler

• Git
• Node.js ≥ 20 (node -v ile kontrol edebilirsin)

Kurulum

git clone git@github.com:ticaretistatistik/ticaretistatistik.com.git
cd ticaretistatistik.com
npm install

Geliştirme

npm start        # development sunucu: http://localhost:3000
npm run build    # production çıktısı üretir (build/ klasörü)
npm run serve    # build çıktısını yerelde sunar
npm run clear    # Docusaurus önbelleğini temizler

Proje yapısı

.
├── blog/                   # Blog yazıları (tarih-prefix klasörleri)
│   └── authors.yml         # Yazar meta bilgileri
├── docs/                   # Ders dokümanları (sidebar.js ile yapılandırılır)
├── src/
│   ├── components/
│   │   ├── home/           # Anasayfa bölümleri (Hero, Stats, vb.)
│   │   └── HomepageFeatures/
│   ├── css/
│   │   └── custom.css      # Design token sistemi
│   ├── pages/              # Özel sayfalar (index, 404, topluluk/*)
│   ├── theme/              # Docusaurus swizzle'ları
│   └── utils/
│       └── generatePreview.js   # Blog paylaşım görseli üretici
├── static/                 # Public asset'ler (img/, docs/)
├── docusaurus.config.js    # Ana yapılandırma
└── sidebars.js             # Docs navigation

İçerik ekleme

Yeni blog yazısı

blog/YYYY-MM-DD-slug/
├── index.md                # Frontmatter + içerik
└── ...                     # İlgili görseller

Frontmatter şablonu:

---
slug: yazi-slug
title: Yazı Başlığı
authors: [kullanici-id]    # blog/authors.yml içinden
tags: [etiket1, etiket2]
---

Uzun yazılarda anasayfa özetini <!-- truncate --> ile sınırlandır.

Yeni yazar ekleme

blog/authors.yml içine ekle:

kullaniciid:
  name: Ad Soyad
  title: Ünvan
  url: https://github.com/kullanici
  image_url: https://github.com/kullanici.png

Yeni doküman ekleme

docs/<konu>/... altına Markdown dosyası oluştur ve gerekirse sidebars.js içinde grupla.

Tasarım sistemi

Tüm renk, tipografi, aralık ve gölge tokenları src/css/custom.css dosyasındaki :root ve [data-theme='dark'] bloklarında tanımlıdır. Özet:

• Birincil renk: --brand-yellow (#f5cf06) — vurgu olarak kullanılır, ana yüzey rengi değil
• Ink: --brand-ink — başlıklar ve ana metin
• Yüzeyler: warm cream (--brand-surface) + raised (--brand-surface-raised)
• Tipografi: Inter (gövde) + Fraunces (başlık, italic display) + JetBrains Mono (kod)
• Spacing: 4px tabanlı --space-1 ... --space-24
• Radii: --radius-sm/md/lg/pill
• Motion: --ease-out + --dur-fast/base/slow

Yeni bileşen yazarken bu tokenları kullan — sabit değer (hardcoded hex, px) yazma.

Katkıda bulunanlar

Katkıda bulunma rehberi

Yazı yazmak veya kod katkısında bulunmak için CONTRIBUTING.md dosyasını inceleyebilirsin. PR'lar, issue'lar ve tartışmalar her zaman açıktır.

Lisans

Bu proje GPL-3.0 lisansı ile lisanslanmıştır. Detaylar için LICENSE dosyasına bakınız.

This project is licensed under the GPL-3.0 License. See the LICENSE file for details.