Quran-App-Data إضافة تفاسير القرآن وترجمات معانيه، ونصه بالرسم الإملائي

السلام عليكم ورحمة الله وبركاته.

جزاك الله خيرا على هذا المستودع القيم، ونفعنا الله وإياكم به.

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

إضافة نص القرآن الكريم بالرسم الإملائي غير المشكول (وربما المشكول أيضا) لتسهيل البحث (أو لأي غرض آخر لا يناسبه الرسم العثماني).

لا أدري ما الصيغة المناسبة؛ ربما قائمة أخرى بجوار verse في ملف كل سورة، مثل الأحاديث؟

أحب أيضا أن أفهم قصدك من العبارة «إن شاء الله مستقبلا سيتم إضافة كل الآيات كملف لاستخدامها في البحث» التي كتبتها في ملف README، فربما أستطيع المساعدة في تنفيذها.

أقترح استخدام: القرآن الكريم/النص المجرد من ويكي مصدر.

سؤال جانبي مرتبط: لماذا verse قاموس وليس قائمة؟ جميع السور تبدأ بالبسملة والتي مفتاحها verse_0 حتى في الفاتحة، عدا التوبة التي تبدأ من verse_1 بغير بسملة. ربما الأفضل فصل البسملة عن جميع السور (عدا الفاتحة، لأنها آيتها الأولى)، وإضافة attribute منفصلة لكل سورة توضح إمكان بدئها بالبسملة من عدمه؟ هذا ما يفعله مشروع Quran-Data مثلا (في ملف meta.txt).

أو على الأقل جعل بسملة الفاتحة هي verse_1، فهي بالفعل آيتها الأولى.
إضافة كتب التفاسير والتراجم للقرآن الكريم.

برنامج آيات الحاسوبي يأتي محمّلا بكتب تفاسير وتراجم، في صورة قواعد بيانات SQLite. أستطيع تحويلها إلى JSON بالصيغة التي تراها مناسبة.

كل واحدة منها جدول واحد به أربعة قيم لكل آية: رقم الآية من بداية المصحف (١-٦٢٣٦)، رقم السورة (١-١١٤)، ورقم الآية داخل السورة، وخانة واحدة نصية للتفسير أو الترجمة. عدا كتابين: التفسير الإنجليزي: تفهيم القرآن للمودودى، والتفسير الروسي؛ كلاهما يسجّلان الترجمة والتفسير في خانتين منفصلتين.

يمكننا كذلك إضافة المزيد من المعلومات عن السور، مثل ترجمة اسمها إلى الإنجليزية، وترتيب نزولها، وربما معلومات أخرى مثل عدد كلماتها وحروفها كموقع equran.me.

Jan 15 '21 19:01 noureddin

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

Jan 16 '21 14:01 Mohamed-Nagdy

جزاك الله خيرا. وأعتذر لتأخري، فقد احتجت أن أبحث أكثر قبل أن أرد.

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

دليل تنزيل التفاسير والتراجم من آيات وتحويلها إلى JSON. إن أحببت، أستطيع أن أقوم بهذه المهمة وأرفع المجلدين المحوّلين (tafasir وtarajem) في PR لهذا المستودع. ولكني أحب أن أعرف رأيك أولا.

