@intlayer/docs 5.7.7 → 5.8.0-canary.0

package/docs/ar/interest_of_intlayer.md

@@ -1,51 +1,114 @@
 ---
 createdAt: 2024-08-14
-updatedAt: 2025-06-29
+updatedAt: 2025-08-20
 title: أهمية Intlayer
-description: اكتشف فوائد ومزايا استخدام Intlayer في مشاريعك. افهم لماذا يتميز Intlayer بين الأُطُر الأخرى.
+description: اكتشف فوائد ومزايا استخدام Intlayer في مشاريعك. فهم لماذا يتميز Intlayer بين الأُطُر الأخرى.
 keywords:
-  - فوائد
-  - مزايا
+  - الفوائد
+  - المزايا
   - Intlayer
-  - إطار عمل
-  - مقارنة
+  - إطار العمل
+  - المقارنة
 slugs:
   - doc
-  - concept
-  - interest
+  - why
 ---
 
-# Intlayer: طريقة مخصصة لترجمة موقعك الإلكتروني
+# لماذا يجب أن تفكر في Intlayer؟
 
-**Intlayer** هي مكتبة تعريب مصممة خصيصًا لمطوري جافاسكريبت. تتيح لك إعلان المحتوى الخاص بك في كل مكان داخل الكود الخاص بك. تقوم بتحويل إعلان المحتوى متعدد اللغات إلى قواميس منظمة لتسهيل دمجها في الكود الخاص بك. باستخدام TypeScript، تجعل **Intlayer** تطويرك أقوى وأكثر كفاءة.
+## ما هو Intlayer؟
 
-## مثال على الاستخدام
+**Intlayer** هو مكتبة تعريب (تدويل) مصممة خصيصًا لمطوري جافا سكريبت. يسمح لك بالإعلان عن محتواك في كل مكان داخل الكود الخاص بك. يقوم بتحويل إعلانات المحتوى متعدد اللغات إلى قواميس منظمة لتتكامل بسهولة في كودك. باستخدام TypeScript، يجعل **Intlayer** تطويرك أقوى وأكثر كفاءة.
+
+## لماذا تم إنشاء Intlayer؟
+
+تم إنشاء Intlayer لحل مشكلة شائعة تؤثر على جميع مكتبات i18n الشائعة مثل `next-intl`، `react-i18next`، `react-intl`، `next-i18next`، `react-intl`، و `vue-i18n`.
+
+تعتمد كل هذه الحلول على نهج مركزي لقائمة وإدارة المحتوى الخاص بك. على سبيل المثال:
+
+```bash
+.
+├── locales
+│   ├── en.json
+│   ├── fr.json
+│   └── es.json
+├── i18n.ts
+└── src
+    └── components
+        └── MyComponent
+            └── index.tsx
+```
+
+أو هنا باستخدام المساحات الاسمية:
+
+```bash
+.
+├── locales
+│   ├── en
+│   │  ├── footer.json
+│   │  └── navbar.json
+│   ├── fr
+│   │  ├── footer.json
+│   │  └── navbar.json
+│   └── es
+│      ├── footer.json
+│      └── navbar.json
+├── i18n.ts
+└── src
+    └── components
+        └── MyComponent
+            └── index.tsx
+```
+
+هذا النوع من البنية يبطئ عملية التطوير ويجعل قاعدة الشيفرة أكثر تعقيدًا للصيانة لأسباب عدة:
+
+1. **لأي مكون جديد يتم إنشاؤه، يجب عليك:**
+   - إنشاء المورد/المساحة الاسمية الجديدة في مجلد `locales`
+   - تذكر استيراد المساحة الاسمية الجديدة في صفحتك
+   - ترجمة المحتوى الخاص بك (غالبًا ما يتم ذلك يدويًا عن طريق النسخ/اللصق من مزودي الذكاء الاصطناعي)
+
+2. **لأي تغيير يتم على مكوناتك، يجب عليك:**
+   - البحث عن المورد/المساحة الاسمية ذات الصلة (بعيدًا عن المكون)
+   - ترجمة المحتوى الخاص بك
+   - التأكد من تحديث المحتوى الخاص بك لكل لغة
+   - التحقق من أن المساحة الاسمية لا تحتوي على مفاتيح/قيم غير مستخدمة
+   - التأكد من أن هيكل ملفات JSON هو نفسه لجميع اللغات
+
+في المشاريع الاحترافية التي تستخدم هذه الحلول، غالبًا ما تُستخدم منصات الترجمة للمساعدة في إدارة ترجمة المحتوى الخاص بك. ومع ذلك، يمكن أن يصبح هذا مكلفًا بسرعة للمشاريع الكبيرة.
+
+لحل هذه المشكلة، تعتمد Intlayer نهجًا يقوم بتحديد نطاق المحتوى الخاص بك لكل مكون ويحافظ على المحتوى قريبًا من المكون الخاص بك، كما نفعل غالبًا مع CSS (`styled-components`)، وأنواع البيانات، والوثائق (`storybook`)، أو اختبارات الوحدة (`jest`).
 
 ```bash codeFormat="typescript"
 .
-└── Components
+└── components
     └── MyComponent
         ├── index.content.ts
+        ├── index.test.tsx
+        ├── index.stories.tsx
         └── index.tsx
 ```
 
 ```bash codeFormat="commonjs"
 .
-└── Components
+└── components
     └── MyComponent
         ├── index.content.cjs
-        └── index.mjs
+        ├── index.test.mjs
+        ├── index.stories.mjs
+        └── index.tsx
 ```
 
 ```bash codeFormat="esm"
 .
-└── Components
+└── components
     └── MyComponent
         ├── index.content.mjs
-        └── index.js
+        ├── index.test.mjs
+        ├── index.stories.mjs
+        └── index.tsx
 ```
 
