@intlayer/docs 5.5.10 → 5.5.12

package/docs/ar/roadmap.md

@@ -0,0 +1,336 @@
+---
+createdAt: 2025-03-01
+updatedAt: 2025-06-29
+title: خارطة الطريق
+description: اكتشف خارطة طريق Intlayer. شاهد جميع الميزات التي نفذها Intlayer، والتي يخطط لتنفيذها.
+keywords:
+  - خارطة الطريق
+  - Intlayer
+  - التدويل
+  - نظام إدارة المحتوى
+  - محرر بصري
+slugs:
+  - doc
+  - roadmap
+---
+
+# Intlayer: نظرة عامة على الميزات وخارطة الطريق
+
+Intlayer هو حل لإدارة المحتوى والتدويل مصمم لتبسيط كيفية إعلان المحتوى وإدارته وتحديثه عبر تطبيقاتك. يقدم ميزات قوية مثل إعلان المحتوى المركزي أو الموزع، خيارات تدويل واسعة، دعم Markdown، العرض الشرطي، التكامل مع TypeScript/JavaScript/JSON، والمزيد. فيما يلي نظرة شاملة على ما يقدمه Intlayer حالياً، تليها الميزات القادمة في خارطة الطريق.
+
+---
+
+## الميزات الحالية
+
+### 1. إعلان المحتوى
+
+#### مركزي أو موزع
+
+- **مركزي**: أعلن كل محتواك في ملف واحد كبير في قاعدة تطبيقك، مشابه لـ i18next، بحيث يمكنك إدارة كل شيء في مكان واحد.
+- **موزع**: بدلاً من ذلك، قسّم محتواك إلى ملفات منفصلة على مستوى المكون أو الميزة لتحسين سهولة الصيانة. هذا يحافظ على محتواك قريبًا من الكود ذي الصلة (المكونات، الاختبارات، Storybook، إلخ). إزالة مكون ما يضمن أيضًا إزالة أي محتوى مرتبط به، مما يمنع بقاء بيانات غير مرغوب فيها تملأ قاعدة الكود الخاصة بك.
+
+> الموارد:
+>
+> - [إعلان المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/get_started.md)
+
+### 2. التدويل
+
+- دعم **230 لغة ولهجة** (بما في ذلك المتغيرات الإقليمية مثل الفرنسية (فرنسا)، الإنجليزية (كندا)، الإنجليزية (المملكة المتحدة)، البرتغالية (البرتغال)، إلخ).
+- إدارة الترجمات لجميع هذه اللهجات بسهولة من مكان واحد.
+
+> الموارد:
+>
+> - [التدويل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/translation.md)
+
+### 3. دعم Markdown
+
+- أعلن عن المحتوى باستخدام **Markdown**، مما يتيح لك تنسيق النص تلقائيًا مع الفقرات، العناوين، الروابط، والمزيد.
+- مثالي للمشاركات في المدونات، المقالات، صفحات التوثيق، أو أي سيناريو يحتاج إلى تنسيق نص غني.
+
+> الموارد:
+>
+> - [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/markdown.md)
+
+### 4. دعم الملفات الخارجية
+
+- استيراد المحتوى من ملفات خارجية بصيغة نصية، مثل TXT، HTML، JSON، YAML، أو CSV.
+- استخدم دالة `file` في Intlayer لتضمين محتوى الملفات الخارجية داخل القاموس، مما يضمن تكاملًا سلسًا مع محرر Intlayer المرئي ونظام إدارة المحتوى.
+- يدعم تحديث المحتوى الديناميكي، مما يعني أنه عند تعديل ملف المصدر، يتم تحديث المحتوى تلقائيًا داخل Intlayer.
+- يتيح إدارة المحتوى متعدد اللغات من خلال ربط ملفات Markdown الخاصة بكل لغة بشكل ديناميكي.
+
+> الموارد:
+>
+> - [تضمين محتوى الملفات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/file.md)
+
+### 5. المحتوى الديناميكي وجلب الدوال
+
+يوفر Intlayer طرقًا متعددة لإدراج وإدارة المحتوى الديناميكي، مما يضمن المرونة وقابلية التكيف في تقديم المحتوى. يشمل ذلك دوال لإدراج المحتوى الديناميكي، العرض الشرطي، التعداد، التداخل، وجلب الدوال.
+
+1. إدراج المحتوى الديناميكي
+
+   استخدم دالة insert لتعريف المحتوى مع عناصر نائب ({{name}}، {{age}}، إلخ).
+
+   يتيح محتوى يشبه القوالب يتكيف بناءً على إدخال المستخدم، أو استجابات API، أو مصادر بيانات ديناميكية أخرى.
+
+   يعمل بسلاسة مع تكوينات TypeScript و ESM و CommonJS و JSON.
+
+   يندمج بسهولة مع React Intlayer و Next Intlayer باستخدام useIntlayer.
+
+2. العرض الشرطي
+
+   عرّف محتوى يتكيف بناءً على شروط خاصة بالمستخدم، مثل اللغة أو حالة المصادقة.
+
+   خصص تجارب شخصية دون تكرار المحتوى عبر ملفات متعددة.
+
+3. التعداد والتثنية
+
+   استخدم دالة enu لتعريف تنويعات المحتوى بناءً على القيم الرقمية، أو النطاقات، أو المفاتيح المخصصة.
+
+   يضمن اختيار العبارة الصحيحة تلقائيًا بناءً على القيمة المعطاة.
+
+   يدعم قواعد الترتيب، مما يضمن سلوكًا متوقعًا.
+
+4. التداخل والإشارة إلى المحتوى الفرعي
+
+   استخدم دالة nest للإشارة إلى المحتوى وإعادة استخدامه من قاموس آخر، مما يقلل من التكرار.
+
+   يدعم إدارة المحتوى المنظمة والهرمية لتحسين سهولة الصيانة.
+
+5. استدعاء الدوال
+
+   يسمح Intlayer بإعلان المحتوى كدوال، مما يتيح استرجاع المحتوى بشكل متزامن أو غير متزامن.
+
+   الدوال المتزامنة: يتم إنشاء المحتوى ديناميكيًا أثناء وقت البناء.
+
+   الدوال غير المتزامنة: جلب البيانات من مصادر خارجية (مثل APIs، قواعد البيانات) بشكل ديناميكي.
+
+   التكامل: يعمل مع TypeScript و ESM و CommonJS ولكنه غير مدعوم في ملفات JSON أو الملفات المحتوى البعيدة.
+
+### 6. صيغ إعلان المحتوى
+
+يدعم Intlayer صيغة **TypeScript** (وكذلك JavaScript) و **JSON** لإعلان المحتوى.
+
+- **TypeScript**:
+
+  - يضمن أن هيكل المحتوى الخاص بك صحيح وأنه لا توجد ترجمات مفقودة.
+  - يقدم أوضاع تحقق صارمة أو أكثر مرونة.
+  - يسمح بجلب البيانات ديناميكيًا من المتغيرات أو الدوال أو واجهات برمجة التطبيقات الخارجية.
+
+- **JSON**:
+
+  - يجعل من السهل التكامل مع الأدوات الخارجية (مثل المحررين المرئيين) بسبب تنسيقه الموحد.
+
+  > الموارد:
+  >
+  > - [تنسيقات إعلان المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/content_extention_customization.md)
+
+### 7. التنقية، تحسين الحزمة والاستيراد الديناميكي
+
+- يدمج Intlayer إضافات `Babel` و `SWC` لتحسين الحزمة الخاصة بك وتحسين الأداء. يستبدل الاستيرادات، مما يسمح باستيراد القواميس المستخدمة فقط في الحزمة.
+- من خلال تفعيل هذا الخيار، يسمح Intlayer أيضًا باستيراد محتوى القاموس ديناميكيًا للغة الحالية فقط.
+
+> الموارد:
+>
+> - [تكوين البناء](https://intlayer.org/doc/concept/configuration#build-configuration)
+
+---
+
+## التكامل مع الأُطُر والبيئات
+
+### 1. Next.js
+
+#### أ. مكونات الخادم والعميل
+
+- يوفر **نهجًا موحدًا لإدارة المحتوى** لكل من مكونات الخادم والعميل.
+- يقدم سياقًا مدمجًا لمكونات الخادم، مما يبسط التنفيذ مقارنةً بالحلول الأخرى.
+
+#### ب. البيانات الوصفية، خرائط المواقع، وملفات robots.txt
+
+- جلب المحتوى وحقنه ديناميكيًا لإنشاء البيانات الوصفية، خرائط المواقع، أو ملفات `robots.txt`.
+
+#### ج. الوسيط (Middleware)
+
+- إضافة وسيط لـ **إعادة توجيه المستخدمين** إلى المحتوى بناءً على لغتهم المفضلة.
+
+#### د. التوافق مع Turbopack و Webpack
+
+- متوافق تمامًا مع Turbopack الجديد في Next.js وكذلك مع Webpack التقليدي.
+
+> الموارد:
+>
+> - [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_15.md)
+
+### 2. Vite
+
+- مشابه لـ Next.js، يمكنك دمج Intlayer مع Vite واستخدام **middleware** لإعادة توجيه المستخدمين إلى المحتوى بناءً على لغتهم المفضلة.
+
+> الموارد:
+>
+> - [Vite](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+react.md)
+
+### 3. Express
+
+- إدارة المحتوى وتعريب خدمات الخلفية المبنية على Express.
+- تخصيص الرسائل الإلكترونية، رسائل الخطأ، الإشعارات الفورية، والمزيد باستخدام نصوص مترجمة.
+
+> الموارد:
+>
+> - [Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_express.md)
+
+### 4. React Native
+
+- دمج Intlayer مع React Native لإدارة المحتوى وتعريب تطبيقاتك المحمولة.
+- يدعم منصات iOS و Android على حد سواء.
+
+> الموارد:
+>
+> - [React Native](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_react_native.md)
+
+### 5. Lynx
+
+- دمج Intlayer مع Lynx لإدارة المحتوى وتعريب تطبيقاتك المحمولة.
+- يدعم منصات iOS و Android على حد سواء.
+
+> الموارد:
+>
+> - [Lynx](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_lynx.md)
+
+### 6. Vue
+
+- دمج Intlayer مع Vue لإدارة المحتوى وتعريب تطبيقات Vite / Vue.js الخاصة بك.
+
+> الموارد:
+>
+> - [Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vue.md)
+
+### 7. Nuxt
+
+- دمج Intlayer مع Nuxt لإدارة المحتوى وتعريب تطبيقات Nuxt / Vue.js الخاصة بك.
+- يدعم كل من مكونات الخادم والعميل.
+- يدمج التوجيه والوسيط لإعادة توجيه المستخدمين إلى المحتوى بناءً على لغتهم المفضلة.
+
+> الموارد:
+>
+> - [Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nuxt.md)
+
+### 8. Preact
+
+- دمج Intlayer مع Preact لإدارة المحتوى وتعريب تطبيقات Preact الخاصة بك.
+
+> الموارد:
+>
+> - [Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_preact.md)
+
+---
+
+## المحررات المرئية ونظم إدارة المحتوى
+
+### 1. المحرر المرئي المحلي
+
+- محرر بصري محلي مجاني يتيح لك تحرير محتوى تطبيقك عن طريق تحديد العناصر مباشرة على الصفحة.
+- يدمج ميزات الذكاء الاصطناعي للمساعدة في:
+  - توليد أو تصحيح الترجمات
+  - التحقق من القواعد الإملائية والنحوية
+  - اقتراح تحسينات
+- يمكن استضافته محليًا أو نشره على خادم بعيد.
+
+> الموارد:
+>
+> - [المحرر البصري](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md)
+
+### 2. نظام إدارة المحتوى Intlayer (عن بُعد)
+
+- حل نظام إدارة محتوى مستضاف يتيح لك إدارة محتوى التطبيق عبر الإنترنت دون الحاجة إلى تعديل قاعدة الشيفرة الخاصة بك.
+- يوفر ميزات مدعومة بالذكاء الاصطناعي لإعلان المحتوى، وإدارة الترجمات، وتصحيح الأخطاء النحوية أو الإملائية.
+- التفاعل مع محتواك عبر واجهة التطبيق الحي الخاصة بك.
+
+> الموارد:
+>
+> - [نظام إدارة المحتوى (CMS)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md)
+
+---
+
+## امتدادات بيئة التطوير المتكاملة (IDE Extensions)
+
+- امتدادات لبيئات التطوير المتكاملة الرئيسية لتوفير **واجهة رسومية** لإدارة الترجمات المحلية والبعيدة.
+- قد تشمل الميزات التوليد التلقائي لملفات إعلان المحتوى للمكونات، التكامل المباشر مع نظام إدارة المحتوى Intlayer CMS، والتحقق في الوقت الحقيقي.
+
+---
+
+## خادم MCP
+
+- **خادم MCP** يسمح لك بإدارة محتواك وترجماته باستخدام أداة مدمجة في بيئة التطوير المتكاملة الخاصة بك.
+
+---
+
+## واجهة سطر الأوامر Intlayer CLI
+
+- **الترجمة وتوليد الملفات**: إجراء تدقيقات على ملفات المحتوى الخاصة بك لتوليد الترجمات المفقودة ومراجعة التناقضات.
+- **التفاعل عن بعد**: دفع المحتوى المحلي الخاص بك إلى نظام إدارة المحتوى البعيد أو سحب المحتوى البعيد لدمجه في تطبيقك المحلي.
+- **ترجمة ومراجعة الوثائق**: ترجم وراجع وثائقك / ملفاتك إلخ.
+
+> الموارد:
+>
+> - [واجهة الأوامر CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_cli.md)
+
+---
+
+## البيئات
+
+- استخدم **متغيرات البيئة** لتكوين Intlayer بشكل مختلف عبر بيئات الإنتاج والاختبار والمحلية.
+- حدد أي محرر بصري أو مشروع CMS عن بُعد تستهدفه بناءً على بيئتك.
+
+---
+
+## تحديثات المحتوى الحية
+
+- عند استخدام القواميس البعيدة وIntlayer CMS، يمكنك **تحديث محتوى تطبيقك مباشرةً**، دون الحاجة لإعادة النشر.
+
+> الموارد:
+>
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md)
+
+---
+
+## الميزات القادمة
+
+### 1. اختبار A/B والتخصيص
+
+- **الاختبار متعدد المتغيرات**: اختبار نسخ مختلفة من قطعة محتوى معينة لمعرفة أيها يحقق أفضل أداء (مثل معدل النقر الأعلى).
+- **التخصيص المعتمد على البيانات**: عرض محتوى مختلف بناءً على خصائص المستخدمين الديموغرافية (الجنس، العمر، الموقع، إلخ)، أو أنماط سلوك أخرى.
+- **التكرار التلقائي**: السماح للذكاء الاصطناعي باختبار نسخ متعددة تلقائيًا واختيار الأفضل أداءً أو اقتراح خيارات لموافقة المسؤول.
+
+### 2. إدارة الإصدارات
+
+- استعادة الإصدارات السابقة من المحتوى الخاص بك باستخدام **إدارة إصدارات المحتوى**.
+- تتبع التغييرات مع مرور الوقت والعودة إلى الحالات السابقة إذا لزم الأمر.
+
+### 3. الترجمة التلقائية
+
+- لمستخدمي نظام إدارة المحتوى عن بُعد، **توليد الترجمة بنقرة واحدة** لأي لغة مدعومة.
+- سيقوم النظام بإنشاء الترجمات في الخلفية ثم يطلب منك التحقق منها أو تعديلها.
+
+### 4. تحسينات تحسين محركات البحث (SEO)
+
+- أدوات لـ **تحليل الكلمات المفتاحية**، نية بحث المستخدم، والاتجاهات الناشئة.
+- اقتراح محتوى محسّن لتحسين الترتيب، وتتبع الأداء على المدى الطويل.
+
+### 5. التوافق مع المزيد من الأُطُر
+
+- هناك جهود جارية لدعم **Solid، Svelte، Angular**، والمزيد.
+- الهدف هو جعل Intlayer متوافقًا مع **أي تطبيق يعمل بجافاسكريبت**.
+
+---
+
+## الخاتمة
+
+يهدف Intlayer إلى أن يكون حلاً شاملاً لإدارة المحتوى والتدويل. يركز على المرونة (الملفات المركزية أو الموزعة)، ودعم واسع للغات، والتكامل السهل مع الأُطُر الحديثة وأدوات التجميع، وميزات قوية مدعومة بالذكاء الاصطناعي. مع توفر قدرات جديدة مثل اختبار A/B، وإصدار النسخ، والترجمات الآلية، سيستمر Intlayer في تبسيط سير عمل المحتوى ورفع تجربة المستخدم عبر مختلف المنصات.
+
+تابع الإصدارات القادمة، ولا تتردد في استكشاف الميزات الحالية لترى كيف يمكن لـ Intlayer أن يساعد في مركزية وتحسين عمليات إدارة المحتوى الخاصة بك اليوم!
+
+---
+
+## تاريخ الوثيقة
+
+- 5.5.10 - 2025-06-30: إضافة دعم Preact و Nuxt، خادم MCP، تحديث CLI
+- 5.5.10 - 2025-06-29: بداية التاريخ

