Merge branch 'crowdin_integration' of https://github.com/Open-Science…

…-Community-Saudi-Arabia/JSquarto into crowdin_integration

config.json

@@ -2,6 +2,7 @@
     "includeLocalizedVersions": false,
     "outputDirectory": "docs",
     "sourceDirectory": "dist",
+    "translationsDirectory": "translations",
     "tutorialDirectory": "tutorials",
     "languages": ["en", "ar"],
     "translationsDirectory": "translations"

crowdin.yml

@@ -1,7 +1,7 @@
 files:
   - source: /docs/**/*.qmd
-    translation: /translation/%two_letters_code%/%original_path%/%original_file_name%.%two_letters_code%.%file_extension%
+    translation: /translations/%two_letters_code%/%original_path%/%original_file_name%.%two_letters_code%.%file_extension%
   - source: /docs/**/*.md
-    translation: /translation/%two_letters_code%/%original_path%/%original_file_name%.%two_letters_code%.%file_extension%
+    translation: /translations/%two_letters_code%/%original_path%/%original_file_name%.%two_letters_code%.%file_extension%
 bundles:
   - 4

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

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

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

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

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

@@ -0,0 +1,211 @@
+# المكونات
+
+يتم استخدام هذه الوحدة لتوليد ملف الـ quarto yml
+
+
+
+
+## متكررًا yConvertAllStringValuesInObjectToLowerCase 
+`[function]`
+
+**وصف:**
+تحويل جميع قيم السلسلة بشكل متكرر في كائن إلى أحرف صغيرة
+
+
+**أمثلة:**
+
+```جافا سكريبت
+const obj = {
+    الاسم: "مرحبا بالعالم"،
+    الوصف: "هذا وصف"،
+    blockInfo: {
+    الاسم: "مرحبا بالعالم"،
+    الوصف: "هذا وصف"،
+    },
+    };
+    متكررًا ConvertAllStringValuesInObjectToLowerCase(obj)؛
+    // => {
+    // الاسم: 'مرحبا بالعالم',
+    // الوصف: "هذا وصف"،
+    //   blockInfo: {
+    // الاسم: 'مرحبا بالعالم',
+    // الوصف: "هذا وصف"،
+    //   },
+    //   }
+```
+
+
+
+## غير معروف 
+`[other]`
+
+**وصف:**
+إضافة مستند إلى الوحدة
+
+
+**أمثلة:**
+
+```جافا سكريبت
+الوحدة النمطية = وحدة جديدة({ name: 'StringUtil' })؛
+      وحدة نمطية = وحدة جديدة ({
+        الأصل: 'سلسلة.ts',
+        البيانات: {
+     
+           blockInfo: {
+           الاسم: 'StringUtil',
+           الوصف: "يحتوي هذا الفصل على أساليب لمعالجة السلاسل"،
+           },
+           بناء المعلومات: {
+           النوع: 'صنف'،
+           الاسم: 'StringUtil',
+           },
+           },
+           });
+           module.addDoc(moduleDoc)؛
+```
+
+
+
+## غير معروف 
+`[other]`
+
+**وصف:**
+احصل على المستندات في الوحدة
+
+
+**أمثلة:**
+
+```جافا سكريبت
+الوحدة النمطية = وحدة جديدة({ name: 'StringUtil' })؛
+      وحدة نمطية = وحدة جديدة ({
+       الأصل: 'سلسلة.ts',
+       البيانات: {
+       blockInfo: {
+       الاسم: 'StringUtil',
+       الوصف: "يحتوي هذا الفصل على أساليب لمعالجة السلاسل"،
+       },
+       بناء المعلومات: {
+       النوع: 'صنف'،
+       الاسم: 'StringUtil',
+       },
+       },
+       });
+       module.addDoc(moduleDoc)؛
+       module.getDocs();
+       // => [ModuleDoc]
+```
+
+
+
+## غير معروف 
+`[other]`
+
+
+
+## غير معروف 
+`[other]`
+
+**وصف:**
+تعيين مسار الملف المصدر
+
+
+
+
+## غير معروف 
+`[other]`
+
+**وصف:**
+إضافة وحدة إلى الفئة الفرعية
+
+
+
+
+
+## غير معروف 
+`[other]`
+
+**وصف:**
+الحصول على الوحدات في الفئة الفرعية
+
+
+
+
+
+## غير معروف 
+`[other]`
+
+**وصف:**
+احصل على اسم الفئة الفرعية
+
+
+
+
+## فئة 
+`[class]`
+
+
+
+## غير معروف 
+`[other]`
+
+**وصف:**
+هذا الصف يمثل فئة.
+
+**Params:**
+
+<unk> الاسم <unk> الوصف <unk>
+| --- | --- |
+<unk> الاسم <unk> اسم الفئة. |
+
+
+
+## غير معروف 
+`[other]`
+
+**وصف:**
+يضيف فئة فرعية إلى الفئة.
+
+**Params:**
+
+<unk> الاسم <unk> الوصف <unk>
+| --- | --- |
+<unk> الفئة الفرعية <unk> الفئة الفرعية المراد إضافتها. |
+
+
+
+## غير معروف 
+`[other]`
+
+**وصف:**
+يسترجع الفئات الفرعية في الفئة.
+
+
+
+## غير معروف 
+`[other]`
+
+**وصف:**
+يسترد اسم الفئة.
+
+
+
+## غير معروف 
+`[other]`
+
+**وصف:**
+يضيف وحدة إلى الفئة.
+
+**Params:**
+
+<unk> الاسم <unk> الوصف <unk>
+| --- | --- |
+<unk> الوحدة النمطية <unk> الوحدة المراد إضافتها. |
+
+
+
+## غير معروف 
+`[other]`
+
+**وصف:**
+يسترجع الوحدات النمطية في الفئة.
+