@intlayer/docs 6.0.1 → 6.0.2-canary.0

package/docs/ar/intlayer_CMS.md

@@ -1,16 +1,16 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-08-23
-title: نظام إدارة المحتوى Intlayer | استخرج محتواك إلى نظام إدارة المحتوى Intlayer
-description: استخرج محتواك إلى نظام إدارة المحتوى Intlayer لتفويض إدارة المحتوى لفريقك.
+title: نظام إدارة المحتوى Intlayer | إخراج محتواك إلى نظام إدارة المحتوى Intlayer
+description: إخراج محتواك إلى نظام إدارة المحتوى Intlayer لتفويض إدارة المحتوى إلى فريقك.
 keywords:
   - نظام إدارة المحتوى
-  - محرر مرئي
-  - تدويل
-  - توثيق
+  - محرر بصري
+  - التدويل
+  - التوثيق
   - Intlayer
   - Next.js
-  - JavaScript
+  - جافا سكريبت
   - React
 slugs:
   - doc
@@ -19,29 +19,29 @@ slugs:
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 ---
 
-# توثيق نظام إدارة المحتوى (CMS) الخاص بـ Intlayer
+# توثيق نظام إدارة المحتوى Intlayer (CMS)
 
-<iframe title="Visual Editor + CMS for Your Web App: Intlayer Explained" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/UDDTnirwi_4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="المحرر البصري + نظام إدارة المحتوى لتطبيق الويب الخاص بك: شرح Intlayer" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/UDDTnirwi_4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
-نظام إدارة المحتوى Intlayer هو تطبيق يتيح لك فصل محتوى مشروع Intlayer الخاص بك.
+نظام إدارة المحتوى Intlayer هو تطبيق يسمح لك بإخراج محتواك من مشروع Intlayer.
 
-لهذا الغرض، يقدم Intlayer مفهوم "القواميس البعيدة".
+لهذا، قدم Intlayer مفهوم "القواميس البعيدة".
 
 ![واجهة نظام إدارة المحتوى Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/assets/CMS.png)
 
 ## فهم القواميس البعيدة
 
-يقوم Intlayer بالتمييز بين القواميس "المحلية" و"البعيدة".
+يفرق Intlayer بين القواميس "المحلية" و"البعيدة".
 
-- القاموس "المحلي" هو قاموس يتم الإعلان عنه في مشروع Intlayer الخاص بك، مثل ملف الإعلان عن زر أو شريط التنقل الخاص بك. لا معنى لفصل المحتوى في هذه الحالة لأن هذا المحتوى ليس من المفترض تغييره بشكل متكرر.
+- القاموس "المحلي" هو قاموس يتم إعلانه داخل مشروع Intlayer الخاص بك. مثل ملف إعلان زر، أو شريط التنقل الخاص بك. إخراج المحتوى الخاص بك لا معنى له في هذه الحالة لأن هذا المحتوى من المفترض ألا يتغير كثيرًا.
 
-- القاموس "البعيد" هو قاموس يتم إدارته من خلال نظام إدارة المحتوى Intlayer. يمكن أن يكون مفيدًا للسماح لفريقك بإدارة المحتوى مباشرةً على موقعك، كما يهدف إلى استخدام ميزات اختبار A/B وتحسين محركات البحث التلقائي.
+- القاموس "البعيد" هو قاموس يتم إدارته من خلال نظام إدارة المحتوى Intlayer CMS. قد يكون مفيدًا للسماح لفريقك بإدارة المحتوى مباشرة على موقعك الإلكتروني، ويهدف أيضًا إلى استخدام ميزات اختبار A/B والتحسين التلقائي لمحركات البحث (SEO).
 
-## المحرر البصري مقابل نظام إدارة المحتوى
+## المحرر المرئي مقابل نظام إدارة المحتوى (CMS)
 
-[المحرر البصري Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md) هو أداة تتيح لك إدارة المحتوى في محرر بصري للقواميس المحلية. بمجرد إجراء تغيير، سيتم استبدال المحتوى في قاعدة الكود. هذا يعني أن التطبيق سيتم إعادة بنائه وستتم إعادة تحميل الصفحة لعرض المحتوى الجديد.
+محرر [Intlayer Visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md) هو أداة تتيح لك إدارة المحتوى الخاص بك في محرر مرئي للقواميس المحلية. بمجرد إجراء تغيير، سيتم استبدال المحتوى في قاعدة الشيفرة. هذا يعني أن التطبيق سيتم إعادة بنائه وستتم إعادة تحميل الصفحة لعرض المحتوى الجديد.
 
