تخطَّ إلى المحتوى
برمجة

كيف تبني تطبيق قرآن؟ مصدر النص وصوت كل آية وبرومبت جاهز

نص مصحف موثوق، وصوت كل آية وحدها مجاناً من Tanzil، وبرومبت مجرَّب يبني لك قارئاً صوتياً في صفحة HTML واحدة — الوصفة التي بُني بها تطبيق رِفقة.

8 دقائق قراءة
كيف تبني تطبيق قرآن؟ مصدر النص وصوت كل آية وبرومبت جاهز
فهرس المقال

الجواب المختصر: تحتاج ثلاثة أشياء فقط — نصّ مصحف موثوق، ومصدر صوت يعطيك كل آية كملفّ مستقل، وطريقة تحفظ بها موضع القارئ. كلها متاحة مجاناً، وكلها في هذا المقال. وفي آخر المقال برومبت جاهز يبني لك أول قارئ صوتي شغّال في صفحة HTML واحدة، خلال دقائق.

الوصفة التي نشرحها هنا ليست نظرية. هي الوصفة نفسها التي بُني بها تطبيق رِفقة — تطبيق قراءة القرآن اليومية من أكاديمية قطوف. لن نخفي منها شيئاً.

شاشة القراءة في تطبيق رِفقة

لماذا يفشل معظم من يحاول؟

من يبدأ ببناء تطبيق قرآن يتعثّر في العادة عند سؤالين، لا عند البرمجة:

  1. من أين آتي بنصّ مصحف صحيح؟ نسخ النص من موقع عشوائي وصفة لكارثة: علامات ضبط ناقصة، وأخطاء إملائية في كلام الله، وترقيم آيات مختلف عن المصحف المطبوع.
  2. كيف أشغّل الصوت عند آية بعينها؟ أغلب مصادر الصوت تعطيك السورة كاملة في ملفّ واحد مدّته أربعون دقيقة. وهذا لا ينفع لتطبيق يتابع القارئ آية آية.

الخبر الجيد أن للسؤالين مصدراً واحداً يحلّهما معاً.


أولاً: من أين نأتي بنصّ المصحف؟

المصدر هو tanzil.net — مشروع متخصّص في نشر نصّ القرآن رقمياً، يُعِدّ نصّه ويدقّقه ويراقبه فريق من المتخصّصين. هو المرجع الذي تبني عليه تطبيقات كثيرة، ونصّه هو ما يعرضه رِفقة.

ما يميّزه:

  • نصّ مأخوذ من مصحف المدينة برواية حفص عن عاصم، مدقَّق ومراجَع باستمرار.
  • صيغتان للرسم: الرسم العثماني (كما في المصحف المطبوع)، والرسم الإملائي المضبوط (أسهل قراءةً لمن لم يعتد الرسم العثماني، وأسهل للبحث والمقارنة النصّية).
  • ترقيم آيات موافق لمصحف المدينة: 114 سورة، و6236 آية.
  • صيغ تحميل جاهزة: نصّ عادي، ونصّ بأرقام الآيات، و XML، و SQL.

الأمانة الواجبة قبل الاستعمال

نصّ Tanzil منشور بترخيص المشاع الإبداعي (CC BY 3.0)، وله شروط استخدام واضحة:

  • لا تُغيّر في النصّ حرفاً — النسخ والتوزيع مسموحان كما هو فقط.
  • اذكر المصدر بوضوح (مشروع Tanzil)، مع رابط إلى tanzil.net حتى يستطيع مستخدموك متابعة تحديثات النص.
  • احتفظ بإشعار حقوق النسخ في كل نسخة من النص أو ملفّ مشتقّ منه.

اقرأها من صفحتهم قبل أن تشحن أي منتج. هذه ليست تفصيلة قانونية — هي أمانة في نقل كلام الله.

درس عملي من رِفقة

نحن لا نطلب النصّ من الشبكة أثناء التشغيل. المصحف كامل مُضمَّن داخل التطبيق كملفّ بيانات، ومعه بصمة تحقّق (SHA-256) وسكربت نشغّله ليتأكّد أن الملف سليم: 114 سورة، و6236 آية، والبصمة مطابقة. السبب بسيط: القارئ الذي يفتح المصحف في مسجد بلا إنترنت يجب أن يقرأ. لا شيء في قراءة النصّ يجوز أن يعتمد على الشبكة.

هذا قرار معماري، لا تفصيلة تقنية — وهو الفرق بين تطبيق يُستعمل وتطبيق يُحذف.


ثانياً: كيف نشغّل صوت كل آية على حدة؟

وهنا الجزء الذي يبحث عنه الناس ولا يجدونه.

Tanzil يستضيف أرشيف MP3 مجانياً، مقسّماً آية آية (وينسب التسجيلات في صفحة الشكر إلى مشروع Verse By Verse Quran). وبنية الرابط بسيطة إلى حدّ يثير الدهشة:

https://tanzil.net/res/audio/{القارئ}/{السورة}{الآية}.mp3
تشريح رابط الصوت

