@intlayer/docs 5.5.8

package/ar/dictionary/condition.md

@@ -0,0 +1,213 @@
+# المحتوى الشرطي / الشرط في Intlayer
+
+## كيف يعمل الشرط
+
+في Intlayer، يتم تحقيق المحتوى الشرطي من خلال وظيفة `cond`، التي تربط شروطًا محددة (عادةً قيم منطقية) بالمحتوى المقابل لها. يتيح لك هذا النهج اختيار المحتوى ديناميكيًا بناءً على شرط معين. عند دمجه مع React Intlayer أو Next Intlayer، يتم اختيار المحتوى المناسب تلقائيًا وفقًا للشرط المقدم أثناء وقت التشغيل.
+
+## إعداد المحتوى الشرطي
+
+لإعداد المحتوى الشرطي في مشروع Intlayer الخاص بك، قم بإنشاء وحدة محتوى تتضمن تعريفاتك الشرطية. فيما يلي أمثلة بتنسيقات مختلفة.
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { cond, type Dictionary } from "intlayer";
+
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "المحتوى الخاص بي عندما يكون الشرط صحيحًا",
+      false: "المحتوى الخاص بي عندما يكون الشرط خاطئًا",
+      fallback: "المحتوى الخاص بي عندما يفشل الشرط", // اختياري
+    }),
+  },
+} satisfies Dictionary;
+
+export default myConditionalContent;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { cond } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "المحتوى الخاص بي عندما يكون الشرط صحيحًا",
+      false: "المحتوى الخاص بي عندما يكون الشرط خاطئًا",
+      fallback: "المحتوى الخاص بي عندما يفشل الشرط", // اختياري
+    }),
+  },
+};
+
+export default myConditionalContent;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { cond } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "المحتوى الخاص بي عندما يكون الشرط صحيحًا",
+      false: "المحتوى الخاص بي عندما يكون الشرط خاطئًا",
+      fallback: "المحتوى الخاص بي عندما يفشل الشرط", // اختياري
+    }),
+  },
+};
+
+module.exports = myConditionalContent;
+```
+
+```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "my_key",
+  "content": {
+    "myCondition": {
+      "nodeType": "condition",
+      "condition": {
+        "true": "المحتوى الخاص بي عندما يكون الشرط صحيحًا",
+        "false": "المحتوى الخاص بي عندما يكون الشرط خاطئًا",
+        "fallback": "المحتوى الخاص بي عندما يفشل الشرط", // اختياري
+      },
+    },
+  },
+}
+```
+
+> إذا لم يتم إعلان fallback، سيتم أخذ المفتاح الأخير المعلن كـ fallback إذا لم يتم التحقق من الشرط.
+
+## استخدام المحتوى الشرطي مع React Intlayer
+
+لاستخدام المحتوى الشرطي داخل مكون React، قم باستيراد واستخدام الخطاف `useIntlayer` من حزمة `react-intlayer`. يقوم هذا الخطاف بجلب المحتوى للمفتاح المحدد ويسمح لك بتمرير شرط لاختيار الإخراج المناسب.
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const ConditionalComponent: FC = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* الإخراج: المحتوى الخاص بي عندما يكون الشرط صحيحًا */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* الإخراج: المحتوى الخاص بي عندما يكون الشرط خاطئًا */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* الإخراج: المحتوى الخاص بي عندما يفشل الشرط */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* الإخراج: المحتوى الخاص بي عندما يفشل الشرط */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const ConditionalComponent = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* الإخراج: المحتوى الخاص بي عندما يكون الشرط صحيحًا */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* الإخراج: المحتوى الخاص بي عندما يكون الشرط خاطئًا */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* الإخراج: المحتوى الخاص بي عندما يفشل الشرط */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* الإخراج: المحتوى الخاص بي عندما يفشل الشرط */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const ConditionalComponent = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* الإخراج: المحتوى الخاص بي عندما يكون الشرط صحيحًا */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* الإخراج: المحتوى الخاص بي عندما يكون الشرط خاطئًا */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* الإخراج: المحتوى الخاص بي عندما يفشل الشرط */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* الإخراج: المحتوى الخاص بي عندما يفشل الشرط */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = ConditionalComponent;
+```
+
+## موارد إضافية
+
+لمزيد من المعلومات التفصيلية حول الإعداد والاستخدام، راجع الموارد التالية:
+
+- [وثائق Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_cli.md)
+- [وثائق React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_with_create_react_app.md)
+- [وثائق Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_with_nextjs_15.md)
+
+تقدم هذه الموارد مزيدًا من الأفكار حول إعداد واستخدام Intlayer عبر بيئات وأطر عمل مختلفة.

