@intlayer/docs 9.4.0 → 9.4.2

package/docs/ar/configuration.md

@@ -1112,3 +1112,101 @@ dictionary: {
 | الحقل     | الوصف                           | النوع              |
 | --------- | ------------------------------- | ------------------ |
 | `plugins` | قائمة إضافات Intlayer لإدراجها. | `IntlayerPlugin[]` |
+
+## الأسئلة الشائعة
+
+<FAQ>
+
+<Question title="أين يجب وضع ملف intlayer.config.ts؟">
+
+في جذر مشروعك، بجانب `package.json`. يفحص Intlayer دليل العمل والأدلة الأصلية بحثًا عن `intlayer.config.ts` أو `intlayer.config.js` أو `intlayer.config.mjs` أو `intlayer.config.cjs`. يمكنك أيضًا تحديد مسار مخصص عبر خيار `--config` في أوامر CLI.
+
+</Question>
+
+<Question title="كم يضيف i18n إلى حجم حزمة (bundle) تطبيقي؟">
+
+أقل بكثير من الإعدادات القائمة على فضاءات الأسماء، لأن الصفحة لا تُحمّل أبدًا كتالوجًا لا تعرضه. يُحل المحتوى المعروض على الخادم مباشرة على الخادم، ويستبدل مترجم وقت البناء استدعاءات `useIntlayer` بإدخالات القاموس الدقيقة التي يستخدمها المكون، لذلك يتم التخلص من المفاتيح واللغات غير المستخدمة. تقسم [القواميس الديناميكية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/index.md) الباقي حسب اللغة. مقارنة بالبدائل التقليدية، يقلل Intlayer حجم الحزمة والصفحة بنسبة تصل إلى 50%. انظر [تحسين الحزم](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/bundle_optimization.md) و [المقارنة المعيارية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/benchmark/index.md).
+
+</Question>
+
+<Question title="هل يمكنني الترحيل من i18next أو next-intl أو react-i18next دون إعادة كتابة مكوناتي؟">
+
+نعم، وبطريقتين. يمكنك ترحيل المحتوى تدريجيًا باستخدام [دليل ترحيل i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/migration_from_i18next_to_intlayer.md) أو [دليل ترحيل next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/migration_from_next-intl_to_intlayer.md). أو يمكنك الاحتفاظ بواجهة برمجة التطبيقات الحالية بالكامل: تكشف [محولات التوافق](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/compat/index.md) نفس واجهات `i18next` و `react-i18next` و `next-intl` و `next-i18next` و `react-intl` و `use-intl` و `vue-i18n` و `Lingui`، ولكنها مدعومة بقواميس Intlayer، بحيث تتغير الاستيرادات فقط بينما يظل كود المكون كما هو.
+
+</Question>
+
+<Question title="هل يمكنني الاحتفاظ بملفات الترجمة JSON الموجودة لدي؟">
+
+نعم. تحافظ [مكونة مزامنة JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/plugins/sync-json.md) على ملفات `/messages/{locale}/{namespace}.json` الخاصة بك كمصدر الحقيقة وتُنشئ قواميس Intlayer منها، في كلا الاتجاهين. وتقوم [مكونة مزامنة PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/plugins/sync-po.md) بنفس الشيء لكتالوجات gettext، وتسمح لك [الملفات المقسمة حسب اللغة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/per_locale_file.md) بتقسيم المحتوى حسب اللغة بدلاً من تجميع كل اللغات في ملف واحد.
+
+</Question>
+
+<Question title="هل يجب أن أنقل المحتوى الخاص بي مفتاحًا تلو الآخر؟">
+
+لا. قم بتشغيل `npx intlayer extract` وسيقرأ Intlayer ملفات المصدر الخاصة بك، ويسحب السلاسل النصية الموجهة للمستخدم ويكتب ملف `.content` بجانب كل منها، بحيث تراجع diff بدلاً من نسخ السلاسل إلى كتالوج يدويًا. راجع [أمر extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/extract.md).
+
+لأتمتة كاملة، يقوم [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/compiler.md) بالشيء نفسه في وقت البناء على كود JSX و TSX و Vue و Svelte، منشئًا القواميس عند كل تغيير دون الحاجة إلى إدارة المفاتيح يدويًا.
+
+</Question>
+
+<Question title="ما هي أدوات المحررات والوكلاء الذكيين المتاحة؟">
+
+خمس أدوات، كلها اختيارية:
+
+- **[امتداد VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/vs_code_extension.md)**: الانتقال من مفتاح `useIntlayer` إلى ملف المحتوى المصرح به، استخراج المحتوى من المكون، وتشغيل build و fill و test و push و pull من لوحة الأوامر أو علامة تبويب Intlayer.
+- **[خادم LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/lsp.md)**: نفس التجربة في أي محرر يدعم LSP، مع الانتقال إلى التعريف وعروض القيمة المترجمة عند التمرير والإكمال التلقائي للمفاتيح. يدعم أيضًا استدعاءات `i18next` و `react-i18next` و `next-intl` و `use-intl`.
+- **[خادم MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/mcp_server.md)**: يكشف وثائق Intlayer و CLI إلى Cursor و VS Code و Claude Desktop و Claude Code و ChatGPT.
+- **[Agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**: مهارات مخصصة مثل `intlayer-config` و `intlayer-cli` و `intlayer-content`.
+- **[ESLint plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/eslint.md)**: قاعدة `no-raw-text` ترصد النصوص المكتوبة مباشرة بدون تدويل.
+
+</Question>
+
+<Question title="كيف أضيف لغة جديدة إلى تطبيقي؟">
+
+أضف رمز اللغة إلى مصفوفة `internationalization.locales`، ثم قم بتشغيل `npx intlayer fill` لترجمة المحتوى الحالي تلقائيًا. سيشمل المترجم اللغة الجديدة في البناء التالي.
+
+</Question>
+
+<Question title="كيف أزيل بادئة اللغة من عنوان URL؟">
+
+اضبط `routing.mode`. تزيل القيمة `"no-prefix"` البادئة لجميع اللغات، وتحدد اللغة عبر ملفات تعريف الارتباط أو الترويسات أو النطاق. تخفي القيمة `"prefix-no-default"` (الافتراضية) البادئة للغة الأساسية فقط.
+
+</Question>
+
+<Question title="هل يمكنني خدمة كل لغة من نطاق مخصص؟">
+
+نعم. يربط خيار `routing.domains` كل لغة باسم مضيف، على سبيل المثال `{ ar: 'example.sa', en: 'example.com' }`. يأخذ الاكتشاف المستند إلى النطاق الأولوية على بادئات المسار، وينشئ `getMultilingualUrls` عناوين URL كاملة لـ `hreflang`.
+
+</Question>
+
+<Question title="كيف يتم اكتشاف لغة المستخدم؟">
+
+عبر `routing.storage`، الذي يسرد المصادر بترتيب الأولوية: عادةً عنوان URL أولاً، ثم ملف تعريف الارتباط، ثم ترويسة `Accept-Language`، والعودة إلى اللغة الافتراضية إذا لم يتم العثور عليها.
+
+</Question>
+
+<Question title="ماذا تفعل routing.enableProxy؟">
+
+تتحكم في وكيل توجيه اللغة، وهو الميدلوير الذي يتعامل مع البادئات وإعادة التوجيه. افتراضيًا، يعمل الوكيل في وضعي التطوير والإنتاج. اضبطه على `false` إذا كنت تدير المسارات يدويًا.
+
+</Question>
+
+<Question title="ما الفرق بين importMode static و dynamic و fetch؟">
+
+`"static"` (الافتراضي) يستورد القواميس بشكل ثابت بحيث يتم حزمها وقراءتها بشكل متزامن. `"dynamic"` يحمل القواميس بشكل غير متزامن لكل لغة لتقليل حجم الحزمة الأولية. `"fetch"` يجلب القواميس من خادم أو CMS في وقت التشغيل.
+
+</Question>
+
+<Question title="أين أقوم بإعداد مزود الذكاء الاصطناعي ومفتاح API للترجمة التلقائية؟">
+
+في ملف التكوين تحت قسم `ai` أو عبر سطر الأوامر باستخدام الخيارات `--provider` و `--model` و `--api-key`. يظل مفتاح API في بيئتك المحلية ولا يتم إرساله خارجيًا أبدًا. انظر [مرجع تكوين الذكاء الاصطناعي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).
+
+</Question>
+
+<Question title="هل أحتاج إلى إعادة تشغيل خادم التطوير بعد تغيير التكوين؟">
+
+عادة لا. يراقب مراقب Intlayer ملف `intlayer.config.ts`: عند الحفظ، يعيد تحميل التكوين ويحدث القواميس في الخلفية.
+
+</Question>
+
+</FAQ>

package/docs/ar/dictionary/content_file.md

@@ -367,15 +367,15 @@ export default {
 
 **مثال:**
 
-```json
+```jsonc
 // قاموس حسب اللغة
 {
   "key": "about-page",
   "locale": "en",
   "content": {
     "title": "About Us", // تصبح هذه عقدة ترجمة للغة 'en'
-    "description": "Learn more about our company"
-  }
+    "description": "Learn more about our company",
+  },
 }
 ```
 
@@ -444,7 +444,7 @@ export default aboutPageMetaContent;
 
 **أمثلة:**
 
-```json
+```jsonc
 // تمكين لجميع اللغات
 {
   "autoFill": true

package/docs/ar/dictionary/html.md

@@ -262,6 +262,25 @@ const myContent = html(
     );
     ```
 
+    يمكنك أيضًا استخدام محرك تصيير HTML الخاص بك:
+
+    ```tsx fileName="AppProvider.tsx"
+    import { HTMLProvider } from "react-intlayer/html";
+
+    export const AppProvider = ({ children }) => (
+      <HTMLProvider
+        renderHTML={async (html) => {
+          const { renderHTML } = await import('react-intlayer/html');
+          return renderHTML(html);
+        }}
+      >
+        {children}
+      </HTMLProvider>
+    );
+    ```
+
+    > استيراد محرك HTML الخاص بك ديناميكيًا هو طريقة جيدة لتقليل حجم حزمة تطبيقك.
+
   </Tab>
   <Tab label="Vue" value="vue">
 
@@ -284,6 +303,29 @@ const myContent = html(
     app.mount("#app");
     ```
 
+    يمكنك أيضًا استخدام محرك تصيير HTML الخاص بك:
+
+    ```typescript fileName="main.ts"
+    import { createApp, h } from "vue";
+    import { intlayer } from "vue-intlayer";
+    import { intlayerHTML } from "vue-intlayer/html";
+    import App from "./App.vue";
+
+    const app = createApp(App);
+
+    app.use(intlayer);
+    app.use(intlayerHTML, {
+      renderHTML: async (html) => {
+        const { renderHTML } = await import('vue-intlayer/html');
+        return renderHTML(html);
+      },
+    });
+
+    app.mount("#app");
+    ```
+
+    > استيراد محرك HTML الخاص بك ديناميكيًا هو طريقة جيدة لتقليل حجم حزمة تطبيقك.
+
   </Tab>
   <Tab label="Svelte" value="svelte">
 
@@ -302,6 +344,25 @@ const myContent = html(
     </HTMLProvider>
     ```
 
+    يمكنك أيضًا استخدام محرك تصيير HTML الخاص بك:
+
+    ```svelte fileName="App.svelte"
+    <script lang="ts">
+      import { HTMLProvider } from "svelte-intlayer/html";
+    </script>
+
+    <HTMLProvider
+      renderHTML={async (html) => {
+        const { renderHTML } = await import('svelte-intlayer/html');
+        return renderHTML(html);
+      }}
+    >
+      <slot />
+    </HTMLProvider>
+    ```
+
+    > استيراد محرك HTML الخاص بك ديناميكيًا هو طريقة جيدة لتقليل حجم حزمة تطبيقك.
+
   </Tab>
   <Tab label="Preact" value="preact">
 
@@ -319,6 +380,25 @@ const myContent = html(
     );
     ```
 
+    يمكنك أيضًا استخدام محرك تصيير HTML الخاص بك:
+
+    ```tsx fileName="AppProvider.tsx"
+    import { HTMLProvider } from "preact-intlayer/html";
+
+    export const AppProvider = ({ children }) => (
+      <HTMLProvider
+        renderHTML={async (html) => {
+          const { renderHTML } = await import('preact-intlayer/html');
+          return renderHTML(html);
+        }}
+      >
+        {children}
+      </HTMLProvider>
+    );
+    ```
+
+    > استيراد محرك HTML الخاص بك ديناميكيًا هو طريقة جيدة لتقليل حجم حزمة تطبيقك.
+
   </Tab>
   <Tab label="Solid" value="solid">
 
@@ -336,6 +416,25 @@ const myContent = html(
     );
     ```
 
+    يمكنك أيضًا استخدام محرك تصيير HTML الخاص بك:
+
+    ```tsx fileName="AppProvider.tsx"
+    import { HTMLProvider } from "solid-intlayer/html";
+
+    export const AppProvider = (props) => (
+      <HTMLProvider
+        renderHTML={async (html) => {
+          const { renderHTML } = await import('solid-intlayer/html');
+          return renderHTML(html);
+        }}
+      >
+        {props.children}
+      </HTMLProvider>
+    );
+    ```
+
+    > استيراد محرك HTML الخاص بك ديناميكيًا هو طريقة جيدة لتقليل حجم حزمة تطبيقك.
+
   </Tab>
   <Tab label="Angular" value="angular">
 
@@ -354,7 +453,24 @@ const myContent = html(
     };
     ```
 
-> استيراد محرك HTML الخاص بك بشكل ديناميكي هو طريقة جيدة لتقليل حجم حزمة تطبيقك.
+    يمكنك أيضًا استخدام محرك تصيير HTML الخاص بك:
+
+    ```typescript fileName="app.config.ts"
+    import { createIntlayerHTMLProvider } from "angular-intlayer/html";
+
+    export const appConfig: ApplicationConfig = {
+      providers: [
+        createIntlayerHTMLProvider({
+          renderHTML: async (html) => {
+            const { renderHTML } = await import('angular-intlayer/html');
+            return renderHTML(html);
+          },
+        }),
+      ],
+    };
+    ```
+
+    > استيراد محرك HTML الخاص بك ديناميكيًا هو طريقة جيدة لتقليل حجم حزمة تطبيقك.
 
   </Tab>
 </Tabs>

package/docs/ar/dictionary/markdown.md

@@ -51,6 +51,7 @@ author: aymericzip
 
 <Tabs>
   <Tab label=".content.md" value=".content.md">
+
     بدءًا من الإصدار `8.10.0` ، يمكنك الإعلان عن محتوى Markdown مباشرةً في ملفات `.content.md`. سيكتشف Intlayer محتوى Markdown ويحلله تلقائيًا.
 
     ```md fileName="markdown-file.en.content.md"
@@ -96,6 +97,7 @@ author: aymericzip
     ```
 
   </Tab>
+
   <Tab label="الملفات الخارجية" value="external-files">
     قم باستيراد ملفات `.md` مباشرة باستخدام وظيفة `file`.
 
@@ -129,6 +131,7 @@ author: aymericzip
     ```
 
   </Tab>
+
 </Tabs>
 
 ## عرض Markdown
@@ -957,7 +960,21 @@ author: aymericzip
   </Tab>
   <Tab label="Angular" value="angular">
 
-> MDX مدعوم — أي اسم مكون يُستخدم داخل Markdown (مثل `<MyCustomJSXComponent />`) يتم حله مقابل خريطة `components`.
+    ```typescript fileName="app.config.ts"
+    import { createIntlayerMarkdownProvider } from "angular-intlayer/markdown";
+
+    export const appConfig: ApplicationConfig = {
+      providers: [
+        createIntlayerMarkdownProvider({
+          components: {
+            h1: { class: "text-2xl font-bold" },
+          },
+        }),
+      ],
+    };
+    ```
+
+    > MDX مدعوم — أي اسم مكون يُستخدم داخل Markdown (مثل `<MyCustomJSXComponent />`) يتم حله مقابل خريطة `components`.
 
 يمكنك أيضًا استخدام markdown renderer الخاص بك:
 

package/docs/ar/dictionary/plurial.md

@@ -35,9 +35,12 @@ author: aymericzip
 
 ## متى تستخدم `plural` مقابل `enu`
 
-To use plural content inside a React component, retrieve it via the `useIntlayer` hook and call it with a count. The active locale and the count are combined to pick the matching CLDR category.
+| حالة الاستخدام                                                        | الأداة المساعدة |
+| --------------------------------------------------------------------- | --------------- |
+| صيغ الجمع النحوية الخاصة باللغة (تفاحة واحدة / تفاحتان / 5 تفاحات)    | `plural`        |
+| النطاقات العددية المخصصة (`<5`، `>=10`) أو الفئات غير التابعة لـ CLDR | `enu`           |
 
-To use plural content in Next.js Client Components, retrieve it via the `useIntlayer` hook and call it with a count. Here's an example:
+إذا كنت تستهدف اللغة الإنجليزية فقط (التي تحتوي على `one` / `other` فقط)، فكلاهما يعمل. لأي لغة بها تمييز `few` / `many` / `two`، يُفضل استخدام `plural`.
 
 ## إعداد محتوى الجمع
 

package/docs/ar/how_works_intlayer.md

@@ -259,3 +259,95 @@ const MyComponent = () => {
 ## تحدث مع وثائقنا الذكية
 
 - [اطرح أسئلتك على وثائقنا الذكية](https://intlayer.org/doc/chat)
+
+## الأسئلة الشائعة
+
+<FAQ>
+
+<Question title="متى يتم بناء القواميس: في وقت البناء أم في وقت التشغيل؟">
+
+في وقت البناء. يفحص مكون Intlayer الإضافي ملفات `.content.ts`، ويترجمها إلى قواميس محسنة، ويكتبها في مجلد `.intlayer`. في بيئة التطوير، تحدث هذه العملية تلقائيًا في كل مرة تحفظ فيها ملفًا.
+
+</Question>
+
+<Question title="كم يضيف i18n إلى حجم حزمة (bundle) تطبيقي؟">
+
+أقل بكثير من الإعدادات القائمة على فضاءات الأسماء، لأن الصفحة لا تُحمّل أبدًا كتالوجًا لا تعرضه. يُحل المحتوى المعروض على الخادم مباشرة على الخادم، ويستبدل مترجم وقت البناء استدعاءات `useIntlayer` بإدخالات القاموس الدقيقة التي يستخدمها المكون، لذلك يتم التخلص من المفاتيح واللغات غير المستخدمة. تقسم [القواميس الديناميكية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/index.md) الباقي حسب اللغة. مقارنة بالبدائل التقليدية، يقلل Intlayer حجم الحزمة والصفحة بنسبة تصل إلى 50%. انظر [تحسين الحزم](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/bundle_optimization.md) و [المقارنة المعيارية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/benchmark/index.md).
+
+</Question>
+
+<Question title="هل يمكنني الترحيل من i18next أو next-intl أو react-i18next دون إعادة كتابة مكوناتي؟">
+
+نعم، وبطريقتين. يمكنك ترحيل المحتوى تدريجيًا باستخدام [دليل ترحيل i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/migration_from_i18next_to_intlayer.md) أو [دليل ترحيل next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/migration_from_next-intl_to_intlayer.md). أو يمكنك الاحتفاظ بواجهة برمجة التطبيقات الحالية بالكامل: تكشف [محولات التوافق](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/compat/index.md) نفس واجهات `i18next` و `react-i18next` و `next-intl` و `next-i18next` و `react-intl` و `use-intl` و `vue-i18n` و `Lingui`، ولكنها مدعومة بقواميس Intlayer، بحيث تتغير الاستيرادات فقط بينما يظل كود المكون كما هو.
+
+</Question>
+
+<Question title="هل يمكنني الاحتفاظ بملفات الترجمة JSON الموجودة لدي؟">
+
+نعم. تحافظ [مكونة مزامنة JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/plugins/sync-json.md) على ملفات `/messages/{locale}/{namespace}.json` الخاصة بك كمصدر الحقيقة وتُنشئ قواميس Intlayer منها، في كلا الاتجاهين. وتقوم [مكونة مزامنة PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/plugins/sync-po.md) بنفس الشيء لكتالوجات gettext، وتسمح لك [الملفات المقسمة حسب اللغة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/per_locale_file.md) بتقسيم المحتوى حسب اللغة بدلاً من تجميع كل اللغات في ملف واحد.
+
+</Question>
+
+<Question title="هل يجب أن أنقل المحتوى الخاص بي مفتاحًا تلو الآخر؟">
+
+لا. قم بتشغيل `npx intlayer extract` وسيقرأ Intlayer ملفات المصدر الخاصة بك، ويسحب السلاسل النصية الموجهة للمستخدم ويكتب ملف `.content` بجانب كل منها، بحيث تراجع diff بدلاً من نسخ السلاسل إلى كتالوج يدويًا. راجع [أمر extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/extract.md).
+
+لأتمتة كاملة، يقوم [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/compiler.md) بالشيء نفسه في وقت البناء على كود JSX و TSX و Vue و Svelte، منشئًا القواميس عند كل تغيير دون الحاجة إلى إدارة المفاتيح يدويًا.
+
+</Question>
+
+<Question title="ما هي أدوات المحررات والوكلاء الذكيين المتاحة؟">
+
+خمس أدوات، كلها اختيارية:
+
+- **[امتداد VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/vs_code_extension.md)**: الانتقال من مفتاح `useIntlayer` إلى ملف المحتوى المصرح به، استخراج المحتوى من المكون، وتشغيل build و fill و test و push و pull من لوحة الأوامر أو علامة تبويب Intlayer.
+- **[خادم LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/lsp.md)**: نفس التجربة في أي محرر يدعم LSP، مع الانتقال إلى التعريف وعروض القيمة المترجمة عند التمرير والإكمال التلقائي للمفاتيح. يدعم أيضًا استدعاءات `i18next` و `react-i18next` و `next-intl` و `use-intl`.
+- **[خادم MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/mcp_server.md)**: يكشف وثائق Intlayer و CLI إلى Cursor و VS Code و Claude Desktop و Claude Code و ChatGPT.
+- **[Agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**: مهارات مخصصة مثل `intlayer-config` و `intlayer-cli` و `intlayer-content`.
+- **[ESLint plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/eslint.md)**: قاعدة `no-raw-text` ترصد النصوص المكتوبة مباشرة بدون تدويل.
+
+</Question>
+
+<Question title="ما هو مجلد .intlayer وهل يجب علي تضمينه في git؟">
+
+هذا المجلد هو المخرج المنشأ: القواميس المترجمة وأنواع TypeScript المنشأة. يتم إنشاؤه بالكامل من ملفات المحتوى الخاصة بك، لذلك يجب إضافته إلى `.gitignore` وإعادة بنائه في CI/CD عبر أمر `intlayer build`.
+
+</Question>
+
+<Question title="كيف يتم تحديد اللغة النشطة؟">
+
+من المصادر المدرجة في `routing.storage`، بالترتيب: بادئة URL، وملفات تعريف الارتباط، وترويسة `Accept-Language`، واللغة الافتراضية.
+
+</Question>
+
+<Question title="ما الفرق بين القواميس المحلية والقواميس البعيدة (remote)؟">
+
+يتم الإعلان عن القاموس المحلي في قاعدة التعليمات البرمجية الخاصة بك ويتم تجميعه مع التطبيق. تتم إدارة القاموس البعيد في نظام إدارة المحتوى (CMS) ويتم جلبه عبر واجهة برمجة التطبيقات (API)، مما يسمح بتحديث النصوص دون إعادة بناء كود التطبيق.
+
+</Question>
+
+<Question title="هل يعمل Intlayer بدون TypeScript؟">
+
+نعم. يمكن كتابة ملفات المحتوى بلغة TypeScript أو JavaScript أو ESM أو CommonJS أو JSON. ومع ذلك، يوفر TypeScript مزايا الفحص التلقائي للأنواع والإكمال التلقائي للمفاتيح في المحرر الخاص بك.
+
+</Question>
+
+<Question title="كيف يشترك العرض على الخادم والعرض على العميل في نفس المحتوى؟">
+
+يحل الخادم محتوى المكونات المعروضة على الخادم مباشرة، لذلك لا يتم إرسال أي قواميس إلى العميل لتلك المكونات. تتلقى مكونات العميل القواميس المطلوبة للتفاعل في المتصفح فقط.
+
+</Question>
+
+<Question title="كيف يتجنب Intlayer أخطاء عدم تطابق الترطيب (hydration mismatch) المتعلقة باللغة؟">
+
+يتم تحديد اللغة مرة واحدة على الخادم وتمريرها إلى موفر العميل بدلاً من إعادة اكتشافها في المتصفح، مما يضمن تطابق مخرجات HTML للخادم والعميل تمامًا.
+
+</Question>
+
+<Question title="هل أحتاج إلى إعادة البناء عند إضافة ترجمات؟">
+
+في بيئة التطوير لا: يراقب المكون الإضافي الملفات ويحدث القواميس على الفور. في الإنتاج نعم: يتم تجميع القواميس المحلية في حزمة التطبيق أثناء خطوة البناء.
+
+</Question>
+
+</FAQ>

package/docs/ar/interest_of_intlayer.md

@@ -38,13 +38,12 @@ author: aymericzip
 
 بالمقارنة مع الحلول الرئيسية مثل `next-intl` أو `i18next`، يعد Intlayer حلاً يأتي مزودًا بتحسينات متكاملة مثل:
 
-**حجم البندل**
-
+<AccordionGroup>
 <Accordion header="حجم الحزمة">
 
 بدلاً من تحميل ملفات JSON ضخمة إلى صفحاتك، قم بتحميل المحتوى الضروري فقط. يساعد Intlayer **في تقليل أحجام البندل وصفحاتك بنسبة تصل إلى 50%**.
 
-** الصيانة **
+</Accordion>
 
 <Accordion header="قابلية الصيانة">
 
@@ -52,17 +51,17 @@ author: aymericzip
 
 </Accordion>
 
-** وكيل الذكاء الاصطناعي **
+<Accordion header="وكيل الذكاء الاصطناعي">
 
 يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (LLMs). يأتي Intlayer أيضًا مزودًا بمجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة،**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** و**[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
 
 </Accordion>
 
-**ميزة**
+<Accordion header="ميزة">
 
 يقدم Intlayer مجموعة من الميزات الإضافية التي لا تتوفر في حلول i18n الأخرى، مثل [دعم Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/markdown.md)، [جلب خارجي المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/function_fetching.md)، [تحميل محتوى الملف](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/file.md)، [المحتوى المباشر تحديث](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/live.md)، [محرر مرئي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md) والمزيد.
 
-**الأتمتة**
+</Accordion>
 
 <Accordion header="الأتمتة">
 
@@ -70,22 +69,24 @@ author: aymericzip
 
 </Accordion>
 
-**أداء**
+<Accordion header="أداء">
 
 يمكن أن يؤدي ربط ملفات JSON الضخمة بالمكونات إلى حدوث مشكلات في الأداء والتفاعل. يعمل Intlayer على تحسين تحميل المحتوى الخاص بك في وقت الإنشاء.
 
 </Accordion>
 
-**التحجيم مع عدم وجود مطور**
+<Accordion header="التحجيم مع عدم وجود مطور">
 
 أكثر من مجرد حل i18n، يوفر Intlayer **[محررًا مرئيًا] مستضافًا ذاتيًا](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** و**[كامل CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** لمساعدتك في إدارة المحتوى متعدد اللغات في **الوقت الفعلي**، مما يجعل التعاون مع المترجمين ومؤلفي النصوص وأعضاء الفريق الآخرين سلسًا. يمكن تخزين المحتوى محليًا و/أو عن بعد.
 
 </Accordion>
 
-** تصميم الإطار المتقاطع **
+<Accordion header="تصميم الإطار المتقاطع">
 
 إذا كنت تستخدم أطر عمل مختلفة لأجزاء مختلفة من تطبيقك (على سبيل المثال، React وReact-native وVue وAngular وSvelte وما إلى ذلك)، فإن Intlayer يوفر طريقة **لاستخدام بناء جملة مشترك وتنفيذه عبر جميع أطر عمل الواجهة الأمامية الرئيسية**. ستتمكن أيضًا من مشاركة إعلان المحتوى الخاص بك عبر نظام التصميم والتطبيقات والواجهة الخلفية وما إلى ذلك.
 
+</Accordion>
+</AccordionGroup>
 ---
 
 ## لماذا تم إنشاء Intlayer؟
@@ -292,3 +293,99 @@ export const ComponentExample = () => {
 باستخدام `intlayer`، يمكنك التصريح عن المحتوى الخاص بك بتنسيق مكتبة i18n المفضلة لديك، وسيقوم intlayer بإنشاء مساحات الأسماء الخاصة بك في الموقع الذي تختاره (مثال: `/messages/{{locale}}/{{namespace}}.json`).
 
 إذا كنت ترغب في الاستمرار في استخدام واجهة برمجة التطبيقات الخاصة بمكتبة i18n الحالية لديك، فإن `intlayer` يوفر أيضًا **محوّلات التوافق (compat adapters)**: حزم تكشف نفس واجهة برمجة التطبيقات تمامًا مثل `react-i18next` و `next-intl` و `react-intl` و `vue-i18n` وغيرها، لكن يتم تزويدها بقواميس Intlayer. هذا يتيح لك الترحيل تدريجيًا دون إعادة كتابة الشيفرة الخاصة بك. راجع [توثيق محوّلات التوافق](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/compat/index.md).
+
+## الأسئلة الشائعة
+
+<FAQ>
+
+<Question title="ما هي الحلول المختلفة المتاحة لتدويل تطبيقات JavaScript؟">
+
+تتعايش ثلاثة أجيال:
+
+- **مكتبات كتالوجات وقت التشغيل**: `i18next`، `react-i18next`، `next-i18next`، `vue-i18n`، `ngx-translate`.
+- **مكتبات رسائل وقت البناء**: `Lingui`، `Paraglide`، `react-intl`، و `next-intl`.
+- **مكتبات طبقة المحتوى (Content layer)**: `Intlayer`. إعلان بجانب المكون، تصفية تلقائية، أنواع TypeScript، ترجمة بالذكاء الاصطناعي، ومحرر مرئي.
+
+</Question>
+
+<Question title="كم يضيف i18n إلى حجم حزمة (bundle) تطبيقي؟">
+
+أقل بكثير من الإعدادات القائمة على فضاءات الأسماء، لأن الصفحة لا تُحمّل أبدًا كتالوجًا لا تعرضه. يُحل المحتوى المعروض على الخادم مباشرة على الخادم، ويستبدل مترجم وقت البناء استدعاءات `useIntlayer` بإدخالات القاموس الدقيقة التي يستخدمها المكون، لذلك يتم التخلص من المفاتيح واللغات غير المستخدمة. تقسم [القواميس الديناميكية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/index.md) الباقي حسب اللغة. مقارنة بالبدائل التقليدية، يقلل Intlayer حجم الحزمة والصفحة بنسبة تصل إلى 50%. انظر [تحسين الحزم](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/bundle_optimization.md) و [المقارنة المعيارية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/benchmark/index.md).
+
+</Question>
+
+<Question title="هل يمكنني الترحيل من i18next أو next-intl أو react-i18next دون إعادة كتابة مكوناتي؟">
+
+نعم، وبطريقتين. يمكنك ترحيل المحتوى تدريجيًا باستخدام [دليل ترحيل i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/migration_from_i18next_to_intlayer.md) أو [دليل ترحيل next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/migration_from_next-intl_to_intlayer.md). أو يمكنك الاحتفاظ بواجهة برمجة التطبيقات الحالية بالكامل: تكشف [محولات التوافق](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/compat/index.md) نفس واجهات `i18next` و `react-i18next` و `next-intl` و `next-i18next` و `react-intl` و `use-intl` و `vue-i18n` و `Lingui`، ولكنها مدعومة بقواميس Intlayer، بحيث تتغير الاستيرادات فقط بينما يظل كود المكون كما هو.
+
+</Question>
+
+<Question title="هل يمكنني الاحتفاظ بملفات الترجمة JSON الموجودة لدي؟">
+
+نعم. تحافظ [مكونة مزامنة JSON](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/plugins/sync-json.md) على ملفات `/messages/{locale}/{namespace}.json` الخاصة بك كمصدر الحقيقة وتُنشئ قواميس Intlayer منها، في كلا الاتجاهين. وتقوم [مكونة مزامنة PO](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/plugins/sync-po.md) بنفس الشيء لكتالوجات gettext، وتسمح لك [الملفات المقسمة حسب اللغة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/per_locale_file.md) بتقسيم المحتوى حسب اللغة بدلاً من تجميع كل اللغات في ملف واحد.
+
+</Question>
+
+<Question title="هل يجب أن أنقل المحتوى الخاص بي مفتاحًا تلو الآخر؟">
+
+لا. قم بتشغيل `npx intlayer extract` وسيقرأ Intlayer ملفات المصدر الخاصة بك، ويسحب السلاسل النصية الموجهة للمستخدم ويكتب ملف `.content` بجانب كل منها، بحيث تراجع diff بدلاً من نسخ السلاسل إلى كتالوج يدويًا. راجع [أمر extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/extract.md).
+
+لأتمتة كاملة، يقوم [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/compiler.md) بالشيء نفسه في وقت البناء على كود JSX و TSX و Vue و Svelte، منشئًا القواميس عند كل تغيير دون الحاجة إلى إدارة المفاتيح يدويًا.
+
+</Question>
+
+<Question title="ما هي أدوات المحررات والوكلاء الذكيين المتاحة؟">
+
+خمس أدوات، كلها اختيارية:
+
+- **[امتداد VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/vs_code_extension.md)**: الانتقال من مفتاح `useIntlayer` إلى ملف المحتوى المصرح به، استخراج المحتوى من المكون، وتشغيل build و fill و test و push و pull من لوحة الأوامر أو علامة تبويب Intlayer.
+- **[خادم LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/lsp.md)**: نفس التجربة في أي محرر يدعم LSP، مع الانتقال إلى التعريف وعروض القيمة المترجمة عند التمرير والإكمال التلقائي للمفاتيح. يدعم أيضًا استدعاءات `i18next` و `react-i18next` و `next-intl` و `use-intl`.
+- **[خادم MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/mcp_server.md)**: يكشف وثائق Intlayer و CLI إلى Cursor و VS Code و Claude Desktop و Claude Code و ChatGPT.
+- **[Agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**: مهارات مخصصة مثل `intlayer-config` و `intlayer-cli` و `intlayer-content`.
+- **[ESLint plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/eslint.md)**: قاعدة `no-raw-text` ترصد النصوص المكتوبة مباشرة بدون تدويل.
+
+</Question>
+
+<Question title="كيف يختلف Intlayer عن next-intl؟">
+
+`next-intl` هي طبقة رسائل لـ Next.js تعتمد على ملفات JSON لكل لغة. يصرح Intlayer بالمحتوى مباشرة بجوار المكون، ويزيل الإدخالات غير المستخدمة في وقت البناء، وينشئ أنواع TypeScript صارمة لكل قاموس، ويوفر ترجمة مدمجة بالذكاء الاصطناعي ومحررًا مرئيًا.
+
+</Question>
+
+<Question title="كيف يختلف Intlayer عن i18next و react-i18next؟">
+
+يحل `i18next` المفاتيح النصية في وقت التشغيل، مما يعني أن الخطأ الإملائي في اسم المفتاح يفشل بصمت ويعرض نصًا فارغًا. يفحص Intlayer المفاتيح بشكل ثابت أثناء الترجمة، ويستبعد اللغات غير المستخدمة من الحزمة، ويؤتمت سير عمل الترجمة.
+
+</Question>
+
+<Question title="هل Intlayer أسرع أو أخف من البدائل؟">
+
+من حيث حجم الحزمة والصفحة، نعم: يؤدي عدم تحميل الكتالوجات التي لا تعرضها الصفحة إلى تقليل حجم الحزمة بنسبة تصل إلى 50%. من حيث أداء وقت التشغيل، تقضي الترجمة المسبقة على تكلفة التحليل في وقت التشغيل. انظر [المقارنة المعيارية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/benchmark/index.md).
+
+</Question>
+
+<Question title="هل يستحق ترحيل تطبيق حالي؟">
+
+يعتمد ذلك على القيود التي تواجهها. إذا كانت مشكلتك هي الحجم الكبير للحزمة، أو الترجمات المفقودة دون تحذير، أو صعوبة تحرير النصوص لغير المطورين، فإن Intlayer يحل ذلك؛ تسمح محولات التوافق بالترحيل التدريجي دون إعادة كتابة الكود.
+
+</Question>
+
+<Question title="ما الذي يقدمه Intlayer ولا تقدمه مكتبات i18n الأخرى؟">
+
+دعم [محتوى Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/markdown.md)، جلب المحتوى من CMS، محرر مرئي متكامل، ترجمة تلقائية بالذكاء الاصطناعي باستخدام الخيار `--git-diff`، وإكمال تلقائي لـ TypeScript بناءً على تحليل المكون.
+
+</Question>
+
+<Question title="هل يمكنني استخدام Intlayer كمدير ترجمة فقط والاحتفاظ بمكتبتي الحالية؟">
+
+نعم. يمكن لـ Intlayer إنشاء فضاءات أسماء بالتنسيق والموقع المتوقعين بواسطة مكتبتك الحالية (على سبيل المثال `/messages/{locale}/{namespace}.json`)، مما يتيح لك الاستمتاع بـ CLI ومحرر Intlayer دون تغيير كود تطبيقك.
+
+</Question>
+
+<Question title="هل Intlayer مفتوح المصدر ومجاني؟">
+
+نعم، بموجب ترخيص Apache 2.0، بما في ذلك الاستخدام التجاري. الـ CMS السحابي هو خدمة مدفوعة اختيارية ويمكن أيضًا [استضافتها ذاتيًا](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/self_hosting.md).
+
+</Question>
+
+</FAQ>