Kamil Saim

Dua

Maneviyat

Kur'an-ı Kerim'de geçen duaların Arapça metni, okunuşu ve anlamı — tek bir dosyada, çevrimdışı çalışan bir web uygulaması.

Kur'an'da Geçen Dualar

Kur'an'da Geçen Dualar

Kur'an-ı Kerim'de geçen duaların Arapça metni, okunuşu ve anlamı — tek bir dosyada, çevrimdışı çalışan bir web uygulaması.

71 dua · 93 âyet · 36 sûre · 18 konu


Ne işe yarar

Kur'an'da doğrudan dua olarak geçen âyetleri, hangi bağlamda söylendikleriyle birlikte bir araya getirir. Aramak, favorilere eklemek, kaç kez okuduğunuzu saymak ve bir âyeti paylaşılabilir bir görsel olarak dışa aktarmak için tasarlandı.

Kurulum, hesap, sunucu ve internet bağlantısı gerektirmez.

Özellikler

Günün duası Her gün değişen bir âyet; karıştır düğmesiyle rastgele bir başkasına geçilebilir
Konu bazlı gezinme Şifa, Bağışlanma, Kolaylık, Yolculuk, Korunma gibi 18 başlık
Şifa âyetleri serisi Altı şifa âyetini geleneksel sırasıyla arka arkaya okuma ekranı
Arama Türkçe anlam, okunuş, sûre adı ve bağlam üzerinden; ayrıca harekeden bağımsız Arapça arama
Favoriler Cihazda saklanır, hesap gerektirmez
Okuma sayacı Her dua için kaç kez okunduğu tutulur
Görsel paylaşım Âyeti çerçeveli bir kart olarak PNG üretir; destekleyen cihazlarda doğrudan paylaşım menüsüne düşer
Aydınlık / karanlık tema Paylaşım görselleri de aktif temaya uyum sağlar
Arapça yazı boyutu Üç kademeli, tercih hatırlanır
Metin doğrulama modu Âyetleri mushafla karşılaştırıp işaretlemek için; işaretli id listesi dışa aktarılabilir
Çevrimdışı Service worker ile fontlar dahil tam çevrimdışı çalışır; ana ekrana eklenebilir (PWA)

Kullanım

En hızlı yol: index.html dosyasına çift tıklayın. Uygulama olduğu gibi açılır.

PWA olarak (önerilen): Ana ekrana ekleme ve çevrimdışı önbellek için sayfanın http:// veya https:// üzerinden sunulması gerekir:

python -m http.server 8000
# tarayıcıda http://localhost:8000

GitHub Pages, Netlify, Vercel ya da herhangi bir statik sunucu doğrudan çalışır — derleme adımı yoktur.

Dosya yapısı

index.html      Tüm arayüz, stil ve uygulama mantığı (bağımlılık yok)
dualar.js       Veri — tek kaynak. window.DUALAR_DATA olarak 71 kayıt
dualar.json     Aynı verinin JSON kopyası (uygulama tarafından okunmaz)
sw.js           Service worker — çevrimdışı önbellek
manifest.json   PWA tanımı
icon-512.png    Uygulama simgesi (favicon, ana ekran, paylaşım)
icon-192.png    icon-512.png'den üretilmiş küçük boy

Veri şeması

dualar.js içindeki her kayıt:

{
  id:    35,                      // benzersiz, kalıcı — favoriler ve sayaçlar buna bağlı
  sn:    2,                       // sûre numarası
  an:    127,                     // ilk âyet numarası (sıralama için)
  cat:   "İbadet",                // konu başlığı
  sure:  "Bakara",
  ayet:  "127-128",               // tek âyet, aralık ya da virgüllü liste
  title: "Bizden kabul buyur",
  ar:    "رَبَّنَا تَقَبَّلْ مِنَّا…",      // harekeli Arapça metin
  ok:    "Rabbenâ tekabbel minnâ…", // Türkçe okunuş
  tr:    "Rabbimiz! Bizden kabul buyur…", // meal
  ctx:   "Hz. İbrâhim ile Hz. İsmâil'in…" // âyetin bağlamı
}

Dua eklerken: dualar.js dosyasına yeni kayıt ekleyin ve kullanılmamış bir id verin. Favoriler ile okuma sayaçları id üzerinden saklandığı için mevcut id'leri değiştirmeyin. Yeni bir cat değeri kullanırsanız konu listesinde otomatik belirir.

Teknik notlar

  • Tek dosyalık, çerçevesiz (vanilla) JavaScript. Derleme, paket yöneticisi ya da bağımlılık yok.
  • Tek harici kaynak Google Fonts (Amiri, Amiri Quran, Inter). Service worker bu fontları da önbelleğe aldığı için ilk çevrimiçi ziyaretten sonra çevrimdışı çalışır.
  • Tüm kullanıcı verisi localStorage'da; localStorage kapalıysa bellek içi bir yedeğe düşer. Hiçbir veri dışarı gönderilmez, analitik ya da izleme yoktur.
  • Paylaşım görselleri tarayıcıda <canvas> ile üretilir; navigator.share destekleniyorsa paylaşım menüsüne, desteklenmiyorsa indirmeye düşer.
  • Service worker önbellek öncelikli çalışır: bir güncellemeden sonra değişiklikler ikinci açılışta görünür.

Katkı

Metin hataları en kritik konu. Bir âyette yazım ya da hareke hatası fark ederseniz issue açarken sûre ve âyet numarasını belirtin. Uygulamadaki doğrulama modu (Ayarlar) mushafla karşılaştırma yaparken hangi âyetleri kontrol ettiğinizi işaretlemenizi ve listeyi dışa aktarmanızı sağlar.

Lisans

Kur'an-ı Kerim metni kamuya açıktır. Meal, okunuş ve bağlam notları ile uygulama kodunun lisansını proje sahibi belirler.

Diğer uygulamalar