Skip to content

Latest commit

 

History

History
332 lines (230 loc) · 11.5 KB

README-AR.md

File metadata and controls

332 lines (230 loc) · 11.5 KB

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


رفيق القرآن

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

StandWithPalestine GitHub Release AUR Version GitHub Actions Workflow Status GitHub issues

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

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

عن المشروع ✨

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

أهم المميزات

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

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

الصور

ar_light.png

ar_dark.png

ar_two-page.png

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

light.png

dark.png

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

التنصيب ⚙️

ويندوز

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

لينكس

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

Download Flatpak Download AppImage احصل عليه من Snap Store

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

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

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

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

التبعيات

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

البناء

  1. استنساخ المستودع
git clone --depth=1 -b main https://github.com/0xzer0x/quran-companion.git

ويندوز

  1. قم بتثبيت Qt باستخدام المثبت عبر الانترنت
  2. إضافة مجلد bin الخاص ب Qt لمسار البحث الخاص بالنظام (PATH)، في الأغلب يكون المسار C:\Qt\6.X.X\msvc_2019\bin
  3. البناء (استبدل 6.x.x بنسخة Qt الخاصة بك)
mkdir build
cd build
cmake.exe -DCMAKE_PREFIX_PATH="C:\Qt\6.x.x\msvc_2019" -DCMAKE_BUILD_TYPE=Release -G "Ninja" ..
ninja

لينكس

  1. تنصيب التبعيات
  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 ..
make

إذا كنت تستخدم Qt 6.4 ، فأنت بحاجة إلى تعيين المتغير البيئي QT_MEDIA_BACKEND إلى "ffmpeg" في كل مرة تقوم فيها بتشغيل الملف القابل للتنفيذ ، يمكنك وضع المقتطف التالي في ملف bash لتشغيل التطبيق

QT_MEDIA_BACKEND=ffmpeg ./quran-companion

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

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

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

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

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

المشاركة 💡

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

التوثيق 📚

  • تم توثيق كافة أجزاء البرنامج باستخدام منهجية Doxygen يمكنك بناء التوثيق في هيئة html عن طريق الخطوات التالية
  • git clone https://github.com/0xzer0x/quran-companion.git
  • cd quran-companion/docs
  • doxygen

الترجمة 🌐

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

التلاوات 📻

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

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

الحقوق 📌

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

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

الترخيص

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

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

التواصل

0xzer0x - [email protected]

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

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