package/docs/ar/vs_code_extension.md

@@ -0,0 +1,152 @@
+---
+createdAt: 2025-03-17
+updatedAt: 2025-06-29
+title: إضافة VS Code الرسمية
+description: تعلّم كيفية استخدام إضافة Intlayer في VS Code لتعزيز سير عمل التطوير الخاص بك. تنقل بسرعة بين المحتوى المحلي وأدر قواميسك بكفاءة.
+keywords:
+  - إضافة VS Code
+  - Intlayer
+  - التوطين
+  - أدوات التطوير
+  - React
+  - Next.js
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - vs-code-extension
+---
+
+# إضافة VS Code الرسمية
+
+## نظرة عامة
+
+[**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension) هي الإضافة الرسمية لـ Visual Studio Code لـ **Intlayer**، مصممة لتحسين تجربة المطور عند العمل مع المحتوى المحلي في مشاريعك.
+
+![إضافة Intlayer لـ VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif)
+
+رابط الإضافة: [https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)
+
+## الميزات
+
+### التنقل الفوري
+
+**دعم الانتقال إلى التعريف** – استخدم `Cmd+Click` (لنظام ماك) أو `Ctrl+Click` (لنظام ويندوز/لينكس) على مفتاح `useIntlayer` لفتح ملف المحتوى المقابل فورًا.  
+**تكامل سلس** – يعمل بسهولة مع مشاريع **react-intlayer** و **next-intlayer**.  
+**دعم متعدد اللغات** – يدعم المحتوى المحلي عبر لغات مختلفة.  
+**تكامل مع VS Code** – يندمج بسلاسة مع نظام التنقل ولوحة الأوامر في VS Code.
+
+### أوامر إدارة القواميس
+
+قم بإدارة قواميس المحتوى الخاصة بك مباشرة من VS Code:
+
+- **إنشاء القواميس** (`extension.buildDictionaries`) – توليد ملفات المحتوى بناءً على هيكل مشروعك.
+- **دفع القواميس** (`extension.pushDictionaries`) – رفع أحدث محتوى القاموس إلى مستودعك.
+- **سحب القواميس** (`extension.pullDictionaries`) – مزامنة أحدث محتوى القاموس من مستودعك إلى بيئتك المحلية.
+
+### مولد إعلان المحتوى
+
+قم بسهولة بإنشاء ملفات قاموس منظمة بصيغ مختلفة:
+
+- **TypeScript (`.ts`)** – `extension.createDictionaryFile.ts`
+- **ES Module (`.esm`)** – `extension.createDictionaryFile.esm`
+- **CommonJS (`.cjs`)** – `extension.createDictionaryFile.cjs`
+- **JSON (`.json`)** – `extension.createDictionaryFile.json`
+
+## التثبيت
+
+يمكنك تثبيت **Intlayer** مباشرة من سوق إضافات VS Code:
+
+1. افتح **VS Code**.
+2. اذهب إلى **سوق الإضافات**.
+3. ابحث عن **"Intlayer"**.
+4. اضغط على **تثبيت**.
+
+بدلاً من ذلك، قم بتثبيته عبر سطر الأوامر:
+
+```sh
+code --install-extension intlayer
+```
+
+## الاستخدام
+
+### التنقل السريع
+
+1. افتح مشروعًا يستخدم **react-intlayer**.
+2. حدد موقع استدعاء `useIntlayer()`، مثل:
+
+   ```tsx
+   const content = useIntlayer("app");
+   ```
+
+3. **انقر مع الضغط على الأمر** (`⌘+Click` على macOS) أو **انقر مع الضغط على Ctrl** (على Windows/Linux) على المفتاح (مثل `"app"`).
+4. سيقوم VS Code بفتح ملف القاموس المقابل تلقائيًا، مثل `src/app.content.ts`.
+
+### إدارة قواميس المحتوى
+
+#### بناء القواميس
+
+قم بإنشاء جميع ملفات محتوى القاموس باستخدام:
+
+```sh
+Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
+```
+
+ابحث عن **Build Dictionaries** ونفذ الأمر.
+
+#### دفع القواميس
+
+ارفع أحدث محتوى القاموس:
+
+1. افتح **لوحة الأوامر**.
+2. ابحث عن **Push Dictionaries**.
+3. اختر القواميس التي تريد دفعها وقم بالتأكيد.
+
+#### سحب القواميس
+
+زامن أحدث محتوى القاموس:
+
+1. افتح **لوحة الأوامر**.
+2. ابحث عن **Pull Dictionaries**.
+3. اختر القواميس التي تريد سحبها.
+
+## التطوير والمساهمة
+
+هل ترغب في المساهمة؟ نرحب بمساهمات المجتمع!
+
+رابط المستودع: https://github.com/aymericzip/intlayer-vs-code-extension
+
+### البدء
+
+استنسخ المستودع وقم بتثبيت التبعيات:
+
+```sh
+git clone https://github.com/aymericzip/intlayer-vs-code-extension.git
+cd intlayer-vs-code-extension
+npm install
+```
+
+> استخدم مدير الحزم `npm` للتوافق مع حزمة `vsce` لبناء ونشر الإضافة.
+
+### التشغيل في وضع التطوير
+
+1. افتح المشروع في **VS Code**.
+2. اضغط على `F5` لفتح نافذة جديدة لـ **مضيف تطوير الإضافة**.
+
+### تقديم طلب سحب
+
+إذا قمت بتحسين الإضافة، قدم طلب سحب على [GitHub](https://github.com/aymericzip/intlayer-vs-code-extension).
+
+## الملاحظات والمشاكل
+
+هل وجدت خطأً أو لديك طلب ميزة؟ افتح مشكلة في **مستودع GitHub** الخاص بنا:
+
+[مشاكل GitHub](https://github.com/aymericzip/intlayer-vs-code-extension/issues)
+
+## الترخيص
+
+تم إصدار Intlayer بموجب **رخصة MIT**.
+
+## تاريخ الوثائق
+
+- 5.5.10 - 2025-06-29: بداية التاريخ

package/docs/de/CI_CD.md

@@ -0,0 +1,173 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: CI/CD-Integration
+description: Erfahren Sie, wie Sie Intlayer in Ihre CI/CD-Pipeline für automatisiertes Content-Management und Deployment integrieren.
+keywords:
+  - CI/CD
+  - Kontinuierliche Integration
+  - Kontinuierliche Bereitstellung
+  - Automatisierung
+  - Internationalisierung
+  - Dokumentation
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - de
+  - ci-cd
+---
+
+# Automatische Generierung von Übersetzungen in einer CI/CD-Pipeline
+
+Intlayer ermöglicht die automatische Generierung von Übersetzungen für Ihre Content-Deklarationsdateien. Es gibt verschiedene Möglichkeiten, dies je nach Ihrem Workflow zu erreichen.
+
+## Verwendung des CMS
+
+Mit Intlayer können Sie einen Workflow übernehmen, bei dem nur eine einzige Locale lokal deklariert wird, während alle Übersetzungen remote über das CMS verwaltet werden. Dies ermöglicht es, Inhalte und Übersetzungen vollständig von der Codebasis zu trennen, bietet mehr Flexibilität für Content-Editoren und ermöglicht ein Hot Content Reloading (kein Neubauen der Anwendung erforderlich, um Änderungen anzuwenden).
+
+### Beispielkonfiguration
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.SPANISH, Locales.FRENCH],
+    requiredLocales: [Locales.ENGLISH], // Optionale Locales werden remote verwaltet
+    defaultLocale: Locales.ENGLISH,
+  },
+  editor: {
+    dictionaryPriorityStrategy: "distant_first", // Remote-Inhalte haben Vorrang
+
+    applicationURL: process.env.APPLICATION_URL, // Anwendungs-URL, die vom CMS verwendet wird
+
+    clientId: process.env.INTLAYER_CLIENT_ID, // CMS-Zugangsdaten
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+  ai: {
+    applicationContext: "Dies ist eine Testanwendung", // Hilft, eine konsistente Übersetzungserstellung sicherzustellen
+  },
+};
+
+export default config;
+```
+
+Um mehr über das CMS zu erfahren, siehe die [offizielle Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_CMS.md).
+
+## Verwendung von Husky
+
+Sie können die Übersetzungserstellung in Ihren lokalen Git-Workflow mit [Husky](https://typicode.github.io/husky/) integrieren.
+
+### Beispielkonfiguration
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.SPANISH, Locales.FRENCH],
+    requiredLocales: [Locales.ENGLISH], // Optionale Sprachen werden remote verwaltet
+    defaultLocale: Locales.ENGLISH,
+  },
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+  ai: {
+    provider: "openai",
+    apiKey: process.env.OPENAI_API_KEY, // Verwenden Sie Ihren eigenen API-Schlüssel
+
+    applicationContext: "Dies ist eine Testanwendung", // Hilft, eine konsistente Übersetzungserstellung sicherzustellen
+  },
+};
+
+export default config;
+```
+
+```bash fileName=".husky/pre-push"
+npx intlayer build                          # Um sicherzustellen, dass die Wörterbücher aktuell sind
+npx intlayer fill --unpushed --mode fill    # Füllt nur fehlende Inhalte, aktualisiert keine bestehenden
+```
+
+> Für weitere Informationen zu den Intlayer-CLI-Befehlen und deren Verwendung siehe die [CLI-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_cli.md).
+
+> Wenn Sie mehrere Apps in Ihrem Repository haben, die separate Intlayer-Instanzen verwenden, können Sie das Argument `--base-dir` wie folgt verwenden:
+
+```bash fileName=".husky/pre-push"
+# App 1
+npx intlayer build --base-dir ./app1
+npx intlayer fill --base-dir ./app1 --unpushed --mode fill
+
+# App 2
+npx intlayer build --base-dir ./app2
+npx intlayer fill --base-dir ./app2 --unpushed --mode fill
+```
+
+## Verwendung von GitHub Actions
+
+Intlayer stellt einen CLI-Befehl zum automatischen Ausfüllen und Überprüfen von Wörterbuchinhalten bereit. Dies kann in Ihren CI/CD-Workflow mit GitHub Actions integriert werden.
+
+```yaml fileName=".github/workflows/intlayer-translate.yml"
+name: Intlayer Auto-Fill
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'src/**'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'src/**'
+  workflow_dispatch: {}
+
+concurrency:
+  group: 'autofill-${{ github.ref }}'
+  cancel-in-progress: true
+
+jobs:
+  autofill:
+    runs-on: ubuntu-latest
+    env:
+      INTLAYER_CLIENT_ID: ${{ secrets.INTLAYER_CLIENT_ID }}
+      INTLAYER_CLIENT_SECRET: ${{ secrets.INTLAYER_CLIENT_SECRET }}
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+
+    steps:
+      - name: ⬇️ Repository auschecken
+        uses: actions/checkout@v3
+        with:
+          persist-credentials: true
+
+      - name: 🟢 Node.js einrichten
+        uses: actions/setup-node@v3
+        with:
+          node-version: 20
+
+      - name: 📦 Abhängigkeiten installieren
+        run: npm ci
+
+      - name: ⚙️ Intlayer-Projekt bauen
+        run: npx intlayer build
+
+      - name: 🤖 Fehlende Übersetzungen automatisch ausfüllen
+        run: npx intlayer fill --git-diff --mode fill
+
+      - name: 📤 Übersetzungs-PR erstellen oder aktualisieren
+        uses: peter-evans/create-pull-request@v4
+        with:
+          commit-message: chore: fehlende Übersetzungen automatisch ausfüllen [skip ci]
+          branch: auto-translations
+          title: chore: fehlende Übersetzungen aktualisieren
+          labels: translation, automated
+```
+
+> Wie bei Husky können Sie im Fall eines Monorepos das Argument `--base-dir` verwenden, um jede App nacheinander zu behandeln.
+
+> Standardmäßig filtert das Argument `--git-diff` Wörterbücher, die Änderungen vom Basiszweig (Standard `origin/main`) zum aktuellen Zweig (Standard: `HEAD`) enthalten.
+
+> Für weitere Informationen zu den Intlayer-CLI-Befehlen und deren Verwendung lesen Sie bitte die [CLI-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_cli.md).
+
+## Dokumentationsverlauf
+
+- 5.5.10 - 2025-06-29: Initialer Verlauf