From c6b72463f5af10ba9e68b16651978ec153d51813 Mon Sep 17 00:00:00 2001 From: Noureddin Date: Thu, 2 Nov 2023 17:37:46 +0300 Subject: [PATCH] fixes in both readme files --- README.md | 21 +++- ...31\202\330\261\330\243\331\206\331\212.md" | 105 ++++++++++-------- 2 files changed, 71 insertions(+), 55 deletions(-) diff --git a/README.md b/README.md index 12a5044..b273862 100644 --- a/README.md +++ b/README.md @@ -19,9 +19,9 @@ Use it at: [noureddin.github.io/recite](https://noureddin.github.io/recite). 2. Opt-in audio recitation after completing every ayah, in either mode. (It can optionally be made _before_ every ayah, which is called the "teacher mode".) -3. Night mode, in addition to the default light mode. +3. Night mode, in addition to the light mode, with your system preference as the default, but easy to change. -4. The ability to quiz yourself on any number of consecutive ayat, including for example a number of complete suar, an entire juz that starts in a sura and ends in another, etc. +4. The ability to quiz yourself on any number of consecutive ayat, including for example a number of complete suar, an entire juz that starts in the middle of a sura and ends in the middle of another, etc. 5. Tajweed–color-coding in the No-typing Uthmani mode, or with no colorization. @@ -49,11 +49,20 @@ Examples of `PARAMS`: - `p=1-3`: the first three pages (in Mushaf Medina). - `j=1`: the entire first juz. - `j=30`: the entire last juz. +- `h=1`: the entire first hizb (half juz). +- `r=1`: the entire first rub (quarter hizb, ie eighth of a juz). - `r=1-4`: the first four rubs (in the entire Quran). -- `r=10//1`: the first rub in the 10th juz. -- `r=10//1-10//2`: the first two rubs in the 10th juz. -- `r=10//7-10//8`: the last two rubs in the 10th juz. -- `h=1`: the entire first hizb (half-juz). +- `r=10//0`: the first rub in the 10th juz (when the Mushaf writes «جزء» in the margin). +- `r=10//1`: the second rub in the 10th juz (when the Mushaf writes «ربع» (¼) in the margin). +- `r=10//2`: the third rub in the 10th juz (when the Mushaf writes «نصف» (½) in the margin). +- `r=10//3`: the fourth rub in the 10th juz (when the Mushaf writes «ثلاثة أرباع» (¾) in the margin). +- `r=10//4`: the fifth rub in the 10th juz (when the Mushaf writes «حزب» in the margin). +- `r=10//5`: the sixth rub in the 10th juz (when the Mushaf writes «ربع» (¼) in the margin). +- `r=10//6`: the seveth rub in the 10th juz (when the Mushaf writes «نصف» (½) in the margin). +- `r=10//7`: the eighth (last) rub in the 10th juz (when the Mushaf writes «ثلاثة أرباع» (¾) in the margin). +- `r=10//0-10//1`: the first two rubs in the 10th juz. +- `r=10//6-10//7`: the last two rubs in the 10th juz. +- `1/2`: only the second ayah of the first sura. - `1/1-1/3`: from the first ayah of first sura, till the third ayah of the first sura. - `2/1-4/3`: from the first ayah of second sura, till the third ayah of the fourth sura. diff --git "a/\330\247\331\202\330\261\330\243\331\206\331\212.md" "b/\330\247\331\202\330\261\330\243\331\206\331\212.md" index 28f7d3d..62ec2e8 100644 --- "a/\330\247\331\202\330\261\330\243\331\206\331\212.md" +++ "b/\330\247\331\202\330\261\330\243\331\206\331\212.md" @@ -14,28 +14,28 @@ ## الخصائص
    -
  1. وضعان للتسميع: +

  2. وضعان للتسميع:

      -
    1. بالرسم العثماني (لا كتابة)، -
    2. وبالرسم الإملائي (كتابة). +
    3. بالرسم العثماني (بلا كتابة)، +
    4. بالرسم الإملائي (كتابة).
    -
  3. تلاوة صوتية اختياريًّا بعد إتمام تسميع كل آية، في كلا الوضعين. (يمكن اختياريا جعلها قبل كل آية، والذي يسمى «الوضع المعلم».) +

  4. تلاوة صوتية اختياريًّا بعد إتمام تسميع كل آية، في كلا الوضعين. (يمكن اختياريا جعلها قبل كل آية، والذي يسمى «الوضع المعلم».) -

  5. الوضع الليلي، إضافةً إلى الوضع النهاري المبدئي. +

  6. الوضع الليلي، إضافةً إلى الوضع النهاري. ويختار مبدئيا اختيار نظامك، ويمكنك تغييره. -

  7. إمكانية اختبار تسميع أي أيات متتالية بغض النظر عن سورها، فيمكن مثلا تسميع عدد من السور الكاملة، أو تسميع جزء كامل يبدأ في منتصف سورة وينتهي في منتصف سورة أخرى، وغير ذلك. +

  8. إمكانية اختبار تسميع أي أيات متتالية بغض النظر عن سورها، فيمكن مثلا تسميع عدد من السور الكاملة، أو تسميع جزء كامل يبدأ في منتصف سورة وينتهي في منتصف سورة أخرى، وغير ذلك. -

  9. تلوين النص طبقا لأحكام التجويد (مثل مصحف دار المعرفة) في الوضع العثماني، ويمكن جعل النص بلا تلوين. +

  10. تلوين النص طبقا لأحكام التجويد (مثل مصحف دار المعرفة) في الوضع العثماني، ويمكن جعل النص بلا تلوين. -

  11. إمكانية استخدام لوحة المفاتيح وحدها، أو الفأرة وحدها، أو لوحة اللمس وحدها، أو حتى شاشة اللمس وحدها. +

  12. إمكانية استخدام لوحة المفاتيح وحدها، أو الفأرة وحدها، أو لوحة اللمس وحدها، أو حتى شاشة اللمس وحدها. -

  13. استخدام تصميم ويب مستجيب، فيتكيّف مع تقريبا أي جهاز، من شاشات التلفاز الكبيرة إلى الهواتف المحمولة الصغيرة. +

  14. استخدام تصميم ويب مستجيب، فيتكيّف مع تقريبا أي جهاز، من شاشات التلفاز الكبيرة إلى الهواتف المحمولة الصغيرة. -

  15. (للخارقين) مُعامِلات رابط «للضبط المسبق» للإعدادات وحتى لاختيار الآيات المراد تسميعها. (مفصل بالأسفل.) +

  16. (للخارقين) مُعامِلات رابط «للضبط المسبق» للإعدادات وحتى لاختيار الآيات المراد تسميعها. (مفصل بالأسفل.) -

  17. (للمطورين) سَهولة تضمينه في تطبيقات ويب أخرى. (مفصل بالأسفل، تحت عنوان «مُعامِلات رابط أشد تقدما».) +

  18. (للمطورين) سَهولة تضمينه في تطبيقات ويب أخرى. (مفصل بالأسفل، تحت عنوان «مُعامِلات رابط أشد تقدما».)

