@intlayer/docs 7.5.10 → 7.5.12

package/docs/ar/plugins/sync-json.md

@@ -108,18 +108,22 @@ syncJSON({
   source: ({ key, locale }) => string, // مطلوب
   location?: string, // تسمية اختيارية، الافتراضي: "plugin"
   priority?: number, // أولوية اختيارية لحل التعارضات، الافتراضي: 0
-  format?: 'intlayer' | 'icu' | 'i18next', // مُنسق اختياري، الافتراضي: 'intlayer'
+  format?: 'intlayer' | 'icu' | 'i18next', // مُنسق اختياري، يُستخدم للتوافق مع وقت تشغيل Intlayer
 });
 ```
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-يحدد المُنسق الذي سيتم استخدامه لمحتوى القاموس عند مزامنة ملفات JSON. يسمح هذا باستخدام صيغ تنسيق رسائل مختلفة متوافقة مع مكتبات i18n مختلفة.
+يحدد المُنسق الذي سيتم استخدامه لمحتوى القاموس عند مزامنة ملفات JSON. يسمح هذا باستخدام صيغ تنسيق رسائل مختلفة متوافقة مع وقت تشغيل Intlayer.
 
+- `undefined`: لن يتم استخدام أي مُنسق، سيتم استخدام محتوى JSON كما هو.
 - `'intlayer'`: مُنسق Intlayer الافتراضي (الافتراضي).
 - `'icu'`: يستخدم تنسيق رسائل ICU (متوافق مع مكتبات مثل react-intl، vue-i18n).
 - `'i18next'`: يستخدم تنسيق رسائل i18next (متوافق مع i18next، next-i18next، Solid-i18next).
 
+> لاحظ أن استخدام مُنسق سيحول محتوى JSON الخاص بك في المدخلات والمخرجات. بالنسبة لقواعد JSON المعقدة مثل صيغ الجمع ICU، قد لا يضمن التحليل تطابقاً 1 إلى 1 بين المدخلات والمخرجات.
+> إذا كنت لا تستخدم وقت تشغيل Intlayer، قد تفضل عدم تعيين مُنسق.
+
 **مثال:**
 
 ```ts

