Merge branch 'albayan_beta' of https://github.com/tecwindow/albayan into albayan_beta

Author: MahmoudAtef999

core_functions/info.py

@@ -215,8 +215,8 @@ def _format(self, data: dict) -> str:
             "english_name": "الاسم بالإنجليزية",
             "revelationType": "نوع السورة",
             "numberOfAyahs": "عدد الآيات",
-            "firstAyahNumber": "رقم أول آية في المصحف",
-            "lastAyahNumber": "رقم آخر آية في المصحف",
+            "firstAyahNumber": "رقم أول آية بترتيب المصحف",
+            "lastAyahNumber": "رقم آخر آية بترتيب المصحف",
             "start_page": "تبدأ في الصفحة",
             "end_page": "تنتهي في الصفحة",
             "start_hizb": "تبدأ في الحزب",
@@ -295,7 +295,7 @@ def _format(self, data: dict) -> str:
 يبدأ في الحزب {data["start_hizb"]} وينتهي في الحزب {data["end_hizb"]}.
 عدد السور في الجزء: {data["count_surahs"]}.
 عدد الآيات في الجزء: {data["count_ayahs"]}.
-السور الموجودة في الجزء: {data["surah_names"]}.
+السور في الجزء: {data["surah_names"]}.
 """
         logger.debug(f"Formatted information for Juz {data['juz_number']}.")
         return text.strip()
@@ -363,7 +363,7 @@ def _format(self, data: dict) -> str:
 يبدأ في الربع {data["start_hizbQuarter"]} وينتهي في الربع {data["end_hizbQuarter"]}.
 عدد السور في الحزب: {data["count_surahs"]}.
 عدد الآيات في الحزب: {data["count_ayahs"]}.
-السور الموجودة في الحزب: {data["surah_names"]}.
+السور في الحزب: {data["surah_names"]}.
 """
         logger.debug(f"Formatted information for Hizb {data['hizb_number']}.")
         return text.strip()
@@ -431,12 +431,12 @@ def _format(self, data: dict) -> str:
 رقم الربع: {data["quarter_number"]}.
         يبدأ الربع {data["quarter_number"]} من الآية {data["start_ayah_number"]} في {data["start_sura_name"]}.
 ينتهي الربع في الآية {data["end_ayah_number"]} من {data["end_sura_name"]}.
-موضع الربع في الجزء: الربع {data["quarter_order_in_hizb"]} من الحزب {data["hizb"]} في الجزء {data["juz_number"]}.
-موضع الربع في المصحف:
+موضع الربع في الجزء: الربع {data["quarter_order_in_hizb"]} في الحزب {data["hizbOrderInJuz"]} في الجزء  {data["juz_number"]}.
+موضع الربع في المصحف: الربع {data["quarter_order_in_hizb"]} من الحزب {data["hizb"]} في الجزء {data["juz_number"]}.
 يبدأ من الصفحة {data["start_page"]} وينتهي في الصفحة {data["end_page"]}.
 عدد السور في الربع: {data["count_surahs"]}.
 عدد الآيات في الربع: {data["count_ayahs"]}.
-السور الموجودة في الربع: {data["surah_names"]}.
+السور في الربع: {data["surah_names"]}.
 """
         logger.debug(f"Formatted information for Quarter {data['quarter_number']}.")
         return text.strip()
@@ -497,7 +497,7 @@ def _format(self, data: dict) -> str:
 تنتهي الصفحة بالآية {data["end_ayah_number"]} من {data["end_sura_name"]}.
  عدد السور في الصفحة: {data["count_surahs"]}.
 عدد الآيات في الصفحة: {data["count_ayahs"]}.
-السور الموجودة في الصفحة: {data["surah_names"]}.
+السور في الصفحة: {data["surah_names"]}.
 """
         logger.debug(f"Formatted information for Page {data['page_number']}.")
         return text.strip()
@@ -550,10 +550,14 @@ def _format(self, data: dict) -> str:
 عدد السور المكية: {self.MECCAN_COUNT} سورة.
 عدد السور المدنية: {self.MEDINAN_COUNT} سورة.
 عدد الآيات: {data["total_ayahs"]} آية.