### مُعامِلات الرابط (للمستخدمين المتقدمين) @@ -55,11 +55,20 @@
  • p=1-3: الصفحات الثلاثة الأولى (في مصحف المدينة).
  • j=1: الجزء الأول بكامله.
  • j=30: الجزء الأخير بكامله. -
  • r=1-4: الأرباع الأربعة الأولى (في القرءان بكامله). -
  • r=10//1: الربع الأول في الجزء العاشر. -
  • r=10//1-10//2: أول ربعين في الجزء العاشر. -
  • r=10//7-10//8: آخر ربعين في الجزء العاشر.
  • h=1: الحزب الأول بكامله (الحزب هو نصف جزء). +
  • r=1: الربع الأول بكامله (الربع هو ربع حزب، أي ثُمن جزء). +
  • r=1-4: الأرباع الأربعة الأولى (في القرءان بكامله). +
  • r=10//0: الربع الأول في الجزء العاشر (عندما يكتب «جزء» في هامش المصحف). +
  • r=10//1: الربع الثاني في الجزء العاشر (عندما يكتب «ربع» في هامش المصحف). +
  • r=10//2: الربع الثالث في الجزء العاشر (عندما يكتب «نصف» في هامش المصحف). +
  • r=10//3: الربع الرابع في الجزء العاشر (عندما يكتب «ثلاثة أرباع» في هامش المصحف). +
  • r=10//4: الربع الخامس في الجزء العاشر (عندما يكتب «حزب» في هامش المصحف). +
  • r=10//5: الربع السادس في الجزء العاشر (عندما يكتب «ربع» في هامش المصحف). +
  • r=10//6: الربع السابع في الجزء العاشر (عندما يكتب «نصف» في هامش المصحف). +
  • r=10//7: الربع الثامن (الأخير) في الجزء العاشر (عندما يكتب «ثلاثة أرباع» في هامش المصحف). +
  • r=10//0-10//1: أول ربعين في الجزء العاشر. +
  • r=10//6-10//7: آخر ربعين في الجزء العاشر. +
  • 1/2: الآية الثانية فقط من السورة الأولى.
  • 1/1-1/3: من الآية الأولى من السورة الأولى حتى الآية الثالثة من السورة الأولى.
  • 2/1-4/3: من الآية الأولى من السورة الثانية حتى الآية الثالثة من السورة الرابعة. @@ -76,13 +85,13 @@ مُعامِلات أخرى لضبط القيم المبدئية للخيارات: @@ -140,19 +149,17 @@
    مُعامِلات رابط أشد تقدما -

    - -لا يمكن تغيير هذه الخصائص من الواجهة، بل من مُعامِلات الرابط فقط، لأنها تجريبية أو متقدمة جدا أو خاصة باستخدام محدود جدا أو كل ذلك، فلن تفيد الغالبية العظمى من المستخدمين. +

    لا يمكن تغيير هذه الخصائص من الواجهة، بل من مُعامِلات الرابط فقط، لأنها تجريبية أو متقدمة جدا أو خاصة باستخدام محدود جدا أو كل ذلك، فلن تفيد الغالبية العظمى من المستخدمين.

      -
    • qariurl=: +

    • qariurl=: لإعطاء رابط خادم تلاوتك الصوتية المفضلة، حتى لو خادم محلي (مثل http://0.0.0.0:6236 ولكن ليس file:///). يجعل محدِّد التلاوة الصوتية فارغا. لكن اختيار تلاوة صوتية من الواجهة سيغطى على هذه الخاصية. يجب على الرابط المعطى أن يكون فيه صوتيات الآيات، فمثلا إضافة /001001.mp3 إلى نهايته يجب أن تعطي صوت الآية الأولى من السورة الأولى. -

    • hc أو highcontrast: يجعل جميع الألوان ذات تباين أعلى في الوضع الليلي، حتى ألوان التجويد. +

    • hc أو highcontrast: يجعل جميع الألوان ذات تباين أعلى في الوضع الليلي، حتى ألوان التجويد. -

    • cn: يضيف في نهاية التسميع «عبارة» من الآية التالية إذا كانت في نفس السورة. +

    • cn: يضيف في نهاية التسميع «عبارة» من الآية التالية إذا كانت في نفس السورة. -

    • emu= أو emulate= أو emulation=: +

    • emu= أو emulate= أو emulation=: لاستخدام تخطيط لوحة مفاتيح مختلف عن نظامك، حتى لو كنت تستخدم لوحة مفاتيح أجنبية. اللوحات المدعومة حاليا هي:

        @@ -162,15 +169,15 @@
      • dv: لوحة تجريبية لكتابة العربية صوتيا بتخطيط Dvorak.
      -
    • dt أو disableteacher: لإزالة إمكانية تغيير الوضع المعلم من الواجهة. سيبقى الوضع المعلم قابلا للتغيير من مُعامِلات الرابط. هذا مفيد لفرض قيمة معينة له (مثلا بلا معلم) في حالة تضمينه في تطبيق ويب مثلا. +

    • dt أو disableteacher: لإزالة إمكانية تغيير الوضع المعلم من الواجهة. سيبقى الوضع المعلم قابلا للتغيير من مُعامِلات الرابط. هذا مفيد لفرض قيمة معينة له (مثلا بلا معلم) في حالة تضمينه في تطبيق ويب مثلا.

      تحذير: ستبقى قيمته قابلةً للتغيير من شاشة كونسول جافاسكربت؛ لم أستطيع تعطيل هذا بعد. -

    • dq أو disablequizmode: لإزالة إمكانية تغيير وضع التسميع من الواجهة. سيبقى وضع التسميع قابلا للتغيير من مُعامِلات الرابط. هذا مفيد لفرض قيمة معينة له (مثلا الإملائي) في حالة تضمينه في تطبيق ويب مثلا. +

    • dq أو disablequizmode: لإزالة إمكانية تغيير وضع التسميع من الواجهة. سيبقى وضع التسميع قابلا للتغيير من مُعامِلات الرابط. هذا مفيد لفرض قيمة معينة له (مثلا الإملائي) في حالة تضمينه في تطبيق ويب مثلا.

      تحذير: ستبقى قيمته قابلةً للتغيير من شاشة كونسول جافاسكربت؛ لم أستطيع تعطيل هذا بعد. -

    • zz: +

    • zz: للعمل داخل تطبيق آخر والتكامل معه. صُنع في الأساس من أجل ذِكر الذِكرِ، ولكنه عام بما يكفي ليكون مفيدا للاستخدام في تطبيقات أخرى.

      سيفعل ما يلي عند تفعيله: @@ -183,30 +190,30 @@

    • عندما يغيّر المستخدم أي خيار، فإن التطبيق الأب سيعلم في الحال.
    -

    لاستخدام هذا الوضع، عليك تشغيل رسايت في إطار ضمني (iframe) باستخدام مُعامِل الرابط zz، وعليك تعريف هذه الدوال في مساحة الأسماء العامة في تطبيقك (أيْ تحت كائن window): +

    لاستخدام هذا الوضع، عليك تشغيل رسايت في إطار مضمّن (iframe) باستخدام مُعامِل الرابط zz، وعليك تعريف هذه الدوال في مساحة الأسماء العامة في تطبيقك (أيْ تحت كائن window):

      -
    • zz_show(): +

    • zz_show(): تُنادى بعد التحميل الأساسي، حتى يُظهر التطبيق الأب إطار رسايت. -

    • zz_done(): +

    • zz_done(): تُنادى عند ضغط «عودة»، بعد الانتهاء من التسميع. -

    • zz_ignore(): +

    • zz_ignore(): تُنادى عند ضغط «تجاهل»، الذي قد يكون في أي وقت.

      على عكس zz_done() (زر «عودة»)، فإن zz_ignore() تعني أن المستخدم لا يريد الاعتبار بهذا التسميع. فمثلا إذا كنت تسأل المستخدم عن مدى حفظه للآيات المحددة، فلا تفعل ذلك إذا نوديت zz_ignore() بدلا من zz_done(). -

    • zz_set_title(title): +

    • zz_set_title(title): تُنادى عند البدء لضبط عنوان نافذة الأب إلى عنوان التسميع الحالي، المطابق لعنوان نافذة رسايت دون | رسايت وللعنوان الظاهر فوق الأزرار العلوية. -

    • zz_set_quizmode(uthm_or_imla): +

    • zz_set_quizmode(uthm_or_imla): تُنادى عندما يغيّر المستخدم وضع التسميع. إما "uthm" للوضع العثماني (المبدئي) وإما "imla" للوضع الإملائي. -

    • zz_set_feedbackrate(emptystring_or_word): +

    • zz_set_feedbackrate(emptystring_or_word): تُنادى عندما يغيّر المستخدم معدل مراجعة الأخطاء في الوضع الإملائي. النص الفارغ ("") لكل حرف (المبدئي) و "word" لكل كلمة. -

    • zz_set_tajweed(t_or_b_or_n): +

    • zz_set_tajweed(t_or_b_or_n): تُنادى عندما يغيّر المستخدم تلوين النص في الوضع العثماني. "t" للتجويد (المبدئي) و "b" للبسيط (أجزاء الرسم) و "n" لنفي التلوين. -

    • zz_set_dark(boolean): +

    • zz_set_dark(boolean): تُنادى عندما يغيّر المستخدم محدِّد الوضع الليلي. إما true للوضع الليلي وإما false للوضع النهاري (المبدئي). -

    • zz_set_mvbtns(b_or_r_or_l): +

    • zz_set_mvbtns(b_or_r_or_l): تُنادى عندما يغيّر المستخدم موضع أزرار التسميع في الوضع العثماني. "b" للأسفل (المبدئي) و "r" لليمين و "l".