وأثناء إعدادي لهذا الدليل، لاحظت أن ملفات الكتب المرفقة مع نسخة لينكس من البرنامج مختلفة عن وندوز، فقارنتها ووجدت أن الاختلافات هي تصليحات أضيفت في ملفات وندوز ولم تصل إلى ملفات لينكس، والاختلاف الوحيد الآخر أن عند عدم وجود تفسير لإحدى الآيات، فإن ملفات لينكس استخدمت إحدى صيغ العبارة «لا يوجد تفسير لهذه الآية» في حين أن ملفات وندوز تركت التفسير فارغا (تحديدا: <p></p>).
ثم ذهبت إلى موقع البرنامج مرة أخرى، ووجدت أن بالإمكان تنزيل الكتب منفردة من صفحة التنزيلات، فقارنتها أيضا بالملفات المرفقة مع نسخة وندوز، ووجدت أيضا أن نسخة وندوز متقدمة عنها في التصليحات.
ثم قمت بتزيل نسخة ماك أيضا للمقارنة، فوجدت أنها مطابقة لملفات نسخة لينكس.
ثم قمت بتنزيل نسخة أندرويد ووجدت أنها لا تحمل التفاسير والتراجم معها، فأظنها تنزل الملفات المنفصلة من موقع البرنامج.
لم أحاول تنزيل نسخة آيفون، ولم أقارن نسخة الوب.

الخلاصة: أظن أن الأخطاء إن وُجدت فهي قليلة بإذن الله، وبرنامج آيات مشهور ومعروف. ويمكن الإشارة في ملف README الخاص بمجلد التفاسير والتراجم أنها مأخوذة من برنامج آيات نسخة وندوز.

ولكني مع ذلك أحببت أن أبحث عن مصادر إضافية. فوجدت:
- موقع التفسير. يقول أن كل تفسير أُدخل كتابةً (وليس مسحا) «ودقق ثلاث مرات على الأقلّ من قبل فرق مختلفة من العلماء». لم أجد طريقة مباشرة لتنزيل شيئا من محتواه، ثم وجدت أن شروط استخدامه تمنع حتى محاولة فعل ذلك (النقاط c و g في الفصل الأول «Accessing the Sites»).
- المكتبة الشاملة (قسم التفاسير). هل هي مناسبة؟
- موقع تنزيل، والذي يتيح النص القرآني بعدة صيغ (عثماني، عثماني بتشكيل أقل، إملائي بأربعة مستويات من التشكيل). لديهم صفحة موارد، والتي تشير إلى صفحة التفاسير والتراجم (متاح الجلالين والميسر فقط للغة العربية)، والتي تشير إلى مصدر هذه الكتب، فوصلت إلى…
- موقع مجمع الملك فهد لطباعة المصحف الشريف، وهو الذي أصدر مصحف المدينة النبوية الشائع. هم أيضا يصدرون التفسير الميسر. فأظن أن هذا هو أدق المصادر وأكثرها موثوقية للتفسير الميسر. يمكن تنزيل التفسير الميسر (ونص المصحف بالرسم العثماني بعدة روايات، بل وصور المصحف بصيغة AI) من صفحة خدمات مطوري برمجيات القرآن الكريم. هذا أدق ما استطعت الوصول إليه.
  
  ووجدتهم أيضا يعملون على ترجمة معاني القرآن الكريم. لكني لم أجد أن بالإمكان تنزيل التراجم بصيغة نصية (غير PDF). (كان بحثي مركزا على التفاسير؛ إن أردنا إضافة التراجم كذلك، فيمكننا الوصول إلى العديد من المصادر الموثوقة الأخرى بإذن الله.)
