Merge pull request #188 from Open-Science-Community-Saudi-Arabia/l10n…

…_crowdin_integration_0001

New Crowdin updates

docs/_translations/ar/chapters/functional doc/index.ar.qmd

@@ -0,0 +1,3 @@
+---
+العنوان: وثيقة وظيفية
+---

docs/_translations/ar/chapters/functional doc/utilities/commentsutil.ar.qmd

@@ -0,0 +1,95 @@
+# ملف Commentsutil
+
+يوفر هذا الملف فئات مفيدة لتحليل واستخراج المعلومات
+  من التعليقات داخل ملفات البرمجة. ويتضمن طرقًا لتحديد و
+  استخراج البيانات الوصفية من تعليقات الوحدة (module) وغير الوحدة (non-module)،
+  تسهيل المواد المرجعية (documentation) بشكل أفضل وفهم بنيات التعليمات البرمجية
+  مثل الوظائف (funcion) والمتغيرات و  الفئات (classes) والوحدات النمطية.
+
+
+
+## مسمى الوحدة moduleName 
+`[متغير]`
+
+**الوصف:**
+هذه الطريقة تستخرج معلومات كتلة الوحدة النمطية من التعليقات، بما في ذلك اسم الوحدة، والوصف، والفئة، والفئة الفرعية، والربط، والمراجع.
+
+** المعلمات (Params):**
+
+| الاسم | الوصف |
+| --- | --- |
+| تعليقات | التعليقات لاستخراج معلومات كتلة الوحدة منها. |
+
+
+
+## الوصف 
+`[متغير]`
+
+**الوصف:**
+تستخرج هذه الطريقة معلومات كتلة أخرى من التعليقات، بما في ذلك الوصف، والمشارجات، والربط، والأمثلة، والإرجاعات، والأخطاء التي ألقيت والمراجع.
+
+** المعلمات (Params):**
+
+| الاسم | الوصف |
+| --- | --- |
+| تعليقات | التعليقات لاستخراج معلومات كتلة الوحدة منها. |
+
+
+
+## محتوى الملف 
+`[متغير]`
+
+**الوصف:**
+تسترجع هذه الطريقة التعليقات من ملف المصدر باستخدام Acorn parser.
+
+** المعلمات (Params):**
+
+| الاسم | الوصف |
+| --- | --- |
+<unk> مصدر الملف <unk> مصدر الملف لاسترداد التعليقات منه. |
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+يمثل هذا الفصل تعليقا مستخرجا من ملف مصدر.
+
+** المعلمات (Params):**
+
+| الاسم | الوصف |
+| --- | --- |
+<unk> النص <unk> المحتوى النصي للتعليق. |
+<unk> الموقع النهائي <unk> الموقع الأخير للتعليق. |
+
+
+
+## غير معروف 
+`[function]`
+
+**الوصف:**
+وتحدد هذه الطريقة المعلومات التجميعية للتعليق، بما في ذلك نوع البناء واسمه.
+
+** المعلمات (Params):**
+
+| الاسم | الوصف |
+| --- | --- |
+<unk> معلومات <unk> المعلومات الأساسية التي يجب تعيينها. |
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+هذه الطريقة تسترجع معلومات الوحدة النمطية من التعليق باستخدام فئة التعليقات.
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+هذه الطريقة تسترجع معلومات الوحدة النمطية من التعليق باستخدام فئة التعليقات.
+

docs/_translations/ar/chapters/functional doc/utilities/components.ar.qmd

@@ -0,0 +1,211 @@
+# المكونات
+
+يتم استخدام هذه الوحدة لإنشاء ملف الـ quarto yml
+
+
+
+
+## متكررًا 
+`[function]`
+
+**الوصف:**
+تحويل جميع قيم السلسلة بشكل متكرر في الكائن إلى أحرف صغيرة
+
+
+* أمثلة: **
+
+```جافا سكريبت
+const obj = {
+    name: 'Hello World',
+    description: 'This is a description',
+    blockInfo: {
+    name: 'Hello World',
+    description: 'This is a description',
+    },
+    };
+    recursivelyConvertAllStringValuesInObjectToLowerCase(obj);
+    // => {
+    //   name: 'hello world',
+    //   description: 'this is a description',
+    //   blockInfo: {
+    //   name: 'hello world',
+    //   description: 'this is a description',
+    //   },
+    //   }
+```
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+إضافة مستند إلى الوحدة النمطية
+
+
+* أمثلة: **
+
+```جافا سكريبت
+const module = new Module({ name: 'StringUtil' });
+      const moduleDoc = new ModuleDoc({
+        originalFilePath: 'string.ts',
+        data: {
+     
+           blockInfo: {
+           name: 'StringUtil',
+           description: 'This class contains methods for manipulating strings',
+           },
+           constructInfo: {
+           type: 'class',
+           name: 'StringUtil',
+           },
+           },
+           });
+           module.addDoc(moduleDoc);
+```
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+إضافة مستند إلى الوحدة النمطية
+
+
+* أمثلة: **
+
+```جافا سكريبت
+const module = new Module({ name: 'StringUtil' });
+      const moduleDoc = new ModuleDoc({
+       originalFilePath: 'string.ts',
+       data: {
+       blockInfo: {
+       name: 'StringUtil',
+       description: 'This class contains methods for manipulating strings',
+       },
+       constructInfo: {
+       type: 'class',
+       name: 'StringUtil',
+       },
+       },
+       });
+       module.addDoc(moduleDoc);
+       module.getDocs();
+       // => [ModuleDoc]
+```
+
+
+
+## غير معروف 
+`[other]`
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+تعيين مسار ملف المصدر
+
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+إضافة وحدة نمطية إلى الفئة الفرعية
+
+
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+إضافة وحدة نمطية إلى الفئة الفرعية
+
+
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+إضافة وحدة نمطية إلى الفئة الفرعية
+
+
+
+
+## فئات 
+`[class]`
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+هذا الصف يمثل فئةً.
+
+** المعلمات (Params):**
+
+| الاسم | الوصف |
+| --- | --- |
+|  إضافة وحدة نمطية إلى الفئة الفرعية. |
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+يضيف فئة فرعية إلى التصنيف.
+
+** المعلمات (Params):**
+
+| الاسم | الوصف |
+| --- | --- |
+<unk> الفئة الفرعية <unk> الفئة الفرعية التي يراد إضافتها. |
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+يسترد الفئات الفرعية في الفئة.
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+يسترد الفئات الفرعية في الفئة.
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+إضافة وحدة نمطية إلى الفئة الفرعية.
+
+** المعلمات (Params):**
+
+| الاسم | الوصف |
+| --- | --- |
+|  إضافة وحدة نمطية إلى الفئة الفرعية. |
+
+
+
+## غير معروف 
+`[other]`
+
+**الوصف:**
+إضافة وحدة نمطية إلى الفئة الفرعية.
+