updated docs

Author: SuhJae

content/ar/1.docs/1.getting-started/1.index.md

@@ -1,32 +1,32 @@
 ---
-title: مقدمة
-description: مرحبًا بك في بلو سكريبت.
+title: المقدمة
+description: مرحبًا بكم في BlueScript.
 ---
 
-## ما هو بلو سكريبت؟
+## ما هو BlueScript؟
 
-BlueScript هو مشروع مفتوح المصدر مصمم لمساعدة الأفراد الذين يعانون من عسر القراءة. ويجمع اسمها بين عنصرين: "أزرق" الذي يرمز إلى التغيير الإيجابي، و"سكريبت" الذي يمثل الحروف أو النص. يتجاوز هذا المشروع المناهج اللغوية التقليدية من خلال توظيف منهجيات علم الأعصاب لتوفير تدريب فعال للمصابين بعسر القراءة.
+BlueScript هو مشروع مفتوح المصدر مصمم لمساعدة الأفراد الذين يعانون من عسر القراءة. يجمع الاسم بين عنصرين: "Blue" التي ترمز إلى التغيير الإيجابي، و"Script" التي تمثل الحروف أو النصوص. يتجاوز هذا المشروع الأساليب اللغوية التقليدية عبر استخدام منهجيات علوم الأعصاب لتقديم تدريبات فعّالة للأشخاص الذين يعانون من عسر القراءة.
 
-لضمان وصول الأفراد الذين يعانون من عسر القراءة إلى التدريب بحرية في أي مكان، تم تطوير BlueScript كتطبيق ويب. يقدم هذا التطبيق مجموعة متنوعة من الوحدات التدريبية التي تهدف إلى تقوية الروابط العصبية في الدماغ، ومعالجة أوجه القصور الناجمة عن عسر القراءة.
+لتوفير إمكانية وصول الأفراد الذين يعانون من عسر القراءة إلى التدريبات في أي مكان، تم تطوير BlueScript كتطبيق ويب. يقدم هذا التطبيق مجموعة متنوعة من الوحدات التدريبية التي تهدف إلى تقوية الروابط العصبية في الدماغ، مما يساعد على معالجة عدم الكفاءة الناجمة عن عسر القراءة.
 
-### بدايات بلو سكريبت: سوه جاي
+### بدايات BlueScript: سوه جاي
 
