@intlayer/docs 9.0.0-canary.3 → 9.0.0-canary.5

package/blog/ar/intlayer_with_i18next.md

@@ -34,6 +34,10 @@ author: aymericzip
 
 <iframe title="كيفية أتمتة ترجمات JSON الخاصة بـ i18next باستخدام Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
+## جدول المحتويات
+
+<TOC/>
+
 ## ما هو Intlayer؟
 
 **Intlayer** هي مكتبة تدويل مبتكرة ومفتوحة المصدر مصممة لمعالجة أوجه القصور في حلول i18n التقليدية. تقدم نهجًا حديثًا لإدارة المحتوى في تطبيقات جافا سكريبت.
@@ -65,24 +69,40 @@ author: aymericzip
 
 قم بتثبيت الحزم اللازمة:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> علامة `--interactive` اختيارية. استخدم `intlayer-cli init` إذا كنت وكيل ذكاء اصطناعي.
+
+> سيقوم هذا الأمر باكتشاف بيئتك وتثبيت الحزم المطلوبة. على سبيل المثال:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **وصف الحزم:**

package/blog/ar/intlayer_with_next-i18next.md

@@ -34,17 +34,6 @@ author: aymericzip
 
 <TOC/>
 
-## ما هو next-i18next؟
-
-**next-i18next** هي واحدة من أكثر أُطُر التدويل (i18n) شعبية لتطبيقات Next.js. مبنية على نظام **i18next** القوي، توفر حلاً شاملاً لإدارة الترجمات، والتعريب، وتبديل اللغات في مشاريع Next.js.
-
-ومع ذلك، يأتي next-i18next مع بعض التحديات:
-
-- **إعداد معقد**: يتطلب إعداد next-i18next ملفات تكوين متعددة وإعداد دقيق لحالات i18n على جانب الخادم والعميل.
-- **ترجمات متفرقة**: عادةً ما تُخزن ملفات الترجمة في مجلدات منفصلة عن المكونات، مما يصعب الحفاظ على الاتساق.
-- **إدارة يدوية للمساحات الاسمية**: يحتاج المطورون إلى إدارة المساحات الاسمية يدويًا وضمان تحميل موارد الترجمة بشكل صحيح.
-- **سلامة نوع محدودة**: يتطلب دعم TypeScript تكوينًا إضافيًا ولا يوفر توليد أنواع تلقائي للترجمات.
-
 ## ما هو Intlayer؟
 
 **Intlayer** هو مكتبة تعريب مبتكرة ومفتوحة المصدر مصممة لمعالجة أوجه القصور في حلول i18n التقليدية. يقدم نهجًا حديثًا لإدارة المحتوى في تطبيقات Next.js.
@@ -73,24 +62,40 @@ author: aymericzip
 
 قم بتثبيت الحزم اللازمة باستخدام مدير الحزم المفضل لديك:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> علامة `--interactive` اختيارية. استخدم `intlayer-cli init` إذا كنت وكيل ذكاء اصطناعي.
+
+> سيقوم هذا الأمر باكتشاف بيئتك وتثبيت الحزم المطلوبة. على سبيل المثال:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **توضيحات الحزم:**

package/blog/ar/intlayer_with_next-intl.md

@@ -29,6 +29,10 @@ author: aymericzip
 
 <iframe title="كيفية أتمتة ترجمات JSON الخاصة بـ next-intl باستخدام Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
+# جدول المحتويات
+
+<TOC/>
+
 ## ما هو Intlayer؟
 
 **Intlayer** هي مكتبة تدويل مبتكرة ومفتوحة المصدر مصممة لمعالجة أوجه القصور في حلول i18n التقليدية. تقدم نهجًا حديثًا لإدارة المحتوى في تطبيقات Next.js.
@@ -59,24 +63,40 @@ author: aymericzip
 
 قم بتثبيت الحزم اللازمة:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> علامة `--interactive` اختيارية. استخدم `intlayer-cli init` إذا كنت وكيل ذكاء اصطناعي.
+
+> سيقوم هذا الأمر باكتشاف بيئتك وتثبيت الحزم المطلوبة. على سبيل المثال:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **وصف الحزم:**