بالنسبة لـ«رقم الآية في القرآن» و«رقم الآية في السورة»، فهذه المعلومات بالفعل في كل جدول من جداول كتب برنامج آيات. ومتاحة كذلك (والمزيد) من موقع تنزيل. أستطيع الوصول إلى مصادر أخرى إن شئت.
أما عن «الآية بتشكيل وبدون تشكيل»، فهما متاحان بالفعل على ويكي مصدر: القرآن الكريم/النص المشكول والقرآن الكريم/النص المجرد، وتحويلهما إلى JSON أو غيرها يسير إن شاء الله. ومتاحان كذلك في موقع تنزيل، بأربعة مستويات للتشكيل في الرسم الإملائي.
بالنسبة لـverse، فقصدت شيئين، أولهما هو أنها قاموس وليست قائمة، مثلا في ملف سورة الإخلاص نجد:
```
    "verse": {
        "verse_0": "بِسْمِ اللَّهِ الرَّحْمَٰنِ الرَّحِيمِ",
        "verse_1": "قُلْ هُوَ ٱللَّهُ أَحَدٌ",
        "verse_2": "ٱللَّهُ ٱلصَّمَدُ",
        "verse_3": "لَمْ يَلِدْ وَلَمْ يُولَدْ",
        "verse_4": "وَلَمْ يَكُن لَّهُۥ كُفُوًا أَحَدٌۢ"
    },
```
مع أني أتوقع:
```
    "verse": [
        "قُلْ هُوَ ٱللَّهُ أَحَدٌ",
        "ٱللَّهُ ٱلصَّمَدُ",
        "لَمْ يَلِدْ وَلَمْ يُولَدْ",
        "وَلَمْ يَكُن لَّهُۥ كُفُوًا أَحَدٌۢ"
    ],
```
وثانيهما هو البسملة: البسملة هي الآية الأولى من سورة الفاتحة (وجزء من آية في سورة النمل)، وجميع السور يجب أن تبدأ بالبسملة، عدا التوبة (وكذلك الفاتحة، لأن البسملة آية منها بالفعل).

ولتوضيح الأمر أكثر: عدد آيات الفاتحة سبعة (منها البسملة)، ونجد أن عدد عناصر verseـها هو سبعة فعلا. والإخلاص عدد آياتها أربعة، لكن عدد عناصر verseـها هو خمسة! كُسر الاتساق بين عدد الآيات وعدد عناصر verse.

وليس هذا فحسب، بل إن آيات الفاتحة مختلفة عن المصحف، فالآية الأخيرة هي السابعة، وليست السادسة كما يقول الملف، وآية «الحمد لله رب العالمين» هي الآية رقم اثنين، ولكن الملف يقول أنها الآية رقم واحد.

أرى حلين لهذه المشكلة (أو فعليا أربعة حلول):
1. حذف البسملة من بداية جميع السور (عدا الفاتحة)، وإضافة attribute إلى كل سورة توضح هل يمكن بدء هذه السورة بالبسملة أم لا. هذا ما يفعله مثلا مشروع Quran-Data (لاحظ الصفر في الخانة الثالثة أمام الفاتحة والتوبة). ويمكننا حينئذٍ تحويل verse من قاموس إلى قائمة، أو بدء القاموس دائما بـverse_1.
2. الإبقاء على verse كقاموس، لكن جعل البسملة (الإضافية) هي دائماverse_0. هذا ما تفعله بالفعل في جميع السور، عدا الفاتحة؛ بسملة الفاتحة هي الآية الأولى منها، وليست «الآية صفر». فهذا الحل يتطلب تعديلا واحدا هو جعل بسملة الفاتحة verse_1 ودفع الآيات الأخرى للأمام خطوة (فتكون الآية الأخيرة هي السابعة (وهو الترقيم المطابق للمصحف) وليست كما هي الآن، الآية السادسة)،
  
  فنجد وقتئذٍ أن عدد الآيات هو نفسه رقم الآية الأخيرة في جميع السور، وأن «الآية صفر» يمكن حذفها (مثلا) أو تنسيقها بشكل مختلف أو معاملتها معاملة خاصة حسب التطبيق، مثلا عند الاستماع إلى الآيات، الآية صفر من أيّة سورة ستُترجم إلى الآية الأولى من الفاتحة. لاحظ أن في هذا المثال (الاستماع إلى الآيات)، الترقيم الحالي لآيات الفاتحة سيتطلب معاملة خاصة لها، لاختلاف رقم الآية المسجّل (في ملف الـJSON) عن رقم الآية الفعلي.
  
  يمكن تنفيذ هذا بقائمة أيضا: العنصر صفر إما يحمل البسملة أو يحمل القيمة null (أو النص الفارغ ""، لا أدري أيهما أنسب)، والعنصر واحد يحمل الآية رقم واحد، وهكذا. هكذا نحافظ على ترقيم الآيات بدءا من الواحد، ونخبر التطبيق المستخدِم عن البسملة بغير attribute إضافية.
تلخيص هذه الحلول الأربعة:
1. حذف البسملة من بداية جميع السور عدا الفاتحة، وإضافة attribute بقيمة true لجميع السور، وبقيمة false للفاتحة والتوبة (أو العكس).
2. نفس الحل السابق + تحويل verse من قاموس إلى قائمة.
3. زيادة رقم verse في جميع آيات سورة الفاتحة فقط.
4. تحويل verse جميع السور إلى قائمة (وبها البسملة في العنصر الأول)، وإضافة null (أو ""؟) قبل العنصر الأول في الفاتحة والتوبة.

بالمناسبة، على GitHub، تستطيع بدء أي محتوى Markdown عربي (ملف أو تعليق) بكتابة

<div dir="rtl">

متبوعًا بسطر فارغ، ثم استخدام Markdown كما تشاء. وسيظهر النص العربي مضبوطا حتى عند خلطه بكلمات إنجليزية. ولا حاجة لغلقها (‪</div>‬) في نهاية الملف أو التعليق. :smiley:

Jan 19 '21 01:01 noureddin

انا بصراحة مش قادر ارد عليك بعد المجهود العظيم اللي انت عملته ده واستفدت منك جدا جدا بالمواقع والمعلومات الجبارة اللي حضرتك حبتاه ف حضرتك تقدر تضيف اللي تقدر عليه ويكبر ال repo ده ويكون شامل وجامع لكل الداتا اللي اي حد ممكن يحتاجها لتطبيق او موقع اسلامي وربنا يجعله في ميزان حسناتنا جميعا يارب

Jan 19 '21 23:01 Mohamed-Nagdy

أعتذر مجددا على تأخر ردي.

ربنا يجعله في ميزان حسناتنا جميعا يارب

جزاك الله خيرا، ونفعنا به وجعل عملنا هذا خالصا لوجهه الكريم.

انا بصراحة مش قادر ارد عليك بعد المجهود العظيم اللي انت عملته ده واستفدت منك جدا جدا بالمواقع والمعلومات الجبارة اللي جبتها

لقد بحثت على الإنترنت وحسب. 😅 وأكثر من نصف تعليقي السابق كان معلومات جديدة بالنسبة لي، وقد استفدت شخصيا كثيرا وتعلمت كثيرا أثناء إعدادي إياه. ولا داعٍ لكلمة «حضرتك». 😄

تقدر تضيف اللي تقدر عليه ويكبر ال repo ده ويكون شامل وجامع لكل الداتا اللي اي حد ممكن يحتاجها لتطبيق او موقع اسلامي

أتفق معك، فوجود هذه الموارد القيّمة في مكان واحد يسهّل كثيرا على المطورين، بل وقد يلهمهم أفكار تطبيقات لم تكن لتأتيهم لولا أن تيسّرت لهم هذه الموارد القيّمة. جزاك الله خيرا على بدء هذا المستودع وملئه بهذا المحتوى القيم.