-https://github.com/SuhJaeوقد بدأ هذا المشروع من قبل [سوه جاي]()، الذي عانى من تحديات وألم عسر القراءة أثناء الطفولة. ومع معاناتها من بطء سرعة القراءة ومحدودية الإلمام بالقراءة والكتابة، عملت سوه جاي بلا كلل للتغلب على هذه الصعوبات. ولحسن الحظ، ساعده التدريب الذي تلقاه خلال المرحلة الإعدادية على تحسين مهاراته في القراءة. ومع ذلك، فقد تركت هذه التجربة فهماً عميقاً لمدى صعوبة التغلب على عسر القراءة لدى العديد من الأشخاص.
+تم إطلاق هذا المشروع بواسطة [سوه جاي](https://github.com/SuhJae)، الذي عانى من تحديات وآلام عسر القراءة خلال طفولته. إذ كان يواجه صعوبة في سرعة القراءة ومحدودية الإلمام بالقراءة والكتابة. عمل سوه جاي بجد للتغلب على هذه الصعوبات. لحسن الحظ، ساعده التدريب الذي تلقاه خلال المرحلة الإعدادية على تحسين مهاراته في القراءة. ولكن، تركت هذه التجربة فهمًا عميقًا للصعوبات التي يواجهها الكثيرون في التغلب على عسر القراءة.
 
-بدافع من رحلته الشخصية، قام سوه جاي بتطوير **BlueScript** بهدف التخفيف من الصعوبات التي يواجهها الآخرون الذين يعانون من عسر القراءة. وقد أدرك أن العبء المالي غالبًا ما يجعل التغلب على عسر القراءة غير متاح للكثيرين. وقد أدى هذا الإدراك إلى تصميمه على إنشاء برنامج تدريبي مجاني لعسر القراءة، مما يتيح للناس فرصة للتغلب على عسر القراءة دون قيود اقتصادية.
+بدافع من رحلته الشخصية، قام سوه جاي بتطوير **BlueScript** بهدف تخفيف معاناة الآخرين الذين يعانون من عسر القراءة. أدرك أن العبء المالي غالبًا ما يجعل التغلب على عسر القراءة أمرًا بعيد المنال للكثيرين. وقاده هذا الإدراك إلى تصميم برنامج تدريبي مجاني لعسر القراءة، يمنح الناس فرصة للتغلب عليه دون قيود اقتصادية.
 
 ## مشروع مفتوح المصدر
 
-BlueScript هو مشروع مفتوح المصدر يمكن لأي شخص استخدامه والمساهمة فيه مجانًا. يتم تشجيع كل من المستخدمين والمطورين على المشاركة في تحسين برامج التدريب. https://github.com/BlueScript-NPOيتوفر بلو سكريبت حاليًا بتسع لغات، مع إصلاحات مستمرة للأخطاء وتحسينات على واجهة المستخدم ([BlueScript GitHub]()).
+BlueScript هو مشروع مفتوح المصدر يمكن لأي شخص استخدامه والمساهمة فيه مجانًا. يتم تشجيع كل من المستخدمين والمطورين على المشاركة في تحسين البرامج التدريبية. حاليًا، يتوفر BlueScript بتسع لغات، مع استمرار إصلاح الأخطاء وتحسين واجهة المستخدم ([GitHub BlueScript](https://github.com/BlueScript-NPO)).
 
-## وحدات التدريب
+## الوحدات التدريبية
 
-يوفر BlueScript مجموعة متنوعة من الوحدات التدريبية المصممة لتحفيز الخلايا العصبية في الدماغ وتعزيز مهارات القراءة للأفراد الذين يعانون من عسر القراءة. تشمل وحدات التدريب الرئيسية ما يلي:
+يوفر BlueScript مجموعة من الوحدات التدريبية المصممة لتحفيز الخلايا العصبية في الدماغ وتعزيز مهارات القراءة للأفراد الذين يعانون من عسر القراءة. تشمل الوحدات التدريبية الرئيسية:
 
-1. /docs/training/visual/rapid-visual-perception[**الإدراك البصري السريع**](): وحدة تدريبية حيث يتعرف المستخدمون بسرعة على الحروف المعروضة على الشاشة ويدخلونها بشكل موجز.
-2. /docs/training/visual/sequential-visual-memory[**ذاكرة بصرية متتابعة**](): وحدة يتم فيها عرض الحروف واحدًا تلو الآخر، ويجب على المستخدمين تذكرها وإدخالها.
-3. /docs/training/visual/character-sequencing[**تسلسل الحروف**](): التدريب الذي يتضمن تحديد الحروف وإدخالها بترتيب محدد.
-4. /docs/training/visual/character-matching[**مطابقة الأحرف**](): وحدة يقوم فيها المستخدمون بتحديد الحروف المطابقة لمطلب معين من بين أحرف متشابهة بصريًا.
-5. /docs/training/visual/character-guesstimate[**تخمين الحروف**](): وحدة تظهر فيها الحروف تدريجيًا، ويجب على المستخدمين التنبؤ بها وإدخالها بأسرع ما يمكن.
+1. [**الإدراك البصري السريع**](/ar/docs/training/visual/rapid-visual-perception): وحدة تدريبية يتعرف فيها المستخدمون بسرعة على الحروف المعروضة لفترة وجيزة على الشاشة ويقومون بإدخالها.
+2. [**الذاكرة البصرية التسلسلية**](/ar/docs/training/visual/sequential-visual-memory): وحدة تعرض الحروف واحدًا تلو الآخر، ويجب على المستخدمين تذكرها وإدخالها.
+3. [**تسلسل الحروف**](/ar/docs/training/visual/character-sequencing): تدريب يشمل تحديد وإدخال الحروف بترتيب محدد.
+4. [**مطابقة الحروف**](/ar/docs/training/visual/character-matching): وحدة يقوم فيها المستخدمون بتحديد الحروف المطابقة للتلميح المُعطى من بين حروف متشابهة بصريًا.
+5. [**التخمين الحرفي**](/ar/docs/training/visual/character-guesstimate): وحدة تظهر الحروف تدريجيًا، ويجب على المستخدمين التنبؤ بها وإدخالها بأسرع وقت ممكن.
 
-صُممت هذه الوحدات لتحفيز الدماغ بطرق مختلفة، مما يضمن استمرار تفاعل المستخدمين وعدم تحولهم إلى حساسين للمحفزات المتكررة.
+تم تصميم هذه الوحدات لتحفيز الدماغ بطرق متنوعة، مما يضمن بقاء المستخدمين متحمسين وعدم شعورهم بالملل من تكرار الأنشطة.

content/ar/1.docs/1.getting-started/2.installation.md

@@ -1,50 +1,50 @@
 ---
-title: التركيب
+title: التثبيت
 description: كيفية تثبيت واستخدام BlueScript
-navigation: التركيب
+navigation: التثبيت
 ---
 
 ## للمستخدمين العامين
 
-يتم توفير BlueScript كتطبيق ويب، مما يسمح لك باستخدامه بسهولة من أي مكان باستخدام **المتصفح فقط**، دون أي عملية تثبيت. قم بزيارة تطبيق الويب الرسمي وابدأ في الاستفادة من جميع ميزات BlueScript على الفور.
+يتم تقديم BlueScript كتطبيق ويب، مما يتيح لك استخدامه بسهولة من أي مكان باستخدام **المتصفح** فقط، دون الحاجة إلى أي عملية تثبيت. قم بزيارة التطبيق الرسمي وابدأ في الاستفادة من جميع ميزات BlueScript على الفور.
 
 ## الاستضافة الذاتية
 
-بالإضافة إلى تطبيق الويب الرسمي، يمكنك استضافة **BlueScript** على خادمك الخاص. هذا الخيار مناسب لذوي مهارات إدارة الخوادم أو أولئك الذين يفضلون بيئة مخصصة.
+بالإضافة إلى التطبيق الرسمي، يمكنك استضافة **BlueScript** على خادمك الخاص. هذا الخيار مناسب للأشخاص الذين لديهم مهارات في إدارة الخوادم أو الذين يفضلون بيئة مخصصة.
 
 ### الاستضافة باستخدام Docker
 
-https://hub.docker.com/r/suhjae/bluescriptيمكن استضافة BlueScript بسهولة باستخدام [صورة Docker الرسمية](). اتبع الخطوات التالية لتثبيت Docker وتشغيل خادم BlueScript.
+يمكن استضافة BlueScript بسهولة باستخدام [الصورة الرسمية لـ Docker](https://hub.docker.com/r/suhjae/bluescript). اتبع الخطوات التالية لتثبيت Docker وتشغيل خادم BlueScript.
 
 #### **1. تثبيت Docker**
 
-https://www.docker.com/إذا لم يكن Docker مثبتًا بالفعل، قم بتنزيل Docker وتثبيته لمنصتك من [موقع Docker الرسمي]().
+إذا لم يكن Docker مثبتًا بالفعل، قم بتنزيل وتثبيت Docker لنظام التشغيل الخاص بك من [الموقع الرسمي لـ Docker](https://www.docker.com/).
 
-#### **2. سحب صورة بلوسكربت دوكر بلو سكريبت**
+#### **2. تحميل صورة BlueScript على Docker**
 
-بمجرد تثبيت Docker، قم بتحميل صورة BlueScript الرسمية عن طريق تشغيل الأمر التالي في جهازك الطرفي:
+بعد تثبيت Docker، قم بتنزيل الصورة الرسمية لـ BlueScript عن طريق تشغيل الأمر التالي في الطرفية:
 
 ```bash
 docker pull suhjae/bluescript
 ```
 
-#### **3. تشغيل بلو سكريبت**
+#### **3. تشغيل BlueScript**
 
-بعد تنزيل صورة Docker، ابدأ تشغيل الحاوية باستخدام الأمر التالي:
+بعد تنزيل صورة Docker، قم بتشغيل الحاوية باستخدام الأمر التالي:
 
 ```bash
-docker run -d -p 80:3000 - الاسم bluescript suhjae/bluescript
+docker run -d -p 80:3000 --name bluescript suhjae/bluescript
 ```
 
-هنا:
+التفاصيل:
 
-- 'd' تشغيل الحاوية في الخلفية.
-- 'ص 80:3000' يعيّن المنفذ 80 على جهازك المحلي إلى المنفذ 3000 داخل الحاوية.
+- `-d` لتشغيل الحاوية في الخلفية.
+- `-p 80:3000` لربط المنفذ 80 على جهازك المحلي بالمنفذ 3000 داخل الحاوية.
 
-#### \*\*4. الوصول إلى بلو سكريبت
+#### **4. الوصول إلى BlueScript**
 
-افتح المتصفح الخاص بك وانتقل إلى 'http://localhost' للوصول إلى BlueScript.
+افتح متصفحك وانتقل إلى `http://localhost` للوصول إلى BlueScript.
 
-#### **5. تكوين الإعدادات**
+#### **5. إعداد التكوينات**
 
-للحصول على تكوين إضافي، يمكنك تعديل ملف 'docker-compose.yml' أو استخدام متغيرات بيئة Docker لتخصيص BlueScript. https://traefik.io/traefik/على سبيل المثال، يمكنك إعداد وكيل ويب مثل [Traefik]() داخل ملف 'docker-compose.yml' لربط نطاقك وإنشاء إعداد أكثر تقدمًا.
+لإجراء إعدادات إضافية، يمكنك تعديل ملف `docker-compose.yml` أو استخدام متغيرات البيئة الخاصة بـ Docker لتخصيص BlueScript. على سبيل المثال، يمكنك إعداد وكيل ويب مثل [Traefik](https://traefik.io/traefik/) داخل ملف `docker-compose.yml` لربط النطاق الخاص بك وإنشاء إعداد أكثر تقدمًا.

content/ar/1.docs/1.getting-started/3.requirements.md

@@ -1,26 +1,26 @@
 ---
-title: التحضير للتدريب
-description: إعداد بيئة التدريب باستخدام BlueScript
+title: الاستعداد للتدريب
+description: إعداد البيئة للتدريب باستخدام BlueScript
 ---
 
 ## الأجهزة
 
-BlueScript هو تطبيق ويب يمكن استخدامه على أي نظام تشغيل. ومع ذلك، من أجل التدريب الفعال، يوصى باستخدام جهاز يستوفي المعايير التالية.
+BlueScript هو تطبيق ويب يمكن استخدامه على أي نظام تشغيل. ومع ذلك، للحصول على تدريب فعال، يُوصى باستخدام جهاز يفي بالمعايير التالية.
 
 ### متطلبات الجهاز
 
-- جهاز كمبيوتر أو كمبيوتر محمول أو جهاز لوحي مزود بلوحة مفاتيح فعلية.
-- شاشة عرض لا تقل عن 7 بوصات (17.78 سم).
+- جهاز كمبيوتر مكتبي، أو محمول، أو جهاز لوحي مزود بلوحة مفاتيح فعلية.
+- شاشة لا تقل عن 7 بوصات (17.78 سم).
 
 ### أدوات مفيدة
 
-- دفتر لتسجيل تقدم التدريب (ستتم إضافة وظيفة الحساب لحفظ سجلات التدريب قريباً).
-- سدادات الأذن أو سماعات الرأس لحجب الضوضاء في بيئة مشتتة للانتباه.
+- دفتر ملاحظات لتسجيل تقدم التدريب (سيتم إضافة وظيفة الحساب لحفظ سجلات التدريب قريبًا).
+- سدادات أذن أو سماعات رأس لحجب الضوضاء في بيئة مشتتة.
 
 ## وضعية التدريب
 
-حافظ على مسافة 30 سم تقريباً من الشاشة أثناء التدريب. وهذا يعادل تقريباً الطول القطري لورقة مقاس A4.
+حافظ على مسافة حوالي 30 سم من شاشتك أثناء التدريب. هذه المسافة تعادل تقريبًا الطول القطري لورقة بحجم A4.
 
-لا تضع يديك على لوحة المفاتيح عند عدم إدخال الإجابات. في جلسات التدريب التي تتطلب الحفظ الفوري قصير المدى، يمكن أن يؤدي وضع يديك مسبقًا على لوحة المفاتيح أو الاستعداد لكتابة الإجابات قبل الأوان إلى تقليل فعالية التدريب.
+لا تضع يديك على لوحة المفاتيح عندما لا تكون في وضع إدخال الإجابات. في الجلسات التدريبية التي تتطلب حفظًا قصير المدى للمحفزات، قد يقلل وضع يديك مسبقًا على لوحة المفاتيح أو الاستعداد لإدخال الإجابات من فعالية التدريب.
 
-تجنب التحدث إلى نفسك أو الغمز واللمز أثناء التدريب. يمكن أن يؤثر تكرار التعليمات بصوت عالٍ أو الهمهمة بها سلباً على تحسين الوظائف الإدراكية البصرية.
+تجنب التحدث مع نفسك أو التمتمة أثناء التدريب. تكرار المحفزات بصوت عالٍ أو التمتمة بها قد يؤثر سلبًا على تحسين الوظائف البصرية الإدراكية.