package/blog/ar/intlayer_with_react-i18next.md

@@ -63,24 +63,40 @@ author: aymericzip
 
 قم بتثبيت الحزم اللازمة:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> علامة `--interactive` اختيارية. استخدم `intlayer-cli init` إذا كنت وكيل ذكاء اصطناعي.
+
+> سيقوم هذا الأمر باكتشاف بيئتك وتثبيت الحزم المطلوبة. على سبيل المثال:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **وصف الحزم:**

package/blog/ar/intlayer_with_react-intl.md

@@ -61,24 +61,40 @@ author: aymericzip
 
 قم بتثبيت الحزم اللازمة:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> علامة `--interactive` اختيارية. استخدم `intlayer-cli init` إذا كنت وكيل ذكاء اصطناعي.
+
+> سيقوم هذا الأمر باكتشاف بيئتك وتثبيت الحزم المطلوبة. على سبيل المثال:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **وصف الحزم:**

package/blog/ar/intlayer_with_vue-i18n.md

@@ -63,24 +63,40 @@ author: aymericzip
 
 قم بتثبيت الحزم اللازمة باستخدام مدير الحزم المفضل لديك:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> علامة `--interactive` اختيارية. استخدم `intlayer-cli init` إذا كنت وكيل ذكاء اصطناعي.
+
+> سيقوم هذا الأمر باكتشاف بيئتك وتثبيت الحزم المطلوبة. على سبيل المثال:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **توضيحات الحزم:**

package/blog/ar/next-i18next_vs_next-intl_vs_intlayer.md

@@ -282,34 +282,6 @@ author: aymericzip
 
 ---
 
-## تجربة المطور، الأدوات والصيانة
-
-<Columns>
-  <Column>
-
-**next-intl**
-
-- غالبًا ما يُستخدم مع منصات التوطين الخارجية وسير العمل التحريري.
-
-  </Column>
-  <Column>
-
-**next-i18next**
-
-- غالبًا ما يُستخدم مع منصات التوطين الخارجية وسير العمل التحريري.
-
-  </Column>
-  <Column>
-
-**intlayer**
-
-- يوفر محررًا بصريًا مجانيًا ونظام إدارة محتوى اختياري (متوافق مع Git أو خارجي)، بالإضافة إلى امتداد VSCode وترجمات بمساعدة الذكاء الاصطناعي باستخدام مفاتيح المزود الخاصة بك.
-
-  </Column>
-</Columns>
-
-**لماذا هذا مهم:** يقلل من تكلفة العمليات ويقصر دورة التواصل بين المطورين ومؤلفي المحتوى.
-
 ## التكامل مع منصات الترجمة (TMS)
 
 تعتمد المؤسسات الكبيرة غالبًا على أنظمة إدارة الترجمة (TMS) مثل **Crowdin**، **Phrase**، **Lokalise**، **Localizely**، أو **Localazy**.
@@ -1417,6 +1389,41 @@ The set up of the middleware centralized in the `intlayer.config.ts` file.
 
 ---
 