package/docs/de/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: CI-Befehl
+description: Erfahren Sie, wie Sie den Intlayer CI-Befehl verwenden, um Intlayer-Befehle mit automatisch injizierten Anmeldedaten in CI/CD-Pipelines und Monorepos auszuführen.
+keywords:
+  - CI
+  - CI/CD
+  - Automatisierung
+  - Monorepo
+  - Anmeldedaten
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: CI-Befehl hinzufügen
+---
+
+# CI-Befehl
+
+```bash
+npx intlayer ci <command...>
+```
+
+Der CI-Befehl ist für Automatisierung und CI/CD-Pipelines konzipiert. Er injiziert automatisch Anmeldedaten aus der Umgebungsvariable `INTLAYER_PROJECT_CREDENTIALS` und kann Intlayer-Befehle über mehrere Projekte in einem Monorepo ausführen.
+
+## Funktionsweise
+
+Der CI-Befehl arbeitet in zwei Modi:
+
+1. **Einzelprojektmodus**: Wenn das aktuelle Arbeitsverzeichnis mit einem der Projektpfade in `INTLAYER_PROJECT_CREDENTIALS` übereinstimmt, führt er den Befehl nur für dieses spezifische Projekt aus.
+
+2. **Iterationsmodus**: Wenn kein spezifischer Projektkontext erkannt wird, iteriert er über alle konfigurierten Projekte und führt den Befehl für jedes aus.
+
+## Umgebungsvariable
+
+Der Befehl erfordert, dass die Umgebungsvariable `INTLAYER_PROJECT_CREDENTIALS` gesetzt ist. Diese Variable sollte ein JSON-Objekt enthalten, das Projektpfade ihren Anmeldedaten zuordnet:
+
+```json
+{
+  "packages/app": {
+    "clientId": "your-client-id-1",
+    "clientSecret": "your-client-secret-1"
+  },
+  "packages/admin": {
+    "clientId": "your-client-id-2",
+    "clientSecret": "your-client-secret-2"
+  }
+}
+```
+
+## Paketmanager-Erkennung
+
+Der CI-Befehl erkennt automatisch, welcher Paketmanager verwendet wird (npm, yarn, pnpm oder bun), basierend auf der Umgebungsvariable `npm_config_user_agent`, und verwendet den entsprechenden Befehl zur Ausführung von Intlayer.
+
+## Argumente
+
+- **`<command...>`**: Der auszuführende Intlayer-Befehl (z. B. `fill`, `push`, `build`). Sie können jeden Intlayer-Befehl und seine Argumente übergeben.
+
+  > Beispiel: `npx intlayer ci fill --verbose`
+  >
+  > Beispiel: `npx intlayer ci push`
+  >
+  > Beispiel: `npx intlayer ci build`
+
+## Beispiele
+
+### Befehl im Einzelprojektmodus ausführen
+
+Wenn Sie sich in einem Projektverzeichnis befinden, das mit einem der Pfade in `INTLAYER_PROJECT_CREDENTIALS` übereinstimmt:
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+Dies führt den Befehl `fill` mit automatisch injizierten Anmeldedaten für das Projekt `packages/app` aus.
+
+### Befehl für alle Projekte ausführen
+
+Wenn Sie sich in einem Verzeichnis befinden, das mit keinem Projektpfad übereinstimmt, iteriert der Befehl über alle konfigurierten Projekte:
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+Dies führt den Befehl `push` für jedes in `INTLAYER_PROJECT_CREDENTIALS` konfigurierte Projekt aus.
+
+### Zusätzliche Flags übergeben
+
+Sie können beliebige Flags an den zugrunde liegenden Intlayer-Befehl übergeben:
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### Verwendung in CI/CD-Pipelines
+
+In Ihrer CI/CD-Konfiguration (z. B. GitHub Actions, GitLab CI) setzen Sie `INTLAYER_PROJECT_CREDENTIALS` als Geheimnis:
+
+```yaml
+# GitHub Actions Beispiel
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: Wörterbücher füllen
+    run: npx intlayer ci fill
+```
+
+## Fehlerbehandlung
+
+- Wenn `INTLAYER_PROJECT_CREDENTIALS` nicht gesetzt ist, beendet sich der Befehl mit einem Fehler.
+- Wenn `INTLAYER_PROJECT_CREDENTIALS` kein gültiges JSON ist, beendet sich der Befehl mit einem Fehler.
+- Wenn ein Projektpfad nicht existiert, wird er mit einer Warnung übersprungen.
+- Wenn ein Projekt fehlschlägt, beendet sich der Befehl mit einem Statuscode ungleich null.
+
+## Anwendungsfälle
+
+- **Monorepo-Automatisierung**: Intlayer-Befehle über mehrere Projekte in einem Monorepo ausführen
+- **CI/CD-Pipelines**: Automatisierung der Wörterbuchverwaltung in Continuous-Integration-Workflows
+- **Massenoperationen**: Dieselbe Operation gleichzeitig für mehrere Intlayer-Projekte durchführen
+- **Geheimnisverwaltung**: Sichere Verwaltung von Anmeldedaten für mehrere Projekte mithilfe von Umgebungsvariablen
+
+## Sicherheitsbest Practices
+
+- Speichern Sie `INTLAYER_PROJECT_CREDENTIALS` als verschlüsselte Geheimnisse in Ihrer CI/CD-Plattform
+- Committen Sie niemals Anmeldedaten in die Versionskontrolle
+- Verwenden Sie umgebungsspezifische Anmeldedaten für verschiedene Bereitstellungsumgebungen
+- Rotieren Sie Anmeldedaten regelmäßig

package/docs/de/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 description: Entdecken Sie, wie Sie die Intlayer CLI verwenden, um Ihre mehrsprachige Website zu verwalten. Folgen Sie den Schritten in dieser Online-Dokumentation, um Ihr Projekt in wenigen Minuten einzurichten.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Projekte-Listen-Befehl hinzugefügt
   - version: 7.5.9
     date: 2025-12-30
     changes: Init-Befehl hinzugefügt