-عدد الأجزاء: {data["total_juz"]} جزء.
-- عدد الأحزاب: {data["total_hizb"]} حزب 
-عدد الأرباع: {data["total_hizb_quarters"]} ربع.
+عدد الأجزاء: {data["total_juz"]} جزءًا.
+- عدد الأحزاب: {data["total_hizb"]} حزبًا.
+عدد الأرباع: {data["total_hizb_quarters"]} ربعًا.
 عدد الصفحات: {data["total_pages"]} صفحة.
+عدد الأرباع في الحزب: 4.
+عدد الأرباع في الجزء: 8.
+عدد الأحزاب في الجزء: 2.
+الرواية الحالية: حفص عن عاصم.
 """
         logger.debug("General information about the Quran formatted successfully.")
         return text.strip()

core_functions/quran/formatter.py

@@ -58,7 +58,7 @@ def replace_marks(self, text: str) -> str:
             marks = {
                 "۩": "(سجدة)",
                 "ۚ": "(،)",
-                "ۗ": "(ء)",
+                "ۗ": "(.ء)",
                 "ۖ": "(؛)",
                 "ۘ": "(.)",
                 "ۙ": "(لا)",

documentation/UserGuide.md

@@ -1120,29 +1120,29 @@
 
 يوفر البيان بشكل افتراضي علامات الوقف برموزها في المصحف، وهي رموز غير متوافقة مع معظم آلات النطق ضمن قارئات الشاشة.
 
-ولذلك, قررنا الالستعانة بصديقنا الأستاذ رياض أسوم الذي تمكن من استخدام مصاحف برايل بطبعة أكثر من دولة عربية، وقمنا باختيار العلامات الشائعة في مصاحف برايل كبديل عن العلامات الأصلية.
+ولذا, قررنا الاستعانة بصديقنا الأستاذ رياض أسوم الذي تمكن من استخدام مصاحف برايل بطبعة أكثر من دولة عربية، وقمنا باختيار العلامات الشائعة في مصاحف برايل بديلاً عن العلامات الأصلية.
 
-ولتوفير المزيد من السهولة، استعننا بتسميات نصية لمعظم العلامات، بحيث يدعم البيان 3 خيارات لعلامات الوقف، تشمل:
+ولتوفير المزيد من السهولة، استعننا بتسميات نصية لمعظم العلامات، بحيث يدعم البيان ثلاثة خيارات لعلامات الوقف تشمل:
 
-- الافتراضي: وهو المستخدم في المصاحف العادية.
-- النصية: وهي التسميات التي توصف كل علامة.
-- برايل: وهي الرموز الشائعة كبديل عن العلامات في مصاحف برايل.
+- الخيار الافتراضي: وهو المستخدم في المصاحف العادية.
+- خيار علامات الوقف النصية: وهي التسميات التي تصف كل علامة.
+- خيار الرموز بطريقة برايل: وهي الرموز الشائعة بديلاً عن العلامات في مصاحف برايل.
 
-عند اختيار أي وضع باستثناء الوضع الافتراضي، يتم وضع العلامة البديلة في نصوص الآيات بين قوسين، لتجنب أي تعديل في نص الآية نفسه.
+وعند اختيار أي وضع باستثناء الوضع الافتراضي، توضَع العلامة البديلة في نصوص الآيات بين قوسين لتجنب أي تعديل في نص الآية نفسه.
 
-بعض العلامات تستخدم في النصية وبرايل معًا.
+وتُستخدَم بعض العلامات على الهيئة نفسها في نمط "النصية" ونمط "برايل".
 
 ويوضح هذا الجدول العلامات المتوفرة مع البدائل ووصف كل علامة.
 
 | اسم العلامة | الرمز في المصحف | النصي | برايل | الوصف                                                                         |
 | ------------ | --------------- | -------------- | ----- | ----------------------------------------------------------------------------- |
 | الوقف الجائز | ۚ               | ج              | ،     | يجوز الوقف أو الوصل، وكلاهما سواء، لا يُرجّح أحدهما على الآخر.|
-| الوقف أولى   | ۗ               | قلى            | ء     | الوقف أولى من الوصل، أي يُستحب الوقف ولكن يجوز الوصل.|
+| الوقف أولى   | ۗ               | قلى            | .ء     | الوقف أولى من الوصل، أي يُستحب الوقف ولكن يجوز الوصل.|
 | الوصل أولى   | ۖ               | صلى            | ؛     | الوصل أولى من الوقف، أي يُستحب الوصل ولكن يجوز الوقف.|
-| الوقف اللازم | ۘ               | م              | .     | يجب الوقف ولا يجوز الوصل، لتمام المعنى أو لتغيره في حال الوصل.|
+| الوقف اللازم | ۘ               | م              | .     | يجب الوقف ولا يجوز الوصل لتمام المعنى أو لتغيره في حال الوصل.|
 | لا وقف       | ۙ               | لا             | لا    | لا يصح الوقف إطلاقًا، لأن الوقف يُفسد المعنى.|
-| تعانق الوقف  | ۛ               | --             | --    | توضع على كلمتين متقاربتين، يجوز الوقف على إحداهما فقط، وليس على كلتيهما معًا.|
-| السكتة       | ۜ               | س              | س     | سكتة خفيفة بدون تنفس، للاستمرار في القراءة مع توقف يسير جدًا.|
+| تعانق الوقف  | ۛ               | --             | --    | توضع على كلمتين متقاربتين، يجوز الوقف على إحداهما فقط، لا على كلتيهما معًا.|
+| السكتة       | ۜ               | س              | س     | سكتة خفيفة دون تنفس للاستمرار في القراءة مع توقف يسير جدًا.|
 | علامة السجدة | ۩               | سجدة           | سجدة  | تشير إلى موضع سجدة تلاوة، ويُستحب السجود عندها.|
 
 ويمكنك من [إعدادات القراءة](#ReadingSettings) اختيار الإعداد المناسب لك لتطبيقه على الفور.
@@ -1271,7 +1271,7 @@
 - يتم تخزين الأذكار الصوتية للقسم الافتراضي في مجلد Audio ثم athkar.
 - يتم تخزين إعدادات [الأذكار](#AlAthkar) [والتسابيح](#MisbahaWindow) وقيمتها في: athkar.db.
 - يتم تخزين [العلامات](#Bookmarks) في: bookmark.db.
-- يتم تخزين الموضع المحفوظ في المصحف ومشغل السور في user_data.db.
+- يتم تخزين الموضع المحفوظ في المصحف ومشغل السور وآخر عملية بحث وآخر تفسير مستخدم في user_data.db.
 - يتم تخزين إعدادات البرنامج في config.ini.
 - يتم تخزين سجل الأخطاء في albayan.log.
 - يمكنك الوصول إلى مسار البرنامج عن طريق كتابة التالي في Run: %appdata%\tecwindow\Albayan.
@@ -1322,7 +1322,7 @@
 
 يمكنك التحكم في السجل من [الإعدادات العامة ](#GeneralSettings).
 
-تحذير، كل ما اخترت مستوةى أعلى للسجل، يكتب البيان معلومات أكثر مع كل خطوة، في مستوى تصحيح الأخطاء، سيصبح البيان أبطأ في الاستخدام، لذلك لا تقم بتفعيله إلا لتتبع الأخطاء ومن ثم يجب تعطيله مرة أخرى أو تغييره إلى أخطاء.
+تنبيه هام، كل ما اخترت مستوةى أعلى للسجل، يكتب البيان معلومات أكثر مع كل خطوة، في مستوى تصحيح الأخطاء، سيصبح البيان أبطأ في الاستخدام، لذلك لا تقم بتفعيله إلا لتتبع الأخطاء ومن ثم يجب تعطيله مرة أخرى أو تغييره إلى أخطاء.
 
 يتسبب أيضًا مستوى تصحيح الأخطاء في كتابة معلومات كثيرة قد تجعل حجم ملف السجل يتجاوز 2MB في يوم واحد، لن يتم كتابة الكثير من المعلومات ولن تواجه مشاكل في أداء البيان عند الاحتفاظ بمستوى أخطاء.
 
@@ -1334,7 +1334,7 @@
 
 `%appdata%\tecwindow\Albayan`
 
-ثم مشاركة ملف albayan.log معنا وشرح الخطوات التي تسببت بالخطأ.
+عند مواجهة أي خطأ, توجه إلى المسار السابق، ثم شارك ملف albayan.log معنا واشرح الخطوات التي تسببت بالخطأ.
 
 قد يظهر رقم خطأ في رسالة الخطأ داخل البرنامج، ونرجو مشاركته معنا أيضًا.