README-AR.md

بسم الله الرحمن الرحيم

رفيق القرآن

قارئ و مشغل للقرآن الكريم متعدد-المنصات

أهم المميزات • الصور • التحميل • الحقوق • بلّغ عن مشكلة • الترخيص

فهرس المحتويات

1. عن المشروع
2. أهم المميزات
3. الصور
4. التنصيب
5. البناء من المصدر
   • التبعيات
   • البناء
     • ويندوز
     • لينكس
6. خارطة الطريق
7. المشاركة
8. الحقوق
9. الترخيص
10. التواصل

عن المشروع ✨

رفيق القرآن هو برنامج متعدد-المنصات لقراءة و سماع القرآن الكريم مع إمكانية تحميل التلاوات، تظليل الآيات، حجم خط متغير للمصحف، و مجموعة مميزة من كتب التفسير و الترجمات

أهم المميزات

• واجهة عصرية تدعم الوضع الداكن
• قراءة القرآن من صفحة المصحف أو قراءة ايآت الصفحة كلٌ على حدة
• حجم صفحة المصحف قابل للتغيير
• إمكانية تحميل تلاوات القرآن الكريم لمجموعة من المشايخ و القرّاء
• تظليل الآية عند تلاوتها
• مجموعة من كتب التفسير و الترجمات
• خاصية البحث السريع في آيات القرآن الكريم

(عد إلى الأعلى)

الصور

الواجهة الإنجليزية

(عد إلى الأعلى)

التنصيب ⚙️

ويندوز

مثّبت البرنامج يمكنك تحميله من هنا

ماك

1. قم بتحميل و فتح ملف الdmg.
2. قم بسحب البرنامج لمجلد التطبيقات.

لينكس

يمكنك تحميل البرنامج بأي صيغة من الصيغ المتوفرة (snap, flatpak, appimage, aur package)

(عد إلى الأعلى)

البناء من المصدر 🛠️

لإنشاء التطبيق في نظامك، ستحتاج إلى تثبيت التبعيات المطلوبة له وقد تختلف أسماء الحزم لكل توزيعة، راجع التبعيات أدناه لمزيد من المعلومات. يمكنك أيضا تثبيت معظم تبعيات Qt عبر المثبت. إذا كنت تقوم بتطوير تطبيقات Qt من قبل ، فمن المحتمل أن تكون لديك بالفعل. يستخدم هذا المشروع نظام بناء CMake ، لذلك تحتاج إلى تثبيته من أجل بناء المشروع (في معظم توزيعات لينكس يتوفر في المستودعات الرئيسية كحزمة تسمى cmake). كما يمكنك فتح وبناء / تصحيح المشروع في بيئة تطوير لغة ++C متكاملة. على سبيل المثال ، في Qt Creator ، يجب أن تكون قادرا ببساطة على فتح "CMakeLists.txt" عبر "فتح ملف أو مشروع" في القائمة بعد تثبيت CMake في نظامك. مزيد من المعلومات حول مشاريع CMake في Qt Creator.

(عد إلى الأعلى)

التبعيات

• GCC / MSVC
• CMake
• Qt >= 6.5
  • qtbase
  • qtimageformats
  • qtsvg
  • qtmultimedia
  • qttools

البناء

1. استنساخ المستودع

git clone --depth=1 -b main https://github.com/0xzer0x/quran-companion.git

ويندوز

2. قم بتثبيت Qt باستخدام المثبت عبر الانترنت
3. إضافة مجلد bin الخاص ب Qt لمسار البحث الخاص بالنظام (PATH)، في الأغلب يكون المسار C:\Qt\6.X.X\msvc_2019\bin
4. البناء (استبدل 6.x.x بنسخة Qt الخاصة بك)

mkdir build
cd build
cmake.exe -DCMAKE_PREFIX_PATH="C:\Qt\6.x.x\msvc_2019" -DCMAKE_BUILD_TYPE=Release ..
cmake.exe --build . --config Release

لينكس

2. تنصيب التبعيات

أوبونتو

sudo apt install build-essential cmake qt6-tools-dev qt6-base-dev qt6-image-formats-plugins qt6-multimedia-dev qt6-l10n-tools qt6-translations-l10n

آرش لينكس

sudo pacman -Sy base-devel cmake qt6-base qt6-multimedia qt6-tools qt6-imageformats qt6-translations

3. البناء

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -G "Ninja" ..
cmake --build .

(عد إلى الأعلى)

خارطة الطريق 🎯

• إضافة خاصية الآية اليومية
• إضافة نافذة الايآت المفضلة
• تحسين خاصية البحث
  • البحث في نطاق عدد معين من الصفحات
  • البحث في سور محددة فقط
• إضافة كتب تفسير جديدة
  • أيسر التفاسير - أبو بكر الجزائري
  • التسهيل لعلوم التنزيل (تفسير إبن جزي)
  • أضواء البيان - الشنقيطي

راجع المشكلات المفتوحة للحصول على قائمة كاملة بالميزات المقترحة (والمشكلات المعروفة).

(عد إلى الأعلى)

المشاركة 💡

إذا كان لديك اقتراح من شأنه أن يجعل هذا أفضل ، فيرجى تفريع المستودع وإنشاء طلب سحب. يمكنك أيضا ببساطة فتح مشكلة باستخدام العلامة "تحسين".

التوثيق 📚

• تم توثيق كافة أجزاء البرنامج باستخدام منهجية Doxygen يمكنك بناء التوثيق في هيئة html عن طريق الخطوات التالية

• git clone https://github.com/0xzer0x/quran-companion.git
• cd quran-companion/docs
• doxygen

الترجمة 🌐

ألق نظرة على هذه الصفحة (إنجليزية)

التلاوات 📻

ألق نظرة على هذه الصفحة (إنجليزية)

(عد إلى الأعلى)

الحقوق 📌

تم استخدام المشاريع/المواقع التالية في تطوير البرنامج:

• Ayat
• Quran.com API
• Every Ayah recitations
• Mosshaf

(عد إلى الأعلى)

الترخيص

مرخّص بموجب رخصة وقف العامة

(عد إلى الأعلى)

التواصل

0xzer0x - y.essam2256@nu.edu.eg

رابط المشروع: https://github.com/0xzer0x/quran-companion

(عد إلى الأعلى)