@intlayer/docs 5.7.8 → 5.8.0

package/docs/ar/how_works_intlayer.md

@@ -25,8 +25,8 @@ slugs:
 .
 └── Components
     └── MyComponent
-        ├── index.content.cjs
-        └── index.mjs
+        ├── index.content.ts
+        └── index.tsx
 ```
 
 للقيام بذلك، دور Intlayer هو العثور على جميع `ملفات إعلان المحتوى`، بجميع التنسيقات المختلفة الموجودة في مشروعك، ثم سيقوم بإنشاء `القواميس` منها.
@@ -45,12 +45,10 @@ slugs:
 - باستخدام إضافات التطبيقات مثل حزمة [`vite-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/vite-intlayer/index.md)، أو ما يعادلها لـ [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/next-intlayer/index.md). عند استخدامك لإحدى هذه الإضافات، سيقوم Intlayer تلقائيًا ببناء القواميس عند بدء (التطوير) أو بناء (الإنتاج) تطبيقك.
 
 1. إعلان ملفات المحتوى
-
    - يمكن تعريف ملفات المحتوى بتنسيقات مختلفة، مثل TypeScript، ECMAScript، CommonJS، أو JSON.
    - يمكن تعريف ملفات المحتوى في أي مكان في المشروع، مما يسمح بصيانة أفضل وقابلية للتوسع. من المهم احترام قواعد امتداد الملفات لملفات المحتوى. هذا الامتداد هو افتراضيًا `*.content.{js|cjs|mjs|ts|tsx|json}`، ولكن يمكن تعديله في [ملف التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).
 
 2. إنشاء `القواميس`
-
    - يتم إنشاء القواميس من ملفات المحتوى. افتراضيًا، يتم إنشاء قواميس Intlayer في دليل `.intlayer/dictionaries` الخاص بالمشروع.
    - يتم إنشاء هذه القواميس بتنسيقات مختلفة لتلبية جميع الاحتياجات وتحسين أداء التطبيق.
 

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,76 @@ 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. **تجنب تلويث قاعدة الشيفرة الخاصة بك بمفاتيح/قيم غير مستخدمة للمكونات غير المستخدمة**
+   - إذا لم تستخدم مكونًا، فلن يقوم Intlayer باستيراد المحتوى المرتبط به
+   - إذا قمت بحذف مكون، ستتذكر بسهولة أكبر إزالة المحتوى المرتبط به لأنه سيكون موجودًا في نفس المجلد
+
+5. **تقليل تكلفة التفكير لوكلاء الذكاء الاصطناعي لإعلان المحتوى متعدد اللغات الخاص بك**
+   - لن يضطر وكيل الذكاء الاصطناعي إلى مسح قاعدة الشيفرة الخاصة بك بالكامل لمعرفة مكان تنفيذ المحتوى الخاص بك
+   - يمكن إجراء الترجمات بسهولة بواسطة أدوات الإكمال التلقائي للذكاء الاصطناعي في بيئة التطوير الخاصة بك (مثل GitHub Copilot)
+
+## الميزات الإضافية لـ 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/intlayer_CMS.md

@@ -1,6 +1,6 @@
 ---
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
 title: نظام إدارة المحتوى Intlayer | استخرج محتواك إلى نظام إدارة المحتوى Intlayer
 description: استخرج محتواك إلى نظام إدارة المحتوى Intlayer لتفويض إدارة المحتوى لفريقك.
 keywords:
@@ -342,7 +342,6 @@ module.exports = config;
 - التطبيق يعمل.
 
 - تم تعيين إعدادات [`editor`](https://intlayer.org/doc/concept/configuration#editor-configuration) بشكل صحيح في ملف تكوين Intlayer الخاص بك.
-
   - الحقول المطلوبة:
     - يجب أن يتطابق عنوان URL للتطبيق مع الذي قمت بتعيينه في إعدادات المحرر (`applicationURL`).
     - عنوان URL لنظام إدارة المحتوى.

package/docs/ar/intlayer_visual_editor.md

@@ -1,6 +1,6 @@
 ---
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
 title: محرر المرئي لِانتلاير | تحرير محتوىك باستخدام محرر المرئي
 description: اكتشف كيفية استخدام محرر Intlayer لإدارة موقعك الإلكتروني متعدد اللغات. اتبع الخطوات في هذه الوثيقة عبر الإنترنت لإعداد مشروعك في بضع دقائق.
 keywords:
@@ -257,7 +257,6 @@ pnpm intlayer-editor start -e development
 - المحرر البصري والتطبيق يعملان.
 
 - تم إعداد [تكوين المحرر](https://intlayer.org/doc/concept/configuration#editor-configuration) بشكل صحيح في ملف تكوين Intlayer الخاص بك.
-
   - الحقول المطلوبة:
     - يجب أن يتطابق عنوان URL للتطبيق مع الذي قمت بتعيينه في تكوين المحرر (`applicationURL`).
 

package/docs/ar/intlayer_with_tanstack.md

@@ -2,7 +2,7 @@
 createdAt: 2025-08-11
 updatedAt: 2025-08-11
 title: البدء مع Intlayer في TanStack Start (React)
-description: أضف التدويل (i18n) إلى تطبيق TanStack Start الخاص بك باستخدام Intlayer — قواميس على مستوى المكونات، عناوين URL محلية، وبيانات وصفية صديقة لمحركات البحث.
+description: أضف التدويل (i18n) إلى تطبيق TanStack Start الخاص بك باستخدام Intlayer - قواميس على مستوى المكونات، عناوين URL محلية، وبيانات وصفية صديقة لمحركات البحث.
 keywords:
   - التدويل
   - التوثيق

package/docs/ar/introduction.md

@@ -1,6 +1,6 @@
 ---
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
 title: مقدمة
 description: اكتشف كيف يعمل Intlayer. شاهد الخطوات التي يستخدمها Intlayer في تطبيقك. تعرف على ما تفعله الحزم المختلفة.
 keywords:
@@ -32,8 +32,8 @@ slugs:
 .
 └── Components
     └── MyComponent
-        ├── index.content.cjs
-        └── index.mjs
+        ├── index.content.ts
+        └── index.tsx
 ```
 
 ```tsx fileName="src/components/MyComponent/index.content.ts" contentDeclarationFormat="typescript"
@@ -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": "أقل من ناقص سيارة واحدة",