القاعدة الوحيدة: رقم السورة ورقم الآية، كلٌّ منهما مكمَّل إلى ثلاث خانات بالأصفار، وملتصقان بلا فاصل.

ما تريده السورة الآية الجزء الأخير من الرابط
الفاتحة، الآية ١ 1 1 001001
البقرة، آية الكرسي 2 255 002255
الناس، الآية ٦ 114 6 114006

فلو أردت آية الكرسي بصوت الشيخ سعود الشريم:

https://tanzil.net/res/audio/shuraim/002255.mp3

الصقه في متصفّحك الآن. سيشتغل.

⚠️ فخّ لن تجده مكتوباً في أي مكان: إن طلبت آية غير موجودة — الآية 8 من الفاتحة مثلاً — لا يرجع الأرشيف خطأً، بل يرجع بصمت تسجيل الآية الأولى من الفاتحة بصوت القارئ نفسه. فلا تعتمد على فشل التحميل لتعرف أن السورة انتهت: ضع في كودك عدد آيات كل سورة (الفاتحة 7 … الناس 6)، وانتقل من آخر آية إلى أول السورة التالية بنفسك.

أسماء القرّاء المتاحة

هذه المعرّفات مستعملة فعلاً في رِفقة، وجرّبناها كلها عند مراجعة هذا المقال:

المعرّف القارئ المعرّف القارئ
shuraim سعود الشريم husary محمود خليل الحصري
sudais عبد الرحمن السديس husary-mjwd الحصري (مجوّد)
afasy مشاري العفاسي abdulbasit عبد الباسط عبد الصمد
muaiqly ماهر المعيقلي minshawi محمد صديق المنشاوي
ghamadi سعد الغامدي ajamy أحمد بن علي العجمي
hudhaify علي الحذيفي akhdar إبراهيم الأخضر

أمانة تجاه مصدر مجاني: هذا أرشيف يستضيفه مشروع يقدّمه للناس بلا مقابل. لا تسحب منه آلاف الملفات في حلقة برمجية، وخبّئ (cache) ما نزّلته إن احتجت إليه مرّة أخرى. في رِفقة لا نطلب إلا الآية التي يستمع إليها القارئ الآن، ولا نحمّل شيئاً مسبقاً. عامِل المصدر المجاني كما تحبّ أن يُعامَل مصدرك.


🎁 الهدية: برومبت يبني لك أول قارئ صوتي

هذا هو الجزء العملي. انسخ البرومبت التالي كما هو، وألصقه في Claude أو ChatGPT أو أي مساعد برمجي. سيبني لك صفحة HTML واحدة تشتغل فوراً.

من البرومبت إلى صفحة تعمل

البرومبت (انسخه كما هو)

اصنع لي صفحة HTML واحدة، ملفاً واحداً بلا أي مكتبات خارجية، تشغّل القرآن آية آية.

المتطلّبات:

1) مصدر الصوت هو أرشيف tanzil.net المجاني، ونمط الرابط:
   https://tanzil.net/res/audio/{reciter}/{SSS}{AAA}.mp3
   حيث SSS رقم السورة و AAA رقم الآية، كلٌّ منهما مكمَّل إلى 3 خانات بالأصفار.
   مثال: سورة 2 آية 255 بصوت shuraim →
   https://tanzil.net/res/audio/shuraim/002255.mp3
   تنبيه: الأرشيف لا يرجع خطأً لآية غير موجودة، بل يرجع الآية الأولى من الفاتحة بصمت.

2) الواجهة (عربية بالكامل، واتجاه RTL):
   - قائمة اختيار للقارئ فيها: shuraim (سعود الشريم)، husary (الحصري)،
     sudais (السديس)، afasy (العفاسي)، muaiqly (المعيقلي).
   - حقل لرقم السورة (1 إلى 114) وحقل لرقم الآية لا يتجاوز عدد آيات السورة.
   - زرّ "استمع"، وزرّ "الآية التالية"، وزرّ "الآية السابقة".
   - خانة اختيار "تشغيل متتابع": عند انتهاء الآية ينتقل تلقائياً إلى التي بعدها.

3) السلوك:
   - استعمل عنصر <audio> واحداً وبدّل مصدره، لا تُنشئ عنصراً لكل آية.
   - ضمّن في الكود عدد آيات كل سورة (114 رقماً: الفاتحة 7 … الناس 6).
     "الآية التالية" والتشغيل المتتابع ينتقلان من آخر آية في السورة إلى
     أول السورة التي بعدها، و"الآية السابقة" من أول آية إلى آخر التي قبلها،
     ويتوقّف التشغيل بعد آخر آية في سورة الناس.
   - أظهر حالة واضحة: "جارٍ التحميل…"، و"تعذّر تحميل هذه الآية" عند الفشل.
   - عطّل زرّ "استمع" أثناء التحميل حتى لا يُضغط مرّتين.
   - احفظ آخر قارئ وآخر موضع في localStorage واسترجعهما عند إعادة الفتح.

4) التصميم:
   - هادئ ومريح للعين، خلفية فاتحة، مساحات واسعة، وخط عربي واضح.
   - أهداف اللمس لا تقلّ عن 44×44 بكسل (التطبيق قد يستعمله كبار السنّ).
   - يعمل على شاشة الهاتف قبل شاشة الحاسوب.

