مشروع متصفح القرآن المتقدم

يهدف مشروع متصفح القرآن المتقدم إلى تقديم أداة فريدة للبحث والتلاوة والتدبر في القرآن الكريم بطريقة مبتكرة وسهلة الاستخدام. يعتمد التطبيق على لغة Python مع استخدام مكتبات PyQT5 وPyQtWebEngine لتوفير واجهة رسومية غنية، مما يتيح للمستخدمين الاستمتاع بتجربة متكاملة تجمع بين النصوص والملفات الصوتية وملاحظات التدبر.

مميزات المشروع

• بحث ذكي في نصوص القرآن الكريم باستخدام خطوط عثمانية ومبسطة.

• تشغيل التلاوة الصوتية مع تزامن دقيق بين الصوت والنص.

• إدارة متكاملة للملاحظات والتدبرات مع إمكانية استيراد وتصدير البيانات بصيغة CSV.

• إمكانية إنشاء دروس قرآنية وتسجيل تسلسلات تعليمية قابلة للتشغيل الآلي.

• واجهة قابلة للتخصيص مع دعم للوضع الليلي والنهاري.

• دعم كامل لاختصارات لوحة المفاتيح لتسهيل التنقل والتحكم في التطبيق.

تثبيت المشروع

يمكن تثبيت وتشغيل التطبيق على أنظمة Windows وLinux باتباع التعليمات التالية. يعتمد التطبيق على بيئة Python، لذا يجب التأكد من تثبيت Python والإعدادات اللازمة قبل بدء التثبيت.

تثبيت المشروع على نظام Windows

1. قم بتحميل وتثبيت Python من الموقع الرسمي python.org، وتأكد من إضافته إلى متغيرات النظام.

2. بعد تنزيل المشروع كملف مضغوط (ZIP) أو استنساخه من GitHub، قم بفك ضغطه وافتح موجه الأوامر (CMD) داخل مجلد المشروع.

3. قم بتشغيل سكربت التثبيت الخاص بنظام Windows عن طريق الأمر التالي:
   python install-for-windows.py

سيقوم السكربت بما يلي:

• إنشاء بيئة افتراضية داخل مجلد env إذا لم تكن موجودة.

• تثبيت الاعتماديات المطلوبة من ملف requirements.txt.

• إنشاء ملف دفعي (Batch file) لتشغيل التطبيق بسهولة.

• محاولة إنشاء اختصار على سطح المكتب لتشغيل التطبيق.

تثبيت المشروع على نظام Linux

1. قم باستنساخ المشروع من GitHub باستخدام الأمر التالي:
   git clone https://github.com/neoMOSAID/quran-search-and-play.git

2. انتقل إلى مجلد المشروع:
   cd quran-search-and-play

3. قم بتشغيل سكربت التثبيت المخصص لنظام Linux عبر الأمر:
   ./install.sh

سيقوم السكربت بما يلي:

• نسخ الملفات اللازمة.

• إنشاء بيئة افتراضية (virtual environment) داخل المجلد.

• تثبيت جميع الاعتماديات المطلوبة من ملف requirements.txt.

• إنشاء ملف تنفيذي لتسهيل تشغيل التطبيق من سطر الأوامر.

• إنشاء مدخل على سطح المكتب لتشغيل التطبيق.

تفاصيل المميزات والوظائف

يوفر التطبيق تجربة مستخدم متميزة تجمع بين عدة وظائف ومميزات متقدمة:

• بحث نصي ذكي يتيح العثور على الآيات باستخدام كلمات مفتاحية دقيقة.

• تلاوة صوتية متزامنة مع عرض النص القرآني، مما يسهل عملية التدبر.

• نظام إدارة ملاحظات متكامل يساعد المستخدم على حفظ تدبراته وإنشاء دروس قرآنية.

• تسجيل تسلسلات بحث وتلاوة لإعادة تشغيلها أثناء الدروس.

• واجهة مستخدم رسومية متطورة مبنية باستخدام PyQT5 وPyQtWebEngine توفر تجربة سلسة وجذابة.

الخاتمة

يمثل مشروع متصفح القرآن المتقدم خطوة مهمة نحو تسهيل الوصول إلى القرآن الكريم بأسلوب عصري وفعال. ندعو جميع المطورين والمهتمين للمساهمة في تطوير المشروع والمشاركة في تحسينه، مع العلم أنه مفتوح المصدر ويستقبل جميع الاقتراحات والمساهمات عبر صفحة GitHub الخاصة به.

لمزيد من المعلومات وللمساهمة، يرجى زيارة صفحة المشروع على GitHub: https://github.com/neoMOSAID/quran-search-and-play

دليل استخدام متصفح القرآن المتقدم

1. المقدمة

يمتلك البرنامج المميزات التالية:

• بحث متقدم في نص القرآن الكريم بخطوط عثمانية ومبسطة

• تشغيل التلاوات الصوتية مع مزامنة النص

