Skip to content

README.tr.md

Latest commit

 

History

History
191 lines (151 loc) · 6.5 KB

README.tr.md

File metadata and controls

191 lines (151 loc) · 6.5 KB

React TypeScript Vite TailwindCSS

∑ MATiK

Adım Adım Denklem Çözücü

Matematik denklemlerini görsel adımlarla çözen, eğitim amaçlı interaktif bir web uygulaması. Cebirin mantığını anlamaya çalışan öğrenciler için tasarlanmıştır.

Türkçe • English

English README • Özellikler • Kurulum • Kullanım • Teknolojiler • Katkıda Bulunma

Özellikler

Denklem Üreteci

  • Sınırsız Pratik: Farklı zorluk seviyelerinde rastgele ve sonsuz sayıda denklem üretin.
  • Özelleştirilebilir Ayarlar: Tam sayı zorunluluğu, kesirli sonuçlar veya özel sayı aralıkları belirleyin.
  • Zorluk Seviyeleri: Öğrenme hızınıza uygun olarak Kolay, Orta veya Zor modlarını seçin.

Adım Adım Çözüm

  • Görsel Öğrenme: Denklemlerin tam olarak nasıl çözüldüğünü adım adım izleyin.
  • Animasyonlu Gösterim: Terimlerin eşitliğin diğer tarafına geçişini (transfer) oklar ve animasyonlarla görün.
  • Renk Kodlaması: Önemli terimler ve değişiklikler, dikkati odaklamak için renklendirilmiştir.
  • Detaylı Açıklamalar: Her adımda yapılan matematiksel işlem açık ve anlaşılır bir dille ifade edilir.

Modern ve Responsive Tasarım

  • Glassmorphism Arayüz: Cam efektli, şık ve modern bir kullanıcı arayüzü.
  • Karanlık Mod: Gözü yormayan, özenle tasarlanmış karanlık tema.
  • Tam Uyumluluk: Hem masaüstü hem de mobil cihazlarda sorunsuz çalışır.
  • İnteraktif Deneyim: Akıcı geçişler ve hover efektleri ile canlı bir kullanım sunar.

Yapılandırma

Ayar Açıklama
Tam Sayı Sonuç Sonucun her zaman bir tam sayı olmasını zorlar.
Kesirli Sonuçlar Kesirli (örn: 1/2, 3/4) sonuçlara izin verir.
Negatif Sonuçlar Negatif sonuçlu denklemler üretilmesini sağlar.
Sıfır Sonuç Sonucun sıfır çıkmasına izin verir.
Özel Aralık Üretilecek sonuç için minimum ve maksimum değerleri belirleyin.
Zorluk Seviyesi Kolay, Orta veya Zor seviyelerinden birini seçin.

Kurulum

Gereksinimler

Adımlar

  1. Repoyu klonlayın

    git clone https://github.com/MZRCode/matik.git

  2. Proje dizinine gidin

    cd matik

  3. Bağımlılıkları yükleyin

    npm install

  4. Geliştirme sunucusunu başlatın

    npm run dev

Tarayıcınızda http://localhost:5173 adresine giderek uygulamayı görüntüleyebilirsiniz.

Production Build (Canlı Sürüm)

Yayınlanmaya hazır bir sürüm oluşturmak için:

npm run build

Oluşturulan sürümü yerel olarak önizlemek için:

npm run preview

Kullanım

  1. Ayarları Yapın: Sol panelden istediğiniz zorluk seviyesini ve kısıtlamaları seçin.
  2. Denklem Oluşturun: "Denklem Oluştur" butonuna tıklayarak yeni bir soru üretin.
  3. Cevabı Görün: "Sonucu Göster" butonu ile sadece cevabı görüntüleyin.
  4. Yöntemi Öğrenin: "Nasıl Çözdük?" butonuna tıklayarak adım adım çözüm sürecini inceleyin.

Örnek Denklem

3(2x + 4) + 5 = 2(x - 1) + 7

MATiK bu denklemi şu adımlarla çözer:

  1. Parantezleri dağıtır.
  2. Sabit terimleri kendi aralarında toplar.
  3. Bilinmeyenleri ($x$) eşitliğin bir tarafına toplar.
  4. Sabit sayıları eşitliğin diğer tarafına taşır.
  5. $x$'i yalnız bırakmak için her iki tarafı böler.
  6. Sonucu gösterir.

Teknolojiler

Teknoloji Sürüm Kullanım Amacı
React 19.2.0 Kullanıcı Arayüzü Kütüphanesi
TypeScript 5.9.3 Tip Güvenliği ve Geliştirme
Vite 7.2.4 Build Aracı ve Geliştirme Sunucusu
TailwindCSS 4.1.18 Stil ve Tasarım
ESLint 9.39.1 Kod Düzeni ve Denetimi

Proje Yapısı (Project Structure)

matik/
├── public/              # Statik dosyalar
├── src/
│   ├── App.tsx          # Ana uygulama ve yönlendirme
│   ├── Denklemler.tsx   # Denklem bileşeni
│   ├── LandingPage.tsx  # Karşılama sayfası
│   ├── SolverPage.tsx   # Çözücü sayfası
│   ├── index.css        # Global stiller
│   └── main.tsx         # Giriş noktası
├── index.html           # HTML şablonu
├── package.json         # Proje bağımlılıkları
├── tsconfig.json        # TypeScript ayarları
└── vite.config.ts       # Vite ayarları

🤝 Katkıda Bulunma (Contributing)

Katkılarınızı bekliyoruz! Projeye katkıda bulunmak için lütfen şu adımları izleyin:

  1. Projeyi Fork'layın.
  2. Yeni bir Branch oluşturun (git checkout -b feature/yeni-cozum-algoritmasi).
  3. Değişikliklerinizi Commitleyin (git commit -m 'feat: Yeni denklem çözüm algoritması eklendi').
  4. Branch'inizi Pushlayın (git push origin feature/yeni-cozum-algoritmasi).
  5. Bir Pull Request oluşturun.

Commit Mesaj Formatı

Lütfen conventional commits standardına uyun:

<tip>: <açıklama>

Tipler: feat, fix, docs, style, refactor, test, chore

Lisans

Bu proje MIT Lisansı altında lisanslanmıştır.

İletişim

Herhangi bir sorunuz veya öneriniz varsa, Discord üzerinden bizimle iletişime geçebilirsiniz.

Bu projeyi yararlı bulduysanız yıldız vermeyi unutmayın ⭐️