@@ -119,6 +122,7 @@ Um zu sehen, wie verfügbare Sprachen oder andere Parameter konfiguriert werden,
 - **[Dictionaries erstellen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/build.md)** – Erstellen Sie Ihre Wörterbücher aus Inhaltsdeklarationsdateien
 - **[Dictionaries überwachen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/watch.md)** – Überwachen Sie Änderungen und erstellen Sie Wörterbücher automatisch
 - **[CLI-Version prüfen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/version.md)** – Prüfen Sie die installierte Intlayer CLI-Version
+- **[Projekte auflisten](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/list_projects.md)** – Listen Sie alle Intlayer-Projekte in einem Verzeichnis oder Git-Repository auf
 
 ### Wörterbuchverwaltung
 
@@ -166,6 +170,7 @@ Um zu sehen, wie verfügbare Sprachen oder andere Parameter konfiguriert werden,
   "intlayer:list": "npx intlayer content list",
   "intlayer:test": "npx intlayer content test",
   "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
   "intlayer:doc:review": "npx intlayer doc review"
 }
@@ -175,3 +180,4 @@ Um zu sehen, wie verfügbare Sprachen oder andere Parameter konfiguriert werden,
 >
 > - `npx intlayer list` anstelle von `npx intlayer content list`
 > - `npx intlayer test` anstelle von `npx intlayer content test`
+> - `npx intlayer projects-list` oder `npx intlayer pl` anstelle von `npx intlayer projects list`

package/docs/de/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: Inhaltsdeklarationsdateien auflisten
 description: Erfahren Sie, wie Sie alle Inhaltsdeklarationsdateien in Ihrem Projekt auflisten können.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Absolute Ausgabeoption zum Listen-Befehl hinzugefügt
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: JSON-Ausgabeoption zum Listen-Befehl hinzugefügt
 ---
 
 # Inhaltsdeklarationsdateien auflisten
@@ -27,14 +34,36 @@ npx intlayer content list
 
 Dieser Befehl zeigt alle Inhaltsdeklarationsdateien in Ihrem Projekt an, einschließlich ihrer Wörterbuchschlüssel und Dateipfade. Er ist nützlich, um einen Überblick über alle Ihre Inhaltsdateien zu erhalten und zu überprüfen, ob sie von Intlayer korrekt erkannt werden.
 
-## Beispiel:
+## Argumente:
+
+- **`--json`**: Gibt die Ergebnisse als JSON statt als formatierten Text aus. Nützlich für Skripte und programmatischen Zugriff.
+
+  > Beispiel: `npx intlayer content list --json`
+
+## Beispiele:
+
+### Inhaltsdeklarationsdateien auflisten:
 
 ```bash
 npx intlayer content list
 ```
 
+### Ausgabe als JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### Ausgabe als absolute Pfade:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Beispielausgabe:
 
+### Formatierte Ausgabe:
+
 ```bash
 npx intlayer content list
 Inhaltsdeklarationsdateien:
@@ -45,6 +74,14 @@ Inhaltsdeklarationsdateien:
 Gesamtanzahl der Inhaltsdeklarationsdateien: 3
 ```
 
+### JSON-Ausgabe:
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
 Dieser Befehl gibt aus:
 
 - Eine formatierte Liste aller Inhaltsdeklarationsdateien mit ihren Schlüsseln und relativen Dateipfaden

