الصفحة المباركة - قارئ القرآن الكريم التفاعلي

📖 الصفحة المباركة هو تطبيق ويب تفاعلي وجذاب لعرض وقراءة القرآن الكريم، مصمم ليوفر تجربة روحانية وسهلة الاستخدام. تم بناء التطبيق باستخدام HTML، CSS، و JavaScript thuần (Vanilla JS)، مع التركيز على الأداء والتجاوب على مختلف الأحجام الشاشات.

🌟 الميزات الحالية

• عرض كامل للقرآن الكريم: إمكانية تصفح وعرض جميع سور القرآن الكريم الـ 114.
• واجهة مستخدم جذابة وروحانية:
  • خلفية داكنة مع نجوم متحركة ببطء.
  • تصميم زجاجي (Glassmorphism) للقائمة الجانبية.
  • أيقونات وخطوط عربية مختارة بعناية.
• بيانات السور من ملفات JSON: يتم جلب بيانات كل سورة ديناميكيًا من ملف JSON خاص بها، مما يحافظ على سرعة التحميل الأولية.
• قائمة جانبية للتنقل:
  • 🕋 السور: لعرض فهرس السور.
  • 🔍 بحث: للبحث عن السور بالاسم (عربي/إنجليزي) أو بالرقم. (سيتم تطويره ليشمل البحث في الآيات).
  • 🎧 استمع: (قيد التطوير).
  • 📅 ختمتي: (قيد التطوير).
  • ⚙️ إعدادات: (قيد التطوير).
• عرض السور والآيات:
  • عرض اسم السورة بشكل واضح.
  • عرض البسملة (حيثما وجدت).
  • عرض الآيات مرقمة بالأرقام الهندية (۱, ۲, ۳).
• تحكم بحجم الخط: إمكانية تكبير وتصغير حجم خط الآيات لتناسب راحة القارئ.
• زر العودة للأعلى: لسهولة التنقل في السور الطويلة.
• متجاوب مع جميع الأجهزة: تصميم مرن يعمل بشكل جيد على أجهزة الكمبيوتر المكتبية، الأجهزة اللوحية، والهواتف المحمولة.
• بحث في السور: إمكانية البحث السريع في قائمة السور بناءً على الاسم العربي، الاسم المبسّط، الاسم الإنجليزي، أو رقم السورة.
• كود مصدر واحد: تم تجميع كل من HTML، CSS، و JavaScript في ملف واحد لتسهيل التجربة الأولية (يمكن فصلها لمشاريع أكبر).

🚀 كيف تبدأ

1. استنساخ المستودع (Clone):

   git clone https://github.com/seif4d/quran.git
   cd quran

2. هيكل الملفات: تأكد من أن لديك مجلد surah في جذر المشروع يحتوي على ملفات JSON الخاصة بكل سورة (مثل surah_1.json, surah_2.json, ..., surah_114.json). يجب أن يتبع كل ملف JSON الهيكل المحدد (انظر الأمثلة المضمنة في الكود أو الملفات الأصلية لديك).

3. فتح التطبيق: افتح ملف quran_viewer.html (أو أي اسم أعطيته للملف الرئيسي) في متصفح الويب المفضل لديك.

📂 هيكل المشروع (المقترح للملفات الفعلية)

📦 جذر المشروع
├── 📁 surah/               ← هنا بنخزّن كل سورة في ملف JSON مستقل، من الفاتحة للناس.
│   ├── surah_1.json
│   ├── surah_2.json
│   └── surah_114.json

├── 📁 images/              ← مجلد الصور (اختياري)، فيه لقطات شاشة أو أيقونات مخصصة لو عايز تبهر المستخدمين بصريًا.
│   └── screenshot.png

├── 📄 quran_viewer.html     ← ده عقل المشروع، الواجهة اللي بيشوفها المستخدم.
└── 📄 README.md             ← اللي إنت بتقرأه دلوقتي.

(ملاحظة: الكود الحالي في quran_viewer.html يتضمن CSS و JS داخليًا. للتطوير المستقبلي، يُنصح بفصلها إلى ملفات .css و .js منفصلة).

🛠️ التقنيات المستخدمة

• HTML5
• CSS3 (مع متغيرات CSS و Flexbox/Grid للتخطيط)
• JavaScript (ES6+) - بدون أي مكتبات أو أطر عمل خارجية (Vanilla JS)

💡 خطط مستقبلية ومساهمات

يهدف المشروع إلى إضافة المزيد من الميزات لتحسين تجربة المستخدم. بعض الأفكار المستقبلية تشمل:

• ميزة الاستماع: دمج ملفات صوتية للقرآن مع إمكانية التحكم بالتشغيل.
• ميزة "ختمتي": تتبع تقدم القراءة وحفظ الموضع الأخير.
• بحث متقدم: البحث داخل نصوص الآيات، مع خيارات للبحث الدقيق أو بالجذر.
• إعدادات متقدمة: اختيار القارئ، تغيير الثيم (فاتح/داكن)، تفضيلات عرض أخرى.
• ترجمات: إضافة ترجمات لمعاني القرآن الكريم بلغات متعددة.
• تفسير: ربط الآيات بتفاسير مختارة.
• وضع إشارة مرجعية (Bookmarking).
• تحسينات على الأداء وإمكانية الوصول (Accessibility).

نرحب بالمساهمات! إذا كنت ترغب في المساهمة، يرجى الاطلاع على CONTRIBUTING.md (إذا أنشأت هذا الملف) أو ببساطة قم بـ:

1. عمل Fork للمستودع.
2. إنشاء فرع جديد (git checkout -b feature/AmazingFeature).
3. إجراء التعديلات المطلوبة (git commit -m 'Add some AmazingFeature').
4. دفع التعديلات إلى الفرع (git push origin feature/AmazingFeature).
5. فتح طلب سحب (Pull Request).

📄 الترخيص

هذا المشروع مرخص بموجب ترخيص MIT License - انظر ملف LICENSE.md (إذا أنشأته) لمزيد من التفاصيل. بيانات القرآن الكريم نفسها هي ملك عام.

---

نتمنى أن تجد هذا التطبيق مفيدًا ونافعًا. نسأل الله القبول.