@intlayer/docs 5.5.8

package/ar/packages/intlayer/getTranslationContent.md

@@ -0,0 +1,175 @@
+# وثائق: وظيفة `getTranslation` في `intlayer`
+
+## الوصف
+
+تقوم وظيفة `getTranslation` باسترجاع المحتوى المقابل للغة معينة من مجموعة محتويات لغوية قابلة للتخصيص. إذا لم يتم العثور على اللغة المحددة، فإنها تعود افتراضيًا إلى إرجاع المحتوى الخاص باللغة الافتراضية المُعدة في المشروع.
+
+## المعلمات
+
+- `languageContent: CustomizableLanguageContent<Content>`
+
+  - **الوصف**: كائن يحتوي على الترجمات للغات مختلفة. يمثل كل مفتاح لغة معينة، وقيمته هي المحتوى المقابل.
+  - **النوع**: `CustomizableLanguageContent<Content>`
+    - يمكن أن يكون `Content` أي نوع، والافتراضي هو `string`.
+
+- `locale: Locales`
+
+  - **الوصف**: اللغة التي سيتم استرجاع المحتوى الخاص بها.
+  - **النوع**: `Locales`
+
+## العوائد
+
+- **النوع**: `Content`
+- **الوصف**: المحتوى المقابل للغة المحددة. إذا لم يتم العثور على اللغة، يتم إرجاع محتوى اللغة الافتراضية.
+
+## مثال على الاستخدام
+
+### الاستخدام الأساسي
+
+```typescript codeFormat="typescript"
+import { getTranslation, Locales } from "intlayer";
+
+const content = getTranslation(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    ar: "مرحبا",
+  },
+  Locales.ENGLISH
+);
+
+console.log(content); // Output: "Bonjour"
+```
+
+```javascript codeFormat="esm"
+import { getTranslation, Locales } from "intlayer";
+
+const content = getTranslation(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    ar: "مرحبا",
+  },
+  Locales.ENGLISH
+);
+
+console.log(content); // Output: "Bonjour"
+```
+
+```javascript codeFormat="commonjs"
+const { getTranslation, Locales } = require("intlayer");
+
+const content = getTranslation(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    ar: "مرحبا",
+  },
+  Locales.ENGLISH
+);
+
+console.log(content); // Output: "Bonjour"
+```
+
+### لغة مفقودة:
+
+```typescript codeFormat="typescript"
+import { getTranslation, Locales } from "intlayer";
+
+const content = getTranslation(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    ar: "مرحبا",
+  },
+  Locales.SPANISH
+);
+
+console.log(content); // Output: "Hello" (محتوى اللغة الافتراضية)
+```
+
+```javascript codeFormat="esm"
+import { getTranslation, Locales } from "intlayer";
+
+const content = getTranslation(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    ar: "مرحبا",
+  },
+  Locales.SPANISH
+);
+
+console.log(content); // Output: "Hello" (محتوى اللغة الافتراضية)
+```
+
+```javascript codeFormat="commonjs"
+const { getTranslation, Locales } = require("intlayer");
+
+const content = getTranslation(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    ar: "مرحبا",
+  },
+  Locales.SPANISH
+);
+
+console.log(content); // Output: "Hello" (محتوى اللغة الافتراضية)
+```
+
+### استخدام أنواع محتوى مخصصة:
+
+```typescript codeFormat="typescript"
+import { getTranslation, Locales } from "intlayer";
+
+const customContent = getTranslation<Record<string, string>>(
+  {
+    en: { greeting: "Hello" },
+    fr: { greeting: "Bonjour" },
+    ar: { greeting: "مرحبا" },
+  },
+  Locales.FRENCH
+);
+
+console.log(customContent.greeting); // Output: "Bonjour"
+```
+
+```javascript codeFormat="esm"
+import { getTranslation, Locales } from "intlayer";
+
+const customContent = getTranslation<Record<string, string>>(
+  {
+    en: { greeting: "Hello" },
+    fr: { greeting: "Bonjour" },
+    ar: { greeting: "مرحبا" }
+  },
+  Locales.FRENCH
+);
+
+console.log(customContent.greeting); // Output: "Bonjour"
+```
+
+```javascript codeFormat="commonjs"
+const { getTranslation, Locales } = require("intlayer");
+
+const customContent = getTranslation<Record<string, string>>(
+  {
+    en: { greeting: "Hello" },
+    fr: { greeting: "Bonjour" },
+    ar: { greeting: "مرحبا" }
+  },
+  Locales.FRENCH
+);
+
+console.log(customContent.greeting); // Output: "Bonjour"
+```
+
+## الحالات الخاصة
+
+- **اللغة غير موجودة:**
+  - عندما لا يتم العثور على `locale` في `languageContent`، تقوم الوظيفة بإرجاع المحتوى الخاص باللغة الافتراضية.
+- **محتوى لغوي غير مكتمل:**
+  - إذا تم تعريف لغة بشكل جزئي، فإن الوظيفة لا تدمج المحتويات. تقوم فقط باسترجاع قيمة اللغة المحددة أو تعود إلى الافتراضية.
+- **فرض TypeScript:**
+  - إذا لم تتطابق اللغات في `languageContent` مع إعدادات المشروع، فإن TypeScript يفرض تعريف جميع اللغات المطلوبة، مما يضمن اكتمال المحتوى وسلامة النوع.