+### قائمة التحقق من الإعداد والممارسات الجيدة
+
+<Tabs defaultTab="next-intl" group='techno'>
+  <Tab label="next-i18next" value="next-i18next">
+
+- تأكد من تعيين `lang` و `dir` على `<html>` الجذر في `src/app/[locale]/layout.tsx`.
+- قسّم الترجمات إلى مساحات الأسماء (على سبيل المثال `common.json` و `about.json`) تحت `src/locales/<locale>/`.
+- قم بتحميل مساحات الأسماء المطلوبة فقط في مكونات العميل باستخدام `useTranslation('<ns>')` وبمحاذاة `I18nProvider` مع نفس مساحات الأسماء.
+- حافظ على الصفحات ثابتة قدر الإمكان: صدّر `export const dynamic = 'force-static'` على الصفحات؛ عيّن `dynamicParams = false` وطبّق `generateStaticParams`.
+- استخدم مكونات خادم متزامنة متداخلة تحت حدود العميل بواسطة تمرير السلاسل المحسوبة مسبقًا أو دالة `t` والـ `locale`.
+- بالنسبة لـ SEO، عيّن `alternates.languages` في البيانات الوصفية، واعرض قوائم عناوين URL المحلية في `sitemap.ts`، وامنع المسارات المحلية المكررة في `robots.ts`.
+- فضّل أدوات التنسيق الموعية بالإعدادات المحلية (مثلاً `Intl.NumberFormat(locale)`) وقم بتخزينها مؤقتًا على العميل إذا كنت تستخدم React < 19.
+
+  </Tab>
+  <Tab label="next-intl" value="next-intl">
+
+- **عيّن `lang` و `dir` على html**: في `src/app/[locale]/layout.tsx`، احسب `dir` عبر `getLocaleDirection(locale)` وعيّن `<html lang={locale} dir={dir}>`.
+- **قسّم الرسائل حسب مساحة الأسماء**: نظّم JSON لكل إعداد محلي ومساحة أسماء (مثلاً `common.json` و `about.json`).
+- **قلّل حمولة العميل**: على الصفحات، أرسل مساحات الأسماء المطلوبة فقط إلى `NextIntlClientProvider` (مثلاً `pick(messages, ['common', 'about'])`).
+- **فضّل الصفحات الثابتة**: صدّر `export const dynamic = 'force-static'` وأنشئ معاملات ثابتة لجميع `locales`.
+- **مكونات الخادم المتزامنة**: حافظ على مكونات الخادم متزامنة بتمرير السلاسل المحسوبة مسبقًا (التسميات المترجمة والأرقام المنسقة) بدلاً من الاستدعاءات غير المتزامنة أو الدوال غير القابلة للتسلسل.
+
+  </Tab>
+  <Tab label="intlayer" value="intlayer">
+
+- **المحتوى المعياري**: ضع قواميس المحتوى بجانب المكونات باستخدام ملفات `.content.{ts|js|json}`.
+- **سلامة النوع**: استفد من دمج TypeScript للتحقق من المحتوى في وقت التجميع.
+- **تحسين وقت البناء**: استخدم أدوات بناء Intlayer لـ tree-shaking التلقائي وتحسين حجم الحزمة.
+- **الأدوات المدمجة**: استفد من دعم التوجيه المدمج ومساعدات SEO ودعم المحرر البصري.
+
+  </Tab>
+</Tabs>
+
+---
+
 ## والفائز هو…
 
 ليس الأمر بسيطًا. كل خيار له مزاياه وعيوبه. إليك كيف أراه:

package/blog/ar/rag_powered_documentation_assistant.md

@@ -311,3 +311,16 @@ RAG هي واحدة من أبسط وأقوى الطرق لجعل نماذج ال
 </Step>
 
 </Steps>