-على النقيض من ذلك، فإن نظام إدارة المحتوى Intlayer هو أداة تتيح لك إدارة المحتوى في محرر بصري للقواميس البعيدة. بمجرد إجراء تغيير، لن يؤثر المحتوى على قاعدة الكود. وسيعرض الموقع تلقائيًا المحتوى الذي تم تغييره.
+على النقيض من ذلك، فإن نظام إدارة المحتوى Intlayer CMS هو أداة تتيح لك إدارة المحتوى الخاص بك في محرر مرئي للقواميس البعيدة. بمجرد إجراء تغيير، لن يؤثر المحتوى على قاعدة الشيفرة الخاصة بك. وسيعرض الموقع تلقائيًا المحتوى المُعدل.
 
 ## التكامل
 
@@ -49,8 +49,6 @@ youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 
 ### التكامل مع Next.js
 
-### التكامل مع Next.js
-
 للتكامل مع Next.js، راجع [دليل الإعداد](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_15.md).
 
 ### التكامل مع Create React App
@@ -61,30 +59,30 @@ youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 
 للتكامل مع Vite + React، راجع [دليل الإعداد](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+react.md).
 
-## التكوين
+## التهيئة
 
-في ملف تكوين Intlayer الخاص بك، يمكنك تخصيص إعدادات نظام إدارة المحتوى:
+في ملف تهيئة Intlayer الخاص بك، يمكنك تخصيص إعدادات نظام إدارة المحتوى:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import type { IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
-  // ... إعدادات التكوين الأخرى
+  // ... إعدادات التهيئة الأخرى
   editor: {
     /**
      * مطلوب
      *
-     * عنوان URL للتطبيق.
-     * هذا هو عنوان URL المستهدف من قبل المحرر البصري.
+     * عنوان URL الخاص بالتطبيق.
+     * هذا هو العنوان الذي يستهدفه المحرر المرئي.
      */
     applicationURL: process.env.INTLAYER_APPLICATION_URL,
 
     /**
      * مطلوب
      *
-     * معرف العميل والسر الخاص بالعميل مطلوبان لتمكين المحرر.
+     * معرف العميل والسر السري للعميل مطلوبان لتمكين المحرر.
      * يسمحان بتحديد هوية المستخدم الذي يقوم بتحرير المحتوى.
-     * يمكن الحصول عليهما عن طريق إنشاء عميل جديد في لوحة تحكم Intlayer - المشاريع (https://intlayer.org/dashboard/projects).
+     * يمكن الحصول عليهما بإنشاء عميل جديد في لوحة تحكم Intlayer - المشاريع (https://intlayer.org/dashboard/projects).
      * clientId: process.env.INTLAYER_CLIENT_ID,
      * clientSecret: process.env.INTLAYER_CLIENT_SECRET,
      */
@@ -94,9 +92,9 @@ const config: IntlayerConfig = {
     /**
      * اختياري
      *
-     * في حالة استضافة نظام إدارة المحتوى Intlayer ذاتيًا، يمكنك تعيين عنوان URL الخاص بنظام إدارة المحتوى.
+     * في حال كنت تستضيف نظام إدارة المحتوى Intlayer بنفسك، يمكنك تعيين عنوان URL الخاص بنظام إدارة المحتوى.
      *
-     * عنوان URL لنظام إدارة المحتوى Intlayer.
+     * عنوان URL الخاص بنظام إدارة المحتوى Intlayer.
      * بشكل افتراضي، يتم تعيينه إلى https://intlayer.org
      */
     cmsURL: process.env.INTLAYER_CMS_URL,
@@ -104,9 +102,9 @@ const config: IntlayerConfig = {
     /**
      * اختياري
      *
-     * في حالة استضافة نظام إدارة المحتوى Intlayer ذاتيًا، يمكنك تعيين عنوان URL الخاص بالخلفية.
+     * في حال كنت تستضيف نظام إدارة المحتوى Intlayer بنفسك، يمكنك تعيين عنوان URL الخاص بالواجهة الخلفية.
      *
-     * عنوان URL لنظام إدارة المحتوى Intlayer.
+     * عنوان URL الخاص بنظام إدارة المحتوى Intlayer.
      * بشكل افتراضي، يتم تعيينه إلى https://back.intlayer.org
      */
     backendURL: process.env.INTLAYER_BACKEND_URL,
@@ -124,17 +122,19 @@ const config = {
     /**
      * مطلوب
      *
-     * عنوان URL للتطبيق.
-     * هذا هو عنوان URL المستهدف من قبل المحرر البصري.
+     * عنوان URL الخاص بالتطبيق.
+     * هذا هو عنوان URL المستهدف من قبل المحرر المرئي.
      */
     applicationURL: process.env.INTLAYER_APPLICATION_URL,
 
     /**
      * مطلوب
      *
-     * معرف العميل والسر الخاص بالعميل مطلوبان لتمكين المحرر.
+     * معرف العميل والسر السري للعميل مطلوبان لتمكين المحرر.
      * يسمحان بتحديد هوية المستخدم الذي يقوم بتحرير المحتوى.
      * يمكن الحصول عليهما عن طريق إنشاء عميل جديد في لوحة تحكم Intlayer - المشاريع (https://intlayer.org/dashboard/projects).
+     * clientId: process.env.INTLAYER_CLIENT_ID,
+     * clientSecret: process.env.INTLAYER_CLIENT_SECRET,
      */
     clientId: process.env.INTLAYER_CLIENT_ID,
     clientSecret: process.env.INTLAYER_CLIENT_SECRET,
@@ -142,9 +142,9 @@ const config = {
     /**
      * اختياري
      *
-     * في حالة استضافة نظام إدارة المحتوى Intlayer ذاتيًا، يمكنك تعيين عنوان URL الخاص بنظام إدارة المحتوى.
+     * في حال كنت تستضيف نظام إدارة المحتوى Intlayer بنفسك، يمكنك تعيين عنوان URL الخاص بنظام إدارة المحتوى.
      *
-     * عنوان URL لنظام إدارة المحتوى Intlayer.
+     * عنوان URL الخاص بنظام إدارة محتوى Intlayer.
      * بشكل افتراضي، يتم تعيينه إلى https://intlayer.org
      */
     cmsURL: process.env.INTLAYER_CMS_URL,
@@ -152,9 +152,9 @@ const config = {
     /**
      * اختياري
      *
-     * في حالة استضافة نظام إدارة المحتوى Intlayer ذاتيًا، يمكنك تعيين عنوان URL الخاص بالخلفية.
+     * في حال كنت تستضيف نظام إدارة محتوى Intlayer بنفسك، يمكنك تعيين عنوان URL الخاص بالواجهة الخلفية.
      *
-     * عنوان URL لنظام إدارة المحتوى Intlayer.
+     * عنوان URL الخاص بنظام إدارة محتوى Intlayer.
      * بشكل افتراضي، يتم تعيينه إلى https://back.intlayer.org
      */
     backendURL: process.env.INTLAYER_BACKEND_URL,
@@ -172,17 +172,19 @@ const config = {
     /**
      * مطلوب
      *
-     * عنوان URL للتطبيق.
-     * هذا هو عنوان URL المستهدف من قبل المحرر البصري.
+     * عنوان URL الخاص بالتطبيق.
+     * هذا هو العنوان الذي يستهدفه المحرر المرئي.
      */
     applicationURL: process.env.INTLAYER_APPLICATION_URL,
 
     /**
      * مطلوب
      *
-     * معرف العميل والسر الخاص بالعميل مطلوبان لتمكين المحرر.
+     * معرف العميل والسر السري للعميل مطلوبان لتمكين المحرر.
      * يسمحان بتحديد هوية المستخدم الذي يقوم بتحرير المحتوى.
      * يمكن الحصول عليهما عن طريق إنشاء عميل جديد في لوحة تحكم Intlayer - المشاريع (https://intlayer.org/dashboard/projects).
+     * clientId: process.env.INTLAYER_CLIENT_ID,
+     * clientSecret: process.env.INTLAYER_CLIENT_SECRET,
      */
     clientId: process.env.INTLAYER_CLIENT_ID,
     clientSecret: process.env.INTLAYER_CLIENT_SECRET,
@@ -190,9 +192,9 @@ const config = {
     /**
      * اختياري
      *
-     * في حالة استضافة نظام إدارة المحتوى Intlayer ذاتيًا، يمكنك تعيين عنوان URL الخاص بنظام إدارة المحتوى.
+     * في حال كنت تستضيف نظام إدارة محتوى Intlayer بنفسك، يمكنك تعيين عنوان URL الخاص بنظام إدارة المحتوى.
      *
-     * عنوان URL لنظام إدارة المحتوى Intlayer.
+     * عنوان URL الخاص بنظام إدارة محتوى Intlayer.
      * بشكل افتراضي، يتم تعيينه إلى https://intlayer.org
      */
     cmsURL: process.env.INTLAYER_CMS_URL,
@@ -200,9 +202,9 @@ const config = {
     /**
      * اختياري
      *
-     * في حالة استضافة نظام إدارة المحتوى Intlayer ذاتيًا، يمكنك تعيين عنوان URL الخاص بالخلفية.
+     * في حال كنت تستضيف نظام إدارة محتوى Intlayer بنفسك، يمكنك تعيين عنوان URL الخاص بالخادم الخلفي.
      *
-     * عنوان URL لنظام إدارة المحتوى Intlayer.
+     * عنوان URL الخاص بنظام إدارة محتوى Intlayer.
      * بشكل افتراضي، يتم تعيينه إلى https://back.intlayer.org
      */
     backendURL: process.env.INTLAYER_BACKEND_URL,
@@ -212,54 +214,55 @@ const config = {
 module.exports = config;
 ```
 
-> إذا لم يكن لديك معرف العميل والسر الخاص بالعميل، يمكنك الحصول عليهما عن طريق إنشاء عميل جديد في [لوحة تحكم Intlayer - المشاريع](https://intlayer.org/dashboard/projects).
+> إذا لم يكن لديك معرف عميل وسر عميل، يمكنك الحصول عليهما بإنشاء عميل جديد في [لوحة تحكم Intlayer - المشاريع](https://intlayer.org/dashboard/projects).
 
-> لرؤية جميع المعلمات المتاحة، راجع [وثائق التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).
+> لرؤية جميع المعلمات المتاحة، راجع [توثيق التهيئة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).
 
 ## استخدام نظام إدارة المحتوى
 
-### دفع التكوين الخاص بك
+### دفع التهيئة الخاصة بك
 
-لتكوين نظام إدارة المحتوى Intlayer، يمكنك استخدام أوامر [intlayer CLI](https://github.com/aymericzip/intlayer/tree/main/docs/ar/intlayer_cli.md).
+لتكوين نظام إدارة محتوى Intlayer، يمكنك استخدام أوامر [intlayer CLI](https://github.com/aymericzip/intlayer/tree/main/docs/ar/intlayer_cli.md).
 
 ```bash
 npx intlayer config push
 ```
 
-> إذا كنت تستخدم متغيرات البيئة في ملف التكوين `intlayer.config.ts`، يمكنك تحديد البيئة المطلوبة باستخدام الوسيطة `--env`:
+> إذا كنت تستخدم متغيرات البيئة في ملف التهيئة `intlayer.config.ts`، يمكنك تحديد البيئة المطلوبة باستخدام الوسيطة `--env`:
 
 ```bash
 npx intlayer config push --env production
 ```
 
-يقوم هذا الأمر بتحميل التكوين الخاص بك إلى نظام إدارة المحتوى Intlayer.
+يقوم هذا الأمر برفع تهيئتك إلى نظام إدارة محتوى Intlayer.
 
 ### دفع قاموس
 
-لتحويل القواميس المحلية الخاصة بك إلى قاموس بعيد، يمكنك استخدام أوامر [intlayer CLI](https://github.com/aymericzip/intlayer/tree/main/docs/ar/intlayer_cli.md).
+لتحويل قواميس اللغة المحلية الخاصة بك إلى قاموس بعيد، يمكنك استخدام أوامر [intlayer CLI](https://github.com/aymericzip/intlayer/tree/main/docs/ar/intlayer_cli.md).
 
 ```bash
 npx intlayer dictionary push -d my-first-dictionary-key
 ```
 
-> إذا كنت تستخدم متغيرات البيئة في ملف التكوين `intlayer.config.ts`، يمكنك تحديد البيئة المطلوبة باستخدام الوسيطة `--env`:
+> إذا كنت تستخدم متغيرات البيئة في ملف التهيئة `intlayer.config.ts` الخاص بك، يمكنك تحديد البيئة المطلوبة باستخدام الوسيطة `--env`:
 
 ```bash
 npx intlayer dictionary push -d my-first-dictionary-key --env production
 ```
 
-يقوم هذا الأمر بتحميل قواميس المحتوى الأولية الخاصة بك، مما يجعلها متاحة للجلب غير المتزامن والتحرير من خلال منصة Intlayer.
+يقوم هذا الأمر برفع قواميس المحتوى الأولية الخاصة بك، مما يجعلها متاحة للتحميل والتحرير غير المتزامن عبر منصة Intlayer.
 
 ### تحرير القاموس
 
-بعد ذلك، ستتمكن من رؤية وإدارة القاموس الخاص بك في [نظام إدارة المحتوى Intlayer](https://intlayer.org/dashboard/content).
+بعد ذلك، ستتمكن من رؤية وإدارة قاموسك في [نظام إدارة محتوى Intlayer](https://intlayer.org/dashboard/content).
+
+## التزامن الحي
 
-## إعادة التحميل الفوري
+يتيح التزامن الحي لتطبيقك عكس تغييرات محتوى نظام إدارة المحتوى أثناء وقت التشغيل. لا حاجة لإعادة البناء أو إعادة النشر. عند التمكين، يتم بث التحديثات إلى خادم التزامن الحي الذي يقوم بتحديث القواميس التي يقرأها تطبيقك.
 
-يستطيع نظام إدارة المحتوى Intlayer إعادة تحميل القواميس تلقائيًا عند اكتشاف تغيير.
+> يتطلب التزامن الحي اتصالًا مستمرًا بالخادم وهو متاح في خطة المؤسسات.
 
-بدون إعادة التحميل الفوري، سيكون من الضروري إنشاء جديد للتطبيق لعرض المحتوى الجديد.
-من خلال تفعيل إعداد [`liveSync`](https://intlayer.org/doc/concept/configuration#editor-configuration)، سيقوم التطبيق تلقائيًا باستبدال المحتوى المحدث عند اكتشافه.
+قم بتمكين التزامن الحي عن طريق تحديث تكوين Intlayer الخاص بك:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"
 import type { IntlayerConfig } from "intlayer";
@@ -267,18 +270,32 @@ import type { IntlayerConfig } from "intlayer";
 const config: IntlayerConfig = {
   // ... إعدادات التكوين الأخرى
   editor: {
-    // ... إعدادات التكوين الأخرى
-
     /**
-     * يشير إلى ما إذا كان يجب على التطبيق إعادة تحميل تكوينات اللغة تلقائيًا عند اكتشاف تغيير.
-     * على سبيل المثال، عند إضافة أو تحديث قاموس جديد، سيقوم التطبيق بتحديث المحتوى لعرضه في الصفحة.
+     * يُمكّن إعادة تحميل التكوينات المحلية تلقائيًا عند اكتشاف تغييرات.
+     * على سبيل المثال، عند إضافة قاموس أو تحديثه، يقوم التطبيق بتحديث
+     * المحتوى المعروض على الصفحة.
      *
-     * لأن إعادة التحميل الفوري تحتاج إلى اتصال مستمر بالخادم، فهي متاحة فقط لعملاء خطة `enterprise`.
+     * نظرًا لأن إعادة التحميل الساخن تتطلب اتصالًا مستمرًا بالخادم،
+     * فهي متاحة فقط لعملاء خطة `enterprise`.
      *
      * الافتراضي: false
      */
     liveSync: true,
   },
+  build: {
+    /**
+     * يتحكم في كيفية استيراد القواميس:
+     *
+     * - "live": يتم جلب القواميس ديناميكيًا باستخدام واجهة برمجة تطبيقات المزامنة الحية (Live Sync API).
+     *   يستبدل useIntlayer بـ useDictionaryDynamic.
+     *
+     * ملاحظة: يستخدم الوضع الحي (Live) واجهة برمجة تطبيقات المزامنة الحية لجلب القواميس. إذا فشل استدعاء الواجهة،
+     * يتم استيراد القواميس ديناميكيًا.
+     * ملاحظة: فقط القواميس التي تحتوي على محتوى عن بُعد وعلامة "live" تستخدم الوضع الحي.
+     * القواميس الأخرى تستخدم الوضع الديناميكي لأداء أفضل.
+     */
+    importMode: "live",
+  },
 };
 
 export default config;
@@ -289,18 +306,31 @@ export default config;
 const config = {
   // ... إعدادات التكوين الأخرى
   editor: {
-    // ... إعدادات التكوين الأخرى
-
     /**
-     * يشير إلى ما إذا كان يجب على التطبيق إعادة تحميل تكوينات اللغة تلقائيًا عند اكتشاف تغيير.
-     * على سبيل المثال، عند إضافة أو تحديث قاموس جديد، سيقوم التطبيق بتحديث المحتوى لعرضه في الصفحة.
+     * يُمكّن إعادة التحميل السريع لتكوينات اللغة عند اكتشاف تغييرات.
+     * على سبيل المثال، عند إضافة قاموس أو تحديثه، يقوم التطبيق بتحديث
+     * المحتوى المعروض على الصفحة.
      *
-     * لأن إعادة التحميل الفوري تحتاج إلى اتصال مستمر بالخادم، فهي متاحة فقط لعملاء خطة `enterprise`.
+     * نظرًا لأن إعادة التحميل السريع تتطلب اتصالًا مستمرًا بالخادم، فهي
+     * متاحة فقط لعملاء خطة `enterprise`.
      *
      * الافتراضي: false
      */
     liveSync: true,
   },
+  build: {
+    /**
+     * يتحكم في كيفية استيراد القواميس:
+     *
+     * - "live": يتم جلب القواميس ديناميكيًا باستخدام واجهة برمجة تطبيقات المزامنة الحية (Live Sync API).
+     *   يستبدل useIntlayer بـ useDictionaryDynamic.
+     *
+     * ملاحظة: يستخدم الوضع الحي واجهة برمجة تطبيقات المزامنة الحية لجلب القواميس. إذا فشل استدعاء الواجهة
+     * ملاحظة: فقط القواميس التي تحتوي على محتوى عن بُعد وعلامات "live" تستخدم الوضع الحي.
+     * يستخدم الآخرون الوضع الديناميكي من أجل الأداء.
+     */
+    importMode: "live",
+  },
 };
 
 export default config;
@@ -311,45 +341,191 @@ export default config;
 const config = {
   // ... إعدادات التكوين الأخرى
   editor: {
-    // ... إعدادات التكوين الأخرى
-
     /**
-     * يشير إلى ما إذا كان يجب على التطبيق إعادة تحميل تكوينات اللغة تلقائيًا عند اكتشاف تغيير.
-     * على سبيل المثال، عند إضافة أو تحديث قاموس جديد، سيقوم التطبيق بتحديث المحتوى لعرضه في الصفحة.
+     * يُمكّن إعادة التحميل السريع لتكوينات اللغة عند اكتشاف تغييرات.
+     * على سبيل المثال، عند إضافة قاموس أو تحديثه، يقوم التطبيق بتحديث
+     * المحتوى المعروض على الصفحة.
      *
-     * لأن إعادة التحميل الفوري تحتاج إلى اتصال مستمر بالخادم، فهي متاحة فقط لعملاء خطة `enterprise`.
+     * نظرًا لأن إعادة التحميل السريع تتطلب اتصالًا مستمرًا بالخادم، فهي
+     * متاحة فقط لعملاء خطة `enterprise`.
      *
      * الافتراضي: false
      */
     liveSync: true,
+
+    /**
+     * منفذ خادم المزامنة الحية.
+     *
+     * الافتراضي: 4000
+     */
+    liveSyncPort: 4000,
+
+    /**
+     * عنوان URL الخاص بخادم المزامنة الحية.
+     *
+     * الافتراضي: http://localhost:{liveSyncPort}
+     */
+    liveSyncURL: "https://live.example.com",
+  },
+  build: {
+    /**
+     * يتحكم في كيفية استيراد القواميس:
+     *
+     * - "live": يتم جلب القواميس ديناميكيًا باستخدام واجهة برمجة تطبيقات المزامنة الحية.
+     *   يستبدل useIntlayer بـ useDictionaryDynamic.
+     *
+     * ملاحظة: يستخدم الوضع الحي واجهة برمجة تطبيقات المزامنة الحية لجلب القواميس. إذا فشل استدعاء API،
+     * يتم استيراد القواميس ديناميكيًا.
+     * ملاحظة: فقط القواميس التي تحتوي على محتوى عن بُعد وعلامات "live" تستخدم الوضع الحي.
+     * القواميس الأخرى تستخدم الوضع الديناميكي لأداء أفضل.
+     */
+    importMode: "live",
+  },
+};
+
+module.exports = config;
+```
+
+ابدأ خادم المزامنة الحية لتغليف تطبيقك:
+
+مثال باستخدام Next.js:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... سكريبتات أخرى
+    "build": "next build",
+    "dev": "next dev",
+    "start": "npx intlayer live --process 'next start'",
+  },
+}
+```
+
+مثال باستخدام Vite:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... سكريبتات أخرى
+    "build": "vite build",
+    "dev": "vite dev",
+    "start": "npx intlayer live --process 'vite start'",
+  },
+}
+```
+
+يقوم خادم المزامنة الحية بتغليف تطبيقك ويطبق المحتوى المحدث تلقائيًا عند وصوله.
+
+لتلقي إشعارات التغيير من نظام إدارة المحتوى (CMS)، يحافظ خادم المزامنة الحية على اتصال SSE مع الخادم الخلفي. عندما يتغير المحتوى في نظام إدارة المحتوى، يقوم الخادم الخلفي بإرسال التحديث إلى خادم المزامنة الحية، الذي يقوم بكتابة القواميس الجديدة. سيعكس تطبيقك التحديث في التنقل التالي أو عند إعادة تحميل المتصفح — دون الحاجة لإعادة بناء التطبيق.
+
+مخطط التدفق (نظام إدارة المحتوى/الخادم الخلفي -> خادم المزامنة الحية -> خادم التطبيق -> الواجهة الأمامية):
+
+![مخطط منطق المزامنة الحية](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
+
+كيف يعمل:
+
+![مخطط تدفق المزامنة الحية نظام إدارة المحتوى/الخادم الخلفي/خادم المزامنة الحية/خادم التطبيق/الواجهة الأمامية](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+
+### سير عمل التطوير (محلي)
+
+- في بيئة التطوير، يتم جلب جميع القواميس البعيدة عند بدء تشغيل التطبيق، بحيث يمكنك اختبار التحديثات بسرعة.
+- لاختبار المزامنة الحية محليًا مع Next.js، قم بتغليف خادم التطوير الخاص بك:
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... سكريبتات أخرى
+    "dev": "npx intlayer live --process 'next dev'",
+    // "dev": "npx intlayer live --process 'vite dev'", // لـ Vite
+  },
+}
+```
+
+قم بتمكين التحسين حتى يطبق Intlayer تحولات الاستيراد الحي أثناء التطوير:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    applicationURL: "http://localhost:5173",
+    liveSyncURL: "http://localhost:4000",
+    liveSync: true,
+  },
+  build: {
+    optimize: true,
+    importMode: "live",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+// تكوين Intlayer مع إعدادات المزامنة الحية
+const config = {
+  editor: {
+    applicationURL: "http://localhost:5173",
+    liveSyncURL: "http://localhost:4000",
+    liveSync: true,
+  },
+  build: {
+    optimize: true,
+    importMode: "live",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+// تكوين Intlayer مع إعدادات المزامنة الحية
+const config = {
+  editor: {
+    applicationURL: "http://localhost:5173",
+    liveSyncURL: "http://localhost:4000",
+    liveSync: true,
+  },
+  build: {
+    optimize: true,
+    importMode: "live",
   },
 };
 
 module.exports = config;
 ```
 
-إعادة التحميل الفوري تستبدل المحتوى على كلا الجانبين الخادم والعميل.
+يقوم هذا الإعداد بتغليف خادم التطوير الخاص بك مع خادم المزامنة الحية، ويجلب القواميس البعيدة عند بدء التشغيل، ويقوم ببث التحديثات من نظام إدارة المحتوى عبر SSE. قم بتحديث الصفحة لرؤية التغييرات.
 
-- على جانب الخادم، يجب التأكد من أن عملية التطبيق لديها حق الوصول للكتابة إلى دليل `.intlayer/dictionaries`.
-- على جانب العميل، تتيح إعادة التحميل الفوري للتطبيق إعادة تحميل المحتوى في المتصفح دون الحاجة إلى إعادة تحميل الصفحة. ومع ذلك، هذه الميزة متاحة فقط لمكونات العملاء.
+ملاحظات وقيود:
 
-> لأن إعادة التحميل الفوري تحتاج إلى اتصال مستمر بالخادم باستخدام `EventListener`، فهي متاحة فقط لعملاء خطة `enterprise`.
+- أضف مصدر المزامنة الحية إلى سياسة أمان موقعك (CSP). تأكد من السماح بعنوان URL الخاص بالمزامنة الحية في `connect-src` (و `frame-ancestors` إذا كان ذلك مناسبًا).
+- لا تعمل المزامنة الحية مع المخرجات الثابتة. بالنسبة لـ Next.js، يجب أن تكون الصفحة ديناميكية لتلقي التحديثات أثناء وقت التشغيل (على سبيل المثال، استخدم `generateStaticParams`، `generateMetadata`، `getServerSideProps`، أو `getStaticProps` بشكل مناسب لتجنب القيود الخاصة بالمحتوى الثابت فقط).
+- في نظام إدارة المحتوى (CMS)، يحتوي كل قاموس على علامة `live`. يتم جلب القواميس التي تحمل العلامة `live=true` فقط عبر واجهة برمجة تطبيقات المزامنة الحية؛ أما القواميس الأخرى فتُستورد ديناميكيًا وتظل دون تغيير أثناء وقت التشغيل.
+- يتم تقييم علامة `live` لكل قاموس أثناء وقت البناء. إذا لم يتم وسم المحتوى البعيد بعلامة `live=true` أثناء البناء، يجب عليك إعادة البناء لتمكين المزامنة الحية لذلك القاموس.
+- يجب أن يكون خادم المزامنة الحية قادرًا على الكتابة إلى `.intlayer`. في الحاويات، تأكد من وجود صلاحية الكتابة إلى `/.intlayer`.
 
-## التصحيح
+## تصحيح الأخطاء
 
-إذا واجهت أي مشاكل مع نظام إدارة المحتوى، تحقق من التالي:
+إذا واجهت أي مشاكل مع نظام إدارة المحتوى (CMS)، تحقق من الأمور التالية:
 
 - التطبيق يعمل.
 
-- تم تعيين إعدادات [`editor`](https://intlayer.org/doc/concept/configuration#editor-configuration) بشكل صحيح في ملف تكوين Intlayer الخاص بك.
+- تم إعداد تكوين [`المحرر`](https://intlayer.org/doc/concept/configuration#editor-configuration) بشكل صحيح في ملف تكوين Intlayer الخاص بك.
   - الحقول المطلوبة:
-    - يجب أن يتطابق عنوان URL للتطبيق مع الذي قمت بتعيينه في إعدادات المحرر (`applicationURL`).
-    - عنوان URL لنظام إدارة المحتوى.
+    - يجب أن يتطابق عنوان URL الخاص بالتطبيق مع العنوان الذي قمت بتعيينه في تكوين المحرر (`applicationURL`).
+    - عنوان URL الخاص بنظام إدارة المحتوى (CMS)
 
-- تأكد من أن تكوين المشروع تم دفعه إلى نظام إدارة المحتوى Intlayer.
+- تأكد من أن تكوين المشروع تم دفعه إلى نظام إدارة محتوى Intlayer.
 
-- يستخدم المحرر البصري إطار iframe لعرض موقعك. تأكد من أن سياسة أمان المحتوى (CSP) لموقعك تسمح بعنوان URL لنظام إدارة المحتوى كـ `frame-ancestors` ('https://intlayer.org' افتراضيًا). تحقق من وحدة تحكم المحرر لأي أخطاء.
+- يستخدم المحرر المرئي إطار iframe لعرض موقعك الإلكتروني. تأكد من أن سياسة أمان المحتوى (CSP) لموقعك تسمح بعنوان URL الخاص بنظام إدارة المحتوى كـ `frame-ancestors` ('https://intlayer.org' بشكل افتراضي). تحقق من وحدة تحكم المحرر لأي أخطاء.
 
-## سجل الوثائق
+## تاريخ الوثيقة
 
-- 5.5.10 - 2025-06-29: بداية السجل
+| الإصدار | التاريخ    | التغييرات                             |
+| ------- | ---------- | ------------------------------------- |
+| 6.0.1   | 2025-09-22 | إضافة توثيق المزامنة الحية            |
+| 6.0.0   | 2025-09-04 | استبدال حقل `hotReload` بـ `liveSync` |
+| 5.5.10  | 2025-06-29 | بدء السجل                             |