@intlayer/docs 5.5.10 → 5.5.12

package/docs/ar/how_works_intlayer.md

@@ -0,0 +1,251 @@
+---
+createdAt: 2024-08-12
+updatedAt: 2025-06-29
+title: كيف يعمل Intlayer
+description: تعلم كيف يعمل Intlayer داخليًا. افهم البنية والمكونات التي تجعل Intlayer قويًا.
+keywords:
+  - Intlayer
+  - كيف يعمل
+  - الهندسة المعمارية
+  - المكونات
+  - العمليات الداخلية
+slugs:
+  - doc
+  - concept
+  - how-works-intlayer
+---
+
+# كيف يعمل Intlayer
+
+## نظرة عامة
+
+الفكرة الرئيسية وراء Intlayer هي تبني إدارة المحتوى لكل مكون على حدة. لذا الفكرة وراء Intlayer هي السماح لك بإعلان المحتوى الخاص بك في أي مكان في قاعدة الكود الخاصة بك، كما في نفس الدليل مثل المكون الخاص بك.
+
+```bash
+.
+└── Components
+    └── MyComponent
+        ├── index.content.cjs
+        └── index.mjs
+```
+
+للقيام بذلك، دور Intlayer هو العثور على جميع `ملفات إعلان المحتوى`، بجميع التنسيقات المختلفة الموجودة في مشروعك، ثم سيقوم بإنشاء `القواميس` منها.
+
+لذا هناك خطوتان رئيسيتان:
+
+- خطوة البناء
+- خطوة التفسير
+
+### خطوة بناء القواميس
+
+يمكن تنفيذ خطوة البناء بثلاث طرق:
+
+- باستخدام CLI مع `npx intlayer build`
+- باستخدام [إضافة VSCode](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/vs_code_extension.md)
+- باستخدام إضافات التطبيقات مثل حزمة [`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` الخاص بالمشروع.
+   - يتم إنشاء هذه القواميس بتنسيقات مختلفة لتلبية جميع الاحتياجات وتحسين أداء التطبيق.
+
+3. إنشاء أنواع القواميس
+   بناءً على `القواميس` الخاصة بك، سيقوم Intlayer بإنشاء أنواع لجعلها قابلة للاستخدام في تطبيقك.
+
+- يتم إنشاء أنواع القواميس من `ملفات إعلان المحتوى` الخاصة بـ Intlayer. افتراضيًا، يتم إنشاء أنواع القواميس الخاصة بـ Intlayer في دليل `.intlayer/types` الخاص بالمشروع.
+
+- [توسيع الوحدة](https://www.typescriptlang.org/docs/handbook/declaration-merging.html) الخاص بـ Intlayer هو ميزة في TypeScript تتيح لك تعريف أنواع إضافية لـ Intlayer. هذا يجعل تجربة التطوير أسهل من خلال اقتراح الوسائط المتاحة أو الوسائط المطلوبة.
+  من بين الأنواع التي يتم إنشاؤها، يتم إضافة أنواع القواميس الخاصة بـ Intlayer أو حتى أنواع تكوين اللغة إلى ملف `types/intlayer.d.ts`، وتستخدمها الحزم الأخرى. للقيام بذلك، من الضروري أن يتم تكوين ملف `tsconfig.json` لتضمين دليل `types` الخاص بالمشروع.
+
+### خطوة تفسير القواميس
+
+باستخدام Intlayer، ستتمكن من الوصول إلى المحتوى الخاص بك في تطبيقك باستخدام الخطاف `useIntlayer`.
+
+```tsx
+const MyComponent = () => {
+  const content = useIntlayer("my-component");
+  return <div>{content.title}</div>;
+};
+```
+
+سيقوم هذا الخطاف بإدارة اكتشاف اللغة المحلية نيابة عنك وسيعيد المحتوى للغة المحلية الحالية. باستخدام هذا الخطاف، ستتمكن أيضًا من تفسير Markdown، إدارة الجمع، والمزيد.
+
+> لرؤية جميع ميزات Intlayer، يمكنك قراءة [وثائق القواميس](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/get_started.md).
+
+## المحتوى البعيد
+
+يسمح لك Intlayer بإعلان المحتوى محليًا، ثم تصديره إلى نظام إدارة المحتوى (CMS) لجعله قابلاً للتعديل من قبل فريقك غير التقني.
+
+لذا ستتمكن من دفع وسحب المحتوى من نظام إدارة المحتوى إلى تطبيقك، بطريقة مشابهة لما تفعله مع Git للكود الخاص بك.
+
+بالنسبة للقواميس الخارجية التي تستخدم نظام إدارة المحتوى، يقوم Intlayer بعملية جلب أساسية لاسترجاع القواميس البعيدة ودمجها مع القواميس المحلية الخاصة بك. إذا تم تكوينه في مشروعك، سيقوم Intlayer تلقائيًا بإدارة جلب المحتوى من نظام إدارة المحتوى عند بدء التطبيق (التطوير) / البناء (الإنتاج).
+
+## المحرر المرئي
+
+يوفر Intlayer أيضًا محررًا مرئيًا يتيح لك تعديل المحتوى الخاص بك بطريقة مرئية. هذا [المحرر المرئي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md) متاح في الحزمة الخارجية `intlayer-editor`.
+
+![المحرر المرئي](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif)
+
+- الخادم هو تطبيق Express بسيط يستمع إلى الطلبات من العميل ويسترجع محتوى تطبيقك، مثل `dictionaries` والتكوين لجعله متاحًا على جانب العميل.
+- من ناحية أخرى، العميل هو تطبيق React يُستخدم للتفاعل مع المحتوى الخاص بك باستخدام واجهة مرئية.
+  عندما تستدعي المحتوى الخاص بك باستخدام `useIntlayer` ويكون المحرر مفعّلًا، فإنه يلف تلقائيًا سلاسل النصوص الخاصة بك بكائن Proxy يُسمى `IntlayerNode`. يستخدم هذا الكائن `window.sendMessage` للتواصل مع iframe مغلف يحتوي على واجهة المحرر المرئي.
+  على جانب المحرر، يستمع المحرر إلى هذه الرسائل ويُحاكي التفاعل الحقيقي مع المحتوى الخاص بك، مما يتيح لك تحرير النص مباشرة في سياق تطبيقك.
+
+## تحسين بناء التطبيق
+
+لتحسين حجم الحزمة لتطبيقك، يوفر Intlayer مكونين إضافيين لتحسين بناء تطبيقك: مكونات `@intlayer/babel` و `@intlayer/swc`.
+تعمل مكونات Babel و SWC عن طريق تحليل شجرة بناء الجملة المجردة (AST) لتطبيقك لاستبدال استدعاءات دوال Intlayer بكود محسن. تجعل هذه العملية الحزمة النهائية أخف في الإنتاج من خلال التأكد من استيراد القواميس المستخدمة فقط، مما يحسن تقسيم الحزم ويقلل من حجم الحزمة.
+
+في وضع التطوير، يستخدم Intlayer استيرادًا ثابتًا مركزيًا للقواميس لتبسيط تجربة التطوير.
+
+بتفعيل الخيار `activateDynamicImport` في [التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)، سيستخدم Intlayer الاستيراد الديناميكي لتحميل القواميس. هذا الخيار معطل افتراضيًا لتجنب المعالجة غير المتزامنة عند عرض التطبيق.
+
+> `@intlayer/babel` متاح افتراضيًا في حزمة `vite-intlayer`،
+
+> `@intlayer/swc` غير مثبت افتراضيًا في حزمة `next-intlayer` حيث أن مكونات SWC لا تزال تجريبية في Next.js.
+
+لرؤية كيفية تكوين بناء تطبيقك، يمكنك قراءة [وثائق التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).
+
+## الحزم
+
+يتكون Intlayer من عدة حزم، كل منها له دور محدد في عملية الترجمة. فيما يلي تمثيل رسومي لهيكل هذه الحزمة:
+
+![حزم Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/assets/packages_dependency_graph.svg)
+
+### intlayer
+
+تُستخدم حزمة `intlayer` في التطبيقات لإعلان المحتوى في ملفات المحتوى.
+
+### react-intlayer
+
+تُستخدم حزمة `react-intlayer` لتفسير قواميس Intlayer وجعلها قابلة للاستخدام في تطبيقات React.
+
+### next-intlayer
+
+تُستخدم حزمة `next-intlayer` كطبقة فوق `react-intlayer` لجعل قواميس Intlayer قابلة للاستخدام في تطبيقات Next.js. تتكامل مع الميزات الأساسية لجعل Intlayer يعمل في بيئة Next.js، مثل الوسيطات الخاصة بالترجمة، التوجيه، أو تكوين ملف `next.config.js`.
+
+### vue-intlayer
+
+تُستخدم حزمة `vue-intlayer` لتفسير قواميس Intlayer وجعلها قابلة للاستخدام في تطبيقات Vue.
+
+### nuxt-intlayer
+
+تُستخدم حزمة `nuxt-intlayer` كوحدة Nuxt لجعل قواميس Intlayer قابلة للاستخدام في تطبيقات Nuxt. تدمج ميزات أساسية لجعل Intlayer يعمل في بيئة Nuxt، مثل وسيط الترجمة، التوجيه، أو تكوين ملف `nuxt.config.js`.
+
+### svelte-intlayer (قيد العمل)
+
+تُستخدم حزمة `svelte-intlayer` لتفسير قواميس Intlayer وجعلها قابلة للاستخدام في تطبيقات Svelte.
+
+### solid-intlayer (قيد العمل)
+
+تُستخدم حزمة `solid-intlayer` لتفسير قواميس Intlayer وجعلها قابلة للاستخدام في تطبيقات Solid.js.
+
+### preact-intlayer
+
+تُستخدم حزمة `preact-intlayer` لتفسير قواميس Intlayer وجعلها قابلة للاستخدام في تطبيقات Preact.
+
+### angular-intlayer (قيد العمل)
+
+تُستخدم حزمة `angular-intlayer` لتفسير قواميس Intlayer وجعلها قابلة للاستخدام في تطبيقات Angular.
+
+### express-intlayer
+
+تُستخدم حزمة `express-intlayer` لاستخدام Intlayer على واجهة خلفية Express.js.
+
+### react-native-intlayer
+
+توفر حزمة `react-native-intlayer` أدوات تتكامل مع مكونات إضافية لـ Intlayer للعمل مع Metro bundler.
+
+### lynx-intlayer
+
+توفر حزمة `lynx-intlayer` أدوات تتكامل مع مكونات إضافية لـ Intlayer للعمل مع Lynx bundler.
+
+### vite-intlayer
+
+تشمل مكون Vite الإضافي لتكامل Intlayer مع [Vite bundler](https://vite.dev/guide/why.html#why-bundle-for-production)، بالإضافة إلى الوسيطات لاكتشاف اللغة المفضلة للمستخدم، إدارة الكوكيز، ومعالجة إعادة توجيه الروابط.
+
+### react-scripts-intlayer
+
+تتضمن أوامر ومكونات `react-scripts-intlayer` الإضافية لتكامل Intlayer مع التطبيقات المستندة إلى Create React App. هذه المكونات الإضافية مبنية على [craco](https://craco.js.org/) وتشمل تكوينًا إضافيًا لأداة التجميع [Webpack](https://webpack.js.org/).
+
+### intlayer-editor
+
+تُستخدم حزمة `intlayer-editor` للسماح باستخدام المحرر المرئي. هذه الحزمة اختيارية ويمكن تثبيتها في التطبيقات وسيتم استخدامها بواسطة حزمة `react-intlayer`.  
+تتكون من جزئين: الخادم والعميل.
+
+يحتوي العميل على عناصر واجهة المستخدم التي سيتم استخدامها بواسطة `react-intlayer`.
+
+الخادم، المستند إلى Express، يُستخدم لاستقبال طلبات المحرر المرئي وإدارة أو تعديل ملفات المحتوى.
+
+### intlayer-cli
+
+يمكن استخدام حزمة `intlayer-cli` لإنشاء القواميس باستخدام الأمر `npx intlayer dictionaries build`. إذا تم تثبيت `intlayer` بالفعل، يتم تثبيت CLI تلقائيًا وهذه الحزمة ليست ضرورية.
+
+### @intlayer/core
+
+حزمة `@intlayer/core` هي الحزمة الرئيسية لـ Intlayer. تحتوي على وظائف إدارة الترجمة والقواميس. `@intlayer/core` متعددة المنصات وتُستخدم من قبل حزم أخرى لتنفيذ تفسير القواميس.
+
+### @intlayer/config
+
+تُستخدم حزمة `@intlayer/config` لتكوين إعدادات Intlayer، مثل اللغات المتاحة، معلمات الوسيط لـ Next.js، أو إعدادات المحرر المتكامل.
+
+### @intlayer/webpack
+
+تُستخدم حزمة `@intlayer/webpack` لتوفير إعدادات Webpack لجعل تطبيق يعتمد على Webpack يعمل مع Intlayer. كما توفر الحزمة مكونًا إضافيًا لإضافته إلى تطبيق Webpack موجود.
+
+### @intlayer/cli
+
+حزمة `@intlayer/cli` هي حزمة NPM تُستخدم لإعلان السكربتات المتعلقة بواجهات سطر الأوامر الخاصة بـ Intlayer. تضمن توحيد جميع أوامر CLI الخاصة بـ Intlayer. يتم استهلاك هذه الحزمة بشكل خاص من قبل حزم [intlayer-cli](https://github.com/aymericzip/intlayer/tree/main/docs/ar/packages/intlayer-cli/index.md)، و[intlayer](https://github.com/aymericzip/intlayer/tree/main/docs/ar/packages/intlayer/index.md).
+
+### @intlayer/mcp
+
+تُوفر حزمة `@intlayer/mcp` خادم MCP (بروتوكول سياق النموذج) الذي يقدم مساعدة IDE مدعومة بالذكاء الاصطناعي مصممة خصيصًا لنظام Intlayer البيئي. يقوم بتحميل الوثائق تلقائيًا ويتكامل مع واجهة سطر الأوامر Intlayer CLI.
+
+### @intlayer/dictionaries-entry & @intlayer/unmerged-dictionaries-entry & @intlayer/dynamic-dictionaries-entry
+
+تُعيد حزم `@intlayer/dictionaries-entry` و `@intlayer/unmerged-dictionaries-entry` و `@intlayer/dynamic-dictionaries-entry` مسار الدخول لقواميس Intlayer. نظرًا لأن البحث في نظام الملفات من المتصفح مستحيل، فإن استخدام أدوات التجميع مثل Webpack أو Rollup لاسترجاع مسار الدخول للقواميس غير ممكن. تم تصميم هذه الحزم لتكون قابلة للاختصار (aliased)، مما يسمح بتحسين التجميع عبر أدوات تجميع مختلفة مثل Vite وWebpack وTurbopack.
+
+### @intlayer/chokidar
+
+تُستخدم حزمة `@intlayer/chokidar` لمراقبة ملفات المحتوى وإعادة توليد القاموس المعدل عند كل تعديل.
+
+### @intlayer/editor
+
+تُوفر حزمة `@intlayer/editor` الأدوات المتعلقة بمحرر القواميس. وتشمل بشكل خاص واجهة برمجة التطبيقات (API) لربط التطبيق بمحرر Intlayer، وأدوات لمعالجة القواميس. هذه الحزمة متعددة المنصات.
+
+### @intlayer/editor-react
+
+تُوفر حزمة `@intlayer/editor-react` الحالات، والسياقات، والهوكس، والمكونات لربط تطبيق React بمحرر Intlayer.
+
+### @intlayer/babel
+
+تُوفر حزمة `@intlayer/babel` أدوات لتحسين تجميع القواميس لتطبيقات تعتمد على Vite وWebpack.
+
+### @intlayer/swc (قيد العمل)
+
+تُوفر حزمة `@intlayer/swc` أدوات لتحسين تجميع القواميس لتطبيقات Next.js.
+
+### @intlayer/api
+
+حزمة `@intlayer/api` هي SDK API للتفاعل مع الخلفية.
+
+### @intlayer/design-system
+
+تُستخدم حزمة `@intlayer/design-system` لمشاركة عناصر التصميم بين نظام إدارة المحتوى والمحرر المرئي.
+
+### @intlayer/backend
+
+تُصدر حزمة `@intlayer/backend` أنواع الخلفية وستقدم في المستقبل الخلفية كحزمة مستقلة.
+
+## تحدث مع وثائقنا الذكية
+
+- [اطرح أسئلتك على وثائقنا الذكية](https://intlayer.org/doc/chat)
+
+## تاريخ الوثيقة
+
+- 5.5.10 - 2025-06-29: بدء التاريخ

package/docs/ar/index.md

@@ -0,0 +1,164 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: توثيق Intlayer - الدليل الكامل للتدويل (i18n) لجافاسكريبت
+description: توثيق كامل لـ Intlayer، مكتبة التدويل الحديثة لجافاسكريبت، React، Next.js، Express، والمزيد من الأُطُر.
+keywords:
+  - intlayer
+  - التدويل
+  - i18n
+  - جافاسكريبت
+  - React
+  - Next.js
+  - توثيق
+  - ترجمة
+  - متعدد اللغات
+slugs:
+  - doc
+  - index
+---
+
+# توثيق Intlayer
+
+مرحبًا بكم في التوثيق الرسمي لـ **Intlayer**! هنا، ستجد كل ما تحتاجه لدمج وتكوين وإتقان Intlayer لجميع احتياجات التدويل (i18n) الخاصة بك، سواء كنت تعمل مع **Next.js**، **React**، **Vite**، **Express**، أو أي بيئة جافاسكريبت أخرى.
+
+يقدم Intlayer نهجًا مرنًا وحديثًا لترجمة تطبيقك. ستوجهك وثائقنا من التثبيت والإعداد إلى الميزات المتقدمة مثل **الترجمة المدعومة بالذكاء الاصطناعي**، وتعريفات **TypeScript**، ودعم **مكونات الخادم**، مما يمكنك من إنشاء تجربة متعددة اللغات بسلاسة.
+
+---
+
+## البدء
+
+- **[مقدمة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/introduction.md)**  
+  احصل على نظرة عامة حول كيفية عمل Intlayer، وميزاته الأساسية، ولماذا يُعتبر تغييرًا جذريًا في مجال التدويل (i18n).
+
+- **[كيفية عمل Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/how_works_intlayer.md)**  
+  تعمق في التصميم المعماري وتعلم كيف يتعامل Intlayer مع كل شيء بدءًا من إعلان المحتوى وحتى تسليم الترجمة.
+
+- **[التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)**  
+  خصص Intlayer ليناسب احتياجات مشروعك. استكشف خيارات الوسيط، وهياكل الدليل، والإعدادات المتقدمة.
+
+- **[واجهة سطر أوامر Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_cli.md)**
+
+قم بإدارة المحتوى والترجمات باستخدام أداة سطر الأوامر الخاصة بنا. اكتشف كيفية دفع وسحب المحتوى، وأتمتة الترجمات، والمزيد.
+
+- **[محرر Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md)**  
+  بسط التعاون مع غير المطورين وقم بتعزيز ترجماتك باستخدام الذكاء الاصطناعي، مباشرة في نظام إدارة المحتوى المجاني والبديهي الخاص بنا.
+
+---
+
+## المفاهيم الأساسية
+
+### القاموس
+
+نظم محتواك متعدد اللغات بالقرب من كودك للحفاظ على كل شيء متسقًا وقابلًا للصيانة.
+
+- **[البدء](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/get_started.md)**  
+  تعلّم أساسيات إعلان محتواك في Intlayer.
+
+- **[الترجمة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/translation.md)**  
+  فهم كيفية إنشاء الترجمات وتخزينها واستخدامها في تطبيقك.
+
+- **[التعداد](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/enumeration.md)**  
+  إدارة مجموعات البيانات المتكررة أو الثابتة بسهولة عبر لغات متعددة.
+
+- **[الشرط](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/conditional.md)**  
+  تعلّم كيفية استخدام المنطق الشرطي في Intlayer لإنشاء محتوى ديناميكي.
+
+- **[الإدخال](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/insertion.md)**  
+  اكتشف كيفية إدخال القيم في سلسلة نصية باستخدام نُسخ الإدخال.
+
+- **[جلب الدوال](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/function_fetching.md)**  
+  شاهد كيفية جلب المحتوى ديناميكيًا باستخدام منطق مخصص ليتناسب مع سير عمل مشروعك.
+
+- **[ماركداون](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/markdown.md)**  
+  تعلّم كيفية استخدام ماركداون في Intlayer لإنشاء محتوى غني.
+
+- **[تضمين الملفات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/file_embeddings.md)**  
+  اكتشف كيفية تضمين ملفات خارجية في Intlayer لاستخدامها في محرر المحتوى.
+
+- **[التداخل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/nesting.md)**  
+  افهم كيفية تداخل المحتوى في Intlayer لإنشاء هياكل معقدة.
+
+---
+
+## البيئات والتكاملات
+
+لقد قمنا ببناء Intlayer مع وضع المرونة في الاعتبار، مقدمين تكاملًا سلسًا عبر الأُطُر وأدوات البناء الشائعة:
+
+- **[Intlayer مع Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_15.md)**
+- **[Intlayer مع Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_14.md)**
+- **[Intlayer مع Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_page_router.md)**
+- **[Intlayer مع React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_create_react_app.md)**
+- **[Intlayer مع Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+react.md)**
+- **[Intlayer مع React Native و Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_react_native+expo.md)**
+- **[Intlayer مع Lynx و React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_lynx+react.md)**
+- **[Intlayer مع Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_express.md)**
+
+تتضمن كل دليل تكامل أفضل الممارسات لاستخدام ميزات Intlayer، مثل **التصيير على جانب الخادم**، **التوجيه الديناميكي**، أو **التصيير على جانب العميل**، حتى تتمكن من الحفاظ على تطبيق سريع، صديق لمحركات البحث، وقابل للتوسع بشكل كبير.
+
+---
+
+## الحزم
+
+يقدم التصميم المعياري لـ Intlayer حزم مخصصة لبيئات واحتياجات محددة:
+
+### `intlayer`
+
+وظائف الأدوات الأساسية لتكوين وإدارة إعدادات التدويل (i18n) الخاصة بك.
+
+- **[getConfiguration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getConfiguration.md)**
+- **[getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getHTMLTextDir.md)**
+- **[getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocaleLang.md)**
+- **[getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocaleName.md)**
+- **[getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocalizedUrl.md)**
+- **[getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getMultilingualUrls.md)**
+- **[getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPathWithoutLocale.md)**
+- **[getTranslation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getTranslation.md)**
+- **[getEnumeration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getEnumeration.md)**
+
+### `express-intlayer`
+
+استخدم Intlayer داخل تطبيقات **Express**:
+
+- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/express-intlayer/t.md)**  
+  مساعد ترجمة بسيط ومباشر لمسارات الخادم والعروض الخاصة بك.
+
+### `react-intlayer`
+
+عزز تطبيقات **React** الخاصة بك باستخدام الخطافات القوية:
+
+- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/t.md)**
+- **[useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useIntlayer.md)**
+- **[useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useDictionary.md)**
+- **[useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useLocale.md)**
+
+### `next-intlayer`
+
+اندماج سلس مع **Next.js**:
+
+- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/next-intlayer/t.md)**
+- **[useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/next-intlayer/useIntlayer.md)**
+- **[useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/next-intlayer/useDictionary.md)**
+- **[useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/next-intlayer/useLocale.md)**
+
+---
+
+## موارد إضافية
+
+- **[مدونة: Intlayer و i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_i18next.md)**  
+  تعرّف على كيفية تكامل Intlayer ومقارنته مع مكتبة **i18next** الشهيرة.
+
+- **[دروس مباشرة على يوتيوب](https://youtu.be/W2G7KxuSD4c?si=GyU_KpVhr61razRw)**  
+  شاهد عرضًا توضيحيًا شاملاً وتعلم كيفية دمج Intlayer في الوقت الحقيقي.
+
+---
+
+## المساهمة والتعليقات
+
+نحن نقدر قوة المصادر المفتوحة والتطوير المدفوع من قبل المجتمع. إذا كنت ترغب في اقتراح تحسينات، أو إضافة دليل جديد، أو تصحيح أي مشاكل في مستنداتنا، فلا تتردد في تقديم طلب سحب (Pull Request) أو فتح مشكلة على [مستودع GitHub الخاص بنا](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+
+**هل أنت مستعد لترجمة تطبيقك بشكل أسرع وأكثر كفاءة؟** اغمر نفسك في مستنداتنا لبدء استخدام Intlayer اليوم. اختبر نهجًا قويًا ومنظمًا للتدويل يحافظ على تنظيم محتواك ويجعل فريقك أكثر إنتاجية.
+
+## تاريخ المستند
+
+- 5.5.10 - 2025-06-29: بداية التاريخ

package/docs/ar/interest_of_intlayer.md

@@ -0,0 +1,157 @@
+---
+createdAt: 2024-08-14
+updatedAt: 2025-06-29
+title: أهمية Intlayer
+description: اكتشف فوائد ومزايا استخدام Intlayer في مشاريعك. افهم لماذا يتميز Intlayer بين الأُطُر الأخرى.
+keywords:
+  - فوائد
+  - مزايا
+  - Intlayer
+  - إطار عمل
+  - مقارنة
+slugs:
+  - doc
+  - concept
+  - interest
+---
+
+# Intlayer: طريقة مخصصة لترجمة موقعك الإلكتروني
+
+**Intlayer** هي مكتبة تعريب مصممة خصيصًا لمطوري جافاسكريبت. تتيح لك إعلان المحتوى الخاص بك في كل مكان داخل الكود الخاص بك. تقوم بتحويل إعلان المحتوى متعدد اللغات إلى قواميس منظمة لتسهيل دمجها في الكود الخاص بك. باستخدام TypeScript، تجعل **Intlayer** تطويرك أقوى وأكثر كفاءة.
+
+## مثال على الاستخدام
+
+```bash codeFormat="typescript"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.ts
+        └── index.tsx
+```
+
+```bash codeFormat="commonjs"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.cjs
+        └── index.mjs
+```
+
+```bash codeFormat="esm"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.mjs
+        └── index.js
+```
+
+```tsx fileName="./Components/MyComponent/index.content.ts" codeFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const componentExampleContent = {
+  key: "component-example",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentExampleContent;
+```
+
+```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",
+    }),
+  },
+};
+
+export default componentExampleContent;
+```
+
+```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",
+    }),
+  },
+};
+
+module.exports = componentExampleContent;
+```
+
+```tsx fileName="./Components/MyComponent/index.tsx" codeFormat="typescript"
+import { useIntlayer } from "react-intlayer";
+
+// مثال لمكون يستخدم intlayer لجلب المحتوى المترجم
+export const ComponentExample = () => {
+  const { myTranslatedContent } = useIntlayer("component-example");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="./Components/MyComponent/index.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const ComponentExample = () => {
+  const { myTranslatedContent } = useIntlayer("component-example");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="./Components/MyComponent/index.csx" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const ComponentExample = () => {
+  const { myTranslatedContent } = useIntlayer("component-example");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+## لماذا تختار 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). |
+
+## تاريخ الوثيقة
+
+- 5.5.10 - 2025-06-29: بداية التاريخ