5) اكتب تعليقاً في أعلى الملف ينسب مصدر الصوت إلى tanzil.net.

أعطني الملف كاملاً جاهزاً للحفظ باسم quran-player.html، ولا تشرح — الكود فقط.

ماذا تتعلّم من هذه التجربة؟

بعد أن تشتغل الصفحة، غيّر شيئاً واحداً بيدك: بدّل shuraim إلى husary وأعد التشغيل. في هذه اللحظة بالذات تفهم الدرس الحقيقي — التطبيق ليس سحراً، هو رابط مبنيّ بقاعدة. وكل ما بعد ذلك تفاصيل: حفظ الموضع، وتتبّع التقدّم، والتصميم.


وماذا في رِفقة أكثر من ذلك؟

الوصفة أعلاه تعطيك مشغّلاً. أمّا أن تبني منتجاً يعود إليه الناس كل يوم، فذلك يحتاج أكثر بكثير من مشغّل. هذه أبرز ما في رِفقة:

📖 المصحف كاملاً بلا إنترنت النصّ مُضمَّن في التطبيق. تفتح وتقرأ في الطائرة، وفي المسجد، وفي أي مكان. (الصوت وحده يحتاج اتصالاً، لأنه يُجلب آية آية عند تشغيله.)

📍 موضعك محفوظ دائماً تُغلق التطبيق وتعود بعد أسبوع، فتجد نفسك عند الآية التي وقفت عندها بالضبط — لا عند أول السورة.

🎧 ٢٦ قارئاً، آية آية تختار الشيخ الذي تحبّ صوته، وتستمع إلى الآية التي أمامك وحدها.

🤝 رِفقة تقرأ معك تُنشئ مجموعة صغيرة — زوجتك، أو أبناؤك، أو ثلاثة أصدقاء — وتتّفقون على وردٍ يومي. ترى من قرأ اليوم ومن لم يقرأ، بلا دردشة ولا لوحة ترتيب.

🕌 ختمة جماعية تقسمون المصحف بينكم وتختمونه معاً. كلٌّ يأخذ نصيبه، والتطبيق يتتبّع الباقي.

🔔 تذكير لا يزعج تذكير في الوقت الذي تختاره — ولا يصلك أبداً في يومٍ أتممت فيه وردك. لأن التذكير الذي يذكّرك بما فعلته إهانة، لا خدمة.

🌱 بلا عقاب في التطبيق سلسلة أيام تفرح بها، لكن انقطاعها لا يُقابَل بلوم. لا نقاط، ولا ترتيب بين الناس في عبادتهم، و«كل عودة بداية جديدة» — هذا مبدأ مكتوب في وثيقة المنتج، لا شعار تسويقي.

👵 مصمَّم لكبار السنّ أولاً خطّ قرآن كبير قابل للتكبير، وتباين واضح، وأهداف لمس واسعة، ودعم قارئ الشاشة.

🌿 حمّل رِفقة: من App Store · من Google Play — واقرأ اليوم ولو آية واحدة.


أسئلة يسألها الناس

هل استعمال نصّ Tanzil مجاني؟ نعم، في أي موقع أو تطبيق، بترخيص المشاع الإبداعي (CC BY 3.0) وبشروطهم المنشورة: لا تغيير في النصّ، وذكر المصدر بوضوح مع رابط إلى tanzil.net، والحفاظ على إشعار حقوق النسخ. راجع صفحة الشروط عندهم قبل النشر.

ما أفضل صيغة للرسم أختارها؟ الرسم العثماني إن أردت أن يطابق ما يراه القارئ المصحفَ المطبوع، والرسم الإملائي المضبوط إن أردت قراءة أسهل لمن لم يعتد العثماني، وهو الأنسب أيضاً للبحث والمقارنة النصّية داخل الكود. رِفقة يعرض الإملائي المضبوط، وكثير من التطبيقات يحمل الاثنين.

هل أستطيع بناء التطبيق بلا خبرة برمجية؟ تستطيع بناء الصفحة التي في البرومبت أعلاه اليوم. أمّا تطبيق متجر كامل فيحتاج تعلّماً حقيقياً — لكن ابدأ بالصفحة، فهي أصدق اختبار لرغبتك في إكمال الطريق.

لماذا آية آية وليس السورة كاملة؟ لأن التطبيق يتابع القارئ. حين تعرف أيّ آية يسمعها الآن، تستطيع أن تُبرزها، وتحفظ موضعه، وتحسب ما قرأه. ملفّ السورة الواحد يجعل كل ذلك مستحيلاً.


تريد أن تتعلّم صناعة تطبيق مثل هذا؟

إن أوصلك هذا المقال إلى هنا، فأنت غالباً من النوع الذي لا يكتفي بالاستعمال. الوصفة أعطيناكها كاملة — والباقي مهارة تُبنى بالممارسة، من أول سطر إلى تطبيق منشور في المتاجر.

🎓 دورة «من فكرة إلى تطبيق على المتاجر» — في أكاديمية قطوف.