package/ar/dictionary/content_extention_customization.md

@@ -0,0 +1,81 @@
+# تخصيص امتدادات المحتوى
+
+## امتدادات ملفات المحتوى
+
+يتيح لك Intlayer تخصيص الامتدادات لملفات إعلان المحتوى. يوفر هذا التخصيص مرونة في إدارة المشاريع الكبيرة ويساعد على تجنب التعارضات مع الوحدات الأخرى.
+
+### الامتدادات الافتراضية
+
+بشكل افتراضي، يراقب Intlayer جميع الملفات ذات الامتدادات التالية لإعلانات المحتوى:
+
+- `.content.json`
+- `.content.ts`
+- `.content.tsx`
+- `.content.js`
+- `.content.jsx`
+- `.content.mjs`
+- `.content.mjx`
+- `.content.cjs`
+- `.content.cjx`
+
+هذه الامتدادات الافتراضية مناسبة لمعظم التطبيقات. ومع ذلك، عندما تكون لديك احتياجات محددة، يمكنك تعريف امتدادات مخصصة لتبسيط عملية البناء وتقليل خطر التعارض مع المكونات الأخرى.
+
+### تخصيص امتدادات المحتوى
+
+لتخصيص امتدادات الملفات التي يستخدمها Intlayer لتحديد ملفات إعلان المحتوى، يمكنك تحديدها في ملف تكوين Intlayer. هذه الطريقة مفيدة للمشاريع الكبيرة حيث أن تقليل نطاق عملية المراقبة يحسن أداء البناء.
+
+إليك مثال على كيفية تعريف امتدادات محتوى مخصصة في التكوين الخاص بك:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  content: {
+    fileExtensions: [".my_content.ts", ".my_content.tsx"], // الامتدادات المخصصة الخاصة بك
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  content: {
+    fileExtensions: [".my_content.cjs", ".my_content.cjx"], // الامتدادات المخصصة الخاصة بك
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  content: {
+    fileExtensions: [".my_content.mjs", ".my_content.mjx"], // الامتدادات المخصصة الخاصة بك
+  },
+};
+
+module.exports = config;
+```
+
+في هذا المثال، يحدد التكوين امتدادين مخصصين: `.my_content.ts` و `.my_content.tsx`. سيقوم Intlayer بمراقبة الملفات ذات هذه الامتدادات فقط لبناء القواميس.
+
+### فوائد الامتدادات المخصصة
+
+- **أداء البناء**: تقليل نطاق الملفات المراقبة يمكن أن يحسن بشكل كبير أداء البناء في المشاريع الكبيرة.
+- **تجنب التعارضات**: تساعد الامتدادات المخصصة في منع التعارضات مع ملفات JavaScript أو TypeScript الأخرى في مشروعك.
+- **التنظيم**: تتيح الامتدادات المخصصة تنظيم ملفات إعلان المحتوى وفقًا لاحتياجات مشروعك.
+
+### إرشادات للامتدادات المخصصة
+
+عند تخصيص امتدادات ملفات المحتوى، ضع الإرشادات التالية في الاعتبار:
+
+- **التفرد**: اختر امتدادات فريدة داخل مشروعك لتجنب التعارضات.
+- **التسمية المتسقة**: استخدم اصطلاحات تسمية متسقة لتحسين قابلية قراءة الكود وصيانته.
+- **تجنب الامتدادات الشائعة**: امتنع عن استخدام الامتدادات الشائعة مثل `.ts` أو `.js` لتجنب التعارضات مع الوحدات أو المكتبات الأخرى.
+
+## الخاتمة
+
+تخصيص امتدادات ملفات المحتوى في Intlayer هو ميزة قيمة لتحسين الأداء وتجنب التعارضات في التطبيقات الكبيرة. من خلال اتباع الإرشادات الموضحة في هذا التوثيق، يمكنك إدارة إعلانات المحتوى الخاصة بك بفعالية وضمان التكامل السلس مع الأجزاء الأخرى من مشروعك.

package/ar/dictionary/enumeration.md

@@ -0,0 +1,221 @@
+# التعداد / الجمع
+
+## كيف يعمل التعداد
+
+في Intlayer، يتم تحقيق التعداد من خلال وظيفة `enu`، التي تربط المفاتيح المحددة بمحتواها المقابل. يمكن أن تمثل هذه المفاتيح قيمًا رقمية، أو نطاقات، أو معرفات مخصصة. عند استخدامها مع React Intlayer أو Next Intlayer، يتم اختيار المحتوى المناسب تلقائيًا بناءً على لغة التطبيق والقواعد المحددة.
+
+## إعداد التعداد
+
+لإعداد التعداد في مشروع Intlayer الخاص بك، تحتاج إلى إنشاء وحدة محتوى تتضمن تعريفات التعداد. إليك مثال على تعداد بسيط لعدد السيارات:
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { enu, type Dictionary } from "intlayer";
+
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "أقل من ناقص سيارة واحدة",
+      "-1": "ناقص سيارة واحدة",
+      "0": "لا توجد سيارات",
+      "1": "سيارة واحدة",
+      ">5": "بعض السيارات",
+      ">19": "العديد من السيارات",
+      "fallback": "قيمة افتراضية", // اختياري
+    }),
+  },
+} satisfies Dictionary;
+
+export default carEnumeration;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { enu } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "أقل من ناقص سيارة واحدة",
+      "-1": "ناقص سيارة واحدة",
+      "0": "لا توجد سيارات",
+      "1": "سيارة واحدة",
+      ">5": "بعض السيارات",
+      ">19": "العديد من السيارات",
+      "fallback": "قيمة افتراضية", // اختياري
+    }),
+  },
+};
+
+export default carEnumeration;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { enu } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "أقل من ناقص سيارة واحدة",
+      "-1": "ناقص سيارة واحدة",
+      "0": "لا توجد سيارات",
+      "1": "سيارة واحدة",
+      ">5": "بعض السيارات",
+      ">19": "العديد من السيارات",
+      "fallback": "قيمة افتراضية", // اختياري
+    }),
+  },
+};
+
+module.exports = carEnumeration;
+```
+
+```json fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "car_count",
+  "content": {
+    "numberOfCar": {
+      "nodeType": "enumeration",
+      "enumeration": {
+        "<-1": "أقل من ناقص سيارة واحدة",
+        "-1": "ناقص سيارة واحدة",
+        "0": "لا توجد سيارات",
+        "1": "سيارة واحدة",
+        ">5": "بعض السيارات",
+        ">19": "العديد من السيارات",
+        "fallback": "قيمة افتراضية" // اختياري
+      }
+    }
+  }
+}
+```
+
+في هذا المثال، تقوم `enu` بربط الشروط المختلفة بمحتوى محدد. عند استخدامها في مكون React، يمكن لـ Intlayer اختيار المحتوى المناسب تلقائيًا بناءً على المتغير المعطى.
+
+> ترتيب التصريحات مهم في تعدادات Intlayer. أول تصريح صالح هو الذي سيتم اختياره. إذا كانت هناك شروط متعددة تنطبق، تأكد من ترتيبها بشكل صحيح لتجنب سلوك غير متوقع.
+
+> إذا لم يتم تحديد قيمة افتراضية، فستعيد الوظيفة `undefined` إذا لم تتطابق أي مفاتيح.
+
+## استخدام التعداد مع React Intlayer
+
+لاستخدام التعداد في مكون React، يمكنك الاستفادة من الخطاف `useIntlayer` من حزمة `react-intlayer`. يقوم هذا الخطاف باسترجاع المحتوى الصحيح بناءً على المعرف المحدد. إليك مثال على كيفية استخدامه:
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const CarComponent: FC = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // الناتج: لا توجد سيارات
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // الناتج: بعض السيارات
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // الناتج: العديد من السيارات
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // الناتج: قيمة افتراضية
+        }
+      </p>
+    </div>
+  );
+};
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const CarComponent = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // الناتج: لا توجد سيارات
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // الناتج: بعض السيارات
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // الناتج: العديد من السيارات
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // الناتج: قيمة افتراضية
+        }
+      </p>
+    </div>
+  );
+};
+
+export default CarComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const CarComponent = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // الناتج: لا توجد سيارات
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // الناتج: بعض السيارات
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // الناتج: العديد من السيارات
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // الناتج: قيمة افتراضية
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = CarComponent;
+```
+
+في هذا المثال، يقوم المكون بضبط مخرجاته ديناميكيًا بناءً على عدد السيارات. يتم اختيار المحتوى الصحيح تلقائيًا، اعتمادًا على النطاق المحدد.
+
+## موارد إضافية
+
+لمزيد من المعلومات التفصيلية حول الإعداد والاستخدام، راجع الموارد التالية:
+
+- [وثائق Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_cli.md)
+- [وثائق React Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_with_create_react_app.md)
+- [وثائق Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_with_nextjs_15.md)
+
+توفر هذه الموارد مزيدًا من الأفكار حول الإعداد والاستخدام لـ Intlayer في بيئات مختلفة ومع أطر عمل متنوعة.