+## الخلاصة
+
+RAG هي إحدى أبسط الطرق وأكثرها قوة لجعل نماذج اللغة الكبيرة عملية. من خلال دمج **البحث + التوليد**، يمكنك تحويل المستندات الثابتة إلى **مساعد ذكي** والحصول في نفس الوقت على تدفق مستمر من رؤى المنتج.
+
+بالنسبة لي، أظهر هذا المشروع أن RAG ليست مجرد حيلة تقنية. إنها طريقة لتحويل التوثيق إلى:
+
+- نظام دعم تفاعلي
+- قناة ردود الفعل
+- أداة استراتيجية للمنتج
+
+👉 [جرب العرض التوضيحي هنا](https://intlayer.org/doc/why) 👉 [تحقق من قالب الكود على GitHub](https://github.com/aymericzip/smart_doc_RAG)
+
+وإذا كنت تجرب RAG أيضًا، فأود أن أسمع كيف تستخدمها.

package/blog/ar/react-i18next_vs_react-intl_vs_intlayer.md

@@ -146,6 +146,12 @@ author: aymericzip
 
 ---
 
+## نجوم GitHub
+
+نجوم GitHub هي مؤشر قوي على شعبية المشروع وثقة المجتمع وأهميته طويلة الأجل. على الرغم من أنها ليست مقياساً مباشراً للجودة التقنية، إلا أنها تعكس عدد المطورين الذين يجدون المشروع مفيداً ويتابعون تقدمه ويرجح أن يعتمدوه. لتقدير قيمة المشروع، تساعد النجوم في مقارنة الزخم عبر البدائل وتوفر رؤى حول نمو النظام البيئي.
+
+[![Star History Chart](https://api.star-history.com/chart?repos=formatjs/formatjs%2Ci18next/react-i18next%2Caymericzip/intlayer&type=date&legend=top-left)](https://www.star-history.com/#formatjs/formatjs&i18next/react-i18next&aymericzip/intlayer)
+
 ## الخلاصة
 
 جميع المكتبات الثلاث تقوم بتوطين React بفعالية. الفارق هو مقدار **البنية التحتية** التي يجب عليك بناؤها للوصول إلى إعداد **آمن وقابل للتوسع**:

package/blog/ar/vue-i18n_vs_intlayer.md

@@ -249,6 +249,14 @@ const { greeting } = useIntlayer("component-example");
 
 ---
 
+## التوافقية مع vue-i18n
+
+يمكن لـ `intlayer` أيضًا أن يساعدك في إدارة مساحات أسماء `vue-i18n` الخاصة بك.
+
+باستخدام `intlayer`، يمكنك التصريح عن محتواك بصيغة مكتبة i18n المفضلة لديك، وسيقوم intlayer بإنشاء مساحات الأسماء الخاصة بك في الموقع الذي تختاره (مثال: `/messages/{{locale}}/{{namespace}}.json`).
+
+---
+
 ## ملاحظات عملية للترحيل (من vue-i18n إلى Intlayer)
 
 - **ابدأ لكل ميزة على حدة**: انقل مسارًا/عرضًا/مكونًا واحدًا في كل مرة إلى قواميس Intlayer المحلية.

package/blog/de/intlayer_with_i18next.md

@@ -34,6 +34,10 @@ author: aymericzip
 
 <iframe title="Wie Sie Ihre i18next JSON-Übersetzungen mit Intlayer automatisieren" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
+## Inhaltsverzeichnis
+
+<TOC/>
+
 ## Was ist Intlayer?
 
 **Intlayer** ist eine innovative, Open-Source-Internationalisierungsbibliothek, die entwickelt wurde, um die Schwächen traditioneller i18n-Lösungen zu beheben. Sie bietet einen modernen Ansatz für das Content-Management in JavaScript-Anwendungen.
@@ -59,28 +63,46 @@ Diese Anleitung zeigt Ihnen, wie Sie das überlegene Inhaltsdeklarationssystem v
 
 ## Schritt-für-Schritt-Anleitung zur Einrichtung von Intlayer mit i18next
 
-### Schritt 1: Abhängigkeiten installieren
+<Steps>
+
+<Step number={1} title="Abhängigkeiten installieren">
 
 Installieren Sie die notwendigen Pakete:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> Das Flag `--interactive` ist optional. Verwenden Sie `intlayer-cli init`, wenn Sie ein KI-Agent sind.
+
+> Dieser Befehl erkennt Ihre Umgebung und installiert die erforderlichen Pakete. Zum Beispiel:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **Paketbeschreibungen:**
@@ -88,7 +110,9 @@ bun x intlayer init
 - **intlayer**: Kernbibliothek für Internationalisierungsmanagement, Inhaltsdeklaration und Build
 - **@intlayer/sync-json-plugin**: Plugin zum Exportieren von Intlayer-Inhaltsdeklarationen in ein mit i18next kompatibles JSON-Format
 
-### Schritt 2: Implementieren Sie das Intlayer-Plugin, um das JSON zu umschließen
+</Step>
+
+<Step number={2} title="Implementieren Sie das Intlayer-Plugin, um das JSON zu umschließen">
 
 Erstellen Sie eine Intlayer-Konfigurationsdatei, um Ihre unterstützten Sprachen zu definieren:
 
@@ -124,6 +148,10 @@ Wenn Änderungen über die CLI zur Übersetzung des JSON vorgenommen werden oder
 
 Um weitere Details zum `syncJSON`-Plugin zu erfahren, lesen Sie bitte die [syncJSON Plugin-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/plugins/sync-json.md).
 
+</Step>
+
+</Steps>
+
 ## Git-Konfiguration
 
 Es wird empfohlen, automatisch generierte Intlayer-Dateien zu ignorieren:

package/blog/de/intlayer_with_next-i18next.md

@@ -34,17 +34,6 @@ author: aymericzip
 
 <TOC/>
 
-## Was ist next-i18next?
-
-**next-i18next** ist eines der beliebtesten Internationalisierungs- (i18n) Frameworks für Next.js-Anwendungen. Es basiert auf dem leistungsstarken **i18next**-Ökosystem und bietet eine umfassende Lösung zur Verwaltung von Übersetzungen, Lokalisierung und Sprachwechsel in Next.js-Projekten.
-
-Allerdings bringt next-i18next einige Herausforderungen mit sich:
-
-- **Komplexe Konfiguration**: Die Einrichtung von next-i18next erfordert mehrere Konfigurationsdateien und eine sorgfältige Einrichtung der i18n-Instanzen auf Server- und Client-Seite.
-- **Verteilte Übersetzungen**: Übersetzungsdateien werden typischerweise in separaten Verzeichnissen von den Komponenten gespeichert, was die Konsistenz erschwert.
-- **Manuelle Namespace-Verwaltung**: Entwickler müssen Namespaces manuell verwalten und sicherstellen, dass die Übersetzungsressourcen korrekt geladen werden.
-- **Begrenzte Typsicherheit**: TypeScript-Unterstützung erfordert zusätzliche Konfiguration und bietet keine automatische Typgenerierung für Übersetzungen.
-
 ## Was ist Intlayer?
 
 **Intlayer** ist eine innovative, Open-Source-Internationalisierungsbibliothek, die entwickelt wurde, um die Schwächen traditioneller i18n-Lösungen zu beheben. Sie bietet einen modernen Ansatz für das Content-Management in Next.js-Anwendungen.
@@ -67,28 +56,46 @@ Dieser Leitfaden zeigt Ihnen, wie Sie das überlegene Inhaltsdeklarationssystem
 
 ## Schritt-für-Schritt-Anleitung zur Einrichtung von Intlayer mit next-i18next
 
-### Schritt 1: Abhängigkeiten installieren
+<Steps>
+
+<Step number={1} title="Abhängigkeiten installieren">
 
 Installieren Sie die notwendigen Pakete mit Ihrem bevorzugten Paketmanager:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> Das Flag `--interactive` ist optional. Verwenden Sie `intlayer-cli init`, wenn Sie ein KI-Agent sind.
+
+> Dieser Befehl erkennt Ihre Umgebung und installiert die erforderlichen Pakete. Zum Beispiel:
+
 ```bash packageManager="npm"
 npm install intlayer @intlayer/sync-json-plugin --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer @intlayer/sync-json-plugin --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer @intlayer/sync-json-plugin --dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer @intlayer/sync-json-plugin --dev
-bun x intlayer init
 ```
 
 **Paket-Erklärungen:**
@@ -96,7 +103,9 @@ bun x intlayer init
 - **intlayer**: Kernbibliothek für Inhaltsdeklaration und -verwaltung
 - **@intlayer/sync-json-plugin**: Plugin zum Synchronisieren von Intlayer-Inhaltsdeklarationen im i18next JSON-Format
 
-### Schritt 2: Implementieren Sie das Intlayer-Plugin, um das JSON zu umschließen
+</Step>
+
+<Step number={2} title="Implementieren Sie das Intlayer-Plugin, um das JSON zu umschließen">
 
 Erstellen Sie eine Intlayer-Konfigurationsdatei, um Ihre unterstützten Sprachen zu definieren:
 
@@ -133,6 +142,10 @@ Wenn Änderungen über die CLI zur Übersetzung des JSON vorgenommen werden oder
 
 Für weitere Details zum `syncJSON`-Plugin lesen Sie bitte die [syncJSON Plugin-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/plugins/sync-json.md).
 
+</Step>
+
+</Steps>
+
 ## Git-Konfiguration
 
 Schließen Sie generierte Dateien von der Versionskontrolle aus: