📚 قاعدة بيانات أذكار الصباح والمساء

قاعدة بيانات أذكار الصباح والمساء هو مشروع مفتوح المصدر يوفر بيانات منظمة لأذكار الصباح والمساء باللغتين العربية والإنجليزية. يتضمن هذا المشروع تنسيقات متنوعة مثل JSON وCSV وSQL وSQLite، والتي تُنشأ من ملفات JSON الأساسية.

✨ أمر الله سبحانه وتعالى عباده المؤمنين بلزوم الذكر، والمداومة عليه في كلّ حينٍ وآن، فقال جلَّ وعلا: {يَا أَيُّهَا الَّذِينَ آمَنُوا اذْكُرُوا اللَّهَ ذِكْرًا كَثِيرًا ۝ وَسَبِّحُوهُ بُكْرَةً وَأَصِيلا} (الأحزاب:41-42)، وقال سبحانه: {فَسُبْحَانَ اللَّهِ حِينَ تُمْسُونَ وَحِينَ تُصْبِحُونَ ۝ وَلَهُ الْحَمْدُ فِي السَّمَاوَاتِ وَالْأَرْضِ وَعَشِيًّا وَحِينَ تُظْهِرُونَ} (الروم:17-18).

📊 هيكل البيانات

📑 أسماء الأعمدة ووصفها

تحتوي الملفات في اللغة العربية واللغة الإنجليزية على الأعمدة التالية:

الوصف	اسم العمود
ترتيب الذكر	order
نص الذكر بالعربية	content
ترجمة النص العربي للذكر	translation (للإنجليزية فقط)
كتابة النص العربي بالأحرف الإنجليزية	transliteration (للإنجليزية فقط)
العدد الموصى به للتكرار	count
فضل أو فائدة تلاوة الذكر	fadl
مصدر الحديث أو الآية القرآنية	source
نوع الذكر (0 للذكر المشمول في الصباح والمساء، 1 للصباح فقط، 2 للمساء فقط)	type
رابط لملف صوتي للذكر	audio
نص الحديث المتعلق بالذكر	hadith_text
شرح لبعض المفردات في الحديث	explanation_of_hadith_vocabulary

📂 هيكلية المستودع

Morning_And_Evening_Adhkar_DB/
├── result/
│   ├── ar.csv
│   ├── ar.json
│   ├── ar.sql
│   ├── ar.sqlite
│   ├── en.csv
│   ├── en.json
│   ├── en.sql
│   ├── en.sqlite
├── scripts/
│   ├── convert_all.sh
│   ├── convert_to_csv.py
│   ├── convert_to_sql.py
│   ├── convert_to_sqlite.py
├── .github/
│   ├── workflows/
│   │   ├── convert_and_commit.yml
├── .gitignore
├── ar.json
├── en.json
├── README.md

🤝 كيفية المساهمة

نرحب بالمساهمات في هذا المشروع! إليك بعض الإرشادات لتبدأ:

1. الملفات الرئيسية: الملفات الرئيسية للمساهمة هي ar.json (العربية) وen.json (الإنجليزية). يجب إجراء أي تعديلات أو إصلاحات على هذه الملفات فقط.
2. الملفات المولدة: الملفات الأخرى في دليل result (مثل ar.csv وen.sqlite) تُنشأ من الملفات الرئيسية JSON. لا تقم بالتعديل في هذه الملفات مباشرة.
3. السكربتات: بعد إجراء التغييرات على ملفات JSON، يمكن تشغيل السكربتات في دليل scripts لإنشاء التنسيقات الأخرى. و أيضاً يتم ذلك تلقائيًا عبر مسار عمل GitHub Action في .github/workflows/convert_and_commit.yml.

📌 خطوات المساهمة

1. قم بعمل fork للمستودع.
2. أنشئ فرعًا جديدًا لتغييراتك.
3. قم بتحرير ملفات ar.json أو en.json حسب الحاجة.
4. قم بعمل commit لتغييراتك وادفعها إلى المستودع الفرعي الخاص بك.
5. قم بإنشاء طلب سحب (Pull Request) من المستودع الفرعي الخاص بك إلى المستودع الرئيسي.

Warning

يرجى التأكد من أن أي تغييرات تُجرى على ملفات ar.json وen.json فقط. حيث يتم التعامل مع تحويل التنسيقات الأخرى تلقائيًا ولا يجب تحريرها يدويًا. لمزيد من التفاصيل حول عملية التحويل، يمكنك الرجوع إلى السكربتات المتوفرة في دليل scripts ومسار عمل GitHub Action في .github/workflows/convert_and_commit.yml.

📚 المصادر

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

📜 الترخيص

هذا المشروع مرخص بموجب رخصة MIT. راجع ملف LICENSE لمزيد من المعلومات.

🌟 ضع نجمة على هذا المستودع 🌟

من فضلك ضع ⭐️ على هذا المستودع وشاركه مع الآخرين

---

سبحَانَكَ اللَّهُمَّ وَبِحَمْدِكَ، أَشْهَدُ أَنْ لا إِلهَ إِلأَ انْتَ أَسْتَغْفِرُكَ وَأَتْوبُ إِلَيْكَ