@intlayer/docs 6.1.6-canary.0 → 7.0.0-canary.0

package/docs/ar/dictionary/file.md

@@ -16,6 +16,10 @@ slugs:
   - concept
   - content
   - file
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: بداية التاريخ
 ---
 
 # محتوى الملف / تضمين الملفات في Intlayer
@@ -220,7 +224,3 @@ const myMultilingualContent = {
 - [توثيق محتوى الترجمة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/translation.md)
 
 توفر هذه الموارد رؤى إضافية حول تضمين الملفات، إدارة المحتوى، وتكامل Intlayer مع أُطُر العمل المختلفة.
-
-## تاريخ الوثيقة
-
-- 5.5.10 - 2025-06-29: بداية التاريخ

package/docs/ar/dictionary/function_fetching.md

@@ -16,6 +16,10 @@ slugs:
   - concept
   - content
   - function-fetching
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: بداية السجل
 ---
 
 # جلب الدوال
@@ -210,7 +214,3 @@ const MyComponent = () => {
 
 module.exports = MyComponent;
 ```
-
-## تاريخ الوثيقة
-
-- 5.5.10 - 2025-06-29: بداية السجل

package/docs/ar/dictionary/gender.md

@@ -16,6 +16,10 @@ slugs:
   - concept
   - content
   - gender
+history:
+  - version: 5.7.2
+    date: 2025-07-27
+    changes: تقديم المحتوى المعتمد على الجنس
 ---
 
 # المحتوى القائم على النوع الاجتماعي / النوع في Intlayer
@@ -267,9 +271,3 @@ module.exports = GenderComponent;
 - [توثيق Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_15.md)
 
 توفر هذه الموارد رؤى إضافية حول إعداد واستخدام Intlayer عبر بيئات وأُطُر عمل مختلفة.
-
-## تاريخ الوثيقة
-
-| الإصدار | التاريخ    | التغييرات                       |
-| ------- | ---------- | ------------------------------- |
-| 5.7.2   | 2025-07-27 | تقديم المحتوى المعتمد على الجنس |

package/docs/ar/dictionary/insertion.md

@@ -16,6 +16,10 @@ slugs:
   - concept
   - content
   - insertion
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: بداية التاريخ
 ---
 
 # محتوى الإدراج / الإدراج في Intlayer
@@ -179,7 +183,3 @@ module.exports = InsertionComponent;
 - [توثيق Next Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_15.md)
 
 تقدم هذه الموارد رؤى إضافية حول إعداد واستخدام Intlayer عبر بيئات وأُطُر عمل مختلفة.
-
-## تاريخ الوثيقة
-
-- 5.5.10 - 2025-06-29: بداية التاريخ

package/docs/ar/dictionary/translation.md

@@ -16,6 +16,10 @@ slugs:
   - concept
   - content
   - translation
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: بداية السجل
 ---
 
 # الترجمة
@@ -312,7 +316,3 @@ module.exports = {
   }
 }
 ```
-
-## تاريخ الوثيقة
-
-- 5.5.10 - 2025-06-29: بداية السجل

package/docs/ar/formatters.md

@@ -18,6 +18,25 @@ keywords:
 slugs:
   - doc
   - formatters
+history:
+  - version: 5.8.0
+    date: 2025-08-20
+    changes: إضافة منسقات vue
+  - version: 5.8.0
+    date: 2025-08-18
+    changes: إضافة توثيق المنسقات
+  - version: 5.8.0
+    date: 2025-08-20
+    changes: إضافة توثيق منسق القوائم
+  - version: 5.8.0
+    date: 2025-08-20
+    changes: إضافة أدوات Intl إضافية (DisplayNames، Collator، PluralRules)
+  - version: 5.8.0
+    date: 2025-08-20
+    changes: إضافة أدوات التعامل مع اللغة (getLocaleName، getLocaleLang، getLocaleFromPath، إلخ)
+  - version: 5.8.0
+    date: 2025-08-20
+    changes: إضافة أدوات التعامل مع المحتوى (getContent، getTranslation، getIntlayer، إلخ)
 ---
 
 # أدوات تنسيق Intlayer
@@ -46,7 +65,6 @@ import {
   getLocalizedUrl,
   getHTMLTextDir,
   getContent,
-  getLocalisedContent,
   getTranslation,
   getIntlayer,
   getIntlayerAsync,
@@ -256,26 +274,6 @@ const content = getContent(
 - **nodeProps**: خصائص سياق التحويل
 - **locale**: اللغة الاختيارية (افتراضيًا إلى اللغة الافتراضية المُعدة)
 
-### `getLocalisedContent(node, locale, nodeProps, fallback?)`
-
-يقوم بتحويل عقدة المحتوى باستخدام إضافة الترجمة فقط:
-
-```ts
-import { getLocalisedContent } from "intlayer";
-
-const content = getLocalisedContent(
-  contentNode,
-  "fr",
-  { dictionaryKey: "common" },
-  true // الرجوع إلى اللغة الافتراضية إذا لم تتوفر الترجمة
-);
-```
-
-- **node**: عقدة المحتوى التي سيتم تحويلها
-- **locale**: اللغة المستخدمة للترجمة
-- **nodeProps**: خصائص سياق التحويل
-- **fallback**: ما إذا كان يجب الرجوع إلى اللغة الافتراضية (الافتراضي هو false)
-
 ### `getTranslation(languageContent, locale?, fallback?)`
 
 يستخرج المحتوى للغة معينة من كائن محتوى متعدد اللغات:
@@ -507,7 +505,6 @@ import {
   getLocalizedUrl,
   getHTMLTextDir,
   getContent,
-  getLocalisedContent,
   getTranslation,
   getIntlayer,
   getIntlayerAsync,
@@ -612,14 +609,3 @@ import {
 ```
 
 > ستأخذ هذه التركيبات في الاعتبار اللغة من `IntlayerProvider` المحقون
-
-## تاريخ الوثيقة
-
-| الإصدار | التاريخ    | التغييرات                                                                           |
-| ------- | ---------- | ----------------------------------------------------------------------------------- |
-| 5.8.0   | 2025-08-20 | إضافة منسقات vue                                                                    |
-| 5.8.0   | 2025-08-18 | إضافة توثيق المنسقات                                                                |
-| 5.8.0   | 2025-08-20 | إضافة توثيق منسق القوائم                                                            |
-| 5.8.0   | 2025-08-20 | إضافة أدوات Intl إضافية (DisplayNames، Collator، PluralRules)                       |
-| 5.8.0   | 2025-08-20 | إضافة أدوات التعامل مع اللغة (getLocaleName، getLocaleLang، getLocaleFromPath، إلخ) |
-| 5.8.0   | 2025-08-20 | إضافة أدوات التعامل مع المحتوى (getContent، getTranslation، getIntlayer، إلخ)       |

package/docs/ar/how_works_intlayer.md

@@ -13,6 +13,10 @@ slugs:
   - doc
   - concept
   - how-works-intlayer
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: بدء التاريخ
 ---
 
 # كيف يعمل Intlayer
@@ -87,7 +91,7 @@ const MyComponent = () => {
 
 يوفر 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)
+![المحرر المرئي](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif?raw=true)
 
 - الخادم هو تطبيق Express بسيط يستمع إلى الطلبات من العميل ويسترجع محتوى تطبيقك، مثل `dictionaries` والتكوين لجعله متاحًا على جانب العميل.
 - من ناحية أخرى، العميل هو تطبيق React يُستخدم للتفاعل مع المحتوى الخاص بك باستخدام واجهة مرئية.
@@ -243,7 +247,3 @@ const MyComponent = () => {
 ## تحدث مع وثائقنا الذكية
 
 - [اطرح أسئلتك على وثائقنا الذكية](https://intlayer.org/doc/chat)
-
-## تاريخ الوثيقة
-
-- 5.5.10 - 2025-06-29: بدء التاريخ

package/docs/ar/index.md

@@ -16,6 +16,10 @@ keywords:
 slugs:
   - doc
   - index
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: بداية التاريخ
 ---
 
 # توثيق Intlayer
@@ -158,7 +162,3 @@ slugs:
 نحن نقدر قوة المصادر المفتوحة والتطوير المدفوع من قبل المجتمع. إذا كنت ترغب في اقتراح تحسينات، أو إضافة دليل جديد، أو تصحيح أي مشاكل في مستنداتنا، فلا تتردد في تقديم طلب سحب (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

@@ -12,6 +12,13 @@ keywords:
 slugs:
   - doc
   - why
+history:
+  - version: 5.8.0
+    date: 2025-08-19
+    changes: تحديث جدول المقارنة
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: بدء التاريخ
 ---
 
 # لماذا يجب أن تفكر في Intlayer؟
@@ -258,10 +265,3 @@ const ComponentExample = () => {
 | **تحليل الشجرة (تحميل المحتوى المستخدم فقط)**          | نعم، لكل مكون أثناء وقت البناء عبر إضافات Babel/SWC                                                                       | عادةً ما يتم تحميل الكل (يمكن تحسينه باستخدام المساحات الاسمية/تقسيم الكود) | عادةً ما يتم تحميل الكل                | ليس افتراضيًا                         | جزئي                                  | جزئي                                  | جزئي (مع تقسيم الكود/إعداد يدوي)                       |
 | **التحميل الكسول**                                     | نعم، لكل لغة/لكل مكون                                                                                                     | نعم (مثل الخلفيات/الأسماء عند الطلب)                                        | نعم (تقسيم حزم اللغة)                  | نعم (استيراد الكتالوجات الديناميكي)   | نعم (لكل مسار/لكل لغة)                | نعم (لكل مسار/لكل لغة)                | نعم (رسائل اللغة غير المتزامنة)                        |
 | **إدارة المشاريع الكبيرة**                             | يشجع على التصميم المعياري، مناسب لنظام التصميم                                                                            | يحتاج إلى انضباط جيد في الملفات                                             | يمكن أن تصبح الكتالوجات المركزية كبيرة | قد تصبح معقدة                         | معياري مع الإعداد                     | معياري مع الإعداد                     | معياري مع إعداد Vue Router/Nuxt i18n                   |
-
-## تاريخ الوثيقة
-
-| الإصدار | التاريخ    | التغييرات           |
-| ------- | ---------- | ------------------- |
-| 5.8.0   | 2025-08-19 | تحديث جدول المقارنة |
-| 5.5.10  | 2025-06-29 | بدء التاريخ         |

package/docs/ar/intlayer_CMS.md

@@ -17,6 +17,16 @@ slugs:
   - concept
   - cms
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
+history:
+  - version: 6.0.1
+    date: 2025-09-22
+    changes: إضافة توثيق المزامنة الحية
+  - version: 6.0.0
+    date: 2025-09-04
+    changes: استبدال حقل `hotReload` بـ `liveSync`
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: بدء السجل
 ---
 
 # توثيق نظام إدارة المحتوى Intlayer (CMS)
@@ -521,11 +531,3 @@ module.exports = config;
 - تأكد من أن تكوين المشروع تم دفعه إلى نظام إدارة محتوى Intlayer.
 
 - يستخدم المحرر المرئي إطار iframe لعرض موقعك الإلكتروني. تأكد من أن سياسة أمان المحتوى (CSP) لموقعك تسمح بعنوان URL الخاص بنظام إدارة المحتوى كـ `frame-ancestors` ('https://intlayer.org' بشكل افتراضي). تحقق من وحدة تحكم المحرر لأي أخطاء.
-
-## تاريخ الوثيقة
-
-| الإصدار | التاريخ    | التغييرات                             |
-| ------- | ---------- | ------------------------------------- |
-| 6.0.1   | 2025-09-22 | إضافة توثيق المزامنة الحية            |
-| 6.0.0   | 2025-09-04 | استبدال حقل `hotReload` بـ `liveSync` |
-| 5.5.10  | 2025-06-29 | بدء السجل                             |

package/docs/ar/intlayer_cli.md

@@ -16,6 +16,13 @@ slugs:
   - doc
   - concept
   - cli
+history:
+  - version: 5.5.11
+    date: 2025-07-11
+    changes: تحديث توثيق معلمات أوامر CLI
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: بدء السجل
 ---
 
 # واجهة الأوامر Intlayer CLI
@@ -564,10 +571,3 @@ npx intlayer dictionary build --help    # يعرض قائمة الخيارات
 ```bash
 npx clear-npx-cache
 ```
-
-## سجل التوثيق
-
-| الإصدار | التاريخ    | التغييرات                    |
-| ------- | ---------- | ---------------------------- |
-| 5.5.11  | 2025-07-11 | تحديث توثيق معلمات أوامر CLI |
-| 5.5.10  | 2025-06-29 | بدء السجل                    |

package/docs/ar/intlayer_visual_editor.md

@@ -16,6 +16,10 @@ slugs:
   - concept
   - editor
 youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: بدء السجل
 ---
 
 # وثائق محرر Intlayer البصري
@@ -24,7 +28,7 @@ youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 
 محرر Intlayer البصري هو أداة تقوم بتغليف موقعك الإلكتروني للتفاعل مع ملفات إعلان المحتوى الخاصة بك باستخدام محرر بصري.
 
-![واجهة محرر Intlayer البصري](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif)
+![واجهة محرر Intlayer البصري](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif?raw=true)
 
 حزمة `intlayer-editor` مبنية على Intlayer ومتاحة لتطبيقات JavaScript، مثل React (Create React App)، Vite + React، و Next.js.
 
@@ -261,7 +265,3 @@ pnpm intlayer-editor start -e development
     - يجب أن يتطابق عنوان URL للتطبيق مع الذي قمت بتعيينه في تكوين المحرر (`applicationURL`).
 
 - يستخدم المحرر المرئي iframe لعرض موقعك الإلكتروني. تأكد من أن سياسة أمان المحتوى (CSP) لموقعك تسمح بعنوان URL الخاص بنظام إدارة المحتوى (CMS) كـ `frame-ancestors` ('http://localhost:8000' بشكل افتراضي). تحقق من وحدة تحكم المحرر لأي أخطاء.
-
-## سجل الوثائق
-
-- 5.5.10 - 2025-06-29: بدء السجل

package/docs/ar/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-06-29
-title: ترجم موقعك الإلكتروني Angular (i18n)
+title: كيفية ترجمة تطبيق Angular – دليل i18n 2025
 description: اكتشف كيفية جعل موقعك الإلكتروني باستخدام Angular متعدد اللغات. اتبع الوثائق لتدويله (i18n) وترجمته.
 keywords:
   - التدويل
@@ -14,9 +14,13 @@ slugs:
   - environment
   - angular
 applicationTemplate: https://github.com/aymericzip/intlayer-angular-template
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: بداية التاريخ
 ---
 
-# البدء مع التدويل (i18n) في Angular باستخدام Intlayer
+# ترجم Angular باستخدام Intlayer | التدويل (i18n)
 
 > هذه الحزمة قيد التطوير. راجع [المشكلة](https://github.com/aymericzip/intlayer/issues/116) لمزيد من المعلومات. أظهر اهتمامك بـ Intlayer لـ Angular من خلال الإعجاب بالمشكلة
 
@@ -633,9 +637,9 @@ For more complex scenarios, you can create a pipe to safely render the HTML.
 
 يستخدم Intlayer توسيع الوحدات (module augmentation) للاستفادة من TypeScript وجعل قاعدة الشيفرة الخاصة بك أقوى.
 
-![alt text](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png)
+![Autocompletion](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
 
-![alt text](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png)
+![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
 
 تأكد من أن تكوين TypeScript الخاص بك يتضمن الأنواع التي تم إنشاؤها تلقائيًا.
 
@@ -681,7 +685,3 @@ For more complex scenarios, you can create a pipe to safely render the HTML.
 للتعمق أكثر، يمكنك تنفيذ [المحرر المرئي](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).
 
 ---
-
-## تاريخ الوثيقة
-
-- 5.5.10 - 2025-06-29: بداية التاريخ

package/docs/ar/intlayer_with_astro.md

@@ -0,0 +1,244 @@
+---
+createdAt: 2024-03-07
+updatedAt: 2025-10-03
+title: كيفية ترجمة تطبيق Astro – دليل i18n 2025
+description: تعلّم كيفية إضافة التدويل (i18n) إلى تطبيق Vite و React الخاص بك باستخدام Intlayer. اتبع هذا الدليل لجعل تطبيقك متعدد اللغات.
+keywords:
+  - التدويل
+  - التوثيق
+  - Intlayer
+  - Vite
+  - React
+  - i18n
+  - جافا سكريبت
+slugs:
+  - doc
+  - environment
+  - astro
+applicationTemplate: https://github.com/aymericzip/intlayer-astro-template
+history:
+  - version: 6.2.0
+    date: 2025-10-03
+    changes: تحديث لتكامل Astro، الإعدادات، الاستخدام
+---
+
+# ترجم Astro باستخدام Intlayer | التدويل (i18n)
+
+راجع [قالب التطبيق](https://github.com/aymericzip/intlayer-astro-template) على GitHub.
+
+## ما هو Intlayer؟
+
+**Intlayer** هي مكتبة تدويل (i18n) مبتكرة ومفتوحة المصدر مصممة لتبسيط دعم اللغات المتعددة في تطبيقات الويب الحديثة.
+
+مع Intlayer، يمكنك:
+
+- **إدارة الترجمات بسهولة** باستخدام قواميس إعلانية على مستوى المكونات.
+- **توطين البيانات الوصفية والمسارات والمحتوى بشكل ديناميكي**.
+- **ضمان دعم TypeScript** من خلال أنواع مولدة تلقائيًا، مما يحسن الإكمال التلقائي واكتشاف الأخطاء.
+- **الاستفادة من ميزات متقدمة**، مثل الكشف الديناميكي عن اللغة وتبديلها.
+
+---
+
+## دليل خطوة بخطوة لإعداد Intlayer في Astro
+
+### الخطوة 1: تثبيت التبعيات
+
+قم بتثبيت الحزم اللازمة باستخدام مدير الحزم الخاص بك:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer
+# Optional: add React island support
+npm install react react-dom react-intlayer @astrojs/react
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer astro-intlayer
+# اختياري: إضافة دعم React island
+pnpm add react react-dom react-intlayer @astrojs/react
+```
+
+```bash packageManager="yarn"
+yarn add intlayer astro-intlayer
+# اختياري: إضافة دعم React island
+yarn add react react-dom react-intlayer @astrojs/react
+```
+
+- **intlayer**
+  الحزمة الأساسية التي توفر أدوات التدويل لإدارة التكوين، والترجمة، و[إعلان المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/get_started.md)، والترجمة البرمجية، و[أوامر CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_cli.md).
+
+- **astro-intlayer**
+  يتضمن مكون التكامل الخاص بـ Astro لدمج Intlayer مع [مجمّع Vite](https://vite.dev/guide/why.html#why-bundle-for-production)، بالإضافة إلى وسيط برمجي لاكتشاف اللغة المفضلة للمستخدم، وإدارة ملفات تعريف الارتباط، والتعامل مع إعادة توجيه عناوين URL.
+
+### الخطوة 2: تكوين مشروعك
+
+أنشئ ملف تكوين لتحديد لغات تطبيقك:
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [
+      Locales.ENGLISH,
+      Locales.FRENCH,
+      Locales.SPANISH,
+      // لغات أخرى خاصة بك
+    ],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+> من خلال ملف التكوين هذا، يمكنك إعداد عناوين URL المحلية، إعادة توجيه الوسيط، أسماء ملفات تعريف الارتباط، موقع وامتداد إعلانات المحتوى الخاصة بك، تعطيل سجلات Intlayer في وحدة التحكم، والمزيد. للحصول على قائمة كاملة بالمعلمات المتاحة، راجع [توثيق التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).
+
+### الخطوة 3: دمج Intlayer في تكوين Astro الخاص بك
+
+أضف مكون intlayer الإضافي إلى تكوينك.
+
+```typescript fileName="astro.config.ts"
+// @ts-check
+
+import { intlayer } from "astro-intlayer";
+import { defineConfig } from "astro/config";
+
+// https://astro.build/config
+export default defineConfig({
+  integrations: [intlayer()],
+});
+```
+
+> يتم استخدام مكون intlayer() الإضافي لتكامل Intlayer مع Astro. يضمن بناء ملفات إعلان المحتوى ومراقبتها في وضع التطوير. كما يحدد متغيرات بيئة Intlayer داخل تطبيق Astro. بالإضافة إلى ذلك، يوفر ألقابًا لتحسين الأداء.
+
+### الخطوة 4: إعلان المحتوى الخاص بك
+
+قم بإنشاء وإدارة إعلانات المحتوى الخاصة بك لتخزين الترجمات:
+
+```tsx fileName="src/app.content.tsx"
+import { t, type Dictionary } from "intlayer";
+import type { ReactNode } from "react";
+
+const appContent = {
+  key: "app",
+  content: {
+    title: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola mundo",
+    }),
+  },
+} satisfies Dictionary;
+
+export default appContent;
+```
+
+> يمكن تعريف إعلانات المحتوى الخاصة بك في أي مكان داخل تطبيقك بمجرد تضمينها في دليل `contentDir` (افتراضيًا، `./src`). ويجب أن تطابق امتداد ملف إعلان المحتوى (افتراضيًا، `.content.{json,ts,tsx,js,jsx,mjs,mjx,cjs,cjx}`).
+
+> لمزيد من التفاصيل، راجع [توثيق إعلان المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/get_started.md).
+
+### الخطوة 5: استخدام المحتوى الخاص بك في Astro
+
+يمكنك استهلاك القواميس مباشرة في ملفات `.astro` باستخدام الأدوات الأساسية التي تصدرها `intlayer`.
+
+```astro fileName="src/pages/index.astro"
+<!-- astro -->
+---
+import { getIntlayer } from "intlayer";
+import appContent from "../app.content";
+
+const { title } = getIntlayer('app');
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width" />
+    <title>{title}</title>
+  </head>
+  <body>
+    <h1>{title}</h1>
+  </body>
+</html>
+```
+
+### الخطوة 6: التوجيه المحلي
+
+قم بإنشاء جزء مسار ديناميكي لخدمة الصفحات المحلية، على سبيل المثال `src/pages/[locale]/index.astro`:
+
+```astro fileName="src/pages/[locale]/index.astro"
+<!-- astro -->
+---
+import { getIntlayer } from "intlayer";
+
+const { title } = getIntlayer('app');
+---
+
+<h1>{title}</h1>
+```
+
+تضيف تكامل Astro وسيط Vite أثناء التطوير يساعد في التوجيه الواعي للغة وتعريفات البيئة. لا يزال بإمكانك الربط بين اللغات باستخدام منطقك الخاص، أو باستخدام دوال مساعدة مثل `getLocalizedUrl` من `intlayer`.
+
+### الخطوة 7: استمر في استخدام إطار العمل المفضل لديك
+
+استمر في استخدام إطار العمل المفضل لديك لبناء تطبيقك.
+
+- Intlayer + React: [Intlayer مع React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+react.md)
+- Intlayer + Vue: [Intlayer مع Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+vue.md)
+- Intlayer + Svelte: [Intlayer مع Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+svelte.md)
+- Intlayer + Solid: [Intlayer مع Solid](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+solid.md)
+- Intlayer + Preact: [Intlayer مع Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+preact.md)
+
+### تكوين TypeScript
+
+يستخدم Intlayer تعزيز الوحدات (module augmentation) للاستفادة من TypeScript وجعل قاعدة الشيفرة الخاصة بك أقوى.
+
+![Autocompletion](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)
+
+![Translation error](https://github.com/aymericzip/intlayer/blob/main/docs/assets/translation_error.png?raw=true)
+
+تأكد من أن تكوين TypeScript الخاص بك يتضمن الأنواع التي تم إنشاؤها تلقائيًا.
+
+```json5 fileName="tsconfig.json"
+{
+  // ... تكوينات TypeScript الحالية الخاصة بك
+  "include": [
+    // ... تكوينات TypeScript الحالية الخاصة بك
+    ".intlayer/**/*.ts", // تضمين الأنواع التي تم إنشاؤها تلقائيًا
+  ],
+}
+```
+
+### تكوين Git
+
+يوصى بتجاهل الملفات التي يتم إنشاؤها بواسطة Intlayer. هذا يسمح لك بتجنب الالتزام بها في مستودع Git الخاص بك.
+
+للقيام بذلك، يمكنك إضافة التعليمات التالية إلى ملف `.gitignore` الخاص بك:
+
+```plaintext
+# تجاهل الملفات التي تم إنشاؤها بواسطة Intlayer
+.intlayer
+```
+
+### امتداد VS Code
+
+لتحسين تجربة التطوير الخاصة بك مع Intlayer، يمكنك تثبيت **امتداد Intlayer الرسمي لـ VS Code**.
+
+[التثبيت من سوق VS Code](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
+
+يوفر هذا الامتداد:
+
+- **الإكمال التلقائي** لمفاتيح الترجمة.
+- **كشف الأخطاء في الوقت الحقيقي** للترجمات المفقودة.
+- **معاينات داخلية** للمحتوى المترجم.
+- **إجراءات سريعة** لإنشاء وتحديث الترجمات بسهولة.
+
+لمزيد من التفاصيل حول كيفية استخدام الامتداد، راجع [توثيق امتداد Intlayer لـ VS Code](https://intlayer.org/doc/vs-code-extension).
+
+---
+
+### التقدم أكثر
+
+للتقدم أكثر، يمكنك تنفيذ [المحرر المرئي](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).
+
+---