@intlayer/docs 5.5.8

package/ar/vs_code_extension.md

@@ -0,0 +1,139 @@
+# امتداد VS Code الرسمي لـ Intlayer
+
+## نظرة عامة
+
+**Intlayer** هو الامتداد الرسمي لـ Visual Studio Code لـ **Intlayer**، مصمم لتحسين تجربة المطور عند العمل مع المحتوى المحلي في مشاريع **React, Next.js, و JavaScript**.
+
+مع هذا الامتداد، يمكن للمطورين **التنقل بسرعة** إلى قواميس المحتوى الخاصة بهم، إدارة ملفات التوطين، وتبسيط سير العمل الخاص بهم باستخدام أوامر أتمتة قوية.
+
+![Intlayer VS Code Extension](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` (Mac) أو `Ctrl+Click` (Windows/Linux) على مفتاح `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+Click** (على Windows/Linux) على المفتاح (مثل `"app"`).
+4. سيقوم VS Code بفتح ملف القاموس المقابل تلقائيًا، مثل `src/app.content.ts`.
+
+### إدارة قواميس المحتوى
+
+#### بناء القواميس
+
+قم بإنشاء جميع ملفات محتوى القواميس باستخدام:
+
+```sh
+Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
+```
+
+ابحث عن **بناء القواميس** ونفذ الأمر.
+
+#### دفع القواميس
+
+قم بتحميل أحدث محتوى القواميس:
+
+1. افتح **لوحة الأوامر**.
+2. ابحث عن **دفع القواميس**.
+3. حدد القواميس التي تريد دفعها وقم بالتأكيد.
+
+#### سحب القواميس
+
+قم بمزامنة أحدث محتوى القواميس:
+
+1. افتح **لوحة الأوامر**.
+2. ابحث عن **سحب القواميس**.
+3. اختر القواميس التي تريد سحبها.
+
+### تخصيص مسارات ملفات القواميس
+
+افتراضيًا، يتبع الامتداد هيكل مشروع **Intlayer** القياسي. ومع ذلك، يمكنك تكوين مسارات مخصصة:
+
+1. افتح **الإعدادات (`Cmd + ,` على macOS / `Ctrl + ,` على Windows/Linux)`**.
+2. ابحث عن `Intlayer`.
+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` لفتح نافذة **Extension Development Host** جديدة.
+
+### إرسال طلب سحب
+
+إذا قمت بتحسين الامتداد، قم بإرسال PR على [GitHub](https://github.com/aymericzip/intlayer-vs-code-extension).
+
+## الملاحظات والمشاكل
+
+هل وجدت خطأً أو لديك طلب ميزة؟ افتح مشكلة على **مستودع GitHub الخاص بنا**:
+
+[مشاكل GitHub](https://github.com/aymericzip/intlayer-vs-code-extension/issues)
+
+## الترخيص
+
+تم إصدار Intlayer بموجب **ترخيص MIT**.

package/de/CI_CD.md

@@ -0,0 +1,149 @@
+# Automatische Generierung von Übersetzungen in einer CI/CD-Pipeline
+
+Intlayer ermöglicht die automatische Generierung von Übersetzungen für Ihre Inhaltsdeklarationsdateien. Es gibt mehrere 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 Sprache lokal deklariert wird, während alle Übersetzungen remote über das CMS verwaltet werden. Dies ermöglicht es, Inhalte und Übersetzungen vollständig vom Code zu trennen, bietet mehr Flexibilität für Inhaltsredakteure und ermöglicht das Hot-Reloading von Inhalten (keine Notwendigkeit, die Anwendung neu zu erstellen, 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 Sprachen werden remote verwaltet
+    defaultLocale: Locales.ENGLISH,
+  },
+  editor: {
+    dictionaryPriorityStrategy: "distant_first", // Remote-Inhalte haben Priorität
+
+    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 Übersetzungsgenerierung sicherzustellen
+  },
+};
+
+export default config;
+```
+
+Weitere Informationen zum CMS finden Sie in der [offiziellen Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/de/intlayer_CMS.md).
+
+## Verwendung von Husky
+
+Sie können die Übersetzungsgenerierung 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 Übersetzungsgenerierung sicherzustellen
+  },
+};
+
+export default config;
+```
+
+```bash fileName=".husky/pre-push"
+npx intlayer build                          # Sicherstellen, dass Wörterbücher aktuell sind
+npx intlayer fill --unpushed --mode fill    # Nur fehlende Inhalte ausfüllen, bestehende nicht aktualisieren
+```
+
+> Weitere Informationen zu Intlayer CLI-Befehlen und deren Verwendung finden Sie in der [CLI-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/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 bietet einen CLI-Befehl, um Wörterbuchinhalte automatisch auszufüllen und zu überprüfen. 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: auto-fill missing translations [skip ci]
+          branch: auto-translations
+          title: chore: update missing translations
+          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 von der Basis (Standard `origin/main`) zum aktuellen Branch (Standard: `HEAD`) enthalten.
+
+> Weitere Informationen zu Intlayer CLI-Befehlen und deren Verwendung finden Sie in der [CLI-Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/de/intlayer_cli.md).

package/de/angular-intlayer/index.md

@@ -0,0 +1,3 @@
+this doc will be automatically generated translated from the english doc
+
+see /docs/en/packages/angular-intlayer/index.md

package/de/autoFill.md

@@ -0,0 +1,157 @@
+# Automatisch ausgefüllte Inhaltsdeklarationsdateien
+
+**Automatisch ausgefüllte Inhaltsdeklarationsdateien** sind eine Möglichkeit, Ihren Entwicklungsarbeitsablauf zu beschleunigen.
+
+Der Autofill-Mechanismus funktioniert über eine _Master-Slave_-Beziehung zwischen Inhaltsdeklarationsdateien. Wenn die Hauptdatei (Master) aktualisiert wird, werden diese Änderungen von Intlayer automatisch auf die abgeleiteten (automatisch ausgefüllten) Deklarationsdateien angewendet.
+
+```ts fileName="src/components/example/example.content.ts"
+import { Locales, type Dictionary } from "intlayer";
+
+const exampleContent = {
+  key: "example",
+  locale: Locales.ENGLISH,
+  autoFill: "./example.content.json",
+  content: {
+    contentExample: "This is an example of content",
+  },
+} satisfies Dictionary;
+
+export default exampleContent;
+```
+
+Hier ist eine [pro-Sprache Inhaltsdeklarationsdatei](https://github.com/aymericzip/intlayer/blob/main/docs/de/per_locale_file.md) mit der `autoFill`-Anweisung.
+
+Wenn Sie dann den folgenden Befehl ausführen:
+
+```bash
+npx intlayer fill --file 'src/components/example/example.content.ts'
+```
+
+Intlayer generiert automatisch die abgeleitete Deklarationsdatei unter `src/components/example/example.content.json` und füllt alle Sprachen aus, die in der Hauptdatei noch nicht deklariert sind.
+
+```json5 fileName="src/components/example/example.content.json"
+{
+  "key": "example",
+  "content": {
+    "contentExample": {
+      "nodeType": "translation",
+      "translation": {
+        "fr": "Ceci est un exemple de contenu",
+        "es": "Este es un ejemplo de contenido",
+      },
+    },
+  },
+}
+```
+
+Anschließend werden beide Deklarationsdateien in ein einzelnes Wörterbuch zusammengeführt, das über den Standard-Hook `useIntlayer("example")` (react) / Composable (vue) zugänglich ist.
+
+## Format automatisch ausgefüllter Dateien
+
+Das empfohlene Format für automatisch ausgefüllte Deklarationsdateien ist **JSON**, was hilft, Formatierungsbeschränkungen zu vermeiden. Intlayer unterstützt jedoch auch die Formate `.ts`, `.js`, `.mjs`, `.cjs` und andere.
+
+```ts fileName="src/components/example/example.content.ts"
+const exampleContent = {
+  key: "example",
+  autoFill: "./example.filled.content.ts",
+  content: {
+    // Ihr Inhalt
+  },
+};
+```
+
+Dies generiert die Datei unter:
+
+```
+src/components/example/example.filled.content.ts
+```
+
+> Die Generierung von `.js`, `.ts` und ähnlichen Dateien funktioniert wie folgt:
+
+> - Wenn die Datei bereits existiert, analysiert Intlayer sie mit dem AST (Abstract Syntax Tree), um jedes Feld zu lokalisieren und fehlende Übersetzungen einzufügen.
+
+> - Wenn die Datei nicht existiert, generiert Intlayer sie mit der Standardvorlage für Inhaltsdeklarationsdateien.
+
+## Absolute Pfade
+
+Das `autoFill`-Feld unterstützt auch absolute Pfade.
+
+```ts fileName="src/components/example/example.content.ts"
+const exampleContent = {
+  key: "example",
+  autoFill: "/messages/example.content.json",
+  content: {
+    // Ihr Inhalt
+  },
+};
+```
+
+Dies generiert die Datei unter:
+
+```
+/messages/example.content.json
+```
+
+## Automatische Generierung von pro-Sprache Inhaltsdeklarationsdateien
+
+Das `autoFill`-Feld unterstützt auch die Generierung von **pro-Sprache** Inhaltsdeklarationsdateien.
+
+```ts fileName="src/components/example/example.content.ts"
+const exampleContent = {
+  key: "example",
+  autoFill: {
+    fr: "./example.fr.content.json",
+    es: "./example.es.content.json",
+  },
+  content: {
+    // Ihr Inhalt
+  },
+};
+```
+
+Dies generiert zwei separate Dateien:
+
+- `src/components/example/example.fr.content.json`
+- `src/components/example/example.es.content.json`
+
+## Filtern des Autofills nach bestimmter Sprache
+
+Die Verwendung eines Objekts für das `autoFill`-Feld ermöglicht es Ihnen, Filter anzuwenden und nur bestimmte Sprachdateien zu generieren.
+
+```ts fileName="src/components/example/example.content.ts"
+const exampleContent = {
+  key: "example",
+  autoFill: {
+    fr: "./example.fr.content.json",
+  },
+  content: {
+    // Ihr Inhalt
+  },
+};
+```
+
+Dies generiert nur die französische Übersetzungsdatei.
+
+## Pfadvariablen
+
+Sie können Variablen innerhalb des `autoFill`-Pfads verwenden, um die Zielpfade für die generierten Dateien dynamisch aufzulösen.
+
+**Verfügbare Variablen:**
+
+- `{{locale}}` – Sprachcode (z.B. `fr`, `es`)
+- `{{key}}` – Wörterbuchschlüssel (z.B. `example`)
+
+```ts fileName="src/components/example/example.content.ts"
+const exampleContent = {
+  key: "example",
+  autoFill: "/messages/{{locale}}/{{key}}.content.json",
+  content: {
+    // Ihr Inhalt
+  },
+};
+```
+
+Dies generiert:
+
+- `/messages/fr/example.content.json`
+- `/messages/es/example.content.json`