@intlayer/docs 9.4.4 → 9.5.0

package/docs/ar/migration_from_react-i18next_to_intlayer.md

@@ -34,7 +34,6 @@ author: aymericzip
 بدلاً من تحميل ملفات JSON ضخمة في صفحاتك، قم بتحميل المحتوى الضروري فقط. يساعدك Intlayer على **تقليل حجم bundle والصفحات بنسبة تصل إلى 50%**.
 
 </Accordion>
-
 <Accordion header="سهولة الصيانة">
 
 تقسيم محتوى التطبيق الخاص بك **يسهل الصيانة** للتطبيقات الكبيرة. يمكنك نسخ أو حذف مجلد ميزة واحد دون العبء الذهني لمراجعة قاعدة الكود كاملة. بالإضافة إلى ذلك، Intlayer **مكتوب بالكامل** لضمان دقة المحتوى الخاص بك.
@@ -42,25 +41,21 @@ author: aymericzip
 Intlayer هو أيضًا الحل الذي يتمتع بـ **أنشط تطور** في نظام i18n البيئي - يتم إصلاح المشاكل بسرعة، وتصل محولات frameworks جديدة بانتظام، ويتم تحسين API الأساسي بشكل مستمر بناءً على ملاحظات الإنتاج الواقعية.
 
 </Accordion>
-
 <Accordion header="وكيل AI">
 
 **يقلل** Co-locating المحتوى من السياق المطلوب بواسطة النماذج اللغوية الكبيرة (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) أكثر سلاسة حتى بالنسبة لوكلاء AI.
 
 </Accordion>
-
 <Accordion header="الأتمتة">
 
 استخدم الأتمتة للترجمة في خط أنابيب CI/CD الخاص بك باستخدام LLM من اختيارك بتكلفة موفر AI الخاص بك. يوفر Intlayer أيضًا **مترجم** لأتمتة استخراج المحتوى، وكذلك [منصة ويب](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) لمساعدتك في **الترجمة في الخلفية**.
 
 </Accordion>
-
 <Accordion header="الأداء">
 
 ربط ملفات JSON ضخمة بمكونات قد يؤدي إلى مشاكل الأداء والتفاعل. يحسّن Intlayer تحميل المحتوى الخاص بك في وقت البناء.
 
 </Accordion>
-
 <Accordion header="التوسع مع غير المطورين">
 
 أكثر من مجرد حل i18n، يوفر Intlayer **محرر بصري مستضاف على الخادم الخاص بك** و **CMS كامل** لمساعدتك في إدارة محتوى متعدد اللغات **في الوقت الفعلي**، مما يجعل التعاون مع المترجمين والمحررين وأعضاء الفريق الآخرين سلساً. يمكن تخزين المحتوى محليًا و/أو عن بعد.
@@ -68,8 +63,6 @@ Intlayer هو أيضًا الحل الذي يتمتع بـ **أنشط تطور**
 </Accordion>
 </AccordionGroup>
 
----
-
 ## استراتيجيات الترحيل
 
 هناك استراتيجيتان متكاملتان للترحيل من `react-i18next` / `i18next` إلى Intlayer:
@@ -80,20 +73,15 @@ Intlayer هو أيضًا الحل الذي يتمتع بـ **أنشط تطور**
 
 يغطي هذا الدليل **الاستراتيجية 1** أولاً (محول التوافق drop-in)، ثم يمر عبر الترحيل الكامل الاختياري.
 
----
-
 ## جدول المحتويات
 
 <TOC/>
 
----
-
 ## الترحيل السريع
 
 الخطوات التالية هي الحد الأدنى المطلوب للحصول على تطبيق `react-i18next` الموجود يعمل على Intlayer دون تغييرات الكود.
 
 <Steps>
-
 <Step number={1} title="تثبيت التبعيات">
 
 قم بتثبيت حزم Intlayer الأساسية ومحولات التوافق:
@@ -137,7 +125,6 @@ bun add intlayer react-intlayer @intlayer/react-i18next @intlayer/i18next @intla
 > يمكنك الاحتفاظ بـ `react-i18next` و `i18next` المثبتة - تستخدم محولات التوافق كـ `devDependencies` / `peerDependencies` اختياري لأنواع TypeScript. لا تحتاج إلى تغيير أي أقران `package.json`.
 
 </Step>
-
 <Step number={2} title="تكوين Intlayer">
 
 ينشئ أمر `intlayer init` ملف `intlayer.config.ts` البداية. قم بتحديثه ليطابق المناطق الموجودة لديك وأشر مكون `syncJSON` إلى ملفات الرسائل الخاصة بك:
@@ -172,7 +159,6 @@ export default config;
 > **`source`** يعيّن منطقة إلى مسار ملفها JSON. **`location`** يخبر المراقب Intlayer أي مجلد يجب مراقبته للتغييرات. يضمن الخيار `format: 'i18next'` أن العناصر النائبة مثل `{{name}}` يتم تحليلها بشكل صحيح.
 
 </Step>
-
 <Step number={3} title="إضافة مكون Intlayer إلى Bundler الخاص بك">
 
 لف إعداد bundler الموجود لديك بمكون التوافق. يقوم بدمج مكون Intlayer الأساسي، ويربط مراقبة المحتوى، و - بشكل حاسم - **يحقن بدائل module** بحيث تتم إعادة توجيه استدعاءات `import … from 'react-i18next'` (و `'i18next'`) الموجودة بشفافية إلى `@intlayer/react-i18next` / `@intlayer/i18next` في وقت البناء. لا توجد حاجة لتغييرات ملفات المصدر.
@@ -233,14 +219,11 @@ export default withIntlayer(nextConfig);
 > tAbout("counter.label"); // ✓ مكتوب
 > ```
 
----
-
 ## الترحيل الكامل
 
 الخطوات أدناه اختيارية ويمكن القيام بها بشكل تدريجي. تفتح مجموعة ميزات Intlayer الكاملة: محرر بصري، CMS، ملفات محتوى مكتوبة، ترجمة مدعومة بـ AI، والمزيد.
 
 <Steps>
-
 <Step number={4} title="إعادة تسمية الاستيراد الصريح (اختياري)" isOptional={true}>
 
 تتعامل مكونات Intlayer بالفعل مع البدائل على مستوى bundler. إذا كنت تفضل جعل التبعية صريحة في ملفات المصدر، يمكنك إعادة تسمية الاستيرادات يدويًا:
@@ -265,7 +248,6 @@ export default withIntlayer(nextConfig);
 | `import { useTranslation } from 'next-i18next'`                                | `import { useTranslation } from '@intlayer/next-i18next'`         |
 
 </Step>
-
 <Step number={5} title="تفعيل أتمتة الترجمة المدعومة بـ AI" isOptional={true}>
 
 بمجرد توصيل Intlayer، استخدم CLI الخاص به لملء الترجمات المفقودة تلقائياً:
@@ -327,8 +309,6 @@ export default config;
 
 </Steps>
 
----
-
 ## ما يمكنك حذفه بعد الترحيل
 
 بمجرد وضع محولات التوافق، يمكن إزالة الكود النموذجي التالي من `react-i18next` / `i18next`:
@@ -341,8 +321,6 @@ export default config;
 
 عندما تكون جاهزاً للمضي قدماً، يكتشف Intlayer **تلقائياً جميع ملفات `.content.ts` و `.content.json` في أي مكان في codebase** (افتراضياً، في أي مكان داخل `./src`). يمكنك وضع ملف `my-component.content.ts` بجوار `MyComponent.tsx` مباشرة وسيلتقطه Intlayer في وقت البناء دون تكوين إضافي - لا استيرادات، لا تسجيل، لا ملف فهرس مركزي مطلوب. هذا يجعل co-locating الترجمات مع الصفحات والمكونات خالياً من الاحتكاك تماماً.
 
----
-
 ## تكوين TypeScript
 
 يستخدم Intlayer تعديل module لتوفير intellisense TypeScript الكامل لمفاتيح الترجمة. تأكد من أن `tsconfig.json` يتضمن الأنواع التي يتم إنشاؤها تلقائياً:
@@ -357,8 +335,6 @@ export default config;
 }
 ```
 
----
-
 ## تكوين Git
 
 أضف مجلد Intlayer المُنتج إلى `.gitignore`:
@@ -368,8 +344,6 @@ export default config;
 .intlayer
 ```
 
----
-
 ## اذهب إلى ما هو أبعد
 
 - **محرر بصري** — إدارة الترجمات بشكل مرئي في المتصفح: [محرر Intlayer البصري](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)

package/docs/ar/migration_from_vue-i18n_to_intlayer.md

@@ -33,7 +33,6 @@ author: aymericzip
 بدلاً من تحميل ملفات JSON ضخمة في صفحاتك، قم بتحميل فقط المحتوى الضروري. يساعد Intlayer على **تقليل حجم الحزمة والصفحات بما يصل إلى 50%**.
 
 </Accordion>
-
 <Accordion header="سهولة الصيانة">
 
 يسهل تحديد نطاق محتوى التطبيق **الصيانة** للتطبيقات واسعة النطاق. يمكنك نسخ أو حذف مجلد ميزة واحد دون الحاجة لمراجعة كود المحتوى بالكامل. بالإضافة إلى ذلك، Intlayer **مكتوب بشكل كامل** لضمان دقة المحتوى الخاص بك.
@@ -41,25 +40,21 @@ author: aymericzip
 Intlayer أيضاً هو الحل ذو **التطوير الأكثر نشاطاً** في نظام i18n البيئي — تُصلح المشاكل بسرعة، وتُضاف محولات إطار عمل جديدة بانتظام، ويتم تحسين API الأساسي بناءً على ملاحظات الإنتاج الحقيقية.
 
 </Accordion>
-
 <Accordion header="وكيل ذكي">
 
 يقلل دمج المحتوى **السياق المطلوب** من نماذج اللغة الكبيرة (LLMs). يأتي Intlayer أيضاً مع مجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة، **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/mcp_server.md)**، و**[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة حتى للوكلاء الذكيين.
 
 </Accordion>
-
 <Accordion header="الأتمتة">
 
 استخدم الأتمتة للترجمة في خط أنابيب CI/CD الخاص بك باستخدام نموذج LLM من اختيارك بتكلفة موفر الذكاء الاصطناعي الخاص بك. يوفر Intlayer أيضاً **compiler** لأتمتة استخراج المحتوى، بالإضافة إلى [منصة ويب](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md) لمساعدتك على **الترجمة في الخلفية**.
 
 </Accordion>
-
 <Accordion header="الأداء">
 
 قد يؤدي ربط ملفات JSON الضخمة بالمكونات إلى مشاكل الأداء والاستجابة. يحسّن Intlayer تحميل المحتوى الخاص بك في وقت البناء.
 
 </Accordion>
-
 <Accordion header="التوسع مع غير المطورين">
 
 أكثر من مجرد حل i18n، يوفر Intlayer **[محرر مرئي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md)** ذاتي الاستضافة و**[CMS كامل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md)** لمساعدتك على إدارة محتواك متعدد اللغات في **الوقت الفعلي**، مما يجعل التعاون مع المترجمين والكتاب والأعضاء الآخرين في الفريق بسيطاً. يمكن تخزين المحتوى محلياً و/أو بعداً.
@@ -67,8 +62,6 @@ Intlayer أيضاً هو الحل ذو **التطوير الأكثر نشاطا
 </Accordion>
 </AccordionGroup>
 
----
-
 ## استراتيجيات الترحيل
 
 هناك استراتيجيتان متكاملتان للترحيل من `vue-i18n` إلى Intlayer:
@@ -79,20 +72,15 @@ Intlayer أيضاً هو الحل ذو **التطوير الأكثر نشاطا
 
 يغطي هذا الدليل **الاستراتيجية 1** أولاً (محول التوافق drop-in)، ثم يرشدك عبر الترحيل الكامل الاختياري.
 
----
-
 ## جدول المحتويات
 
 <TOC/>
 
----
-
 ## الترحيل السريع
 
 الخطوات التالية هي الحد الأدنى المطلوب لتشغيل تطبيق `vue-i18n` الموجود على Intlayer بدون تغيير الكود في المكونات.
 
 <Steps>
-
 <Step number={1} title="تثبيت التبعيات">
 
 قم بتثبيت حزم Intlayer الأساسية ومحول التوافق:
@@ -136,7 +124,6 @@ bun add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
 > يمكنك الاحتفاظ بـ `vue-i18n` مثبتة — يستخدم محول التوافق كـ `devDependency` / `peerDependency` لأنواع TypeScript.
 
 </Step>
-
 <Step number={2} title="تكوين Intlayer">
 
 ينشئ أمر `intlayer init` ملف `intlayer.config.ts` بدء. حدثّه ليطابق البيئات المحلية الموجودة لديك وأشر إلى مكوّن `syncJSON` في ملفات الرسائل الخاصة بك:
@@ -171,7 +158,6 @@ export default config;
 > **`source`** يعيّن بيئة محلية إلى مسار ملف JSON الخاص بها. **`location`** يخبر مراقب Intlayer أي مجلد للبحث عن التغييرات. يضمن الخيار `format: 'icu'` أن الملاصقات يتم تحليلها بشكل صحيح لـ `vue-i18n`.
 
 </Step>
-
 <Step number={3} title="إضافة مكوّن Intlayer إلى Bundler الخاص بك">
 
 غلّف تكوين bundler الموجود مع مكوّن التوافق. يُنشئ هذا مكوّن Intlayer الأساسي، ويوصل مراقبة المحتوى، و— بشكل حاسم — **يحقن اسم مستعار module** حتى استدعاءات `import … from 'vue-i18n'` الموجودة لديك تُعاد توجيهها بشفافية إلى `@intlayer/vue-i18n` في وقت البناء. لا يلزم تغيير ملفات المصدر.
@@ -222,14 +208,11 @@ export default defineNuxtConfig({
 > t("does.not.exist"); // ✗ خطأ TypeScript
 > ```
 