package/docs/de/cli/list_projects.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Intlayer-Projekte auflisten
+description: Erfahre, wie du alle Intlayer-Projekte in einem Verzeichnis oder Git-Repository auflistest.
+keywords:
+  - List
+  - Projects
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Absolute Ausgabeoption zum Befehl list projects hinzufügen
+---
+
+# Intlayer-Projekte auflisten
+
+```bash
+npx intlayer projects list
+```
+
+Dieser Befehl sucht nach und listet alle Intlayer-Projekte, indem er Verzeichnisse findet, die Intlayer-Konfigurationsdateien enthalten. Er ist nützlich, um alle Intlayer-Projekte in einem Monorepo, Workspace oder Git-Repository zu entdecken.
+
+## Aliase:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Argumente:
+
+- **`--base-dir [path]`**: Gibt das Basisverzeichnis an, in dem gesucht werden soll. Standard ist das aktuelle Arbeitsverzeichnis.
+
+  > Beispiel: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > Beispiel: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Suche vom Git-Root-Verzeichnis aus statt vom Basisverzeichnis. Das ist nützlich, um alle Intlayer-Projekte in einem Monorepo oder Git-Repository zu finden.
+
+  > Beispiel: `npx intlayer projects list --git-root`
+
+- **`--json`**: Gibt die Ergebnisse als JSON statt als formatierten Text aus. Nützlich für Skripte und programmatischen Zugriff.
+
+  > Beispiel: `npx intlayer projects list --json`
+
+- **`--absolute`**: Gibt die Ergebnisse als absolute Pfade statt als relative Pfade aus.
+
+  > Beispiel: `npx intlayer projects list --absolute`
+
+## Funktionsweise:
+
+Der Befehl durchsucht das angegebene Verzeichnis (oder das Git-Root, wenn `--git-root` verwendet wird) nach Intlayer-Konfigurationsdateien. Es wird nach den folgenden Konfigurationsdateinamensmustern gesucht:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Jedes Verzeichnis, das eine dieser Dateien enthält, gilt als Intlayer-Projekt und wird in der Ausgabe aufgeführt.
+
+## Beispiele:
+
+### Projekte im aktuellen Verzeichnis auflisten:
+
+```bash
+npx intlayer projects list
+```
+
+### Projekte in einem bestimmten Verzeichnis auflisten:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Alle Projekte im Git-Repository auflisten:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Verwendung des Kurzbefehls (Alias):
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Ausgabe als JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Beispielausgabe:
+
+### Formatierte Ausgabe:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Found 3 Intlayer project(s):
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### JSON-Ausgabe:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Anwendungsfälle:
+
+- **Monorepo-Management**: Entdecke alle Intlayer-Projekte in einer Monorepo-Struktur
+- **Projekterkennung**: Finde alle Intlayer-aktivierten Projekte in einem Workspace
+- **CI/CD**: Überprüfe Intlayer-Projekte in automatisierten Workflows
+- **Dokumentation**: Dokumentation erstellen, die alle mit Intlayer verwendeten Projekte auflistet
+
+Die Ausgabe liefert absolute Pfade zu jedem Projektverzeichnis, wodurch das Navigieren zu oder das Automatisieren von Vorgängen für mehrere Intlayer-Projekte erleichtert wird.

package/docs/de/intlayer_CMS.md

@@ -71,6 +71,26 @@ Für die Integration mit Vite + React siehe die [Installationsanleitung](https:/
 
 ## Konfiguration
 
+Führen Sie den folgenden Befehl aus, um sich beim Intlayer CMS anzumelden:
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+Dies öffnet Ihren Standardbrowser, um den Authentifizierungsprozess abzuschließen und die erforderlichen Anmeldedaten (Client ID und Client Secret) zu erhalten, um Intlayer-Dienste zu verwenden.
+
 In Ihrer Intlayer-Konfigurationsdatei können Sie die CMS-Einstellungen anpassen:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/de/intlayer_with_next-i18next.md

@@ -592,7 +592,6 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
-      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/de/intlayer_with_nextjs_14.md

@@ -74,6 +74,34 @@ bunx intlayer init
 
 ### Schritt 2: Projekt konfigurieren
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Erstellen Sie eine Konfigurationsdatei, um die Sprachen Ihrer Anwendung zu konfigurieren:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/de/intlayer_with_nextjs_15.md

@@ -84,6 +84,34 @@ bunx intlayer init
 
 ### Schritt 2: Konfigurieren Sie Ihr Projekt
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Erstellen Sie eine Konfigurationsdatei, um die Sprachen Ihrer Anwendung zu konfigurieren:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/de/intlayer_with_nextjs_16.md

@@ -104,6 +104,34 @@ bunx intlayer init
 
 ### Schritt 2: Konfigurieren Sie Ihr Projekt
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── proxy.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Erstellen Sie eine Konfigurationsdatei, um die Sprachen Ihrer Anwendung zu konfigurieren:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"