• نظام متكامل لإدارة الملاحظات والتدبرات

• إنشاء دروس قرآنية

• استيراد/تصدير التدبرات والملاحظات بصيغة CSV

• واجهة قابلة للتخصيص (وضع ليلي/نهاري)

2. واجهة المستخدم

المكونات الرئيسية:

• شريط البحث العلوي:

  • قائمة السور (114 سورة)

  • خيارات طريقة البحث (نصي، سورة، نطاق آيات)

  • حقل إدخال بحث ذكي مع اقتراحات

• منطقة النتائج:

  • عرض الآيات المطابقة مع الترقيم القرآني

  • ظهور سلس للنتائج

  • إمكانية التحديد بالأسهم

• منطقة سياق الآية:

  • عرض السياق القرآني (5 آيات قبل وبعد)

  • محرر ملاحظات و تدبرات حوال الآية مع تنسيق النص

3. أنواع البحث

البحث النصي:

• بحث بالكلمات المفتاحية العربية

• مثال: "الرحمن الرحيم"

البحث بالسورة:

• اختيار السورة من القائمة المنسدلة أو باستعمال زري اليمين واليسار (Left/Right)

• إدخال رقم السورة مباشرة (1-114) باستعمال (Ctrl+W)

• مثال: "5" لعرض سورة المائدة

البحث بنطاق الآيات:

• صيغة: [رقم السورة] [الآية الأولى] [الآية الأخيرة]

• مثال 1: "2 255" لآية الكرسي

• مثال 2: "2 255 260" للآيات 255-260 من البقرة

4. التلاوة الصوتية

مميزات التشغيل:

• الإستماع لآية محددة (Space)

• توقيف وإنهاء التلاوة (Ctrl+S)

• تكرار الإستماع لنطاق الآيات الناتجة عن البحث بنطاق آيات (Ctrl+R)

• الإستماع لسورة كاملة ثم استمرار التلاوة للقرأن كاملا، تبدأ التلاوة من الآية المحددة (Ctrl+A)

• تلاوة الآية و 5 بعدها ،تبدأ التلاوة من الآية المحددة (Ctrl+P)

• تلاوة جميع النتائج ،تبدأ التلاوة من الآية المحددة (Ctrl+Shift+P)

• كل الحالات يتم فيها التحول التلقائي للآية التالية

إعدادات الصوت:

• تحديد مجلد الصوتيات من القائمة

• صيغة الملفات: SSSAAA.mp3 (3 أرقام للسورة، 3 أرقام للآية)

• مثال: 001001.mp3 لسورة الفاتحة آية 1

• يمكنك تحميل القرآن الكريم مجزأ الى آيات من https://everyayah.com

5. إدارة الملاحظات والتدبرات

العمليات الأساسية:

• إضافة ملاحظة جديدة (Ctrl+N)

• حفظ التعديلات (Ctrl+S)

• حذف الملاحظة (Ctrl+Delete)

المميزات المتقدمة:

• استيراد/تصدير بصيغة CSV

6. الميزات المتقدمة

منظم دروس القرآن الكريم:

يمكنك من تسجيل عدة عمليات ثم تطبيقها بشكل أوتوماتيكي، مثلا تسجيل آية أو آيات، ثم بحث عن كلمة ، ثم آية وهكذا، ثم بعد ذلك تستطيع استعمال هذا التسجيل أثناء عرضك لدرس قرآني

• فتح المنظم (Ctrl+Shift+A)

• يمكنك استعمال زري اليمين و اليسار (Left/Right) للإنتقال بين الدروس المسجلة

• يمكنك استعمال زري الأعلى و الأسفل (Up/Down) للإنتقال بين التسجيلات

• يمكنك استعمال زري الأعلى و الأسفل (Ctrl+Up / Ctrl+Down) لتغيير موقع التسجيلات

• إنشاء قوائم مخصصة من الآيات

• النقر مرتين أو (Enter) على تسجيل فارغ يمكنك من الكتابة

• إضافة نطاقات آيات بالصيغة: a سورة آية_بداية آية_نهاية
  مثال : a 2 255 أو a 2 255 256

• تسجبل بحث : s كلمة بحث
  مثال : s مصلين
  2 مثال : s لا اله الا الله

• تشغيل/تطبيق العملية المسجلة (Enter)

• حفظ وإدارة قوائم التشغيل

التخصيص:

• تبديل الوضع الليلي (Ctrl+D)

• تغيير نوع الخط (Esc)

7. اختصارات لوحة المفاتيح

8. الاستيراد والتصدير

• تصدير جميع الملاحظات بصيغة CSV

• استيراد ملاحظات من ملفات CSV

• حفظ تلقائي للإعدادات

• استعادة الإعدادات الافتراضية

9. إدعمنا

• البريد الإلكتروني: mail@mosaid.xyz

• الموقع الإلكتروني: https://mosaid.xyz/quran-search