----
-
 ## الترحيل الكامل
 
 الخطوات أدناه اختيارية ويمكن إنجازها بشكل تدريجي. تفتح مجموعة ميزات Intlayer الكاملة: محرر مرئي، CMS، ملفات محتوى مكتوبة، ترجمة مدفوعة بالذكاء الاصطناعي، والمزيد.
 
 <Steps>
-
 <Step number={4} title="إعادة تسمية الاستيراد الصريحة (اختياري)" isOptional={true}>
 
 تتعامل مكوّنات Intlayer بالفعل مع الأسماء المستعارة على مستوى bundler. إذا كنت تفضل جعل التبعية صريحة في ملفات المصدر الخاصة بك، يمكنك إعادة تسمية الاستيرادات يدويياً:
@@ -242,7 +225,6 @@ export default defineNuxtConfig({
 هذه **بدائل drop-in** — لا تغييرات في توقيعات الدالة أو الحجج أو أنواع الإرجاع مطلوبة.
 
 </Step>
-
 <Step number={5} title="تفعيل أتمتة الترجمة المدفوعة بالذكاء الاصطناعي" isOptional={true}>
 
 بمجرد توصيل Intlayer، استخدم CLI الخاص به لملء الترجمات المفقودة تلقائياً:
@@ -304,8 +286,6 @@ export default config;
 
 </Steps>
 
----
-
 ## ما يمكنك حذفه بعد الترحيل
 
 بمجرد وضع محولات التوافق، يمكن إزالة نموذج `vue-i18n` التالي:
@@ -318,8 +298,6 @@ export default config;
 
 عندما تكون جاهزاً للمضي أبعد، يكتشف Intlayer **تلقائياً جميع ملفات `.content.ts` و `.content.json` في أي مكان في قاعدة الكود الخاصة بك** (افتراضياً، في أي مكان داخل `./src`). يمكنك وضع ملف `my-component.content.ts` بجانب `MyComponent.vue` مباشرة وسيلتقطه Intlayer في وقت البناء بدون تكوين إضافي — لا استيرادات، لا تسجيل، لا حاجة لملف فهرس مركزي. هذا يجعل دمج الترجمات مع الصفحات والمكونات بدون احتكاك تماماً.
 
----
-
 ## تكوين TypeScript
 
 يستخدم Intlayer module augmentation لتوفير intellisense TypeScript الكامل لمفاتيح الترجمة الخاصة بك. تأكد من أن `tsconfig.json` الخاص بك يتضمن الأنواع المُنتجة تلقائياً:
@@ -334,8 +312,6 @@ export default config;
 }
 ```
 
----
-
 ## تكوين Git
 
 أضف مجلد Intlayer المُنتج إلى `.gitignore` الخاص بك:
@@ -345,8 +321,6 @@ export default config;
 .intlayer
 ```
 
----
-
 ## اذهب أبعد
 
 - **محرر مرئي** — إدارة الترجمات بصرياً في متصفحك: [محرر Intlayer المرئي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md)

package/docs/ar/packages/@intlayer_babel/export.md

@@ -43,8 +43,6 @@ npm install @intlayer/babel
 import { ... } from "@intlayer/babel";
 ```
 
----
-
 ### الإضافات (Plugins)
 
 | الدالة / الفئة                 | الوصف                                                                                                                                                                           |
@@ -57,8 +55,6 @@ import { ... } from "@intlayer/babel";
 | `makeUsageAnalyzerBabelPlugin` | دالة مُنشِئة تُنتج إضافة Babel تُحلِّل استخدام `useIntlayer` / `getIntlayer` في الكود المصدري وتُجمِّع بيانات استخدام الحقول في `PruneContext` المُشترك.                        |
 | `getSharedPruneContext`        | دالة مساعدة تُعيد كائن `PruneContext` المُشترك للمجلد الأساسي المُحدَّد، أو `null` إن لم يُهيَّأ بعد.                                                                           |
 
----
-
 ### دوال إعداد الإضافات
 
 | الدالة                     | الوصف                                                                                                                               |
@@ -68,8 +64,6 @@ import { ... } from "@intlayer/babel";
 | `getPurgePluginOptions`    | تُحمِّل إعداد Intlayer وتُعيد خيارات `PurgePluginOptions` جاهزة للاستخدام مع `intlayerPurgeBabelPlugin`.                            |
 | `getMinifyPluginOptions`   | تُحمِّل إعداد Intlayer وتُعيد خيارات `MinifyPluginOptions` جاهزة للاستخدام مع `intlayerMinifyBabelPlugin`.                          |
 
----
-
 ### الأنواع
 
 | النوع                   | الوصف                                                                                                   |
@@ -87,8 +81,6 @@ import { ... } from "@intlayer/babel";
 | `CompatCallerConfig`    | إعداد مُحلِّل استخدام مُتوافق لحزم الـ compat-adapter (اسم المُستدعي وخيارات المعالجة).                 |
 | `ScriptBlock`           | كتلة script مستخرجة من ملف SFC (Vue أو Svelte): المحتوى وإزاحتا البداية والنهاية.                       |
 
----
-
 ### الأدوات المساعدة
 
 | الدالة                            | الوصف                                                                                                                            |
@@ -100,8 +92,6 @@ import { ... } from "@intlayer/babel";
 | `BABEL_PARSER_OPTIONS`            | ثابت يُمثِّل خيارات مُحلِّل Babel تُغطي مجموعة الأُطر المدعومة (React/Vue/Svelte/Angular/…).                                     |
 | `INTLAYER_CALLER_NAMES`           | قائمة ثابتة بأسماء المُستدعِيين الأصلية لـ Intlayer: `['useIntlayer', 'getIntlayer']`.                                           |
 
----
-
 ## مثال على الاستخدام
 
 ```js

package/docs/ar/packages/adonis-intlayer/t.md

@@ -27,14 +27,10 @@ author: aymericzip
 
 تعد دالة `t` في حزمة `adonis-intlayer` الأداة الأساسية لتوفير استجابات مترجمة في تطبيق AdonisJS الخاص بك. فهي تبسط عملية التدويل (i18n) من خلال اختيار المحتوى ديناميكيًا بناءً على اللغة المفضلة للمستخدم.
 
----
-
 ## نظرة عامة
 
 تُستخدم دالة `t` لتعريف واسترجاع الترجمات لمجموعة معينة من اللغات. وهي تحدد تلقائيًا اللغة المناسبة للإرجاع بناءً على إعدادات طلب العميل، مثل عنوان `Accept-Language`. إذا كانت اللغة المفضلة غير متوفرة، فإنها تعود بسلاسة إلى اللغة الافتراضية المحددة في التكوين الخاص بك.
 
----
-
 ## الميزات الرئيسية
 
 - **التوطين الديناميكي**: تختار تلقائيًا الترجمة الأكثر ملاءمة للعميل.
@@ -42,8 +38,6 @@ author: aymericzip
 - **السياق غير المتزامن**: تعمل بسلاسة ضمن دورة حياة طلب AdonisJS باستخدام Async Local Storage.
 - **دعم TypeScript**: تفرض سلامة النوع لترجماتك.
 
----
-
 ## توقيع الدالة
 
 ```typescript
@@ -58,8 +52,6 @@ t(translations: Record<string, any>): any;
 
 - المحتوى الذي يمثل اللغة المفضلة للعميل.
 
----
-
 ## تحميل الوسيط (Middleware)
 
 لضمان عمل دالة `t` بشكل صحيح، **يجب** عليك تسجيل وسيط `intlayer` في تطبيق AdonisJS الخاص بك.
@@ -68,8 +60,6 @@ t(translations: Record<string, any>): any;
 router.use([() => import("adonis-intlayer/middleware")]);
 ```
 
----
-
 ## أمثلة الاستخدام
 
 ### مثال أساسي
@@ -105,8 +95,6 @@ export default class ExampleController {
 }
 ```
 
----
-
 ## مواضيع متقدمة
 
 ### آلية الرجوع (Fallback Mechanism)

package/docs/ar/packages/express-intlayer/t.md

@@ -28,14 +28,10 @@ author: aymericzip
 
 تُعد دالة `t` في حزمة `express-intlayer` الأداة الأساسية لتوفير استجابات مترجمة في تطبيق Express الخاص بك. فهي تُبسّط التدويل (i18n) من خلال اختيار المحتوى ديناميكيًا بناءً على اللغة المفضلة للمستخدم.
 
----
-
 ## نظرة عامة
 
 تُستخدم دالة `t` لتعريف واسترجاع الترجمات لمجموعة معينة من اللغات. حيث تحدد تلقائيًا اللغة المناسبة للإرجاع بناءً على إعدادات طلب العميل، مثل رأس `Accept-Language`. وإذا لم تكن اللغة المفضلة متاحة، فإنها تعود بسلاسة إلى اللغة الافتراضية المحددة في تكوينك.
 
----
-
 ## الميزات الرئيسية
 
 - **التوطين الديناميكي**: تختار تلقائيًا الترجمة الأنسب للعميل.
@@ -43,8 +39,6 @@ author: aymericzip
 - **خفيف وسريع**: مصمم للتطبيقات عالية الأداء، مما يضمن الحد الأدنى من التحميل.
 - **دعم الوضع الصارم**: فرض الالتزام الصارم باللغات المعلنة لسلوك موثوق.
 
----
-
 ## توقيع الدالة
 
 ```typescript
@@ -59,8 +53,6 @@ t(translations: Record<string, string>): string;
 
 - نص يمثل المحتوى باللغة المفضلة للعميل.
 
----
-
 ## تحميل معالج طلبات التدويل
 
 لضمان عمل وظيفة التدويل التي يوفرها `express-intlayer` بشكل صحيح، يجب عليك **تحميل وسيط التدويل** في بداية تطبيق Express الخاص بك. هذا يتيح وظيفة `t` ويضمن التعامل الصحيح مع اكتشاف اللغة والترجمة.
@@ -94,8 +86,6 @@ app.get("/", (_req, res) => {
 - **سياق الترجمة**: يقوم بإعداد السياق اللازم لوظيفة `t` للعمل بشكل صحيح، مما يضمن أن الترجمات تُعاد باللغة الصحيحة.
 - **منع الأخطاء**: بدون هذا الوسيط، استخدام وظيفة `t` سيؤدي إلى أخطاء وقت التشغيل لأن معلومات اللغة اللازمة لن تكون متاحة.
 
----
-
 ## أمثلة الاستخدام
 
 ### مثال أساسي
@@ -136,8 +126,6 @@ app.get("/error", (_req, res) => {
 });
 ```
 
----
-
 ### استخدام المتغيرات المحلية
 
 حدد الترجمات للمتغيرات الخاصة بالمحلية:
@@ -184,8 +172,6 @@ app.get("/greet", (_req, res) => {
 });
 ```
 
----
-
 ## مواضيع متقدمة
 
 ### آلية التراجع
@@ -210,8 +196,6 @@ export default config;
 - إذا كانت `defaultLocale` هي `Locales.CHINESE` وطلب العميل `Locales.DUTCH`، فسيتم إرجاع الترجمة الافتراضية لقيمة `Locales.CHINESE`.
 - إذا لم يتم تعريف `defaultLocale`، فستعود دالة `t` إلى قيمة `Locales.ENGLISH`.
 
----
-
 ### فرض وضع الصرامة
 
 قم بتكوين دالة `t` لفرض الالتزام الصارم باللغات المعلنة:
@@ -238,8 +222,6 @@ const config = {
 export default config;
 ```
 
----
-
 ### تكامل TypeScript
 
 دالة `t` آمنة من حيث النوع عند استخدامها مع TypeScript. عرّف كائن ترجمات آمن من حيث النوع:
@@ -258,8 +240,6 @@ app.get("/morning", (_req, res) => {
 });
 ```
 
----
-
 ### الأخطاء الشائعة واستكشاف الأخطاء وإصلاحها
 
 | المشكلة             | السبب                                  | الحل                                                    |
@@ -267,8 +247,6 @@ app.get("/morning", (_req, res) => {
 | دالة `t` لا تعمل    | لم يتم تحميل الوسيط (middleware)       | تأكد من إضافة `app.use(intlayer())` قبل تعريف المسارات. |
 | خطأ في نقص الترجمات | تم تفعيل الوضع الصارم بدون جميع اللغات | قم بتوفير جميع الترجمات المطلوبة.                       |
 
----
-
 ## نصائح للاستخدام الفعال
 
 1. **مركزة الترجمات**: استخدم وحدة مركزية أو ملفات JSON لإدارة الترجمات لتحسين سهولة الصيانة.
@@ -276,8 +254,6 @@ app.get("/morning", (_req, res) => {
 3. **الدمج مع التدويل في الواجهة الأمامية**: قم بمزامنة التدويل في الواجهة الأمامية لتوفير تجربة مستخدم سلسة عبر التطبيق.
 4. **قياس الأداء**: اختبر أوقات استجابة تطبيقك عند إضافة الترجمات لضمان تأثير ضئيل.
 
----
-
 ## الخاتمة
 
 تُعد دالة `t` أداة قوية للتدويل في جانب الخادم. باستخدامها بشكل فعال، يمكنك إنشاء تطبيق أكثر شمولية وسهل الاستخدام لجمهور عالمي. للاستخدام المتقدم وخيارات التكوين التفصيلية، يرجى الرجوع إلى [التوثيق](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).

package/docs/ar/packages/hono-intlayer/t.md

@@ -27,14 +27,10 @@ author: aymericzip
 
 دالة `t` في حزمة `hono-intlayer` هي الأداة الأساسية لتقديم ردود محلية في تطبيق Hono الخاص بك. فهي تبسط عملية التدويل (i18n) من خلال اختيار المحتوى ديناميكيًا بناءً على اللغة المفضلة للمستخدم.
 
----
-
 ## نظرة عامة
 
 تُستخدم دالة `t` لتعريف واسترجاع الترجمات لمجموعة معينة من اللغات. وهي تحدد تلقائيًا اللغة المناسبة للإرجاع بناءً على إعدادات طلب العميل، مثل عنوان `Accept-Language`. إذا كانت اللغة المفضلة غير متوفرة، فإنها تعود بسلاسة إلى اللغة الافتراضية المحددة في التكوين الخاص بك.
 
----
-
 ## الميزات الرئيسية
 
 - **التوطين الديناميكي**: تختار تلقائيًا الترجمة الأكثر ملاءمة للعميل.
@@ -42,8 +38,6 @@ author: aymericzip
 - **خفيفة وسريعة**: مصممة للتطبيقات عالية الأداء، مما يضمن أقل قدر من الحمل الإضافي.
 - **دعم الوضع الصارم**: فرض الالتزام الصارم باللغات المعلنة لسلوك موثوق.
 
----
-
 ## توقيع الدالة
 
 ```typescript
@@ -58,8 +52,6 @@ t(translations: Record<string, string>): string;
 
 - سلسلة نصية تمثل المحتوى بالغة المفضلة للعميل.
 
----
-
 ## تحميل معالج طلبات التدويل
 
 لضمان عمل وظيفة التدويل التي توفرها `hono-intlayer` بشكل صحيح، **يجب** عليك تحميل الوسيط (middleware) الخاص بالتدويل في بداية تطبيق Hono الخاص بك. هذا يفعل دالة `t` ويضمن المعالجة السليمة لاكتشاف اللغة والترجمة.
@@ -94,8 +86,6 @@ app.get("/", (c) => {
 - **سياق الترجمة**: يقوم بإعداد السياق اللازم لتعمل دالة `t` بشكل صحيح، مما يضمن إرجاع الترجمات باللغة الصحيحة.
 - **منع الأخطاء**: بدون هذا الوسيط، سيؤدي استخدام دالة `t` إلى أخطاء في وقت التشغيل لأن معلومات اللغة اللازمة لن تكون متوفرة.
 
----
-
 ## أمثلة الاستخدام
 
 ### مثال أساسي
@@ -137,8 +127,6 @@ app.get("/error", (c) => {
 });
 ```
 
----
-
 ### استخدام متغيرات اللغة
 
 تحديد ترجمات لمتغيرات خاصة باللغة:
@@ -156,8 +144,6 @@ app.get("/greet", (c) => {
 });
 ```
 
----
-
 ## مواضيع متقدمة
 
 ### آلية العودة (Fallback)
@@ -177,8 +163,6 @@ const config = {
 export default config;
 ```
 
----
-
 ### فرض الوضع الصارم
 
 تكوين دالة `t` لفرض الالتزام الصارم باللغات المعلنة:
@@ -189,8 +173,6 @@ export default config;
 | `inclusive` | يجب أن تحتوي اللغات المعلنة على ترجمات. اللغات المفقودة تثير تحذيرات ولكن يتم قبولها. |
 | `loose`     | يتم قبول أي لغة موجودة، حتى لو لم يتم الإعلان عنها.                                   |
 
----
-
 ### تكامل TypeScript
 
 دالة `t` آمنة من حيث النوع عند استخدامها مع TypeScript. قم بتعريف كائن ترجمات آمن النوع:
@@ -209,8 +191,6 @@ app.get("/morning", (c) => {
 });
 ```
 
----
-
 ### الأخطاء الشائعة واستكشاف الأخطاء وإصلاحها
 
 | المشكلة                 | السبب                                  | الحل                                                   |
@@ -218,8 +198,6 @@ app.get("/morning", (c) => {
 | دالة `t` لا تعمل        | لم يتم تحميل الوسيط                    | تأكد من إضافة `app.use("*", intlayer())` قبل المسارات. |
 | خطأ في الترجمة المفقودة | تم تمكين الوضع الصارم بدون جميع اللغات | قم بتقديم جميع الترجمات المطلوبة.                      |
 
----
-
 ## الخاتمة
 
 دالة `t` هي أداة قوية لتدويل الواجهة الخلفية. من خلال استخدامها بفعالية، يمكنك إنشاء تطبيق أكثر شمولاً وسهولة في الاستخدام لجمهور عالمي. للحصول على استخدام متقدم وخيارات تكوين مفصلة، راجع [التوثيق](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md).

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

@@ -45,8 +45,6 @@ author: aymericzip
 - تتسامح مع غياب الشرطات المائلة البادئة والقيم الفارغة (يتم تسويتها إلى `/`)
 - خفيفة الوزن — مبنية على `getPathWithoutLocale`
 
----
-
 ## توقيع الدالة
 
 ```typescript
@@ -62,8 +60,6 @@ normalizePath(
 ): string
 ```
 
----
-
 ## المعلمات (Parameters)
 
 - `pathname: string`
@@ -86,8 +82,6 @@ normalizePath(
 - **النوع**: `boolean`
 - **الوصف**: `true` عندما يتم حل كلا الإدخالين إلى نفس المسار المستقل عن اللغة، وإلا `false`.
 
----
-
 ## مثال على الاستخدام
 
 ### الاستخدام الأساسي
@@ -132,8 +126,6 @@ const NavLink = ({ href, children }) => {
 };
 ```
 
----
-
 ## normalizePath
 
 تقوم `normalizePath` بإرجاع المسار القياسي والمستقل عن اللغة الذي تستخدمه `comparePaths`. تقوم بإزالة جزء اللغة، البروتوكول/المضيف، سلسلة الاستعلام، والتجزئة، وتضمن وجود شرطة مائلة بادئة واحدة، وتزيل أي شرطات مائلة ختامية (باستثناء الجذر)، وتستخدم `/` كقيمة احتياطية للقيم الفارغة.
@@ -150,16 +142,12 @@ normalizePath(""); // "/"
 normalizePath("https://example.com/ru/path"); // "/path"
 ```
 
----
-
 ## دوال ذات صلة
 
 - [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPathWithoutLocale.md): يزيل جزء اللغة من عنوان URL أو مسار.
 - [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getPrefix.md): يحدد بادئة URL للغة معينة.
 - [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocalizedUrl.md): يولد عنوان URL محلي للغة معينة.
 
----
-
 ## TypeScript
 
 ```typescript

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

@@ -37,8 +37,6 @@ author: aymericzip
 - تطابق المسارات المموّلة حسب اللغة مع قواعد إعادة الكتابة المخصصة المعرفة في إعداداتك.
 - تعيد المسار الأصلي إذا لم يتم العثور على قاعدة إعادة كتابة مطابقة.
 
----
-
 ## توقيع الدالة
 
 ```typescript
@@ -49,8 +47,6 @@ getCanonicalPath(
 ): string
 ```
 
----
-
 ## المعلمات
 
 ### المعلمات المطلوبة
@@ -72,15 +68,11 @@ getCanonicalPath(
   - **النوع**: `RoutingConfig['rewrite']`
   - **الافتراضي**: `configuration.routing.rewrite`
 
----
-
 ## القيمة المرجعة
 
 - **النوع**: `string`
 - **الوصف**: المسار الرسمي الداخلي.
 
----
-
 ## مثال على الاستخدام
 
 ### الاستخدام الأساسي (مع التكوين)
@@ -126,8 +118,6 @@ getCanonicalPath("/contactez-nous", Locales.FRENCH, manualRules);
 // الناتج: "/contact"
 ```
 
----
-
 ## الدوال ذات الصلة
 
 - [`getLocalizedPath`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocalizedPath.md): يحوّل مسارًا canonical إلى ما يعادله محليًا.