-```tsx fileName="./Components/MyComponent/index.content.ts" codeFormat="typescript"
+```tsx fileName="./components/MyComponent/index.content.ts" codeFormat="typescript"
 import { t, type Dictionary } from "intlayer";
 
 const componentExampleContent = {
@@ -53,8 +116,8 @@ const componentExampleContent = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 } satisfies Dictionary;
@@ -62,18 +125,17 @@ const componentExampleContent = {
 export default componentExampleContent;
 ```
 
-```jsx fileName="./Components/MyComponent/index.mjx" codeFormat="esm"
+```jsx fileName="./components/MyComponent/index.mjx" codeFormat="esm"
 import { t } from "intlayer";
 
 /** @type {import('intlayer').Dictionary} */
-// محتوى مثال المكون
 const componentExampleContent = {
   key: "component-example",
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };
@@ -81,18 +143,18 @@ const componentExampleContent = {
 export default componentExampleContent;
 ```
 
-```jsx fileName="./Components/MyComponent/index.csx" codeFormat="commonjs"
+```jsx fileName="./components/MyComponent/index.csx" codeFormat="commonjs"
 const { t } = require("intlayer");
 
 /** @type {import('intlayer').Dictionary} */
-// محتوى مثال المكون
+// تعريف محتوى المثال للمكون
 const componentExampleContent = {
   key: "component-example",
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };
@@ -100,10 +162,9 @@ const componentExampleContent = {
 module.exports = componentExampleContent;
 ```
 
-```tsx fileName="./Components/MyComponent/index.tsx" codeFormat="typescript"
+```tsx fileName="./components/MyComponent/index.tsx" codeFormat="typescript"
 import { useIntlayer } from "react-intlayer";
 
-// مثال لمكون يستخدم intlayer لجلب المحتوى المترجم
 export const ComponentExample = () => {
   const { myTranslatedContent } = useIntlayer("component-example");
 
@@ -111,7 +172,7 @@ export const ComponentExample = () => {
 };
 ```
 
-```jsx fileName="./Components/MyComponent/index.mjx" codeFormat="esm"
+```jsx fileName="./components/MyComponent/index.mjx" codeFormat="esm"
 import { useIntlayer } from "react-intlayer";
 
 const ComponentExample = () => {
@@ -121,7 +182,7 @@ const ComponentExample = () => {
 };
 ```
 
-```jsx fileName="./Components/MyComponent/index.csx" codeFormat="commonjs"
+```jsx fileName="./components/MyComponent/index.csx" codeFormat="commonjs"
 const { useIntlayer } = require("react-intlayer");
 
 const ComponentExample = () => {
@@ -131,27 +192,79 @@ const ComponentExample = () => {
 };
 ```
 
-## لماذا تختار Intlayer؟
-
-| الميزة                                  | الوصف                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **إدارة المحتوى المدعومة بجافا سكريبت** | استغل مرونة جافا سكريبت لتعريف وإدارة المحتوى الخاص بك بكفاءة.                                                                                                                                                                                                                                                                                                                                                                                                        |
-| **بيئة آمنة من حيث النوع**              | استغل قوة TypeScript لضمان أن جميع تعريفات المحتوى الخاصة بك دقيقة وخالية من الأخطاء.                                                                                                                                                                                                                                                                                                                                                                                 |
-| **ملفات المحتوى المتكاملة**             | احتفظ بترجماتك قريبة من مكوناتها الخاصة، مما يعزز سهولة الصيانة والوضوح.                                                                                                                                                                                                                                                                                                                                                                                              |
-| **إعداد مبسط**                          | ابدأ بسرعة مع أقل إعداد ممكن، مُحسّن بشكل خاص لمشاريع Next.js.                                                                                                                                                                                                                                                                                                                                                                                                        |
-| **دعم مكونات الخادم**                   | مناسب تمامًا لمكونات خادم Next.js، مما يضمن عرضًا سلسًا على جانب الخادم.                                                                                                                                                                                                                                                                                                                                                                                              |
-| **التوجيه المحسن**                      | دعم كامل لتوجيه تطبيق Next.js، يتكيف بسلاسة مع هياكل التطبيقات المعقدة.                                                                                                                                                                                                                                                                                                                                                                                               |
-| **قاعدة شفرة منظمة**                    | حافظ على تنظيم قاعدة الشفرة الخاصة بك بشكل أفضل: مكون واحد = قاموس واحد في نفس المجلد.                                                                                                                                                                                                                                                                                                                                                                                |
-| **الترجمة التلقائية في CI**             | املأ ترجماتك تلقائيًا في CI باستخدام مفتاح API الخاص بـ OpenAI، مما يلغي الحاجة إلى منصة L10n.                                                                                                                                                                                                                                                                                                                                                                        |
-| **تكامل خادم MCP**                      | يوفر خادم MCP (بروتوكول سياق النموذج) لأتمتة بيئة التطوير المتكاملة (IDE)، مما يتيح إدارة المحتوى بسلاسة وسير عمل التدويل (i18n) مباشرة داخل بيئة التطوير الخاصة بك. [تعرف على المزيد](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/mcp_server.md).                                                                                                                                                                                                  |
-| **دعم لغة ماركداون**                    | استيراد وتفسير ملفات ماركداون للمحتوى متعدد اللغات مثل سياسات الخصوصية.                                                                                                                                                                                                                                                                                                                                                                                               |
-| **محرر بصري مجاني ونظام إدارة محتوى**   | يتوفر محرر بصري مجاني ونظام إدارة محتوى إذا كنت بحاجة إلى العمل مع كتّاب المحتوى لترجماتك، مما يلغي الحاجة إلى منصة تعريب ويسمح بفصل المحتوى عن قاعدة الشيفرة.                                                                                                                                                                                                                                                                                                        |
-| **استرجاع المحتوى المبسط**              | لا حاجة لاستدعاء دالة `t` لكل قطعة محتوى؛ يمكنك استرجاع كل المحتوى الخاص بك مباشرة باستخدام هوك واحد فقط.                                                                                                                                                                                                                                                                                                                                                             |
-| **تنفيذ متسق**                          | نفس التنفيذ لكل من مكونات العميل والخادم، لا حاجة لتمرير دالة `t` الخاصة بك عبر كل مكون خادم.                                                                                                                                                                                                                                                                                                                                                                         |
-| **محتوى قابل للتقليل الشجري**           | المحتوى قابل للتقليل الشجري، مما يخفف من حجم الحزمة النهائية.                                                                                                                                                                                                                                                                                                                                                                                                         |
-| **العرض الثابت غير المعوق**             | لا يقوم Intlayer بحجب العرض الثابت كما يفعل `next-intl`.                                                                                                                                                                                                                                                                                                                                                                                                              |
-| **التشغيل البيني**                      | يسمح بالتشغيل البيني مع [react-i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_react-i18next.md)، [next-i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_next-i18next.md)، [next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_next-intl.md)، و [react-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_react-intl.md). |
+تتيح لك هذه الطريقة:
+
+1. **زيادة سرعة التطوير**
+   - يمكن إنشاء ملفات `.content.{{ts|mjs|cjs|json}}` باستخدام إضافة VSCode
+   - يمكن لأدوات الإكمال التلقائي المعتمدة على الذكاء الاصطناعي في بيئة التطوير الخاصة بك (مثل GitHub Copilot) مساعدتك في إعلان المحتوى الخاص بك، مما يقلل من النسخ/اللصق
+
+2. **تقليل تعقيد قاعدة الشيفرة الخاصة بك**
+
+3. **زيادة قابلية صيانة قاعدة الشيفرة الخاصة بك**
+
+4. **تكرار مكوناتك والمحتوى المرتبط بها بسهولة أكبر (مثال: مكونات تسجيل الدخول/التسجيل، إلخ)**
+   - من خلال الحد من خطر التأثير على محتوى المكونات الأخرى
+   - من خلال نسخ/لصق المحتوى الخاص بك من تطبيق إلى آخر بدون تبعيات خارجية
+
+5. **تجنب تلويث قاعدة الشيفرة الخاصة بك بمفاتيح/قيم غير مستخدمة للمكونات غير المستخدمة**
+   - إذا لم تستخدم مكونًا، فلن تحتاج إلى استيراد محتواه
+   - إذا قمت بحذف مكون، ستتذكر بسهولة أكبر إزالة المحتوى المرتبط به لأنه سيكون موجودًا في نفس المجلد
+
+6. **تقليل تكلفة التفكير لوكلاء الذكاء الاصطناعي لإعلان المحتوى متعدد اللغات الخاص بك**
+   - لن يضطر وكيل الذكاء الاصطناعي إلى مسح قاعدة الشيفرة الخاصة بك بالكامل لمعرفة مكان تنفيذ المحتوى الخاص بك
+   - يمكن إجراء الترجمات بسهولة بواسطة أدوات الإكمال التلقائي للذكاء الاصطناعي في بيئة التطوير الخاصة بك (مثل GitHub Copilot)
+
+7. **تحسين أداء التحميل**
+   - إذا تم تحميل مكون بشكل كسول، فسيتم تحميل المحتوى المرتبط به في نفس الوقت
+
+## الميزات الإضافية لـ Intlayer
+
+| الميزة                                                                                                                 | الوصف                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **دعم عبر الأُطُر المختلفة**<br><br>يتوافق Intlayer مع جميع الأُطُر والمكتبات الرئيسية، بما في ذلك Next.js و React و Vite و Vue.js و Nuxt و Preact و Express والمزيد.                                                                                                                                                                                                                                                                           |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.png?raw=true)       | **إدارة المحتوى باستخدام جافاسكريبت**<br><br>استفد من مرونة جافاسكريبت لتعريف وإدارة محتواك بكفاءة. <br><br> - [إعلان المحتوى](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                                                                                        |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **ملف إعلان المحتوى لكل لغة**<br><br>سرّع عملية تطويرك من خلال إعلان محتواك مرة واحدة، قبل التوليد التلقائي.<br><br> - [ملف إعلان المحتوى لكل لغة](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                                                                            |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **بيئة آمنة من حيث النوع**<br><br>استفد من TypeScript لضمان أن تعريفات المحتوى والرمز الخاص بك خالية من الأخطاء، مع الاستفادة أيضًا من الإكمال التلقائي في بيئة التطوير المتكاملة (IDE).<br><br> - [تكوين TypeScript](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                 |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **إعداد مبسط**<br><br>ابدأ بسرعة مع أقل قدر من التهيئة. قم بضبط الإعدادات الخاصة بالتدويل، التوجيه، الذكاء الاصطناعي، البناء، وإدارة المحتوى بسهولة.<br><br> - [استكشاف تكامل Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                             |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **استرجاع المحتوى المبسط**<br><br>لا حاجة لاستدعاء دالة `t` لكل قطعة محتوى. استرجع كل محتواك مباشرة باستخدام هوك واحد.<br><br> - [تكامل React](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                                                                           |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **تنفيذ متسق لمكونات الخادم**<br><br>مناسب تمامًا لمكونات الخادم في Next.js، استخدم نفس التنفيذ لكل من مكونات العميل والخادم، لا حاجة لتمرير دالة `t` الخاصة بك عبر كل مكون خادم. <br><br> - [مكونات الخادم](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                                                                   |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **قاعدة شفرة منظمة**<br><br>حافظ على تنظيم قاعدة الشفرة الخاصة بك بشكل أفضل: مكون واحد = قاموس واحد في نفس المجلد. الترجمة القريبة من مكوناتها تعزز من سهولة الصيانة والوضوح. <br><br> - [كيف يعمل Intlayer](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                                               |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **توجيه محسّن**<br><br>دعم كامل لتوجيه التطبيقات، يتكيف بسلاسة مع هياكل التطبيقات المعقدة، لـ Next.js و React و Vite و Vue.js، وغيرها.<br><br> - [استكشاف تكامل Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                           |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **دعم ماركداون**<br><br>استيراد وتفسير ملفات اللغة وملفات ماركداون عن بُعد للمحتوى متعدد اللغات مثل سياسات الخصوصية، الوثائق، إلخ. تفسير وجعل بيانات التعريف الخاصة بماركداون متاحة في كودك.<br><br> - [ملفات المحتوى](https://intlayer.org/doc/concept/content/file)                                                                                                                                                                           |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **محرر مرئي مجاني ونظام إدارة محتوى**<br><br>يتوفر محرر مرئي مجاني ونظام إدارة محتوى لكتاب المحتوى، مما يلغي الحاجة إلى منصة تعريب. حافظ على تزامن محتواك باستخدام Git، أو قم بتفويضه كليًا أو جزئيًا باستخدام نظام إدارة المحتوى.<br><br> - [محرر Intlayer](https://intlayer.org/doc/concept/editor) <br> - [نظام إدارة محتوى Intlayer](https://intlayer.org/doc/concept/cms)                                                                  |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                           | **محتوى قابل للتقليل الشجري**<br><br>محتوى قابل للتقليل الشجري، مما يقلل من حجم الحزمة النهائية. يقوم بتحميل المحتوى لكل مكون، مستبعدًا أي محتوى غير مستخدم من الحزمة الخاصة بك. يدعم التحميل الكسول لتحسين كفاءة تحميل التطبيق. <br><br> - [تحسين بناء التطبيق](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                                                    |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **العرض الثابت**<br><br>لا يعوق العرض الثابت.<br><br> - [تكامل Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                                            |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **الترجمة المدعومة بالذكاء الاصطناعي**<br><br>حوّل موقعك الإلكتروني إلى 231 لغة بنقرة واحدة فقط باستخدام أدوات الترجمة المتقدمة المدعومة بالذكاء الاصطناعي من Intlayer باستخدام مزود الذكاء الاصطناعي الخاص بك/مفتاح API الخاص بك. <br><br> - [تكامل CI/CD](https://intlayer.org/doc/concept/ci-cd) <br> - [واجهة سطر أوامر Intlayer](https://intlayer.org/doc/concept/cli) <br> - [الملء التلقائي](https://intlayer.org/doc/concept/auto-fill) |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **تكامل خادم MCP**<br><br>يوفر خادم MCP (بروتوكول سياق النموذج) لأتمتة بيئة التطوير المتكاملة (IDE)، مما يتيح إدارة محتوى سلسة وسير عمل التدويل (i18n) مباشرة داخل بيئة التطوير الخاصة بك. <br><br> - [خادم MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/mcp_server.md)                                                                                                                                                   |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **امتداد VSCode**<br><br>يوفر Intlayer امتدادًا لـ VSCode لمساعدتك في إدارة المحتوى والترجمات الخاصة بك، وبناء قواميسك، وترجمة المحتوى الخاص بك، والمزيد.<br><br> - [امتداد VSCode](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                                 |
+| ![ميزة](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **التشغيل البيني**<br><br>يتيح التشغيل البيني مع react-i18next و next-i18next و next-intl و react-intl. <br><br> - [Intlayer و react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer و next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer و next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next)                                                                          |
+
+## مقارنة Intlayer مع الحلول الأخرى
+
+| الميزة                                                 | Intlayer                                                                                                                  | React-i18next / i18next                                                     | React-Intl (FormatJS)                  | LinguiJS                              | next-intl                             | next-i18next                          | vue-i18n                                               |
+| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | -------------------------------------- | ------------------------------------- | ------------------------------------- | ------------------------------------- | ------------------------------------------------------ |
+| **الترجمات بالقرب من المكونات**                        | نعم، المحتوى موضوع بجانب كل مكون                                                                                          | لا                                                                          | لا                                     | لا                                    | لا                                    | لا                                    | نعم - باستخدام `مكونات الملف الواحد` (SFCs)            |
+| **تكامل TypeScript**                                   | متقدم، أنواع صارمة مولدة تلقائيًا                                                                                         | أساسي؛ إعداد إضافي للسلامة                                                  | جيد، لكنه أقل صرامة                    | أنواع، يحتاج إلى إعداد                | جيد                                   | أساسي                                 | جيد (الأنواع متاحة؛ يحتاج إعداد لأمان المفاتيح)        |
+| **كشف الترجمات المفقودة**                              | خطأ/تحذير أثناء وقت البناء                                                                                                | في الغالب سلاسل بديلة أثناء وقت التشغيل                                     | سلاسل بديلة                            | يحتاج إلى إعداد إضافي                 | سلاسل بديلة أثناء وقت التشغيل         | سلاسل بديلة أثناء وقت التشغيل         | سلاسل بديلة أثناء وقت التشغيل/تحذيرات (قابلة للتكوين)  |
+| **المحتوى الغني (JSX/Markdown/المكونات)**              | دعم مباشر، حتى لعقد React                                                                                                 | محدود / فقط التداخل                                                         | صيغة ICU، ليست JSX حقيقية              | محدود                                 | غير مصمم للعقد الغنية                 | محدود                                 | محدود (المكونات عبر `<i18n-t>`، Markdown عبر الإضافات) |
+| **الترجمة المدعومة بالذكاء الاصطناعي**                 | نعم، يدعم عدة مزودي ذكاء اصطناعي. يمكن استخدامه باستخدام مفاتيح API الخاصة بك. يأخذ في الاعتبار سياق تطبيقك ونطاق المحتوى | لا                                                                          | لا                                     | لا                                    | لا                                    | لا                                    | لا                                                     |
+| **المحرر المرئي**                                      | نعم، محرر مرئي محلي + نظام إدارة محتوى اختياري؛ يمكنه إخراج محتوى قاعدة الشيفرة؛ قابل للتضمين                             | لا / متوفر عبر منصات الترجمة الخارجية                                       | لا / متوفر عبر منصات الترجمة الخارجية  | لا / متوفر عبر منصات الترجمة الخارجية | لا / متوفر عبر منصات الترجمة الخارجية | لا / متوفر عبر منصات الترجمة الخارجية | لا / متوفر عبر منصات الترجمة الخارجية                  |
+| **التوجيه المحلي**                                     | مدمج، دعم الوسيط                                                                                                          | إضافات أو إعداد يدوي                                                        | غير مدمج                               | إعداد يدوي/إضافة                      | مدمج                                  | مدمج                                  | يدوي عبر Vue Router (يتعامل Nuxt i18n معه)             |
+| **توليد المسار الديناميكي**                            | نعم                                                                                                                       | إضافة/نظام بيئي أو إعداد يدوي                                               | غير متوفر                              | إضافة/يدوي                            | نعم                                   | نعم                                   | غير متوفر (يوفره Nuxt i18n)                            |
+| **التصريف الجمعي**                                     | أنماط قائمة على التعداد؛ راجع الوثائق                                                                                     | قابل للتكوين (إضافات مثل i18next-icu)                                       | متقدم (ICU)                            | متقدم (ICU/messageformat)             | جيد                                   | جيد                                   | متقدم (قواعد الجمع المدمجة)                            |
+| **التنسيق (التواريخ، الأرقام، العملات)**               | منسقات محسّنة (Intl تحت الغطاء)                                                                                           | عبر الإضافات أو استخدام Intl مخصص                                           | منسقات ICU متقدمة                      | مساعدو ICU/CLI                        | جيد (مساعدو Intl)                     | جيد (مساعدو Intl)                     | منسقات مدمجة للتواريخ/الأرقام (Intl)                   |
+| **تنسيق المحتوى**                                      | .tsx, .ts, .js, .json, .md, .txt                                                                                          | .json                                                                       | .json, .js                             | .po, .json                            | .json, .js, .ts                       | .json                                 | .json, .js                                             |
+| **دعم ICU**                                            | جاري العمل عليه (ICU الأصلي)                                                                                              | عبر الإضافة (i18next-icu)                                                   | نعم                                    | نعم                                   | نعم                                   | عبر الإضافة (i18next-icu)             | عبر مهيئ/مجمّع مخصص                                    |
+| **مساعدو تحسين محركات البحث (hreflang، خريطة الموقع)** | أدوات مدمجة: مساعدات لخريطة الموقع، **robots.txt**، البيانات الوصفية                                                      | إضافات المجتمع/يدوي                                                         | ليست جزءًا أساسيًا                     | ليست جزءًا أساسيًا                    | جيد                                   | جيد                                   | ليست جزءًا أساسيًا (يوفر Nuxt i18n مساعدات)            |
+| **النظام البيئي / المجتمع**                            | أصغر ولكنها تنمو بسرعة وتتميز بالتفاعل                                                                                    | الأكبر والأكثر نضجًا                                                        | كبير، مؤسسي                            | ينمو، أصغر                            | متوسط الحجم، يركز على Next.js         | متوسط الحجم، يركز على Next.js         | كبير في نظام Vue البيئي                                |
+| **التصيير على جانب الخادم ومكونات الخادم**             | نعم، مُبسّط للتصيير على جانب الخادم / مكونات خادم React                                                                   | مدعوم، يتطلب بعض الإعدادات                                                  | مدعوم في Next.js                       | مدعوم                                 | دعم كامل                              | دعم كامل                              | التصيير على جانب الخادم عبر Nuxt/Vue SSR (بدون RSC)    |
+| **تحليل الشجرة (تحميل المحتوى المستخدم فقط)**          | نعم، لكل مكون أثناء وقت البناء عبر إضافات Babel/SWC                                                                       | عادةً ما يتم تحميل الكل (يمكن تحسينه باستخدام المساحات الاسمية/تقسيم الكود) | عادةً ما يتم تحميل الكل                | ليس افتراضيًا                         | جزئي                                  | جزئي                                  | جزئي (مع تقسيم الكود/إعداد يدوي)                       |
+| **التحميل الكسول**                                     | نعم، لكل لغة/لكل مكون                                                                                                     | نعم (مثل الخلفيات/الأسماء عند الطلب)                                        | نعم (تقسيم حزم اللغة)                  | نعم (استيراد الكتالوجات الديناميكي)   | نعم (لكل مسار/لكل لغة)                | نعم (لكل مسار/لكل لغة)                | نعم (رسائل اللغة غير المتزامنة)                        |
+| **إدارة المشاريع الكبيرة**                             | يشجع على التصميم المعياري، مناسب لنظام التصميم                                                                            | يحتاج إلى انضباط جيد في الملفات                                             | يمكن أن تصبح الكتالوجات المركزية كبيرة | قد تصبح معقدة                         | معياري مع الإعداد                     | معياري مع الإعداد                     | معياري مع إعداد Vue Router/Nuxt i18n                   |
 
 ## تاريخ الوثيقة
 
-- 5.5.10 - 2025-06-29: بداية التاريخ
+| الإصدار | التاريخ    | التغييرات           |
+| ------- | ---------- | ------------------- |
+| 5.8.0   | 2025-08-19 | تحديث جدول المقارنة |
+| 5.5.10  | 2025-06-29 | بدء التاريخ         |

package/docs/ar/introduction.md

@@ -44,8 +44,8 @@ const componentContent = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 } satisfies Dictionary;
@@ -62,8 +62,8 @@ const componentContent = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };
@@ -80,8 +80,8 @@ const componentContent = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };

package/docs/ar/packages/intlayer/index.md

@@ -148,8 +148,8 @@ const clientComponentContent = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
     numberOfCar: enu({
       "<-1": "أقل من ناقص سيارة واحدة",
@@ -174,8 +174,8 @@ const clientComponentContent = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
     numberOfCar: enu({
       "<-1": "أقل من ناقص سيارة واحدة",
@@ -200,8 +200,8 @@ const clientComponentContent = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
     numberOfCar: enu({
       "<-1": "أقل من ناقص سيارة واحدة",

package/docs/ar/packages/next-intlayer/index.md

@@ -110,8 +110,8 @@ const clientComponentContent = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
     numberOfCar: enu({
       "<-1": "Less than minus one car",
@@ -136,8 +136,8 @@ const clientComponentContent = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
     numberOfCar: enu({
       "<-1": "أقل من ناقص سيارة واحدة",
@@ -162,8 +162,8 @@ const clientComponentContent = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
     numberOfCar: enu({
       "<-1": "أقل من ناقص سيارة واحدة",

package/docs/de/CI_CD.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-05-20
-updatedAt: 2025-06-29
+updatedAt: 2025-08-13
 title: CI/CD-Integration
 description: Erfahren Sie, wie Sie Intlayer in Ihre CI/CD-Pipeline für automatisiertes Content-Management und Deployment integrieren.
 keywords:
@@ -19,11 +19,11 @@ slugs:
 
 # Automatische Generierung von Übersetzungen in einer CI/CD-Pipeline
 
-Intlayer ermöglicht die automatische Generierung von Übersetzungen für Ihre Content-Deklarationsdateien. Es gibt verschiedene Möglichkeiten, dies je nach Ihrem Workflow zu erreichen.
+Intlayer ermöglicht die automatische Generierung von Übersetzungen für Ihre Content-Deklarationsdateien. Es gibt verschiedene Möglichkeiten, dies je nach Ihrem Workflow zu realisieren.
 
 ## Verwendung des CMS
 
-Mit Intlayer können Sie einen Workflow übernehmen, bei dem nur eine einzige Locale lokal deklariert wird, während alle Übersetzungen remote über das CMS verwaltet werden. Dies ermöglicht es, Inhalte und Übersetzungen vollständig von der Codebasis zu trennen, bietet mehr Flexibilität für Content-Editoren und ermöglicht ein Hot Content Reloading (kein Neubauen der Anwendung erforderlich, um Änderungen anzuwenden).
+Mit Intlayer können Sie einen Workflow verwenden, bei dem nur eine einzige Locale lokal deklariert wird, während alle Übersetzungen remote über das CMS verwaltet werden. Dies ermöglicht es, Inhalte und Übersetzungen vollständig von der Codebasis zu trennen, bietet mehr Flexibilität für Content-Editoren und ermöglicht ein Hot Content Reloading (kein erneutes Bauen der Anwendung erforderlich, um Änderungen anzuwenden).
 
 ### Beispielkonfiguration
 
@@ -52,7 +52,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-Um mehr über das CMS zu erfahren, siehe die [offizielle Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_CMS.md).
+Um mehr über das CMS zu erfahren, lesen Sie die [offizielle Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_CMS.md).
 
 ## Verwendung von Husky
 
@@ -85,11 +85,11 @@ export default config;
 ```
 
 ```bash fileName=".husky/pre-push"
-npx intlayer build                          # Um sicherzustellen, dass die Wörterbücher aktuell sind
-npx intlayer fill --unpushed --mode fill    # Füllt nur fehlende Inhalte, aktualisiert keine bestehenden
+npx intlayer build                          # Um sicherzustellen, dass die Wörterbücher auf dem neuesten Stand sind
+npx intlayer fill --unpushed --mode fill    # Nur fehlende Inhalte ausfüllen, bestehende nicht aktualisieren
 ```
 
-> Für weitere Informationen zu den Intlayer-CLI-Befehlen und deren Verwendung siehe die [CLI-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_cli.md).
+> Für weitere Informationen zu den Intlayer CLI-Befehlen und deren Verwendung siehe die [CLI-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_cli.md).
 
 > Wenn Sie mehrere Apps in Ihrem Repository haben, die separate Intlayer-Instanzen verwenden, können Sie das Argument `--base-dir` wie folgt verwenden:
 
@@ -105,68 +105,94 @@ npx intlayer fill --base-dir ./app2 --unpushed --mode fill
 
 ## Verwendung von GitHub Actions
 
-Intlayer stellt einen CLI-Befehl zum automatischen Ausfüllen und Überprüfen von Wörterbuchinhalten bereit. Dies kann in Ihren CI/CD-Workflow mit GitHub Actions integriert werden.
+Intlayer bietet einen CLI-Befehl zum automatischen Ausfüllen und Überprüfen von Wörterbuchinhalten. Dies kann in Ihren CI/CD-Workflow mit GitHub Actions integriert werden.
 
 ```yaml fileName=".github/workflows/intlayer-translate.yml"
 name: Intlayer Auto-Fill
+# Auslöserbedingungen für diesen Workflow
 on:
-  push:
-    branches: [ main ]
-    paths:
-      - 'src/**'
   pull_request:
-    branches: [ main ]
-    paths:
-      - 'src/**'
-  workflow_dispatch: {}
+    branches:
+      - "main"
+
+permissions:
+  contents: write
+  pull-requests: write
 
 concurrency:
-  group: 'autofill-${{ github.ref }}'
+  group: "autofill-${{ github.ref }}"
   cancel-in-progress: true
 
 jobs:
   autofill:
     runs-on: ubuntu-latest
     env:
-      INTLAYER_CLIENT_ID: ${{ secrets.INTLAYER_CLIENT_ID }}
-      INTLAYER_CLIENT_SECRET: ${{ secrets.INTLAYER_CLIENT_SECRET }}
-      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      # OpenAI
+      AI_MODEL: openai
+      AI_PROVIDER: gpt-5-mini
+      AI_API_KEY: ${{ secrets.AI_API_KEY }}
 
     steps:
+      # Schritt 1: Hole den neuesten Code aus dem Repository
       - name: ⬇️ Repository auschecken
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
-          persist-credentials: true
+          persist-credentials: true # Anmeldeinformationen zum Erstellen von PRs beibehalten
+          fetch-depth: 0 # Vollständige Git-Historie für Differenzanalyse abrufen
 
+      # Schritt 2: Node.js-Umgebung einrichten
       - name: 🟢 Node.js einrichten
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 20 # Node.js 20 LTS für Stabilität verwenden
 
+      # Schritt 3: Projektabhängigkeiten installieren
       - name: 📦 Abhängigkeiten installieren
-        run: npm ci
+        run: npm install
+
+      # Schritt 4: Intlayer CLI global für Übersetzungsmanagement installieren
+      - name: 📦 Intlayer installieren
+        run: npm install -g intlayer-cli
 
+      # Schritt 5: Intlayer-Projekt bauen, um Übersetzungsdateien zu generieren
       - name: ⚙️ Intlayer-Projekt bauen
         run: npx intlayer build
 
+      # Schritt 6: KI verwenden, um fehlende Übersetzungen automatisch auszufüllen
       - name: 🤖 Fehlende Übersetzungen automatisch ausfüllen
-        run: npx intlayer fill --git-diff --mode fill
-
-      - name: 📤 Übersetzungs-PR erstellen oder aktualisieren
-        uses: peter-evans/create-pull-request@v4
-        with:
-          commit-message: chore: fehlende Übersetzungen automatisch ausfüllen [skip ci]
-          branch: auto-translations
-          title: chore: fehlende Übersetzungen aktualisieren
-          labels: translation, automated
+        run: npx intlayer fill --git-diff --mode fill --provider $AI_PROVIDER --model $AI_MODEL --api-key $AI_API_KEY
+
+      # Schritt 7: Prüfen, ob Änderungen vorliegen und diese committen
+      - name: � Auf Änderungen prüfen
+        id: check-changes
+        run: |
+          if [ -n "$(git status --porcelain)" ]; then
+            echo "has-changes=true" >> $GITHUB_OUTPUT
+          else
+            echo "has-changes=false" >> $GITHUB_OUTPUT
+          fi
+
+      # Schritt 8: Änderungen committen und pushen, falls vorhanden
+      - name: 📤 Änderungen committen und pushen
+        if: steps.check-changes.outputs.has-changes == 'true'
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git add .
+          git commit -m "chore: fehlende Übersetzungen automatisch ausfüllen [skip ci]"
+          git push origin HEAD:${{ github.head_ref }}
 ```
 
+Um die Umgebungsvariablen einzurichten, gehen Sie zu GitHub → Einstellungen → Geheimnisse und Variablen → Aktionen und fügen Sie das Geheimnis hinzu.
+
 > Wie bei Husky können Sie im Fall eines Monorepos das Argument `--base-dir` verwenden, um jede App nacheinander zu behandeln.
 
 > Standardmäßig filtert das Argument `--git-diff` Wörterbücher, die Änderungen vom Basiszweig (Standard `origin/main`) zum aktuellen Zweig (Standard: `HEAD`) enthalten.
 
-> Für weitere Informationen zu den Intlayer-CLI-Befehlen und deren Verwendung lesen Sie bitte die [CLI-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_cli.md).
+> Für weitere Informationen zu den Intlayer CLI-Befehlen und deren Verwendung lesen Sie bitte die [CLI-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_cli.md).
 
-## Dokumentationsverlauf
+## Dokumentationshistorie
 
-- 5.5.10 - 2025-06-29: Initialer Verlauf
+| Version | Datum      | Änderungen              |
+| ------- | ---------- | ----------------------- |
+| 5.5.10  | 2025-06-29 | Historie initialisieren |