أرسلت طلب ضم (#4). ووصفه مفصّل نسبيا، لكن خلاصة ما فيه ما يلي:

إضافة التفاسير والتراجم من برنامج آيات، مع الإشارة إلى تراجم تنزيل وقائمة مواردهم والتفسير الميسر من مجمع الملك فهد.
إضافة الـmetadata من تنزيل، مع جعلها تتبع نفس الصيغة المستخدمة في ملفي الأجزاء والسور في هذا المستودع.
تصحيح ترقيم سورة الفاتحة مؤقتا (انتظر نقطة verse بالأسفل).
إضافة وصف لملفات التفاسير ولملفات الـmetadata ومحتوياتها.

ولدي سؤال: في ملف السور، حقل page مفهوم أنه صفحة السورة (الآية الأولى منها) في مصحف المدينة، لكن ماذا يعني حقل pages (بالـs)؟ لا يبدو لي أنه يحمل عدد صفحات السورة في مصحف المدينة، بل صفحة بداية السورة (أيضا) لكن في مصحف آخر غير مصحف المدينة، نظرت إلى مصحف الأزهر (طبعة الشمرلي) لكني وجدته مختلف عن هذه الأرقام. فلم أستطع شرح هذا الحقل في README المجلد. فما هو؟

أقترح كذلك:

تحويل جميع الأرقام إلى أرقام فعلية، وليست أرقاما في صورة strings، (أي 1 وليس "1" أو "001" أو "verse_1").
إضافة ملف (Markdown) لجمع الموارد المختلفة وتنظيمها، مثلا صفحة الموارد على موقع تنزيل، صفحة خدمات المطورين على موقع مجمع الملك فهد، موقع المكتبة الشاملة، موقع صوتيات آيات القرآن، إلخ. مع وصف شامل لكن قصير عن كل مورد.

verse: اقترحت أربعة حلول، هل ترى أن أحدها مناسب أم تقترح حلا آخر؟

اقتراحي الثالث يتطلب أقل تعديلات (تعديل مفاتيح سورة الفاتحة فقط)، لكن الرابع هو الأقرب إلى أسلوب metadata تنزيل؛ فجميع قوائم metadata تنزيل، بلا استثناء (حتى قائمة السجدات)، تهمل العنصر رقم صفر، مما يجعل قوائمها فعليا ‎1-based.

بحثت كثيرا ولازلت لا أدري أيهما الأنسب: استخدام null أم "" في الاقتراح الرابع (في العنصر رقم صفر من الفاتحة والتوبة، بدلا من البسملة الإضافية). أميل إلى "" إن اخترتَ هذا الاقتراح.

لكني عموما أحبّذ تحويلها إلى قائمة (الاقتراح الثاني أو الرابع).

إضافة نص القرآن الكريم بالرسم الإملائي، بالتشكيل وبدونه. لم أضفه بعد لأني أقترح إضافته بنفس شكل قائمة verse بالضبط، وبجوارها في نفس ملف السورة، فأنتظر قولك في الأمر السابق (verse) وكذلك في مكان إضافته.

موقع تنزيل يوفّر عدة صيغ للرسم الإملائي، منها المشكول طبقا لقواعد الإملاء الحديثة، والخالي من التشكيل. قارنتهما (Simple وSimple Clean) مع المتاح عبر ويكي مصدر (المشكول والمجرد)، فلاحظت الفروق التالية:

اختلاف الرخصة:
- ويكي مصدر يستخدم CC BY-SA 3.0، بغير قيود إضافية. (الإشارة إلى المصدر وحسب.)
- تنزيل يستخدم CC BY 3.0 مع فرض الإشارة إلى الموقع دوما وكذلك إلى الـ"copyright notice". (اقرأ الترخيص في صفحة التنزيل.) لا أجد في فرض نسخ الـ"copyright notice" حرجا لأنه يفرض فعل ذلك في الملف الذي يضم النص فقط (أي الكود المصدري؛ لا قيود على الناتج أو الواجهة الرسومية)، أما نقطة الإشارة إلى الموقع بوضوح للمستخدمين، رغم إني أؤيدها وأفهم المنطق من ورائها، إلا أني لست متأكدا أن جميع التطبيقات سيناسبها هذا. إلا إن كان فهمي خاطئا لرخصتهم.

اختلاف في رسم ثلاث كلمات، وهذا هو الاختلاف الوحيد في الرسم:

الموضع	تنزيل الإملائي	ويكي مصدر الإملائي	النص بالرسم العثماني
سورة طه، الآية ٩٤	قَالَ يَا ابْنَ أُمَّ…	قَالَ يَبْنَؤُمَّ…	قَالَ يَبْنَؤُمَّ…
سورة القلم، الآية ٦	بِأَيْيِكُمُ الْمَفْتُونُ	بِأَيِّكُمُ الْمَفْتُونُ	بِأَييِّكُمُ ٱلْمَفْتُونُ
سورة الجن، الآية ١٦	وَأَنْ لَوِ اسْتَقَامُوا…	وَأَلَّوِ اسْتَقَامُوا…	وَأَلَّوِ ٱسْتَقَٰمُوا۟…

في النص المشكول، بالإضافة إلى اختلاف الرسم السابق، اختلف ترتيب الشدة مع الحركة: كتب تنزيل الشدة دائما قبل الحركة، وهذا هو الشائع في رأيي، أما ويكي مصدر فكتبها بعد الحركة. لا فرق ظاهر بين الاثنين، لكن إن احتجت التعامل مع النص على مستوى المحارف (characters)، فستحتاج أن تعرف هذا. احتجتُ إلى تبديل موضع الشدة مع الحركة في نص ويكي مصدر حتى أقارنه مع نص تنزيل.

لاحظ أن الاثنين يتّبعان قواعد الإملاء الحديثة قدر الإمكان، بغض النظر عن رسم الكلمة في الرسم العثماني (باستثناءات قليلة مثل كتابة التاء المفتوحة كالرسم العثماني، مثل «رحمت ربك» و«امرأت فرعون»).

أترك لك اختيار أحد المصدرين أو غيرهما. 😃 وأستطيع تحويله إلى الصيغة المناسبة بعد الاتفاق على نقطة verse السابقة وتحديد مصدر النص.

أيضا أحب أن أذكّر بأن الاثنين يطلبان الإشارة إلى المصدر. والأفضل الإشارة إلى المصدر حتى وإن لم يطلباه. فسأشير إلى مصدر النص في ملف README الخاص بمجلد السور (بفرض أن النص الإملائي سيوضع في ملف كل سورة بجوار النص العثماني). لذا أظن أيضا أن من المناسب ذكر مصدر النص العثماني كذلك. فما هو؟

لدي اقتراح آخر كذلك:

أسماء الله الحسنى:

حاليا كل اسم له حقل واحد يحمل الاسم باللغة العربية ومكتوبا بالتشكيل. أقترح إضافة:
- الاسم باللغة العربية من غير تشكيل،
- ترجمة صوتية للاسم،
- ترجمة معنى الاسم إلى الإنجيزية (عدا «الله»، يُكتب «Allah»)، ويمكن إضافة أكثر من ترجمة مفصولة بـ, مثلا،
- شرح معنى الاسم بالعربية،
- هل الاسم ثابت في القرآن أو السنة أم لا.

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

Jan 23 '21 08:01 noureddin

بارك الله فيكما انتم الاثنين بس هل استخدام الداتا الخاصة ببرنامج ايات مصرح به ومفتوح المصدر ام ماذا ؟

Feb 21 '21 20:02 moh21amed

لا أجد شيئا في صفحة تنزيل تطبيق آيات عن ترخيص استخدام التفاسير والتراجم وحدها. مذكور فقط أن البرنامج (ككل) يمكن توزيعه للاستخدام الشخصي وغير التجاري.

لكن نافذة حول المشروع في صفحة التطبيق (التي لم ألاحظها إلا الآن)، تقول أن مصدر التراجم هو موقع تنزيل، ومصدر التفاسير هو موقع المصحف.

ولكن موقع المصحف أيضا لا يوضّح وجود أي قيود على التفاسير.

Mar 01 '21 00:03 noureddin

Quran-App-Data Quran-App-Data copied to clipboard

إضافة تفاسير القرآن وترجمات معانيه، ونصه بالرسم الإملائي

Quran-App-Data
Quran-App-Data copied to clipboard