package/ar/packages/intlayer/index.md

@@ -0,0 +1,254 @@
+# intlayer: حزمة NPM لإدارة القاموس متعدد اللغات (i18n)
+
+**Intlayer** هي مجموعة من الحزم المصممة خصيصًا لمطوري JavaScript. وهي متوافقة مع أطر العمل مثل React، Next.js، و Express.js.
+
+**حزمة `intlayer`** تتيح لك إعلان المحتوى الخاص بك في أي مكان في الكود الخاص بك. تقوم بتحويل إعلانات المحتوى متعدد اللغات إلى قواميس منظمة تتكامل بسلاسة مع تطبيقك. مع TypeScript، **تعزز Intlayer** تطويرك من خلال توفير أدوات أقوى وأكثر كفاءة.
+
+## لماذا دمج Intlayer؟
+
+- **إدارة المحتوى المدعومة بـ JavaScript**: استغل مرونة JavaScript لتعريف وإدارة المحتوى الخاص بك بكفاءة.
+- **بيئة آمنة من الأخطاء**: استفد من TypeScript لضمان أن تكون جميع تعريفات المحتوى دقيقة وخالية من الأخطاء.
+- **ملفات محتوى متكاملة**: احتفظ بترجماتك بالقرب من مكوناتها ذات الصلة، مما يعزز القابلية للصيانة والوضوح.
+
+## التثبيت
+
+قم بتثبيت الحزمة اللازمة باستخدام مدير الحزم المفضل لديك:
+
+```bash packageManager="npm"
+npm install intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer
+```
+
+```bash packageManager="yarn"
+yarn add intlayer
+```
+
+### إعداد Intlayer
+
+يوفر Intlayer ملف إعداد لتكوين مشروعك. ضع هذا الملف في جذر مشروعك.
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+// إعداد اللغات الافتراضية
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+// إعداد اللغات الافتراضية
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+// إعداد اللغات الافتراضية
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+module.exports = config;
+```
+
+> للحصول على قائمة كاملة بالمعلمات المتاحة، راجع [وثائق الإعداد](https://github.com/aymericzip/intlayer/blob/main/docs/ar/configuration.md).
+
+## مثال على الاستخدام
+
+مع Intlayer، يمكنك إعلان المحتوى الخاص بك بطريقة منظمة في أي مكان في قاعدة الكود الخاصة بك.
+
+بشكل افتراضي، يقوم Intlayer بفحص الملفات ذات الامتداد `.content.{json,ts,tsx,js,jsx,mjs,mjx,cjs,cjx}`.
+
+> يمكن تعديل الامتداد الافتراضي عن طريق تعيين خاصية `contentDir` في [ملف الإعداد](https://github.com/aymericzip/intlayer/blob/main/docs/ar/configuration.md).
+
+```bash codeFormat="typescript"
+.
+├── intlayer.config.ts
+└── src
+    ├── ClientComponent
+    │   ├── index.content.ts
+    │   └── index.tsx
+    └── ServerComponent
+        ├── index.content.ts
+        └── index.tsx
+```
+
+```bash codeFormat="esm"
+.
+├── intlayer.config.mjs
+└── src
+    ├── ClientComponent
+    │   ├── index.content.mjs
+    │   └── index.mjx
+    └── ServerComponent
+        ├── index.content.mjs
+        └── index.mjx
+```
+
+```bash codeFormat="commonjs"
+.
+├── intlayer.config.cjs
+└── src
+    ├── ClientComponent
+    │   ├── index.content.cjs
+    │   └── index.cjx
+    └── ServerComponent
+        ├── index.content.cjs
+        └── index.cjx
+```
+
+### إعلان المحتوى الخاص بك
+
+إليك مثال على إعلان المحتوى:
+
+```tsx fileName="src/ClientComponent/index.content.ts" codeFormat="typescript"
+// إعلان المحتوى المترجم
+import { t, type Dictionary } from "intlayer";
+
+const clientComponentContent = {
+  key: "client-component",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+      ar: "مرحباً بالعالم",
+    }),
+    numberOfCar: enu({
+      "<-1": "أقل من ناقص سيارة واحدة",
+      "-1": "ناقص سيارة واحدة",
+      "0": "لا سيارات",
+      "1": "سيارة واحدة",
+      ">5": "بعض السيارات",
+      ">19": "الكثير من السيارات",
+    }),
+  },
+} satisfies Dictionary;
+
+export default clientComponentContent;
+```
+
+```jsx fileName="src/ClientComponent/index.content.mjs" contentDeclarationFormat="esm"
+// إعلان المحتوى المترجم
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const clientComponentContent = {
+  key: "client-component",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+      ar: "مرحباً بالعالم",
+    }),
+    numberOfCar: enu({
+      "<-1": "أقل من ناقص سيارة واحدة",
+      "-1": "ناقص سيارة واحدة",
+      "0": "لا سيارات",
+      "1": "سيارة واحدة",
+      ">5": "بعض السيارات",
+      ">19": "الكثير من السيارات",
+    }),
+  },
+};
+
+export default clientComponentContent;
+```
+
+```jsx fileName="src/ClientComponent/index.content.cjs" contentDeclarationFormat="commonjs"
+// إعلان المحتوى المترجم
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const clientComponentContent = {
+  key: "client-component",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+      ar: "مرحباً بالعالم",
+    }),
+    numberOfCar: enu({
+      "<-1": "أقل من ناقص سيارة واحدة",
+      "-1": "ناقص سيارة واحدة",
+      "0": "لا سيارات",
+      "1": "سيارة واحدة",
+      ">5": "بعض السيارات",
+      ">19": "الكثير من السيارات",
+    }),
+  },
+};
+
+module.exports = clientComponentContent;
+```
+
+```json fileName="src/ClientComponent/index.content.json" codeFormat="json"
+{
+  "key": "client-component",
+  "content": {
+    "myTranslatedContent": {
+      "nodeType": "translation",
+      "translation": {
+        "en": "Hello World",
+        "fr": "Bonjour le monde",
+        "es": "Hola Mundo",
+        "ar": "مرحباً بالعالم"
+      }
+    },
+    "numberOfCar": {
+      "nodeType": "enumeration",
+      "enumeration": {
+        "<-1": "أقل من ناقص سيارة واحدة",
+        "-1": "ناقص سيارة واحدة",
+        "0": "لا سيارات",
+        "1": "سيارة واحدة",
+        ">5": "بعض السيارات",
+        ">19": "الكثير من السيارات"
+      }
+    }
+  }
+}
+```
+
+### بناء القواميس الخاصة بك
+
+يمكنك بناء القواميس الخاصة بك باستخدام [intlayer-cli](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer-cli/readme.md).
+
+```bash packageManager="npm"
+npx intlayer dictionaries build
+```
+
+```bash packageManager="yarn"
+yarn intlayer build
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer build
+```
+
+...

package/ar/packages/intlayer-cli/index.md

@@ -0,0 +1,41 @@
+# intlayer-cli: حزمة NPM لاستخدام Intlayer CLI
+
+**Intlayer** هي مجموعة من الحزم المصممة خصيصًا لمطوري JavaScript. وهي متوافقة مع أطر العمل مثل React وExpress.js.
+
+حزمة **`intlayer-cli`** هي حزمة NPM تستهلك حزمة `@intlayer/cli` وتجعلها متاحة لواجهات سطر الأوامر الخاصة بـ `intlayer`.
+
+> لاحظ أن هذه الحزمة ليست ضرورية إذا تم تثبيت حزمة [`intlayer`](https://github.com/aymericzip/intlayer/tree/main/docs/ar/packages/intlayer/index.md). بالمقارنة مع حزمة `intlayer`، فإن حزمة `intlayer-cli` هي حزمة أخف تحتوي فقط على أداة CLI، بدون تبعيات `@intlayer/core`.
+
+## التثبيت
+
+قم بتثبيت الحزمة اللازمة باستخدام مدير الحزم المفضل لديك:
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-cli -g
+```
+
+## الاستخدام
+
+إليك مثال على كيفية استخدام حزمة `intlayer-cli`:
+
+```bash
+npx intlayer dictionaries build
+```
+
+## أوامر CLI
+
+يوفر Intlayer أداة CLI لـ:
+
+- تدقيق إعلانات المحتوى الخاص بك واستكمال الترجمات المفقودة
+- إنشاء القواميس من إعلانات المحتوى الخاص بك
+- دفع وسحب القواميس البعيدة من CMS الخاص بك إلى مشروعك المحلي
+
+راجع [intlayer-cli](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_cli.md) لمزيد من المعلومات.

