تخطَّ إلى المحتوى

موارد

المطوّرون

موارد للمطوّرين الذين يبنون بالبيانات القرآنية.

مدوّنتنا القرآنية

يُقدَّم النص القرآني وبيانات الكلمات والترجمات والتفاسير والحواشي والبحث وبيانات الصوت من قاعدة بياناتنا الخاصة عبر qurangallery.com/quran/api/quran. ولا يعتمد شيء في صفحة القراءة على توافر واجهة برمجية لطرف ثالث.

تغطي القرآن كاملًا بستة أنماط من الرسم، و١٥٠ ترجمة، و٢٣ تفسيرًا، ومواضع الصفحة والسطر لكل كلمة في كل مصحف — إضافةً إلى بيانات السور والآيات والأجزاء وسائر التقسيمات. وتتبع الاستجابات بنية v4 التي تتوقعها أغلب أدوات القرآن، فتقرؤها البرامج القائمة دون تعديل. أما صوت التلاوة نفسه فما زال يُبثّ من QuranCDN.

مرجع الواجهة البرمجية

كل نقطة نهاية أدناه تُقدَّم من مدوّنتنا الخاصة، وتقبل معاملات الاستعلام المعتادة في v4 (language وtranslations وwords وpage).

من أهم نقاط النهاية:

  • /chapters — قائمة السور الـ١١٤ كلها مع بياناتها
  • /verses/by_chapter/:id — جلب آيات سورة معيّنة
  • /search — بحث نصي كامل في الترجمات
  • /resources/recitations — القرّاء والملفات الصوتية المتاحة
  • /resources/translations — الترجمات المتاحة بجميع اللغات

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

بُني معرض القرآن بتقنيات ويب حديثة تركّز على الأداء وسهولة الوصول:

الواجهة الأمامية
SvelteKit 2 مع Svelte 5، وTailwind CSS v4
بيئة التشغيل
Node.js على خادم VPS مستضاف ذاتيًّا (adapter-node)
قاعدة البيانات
PostgreSQL عبر Drizzle ORM
تعدّد اللغات
Paraglide JS — ٧ لغات بينها لغات من اليمين إلى اليسار

المصدر المفتوح

نؤمن بالتعاون المفتوح في المشاريع التي تخدم المجتمع المسلم. والمساهمات مرحّب بها — سواء أكانت إصلاح أخطاء، أو تحسين ترجمات، أو إضافة ميزات، أو تعزيز سهولة الوصول.

البنية التقنية

يعمل معرض القرآن مستودعًا موحّدًا (monorepo) من خدمات Node.js، تخدم كلٌّ منها جزءًا مختلفًا من المنصة. ويوجّه Caddy الطلبات بحسب بادئة المسار إلى الخدمة المناسبة على الخادم.

qurangallery.com (البوابة)  /quran   → قارئ القرآن وأدوات الدراسة  /chat    → محادثة قرآنية بالذكاء الاصطناعي  /studio  → استوديو الفن الإسلامي  /hifz    → متابعة الحفظ  /adhkar  → الأذكار اليومية  /blog    → مقالات وأدلة

التواصل

للأسئلة التقنية أو مشكلات الواجهة البرمجية أو استفسارات التعاون، راسلنا على [email protected] أو افتح بلاغًا على GitHub.