package/ar/packages/intlayer-editor/index.md

@@ -0,0 +1,113 @@
+# intlayer-editor: حزمة NPM لاستخدام محرر Intlayer المرئي
+
+**Intlayer** هي مجموعة من الحزم المصممة خصيصًا لمطوري JavaScript. وهي متوافقة مع أطر العمل مثل React وReact وExpress.js.
+
+حزمة **`intlayer-editor`** هي حزمة NPM تدمج محرر Intlayer المرئي في مشروع React الخاص بك.
+
+## كيف يعمل محرر Intlayer
+
+يسمح محرر Intlayer بالتفاعل مع قاموس Intlayer البعيد. يمكن تثبيته على جانب العميل وتحويل تطبيقك إلى محرر يشبه CMS لإدارة محتوى موقعك بجميع اللغات المُعدة.
+
+![واجهة محرر Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/assets/intlayer_editor_ui.png)
+
+## التثبيت
+
+قم بتثبيت الحزمة اللازمة باستخدام مدير الحزم المفضل لديك:
+
+```bash packageManager="npm"
+npm install intlayer-editor
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-editor
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-editor
+```
+
+### التكوين
+
+في ملف تكوين Intlayer الخاص بك، يمكنك تخصيص إعدادات المحرر:
+
+```typescript
+const config: IntlayerConfig = {
+  // ... إعدادات التكوين الأخرى
+  editor: {
+    enabled: process.env.INTLAYER_ENABLED === "true", // إذا كانت القيمة false، فإن المحرر غير نشط ولا يمكن الوصول إليه.
+    // معرف العميل والسر الخاص بالعميل مطلوبان لتفعيل المحرر.
+    // يسمحان بتحديد هوية المستخدم الذي يقوم بتحرير المحتوى.
+    // يمكن الحصول عليهما عن طريق إنشاء عميل جديد في لوحة تحكم Intlayer - المشاريع (https://intlayer.org/dashboard/projects).
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+};
+```
+
+> إذا لم يكن لديك معرف عميل وسر خاص بالعميل، يمكنك الحصول عليهما عن طريق إنشاء عميل جديد في [لوحة تحكم Intlayer - المشاريع](https://intlayer.org/dashboard/projects).
+
+> لرؤية جميع المعلمات المتاحة، راجع [وثائق التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/ar/configuration.md)
+
+حزمة `intlayer-editor` تعتمد على Intlayer ومتاحة لتطبيقات JavaScript، مثل React (Create React App)، Vite + React، وNext.js.
+
+لمزيد من التفاصيل حول كيفية تثبيت الحزمة، راجع القسم المناسب أدناه:
+
+### التكامل مع Next.js
+
+للتكامل مع Next.js، راجع [دليل الإعداد](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_with_nextjs_15.md).
+
+### التكامل مع Create React App
+
+للتكامل مع Create React App، راجع [دليل الإعداد](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_with_create_react_app.md)
+
+### التكامل مع Vite + React
+
+للتكامل مع Vite + React، راجع [دليل الإعداد](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_with_vite+react.md)
+
+### مثال على التكامل
+
+لدمج محرر Intlayer المرئي في مشروع React الخاص بك، اتبع الخطوات التالية:
+
+- استورد مكون محرر Intlayer في تطبيق React الخاص بك:
+
+  ```tsx fileName="src/App.jsx"
+  import { IntlayerEditorProvider } from "intlayer-editor";
+  import { IntlayerProvider } from "react-intlayer";
+
+  export default function App() {
+    return (
+      <IntlayerProvider>
+        <IntlayerEditorProvider>
+          <IntlayerEditor>{/* محتوى التطبيق الخاص بك هنا */}</IntlayerEditor>
+        </IntlayerEditorProvider>
+      </IntlayerProvider>
+    );
+  }
+  ```
+
+- استورد أنماط محرر Intlayer في تطبيق Next.js الخاص بك:
+
+  ```tsx fileName="src/app/[locale]/layout.jsx"
+  import { IntlayerEditorStyles } from "intlayer-editor";
+
+  export default async function RootLayout({ children, params }) {
+    const { locale } = await params;
+    return (
+      <IntlayerClientProvider locale={locale}>
+        <IntlayerEditorProvider>
+          <html lang={locale}>
+            <body className={IntlayerEditorStyles}>{children}</body>
+          </html>
+        </IntlayerEditorProvider>
+      </IntlayerClientProvider>
+    );
+  }
+  ```
+
+## استخدام المحرر
+
+عندما يتم تثبيت المحرر وتفعيله وتشغيله، يمكنك عرض كل حقل مفهرس بواسطة Intlayer عن طريق التمرير فوق المحتوى الخاص بك باستخدام المؤشر.
+
+![التمرير فوق المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/assets/intlayer_editor_hover_content.png)
+
+إذا كان المحتوى الخاص بك محددًا، يمكنك الضغط عليه مطولًا لعرض درج التحرير.

package/ar/packages/lynx-intlayer/index.md

@@ -0,0 +1,58 @@
+**Intlayer** هي مجموعة من الحزم المصممة خصيصًا لمطوري JavaScript. وهي متوافقة مع أطر العمل مثل React وReact وExpress.js.
+
+**حزمة `lynx-intlayer`** تتيح لك تعريب تطبيق Vite الخاص بك. تتضمن مكون Metro الإضافي لتعيين التكوين من خلال متغيرات البيئة في [مُجمّع Lynx](https://lynxjs.org/index.html).
+
+## لماذا تعريب تطبيق Lynx الخاص بك؟
+
+تعريب تطبيق Lynx الخاص بك ضروري لخدمة جمهور عالمي بفعالية. يتيح لتطبيقك تقديم المحتوى والرسائل بلغة المستخدم المفضلة. هذه القدرة تعزز تجربة المستخدم وتوسع نطاق تطبيقك من خلال جعله أكثر سهولة وملاءمة للأشخاص من خلفيات لغوية مختلفة.
+
+## التكوين
+
+تعمل حزمة `lynx-intlayer` بسلاسة مع [حزمة `react-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/ar/packages/react-intlayer/index.md)، وحزمة [`intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/ar/packages/intlayer/index.md). اطلع على الوثائق ذات الصلة لمزيد من المعلومات.
+
+## التثبيت
+
+قم بتثبيت الحزمة المطلوبة باستخدام مدير الحزم المفضل لديك:
+
+```bash packageManager="npm"
+npm install lynx-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add lynx-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add lynx-intlayer
+```
+
+## مثال على الاستخدام
+
+اطلع على مثال حول كيفية تضمين المكونات الإضافية في تكوين vite الخاص بك.
+
+```ts
+// lynx.config.ts
+import { defineConfig } from "@lynx-js/rspeedy";
+import { pluginIntlayerLynx } from "lynx-intlayer/plugin";
+
+export default defineConfig({
+  plugins: [
+    // ... مكونات إضافية أخرى
+    pluginIntlayerLynx(),
+  ],
+});
+```
+
+## إتقان تعريب تطبيق Vite الخاص بك
+
+يوفر Intlayer العديد من الميزات لمساعدتك في تعريب تطبيق Vite الخاص بك.
+
+**لمعرفة المزيد عن هذه الميزات، راجع دليل [تعريب React (i18n) باستخدام Intlayer وLynx](https://github.com/aymericzip/intlayer/blob/main/docs/ar/intlayer_with_lynx+react.md) لتطبيق Lynx.**
+
+## اقرأ عن Intlayer
+
+- [موقع Intlayer](https://intlayer.org)
+- [وثائق Intlayer](https://intlayer.org/doc)
+- [GitHub الخاص بـ Intlayer](https://github.com/aymericzip/intlayer)
+
+- [اطرح أسئلتك على وثائقنا الذكية](https://intlayer.org/docchat)