@intlayer/docs 7.2.3 → 7.3.0

package/docs/de/cli/fill.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Wörterbücher füllen
+description: Erfahren Sie, wie Sie Ihre Wörterbücher mit KI füllen, prüfen und übersetzen.
+keywords:
+  - Füllen
+  - Prüfen
+  - Übersetzen
+  - Wörterbücher
+  - CLI
+  - Intlayer
+  - KI
+slugs:
+  - doc
+  - concept
+  - cli
+  - fill
+---
+
+# Wörterbücher füllen / prüfen / übersetzen
+
+```bash
+npx intlayer fill
+```
+
+Dieser Befehl analysiert Ihre Content-Deklarationsdateien auf potenzielle Probleme wie fehlende Übersetzungen, strukturelle Inkonsistenzen oder Typabweichungen. Wenn Probleme gefunden werden, schlägt **intlayer fill** Aktualisierungen vor oder wendet sie an, um Ihre Wörterbücher konsistent und vollständig zu halten.
+
+## Aliase:
+
+- `npx intlayer dictionaries fill`
+- `npx intlayer dictionary fill`
+- `npx intlayer dic fill`
+
+## Argumente:
+
+**Optionen für die Dateiliste:**
+
+- **`-f, --file [files...]`**: Eine Liste spezifischer Content-Deklarationsdateien, die geprüft werden sollen. Wenn nicht angegeben, werden alle entdeckten `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` basierend auf Ihrer Konfigurationsdatei geprüft.
+
+  > Beispiel: `npx intlayer dictionary fill -f src/home/app.content.ts`
+
+- **`-k, --keys [keys...]`**: Filtert Wörterbücher basierend auf Schlüsseln. Wenn nicht angegeben, werden alle Wörterbücher geprüft.
+
+  > Beispiel: `npx intlayer dictionary fill -k key1 key2`
+
+- **`--key [keys...]`**: Filtert Wörterbücher basierend auf Schlüsseln (Alias für --keys).
+
+  > Beispiel: `npx intlayer dictionary fill --key key1 key2`
+
+- **`--excluded-keys [excludedKeys...]`**: Schließt Wörterbücher basierend auf Schlüsseln aus. Wenn nicht angegeben, werden alle Wörterbücher geprüft.
+
+  > Beispiel: `npx intlayer dictionary fill --excluded-keys key1 key2`
+
+- **`--excluded-key [excludedKeys...]`**: Filtert Wörterbücher basierend auf Schlüsseln heraus (Alias für --excluded-keys).
+
+  > Beispiel: `npx intlayer dictionary fill --excluded-key key1 key2`
+
+- **`--path-filter [pathFilters...]`**: Filtert Wörterbücher basierend auf einem Glob-Muster für Dateipfade.
+
+  > Beispiel: `npx intlayer dictionary fill --path-filter "src/home/**"`
+
+**Optionen für die Ausgabe von Einträgen:**
+
+- **`--source-locale [sourceLocale]`**: Die Quell-Locale, von der übersetzt werden soll. Wenn nicht angegeben, wird die Standard-Locale aus Ihrer Konfiguration verwendet.
+
+- **`--output-locales [outputLocales...]`**: Ziel-Locale(n), in die übersetzt werden soll. Wenn nicht angegeben, werden alle Locale aus Ihrer Konfiguration verwendet, außer der Quell-Locale.
+
+- **`--mode [mode]`**: Übersetzungsmodus: `complete`, `review`. Standard ist `complete`. `complete` füllt alle fehlenden Inhalte aus, `review` füllt fehlende Inhalte aus und überprüft vorhandene Schlüssel.
+
+**Git-Optionen:**
+
+- **`--git-diff`**: Nur auf Wörterbüchern ausführen, die Änderungen vom Basis-Branch (Standard `origin/main`) zum aktuellen Branch (Standard: `HEAD`) enthalten.
+- **`--git-diff-base`**: Gibt die Basis-Referenz für den Git-Diff an (Standard `origin/main`).
+- **`--git-diff-current`**: Gibt die aktuelle Referenz für den Git-Diff an (Standard: `HEAD`).
+- **`--uncommitted`**: Uncommittete Änderungen einschließen.
+- **`--unpushed`**: Nicht gepushte Änderungen einschließen.
+- **`--untracked`**: Nicht verfolgte Dateien einschließen.
+
+  > Beispiel: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Beispiel: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+**KI-Optionen:**
+
+- **`--model [model]`**: Das für die Übersetzung zu verwendende KI-Modell (z.B. `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Der KI-Anbieter, der für die Übersetzung verwendet wird.
+- **`--temperature [temperature]`**: Temperatureinstellung für das KI-Modell.
+- **`--api-key [apiKey]`**: Geben Sie Ihren eigenen API-Schlüssel für den KI-Dienst an.
+- **`--custom-prompt [prompt]`**: Geben Sie eine benutzerdefinierte Eingabeaufforderung für Ihre Übersetzungsanweisungen an.
+- **`--application-context [applicationContext]`**: Geben Sie zusätzlichen Kontext für die KI-Übersetzung an.
+
+  > Beispiel: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "Meine Anwendung ist ein Katzenladen"`
+
+**Optionen für Umgebungsvariablen:**
+
+- **`--env`**: Gibt die Umgebung an (z.B. `development`, `production`).
+- **`--env-file [envFile]`**: Gibt eine benutzerdefinierte Umgebungsdatei an, aus der Variablen geladen werden.
+
+  > Beispiel: `npx intlayer fill --env-file .env.production.local`
+
+  > Beispiel: `npx intlayer fill --env production`
+
+**Konfigurationsoptionen:**
+
+- **`--base-dir`**: Gibt das Basisverzeichnis für das Projekt an.
+
+  > Beispiel: `npx intlayer fill --base-dir ./src`
+
+- **`--no-cache`**: Deaktiviert den Cache.
+
+  > Beispiel: `npx intlayer build --no-cache`
+
+**Vorbereitungsoptionen:**
+
+- **`--build`**: Baut die Wörterbücher vor dem Pushen, um sicherzustellen, dass der Inhalt aktuell ist. True erzwingt den Build, false überspringt den Build, undefined erlaubt die Verwendung des Build-Caches.
+
+- **`--skip-metadata`**: Überspringt das Ausfüllen fehlender Metadaten (Beschreibung, Titel, Tags) für Wörterbücher.
+
+**Protokollierungsoptionen:**
+
+- **`--verbose`**: Aktiviert ausführliche Protokollierung zur Fehlerbehebung. (Standardmäßig true bei Verwendung der CLI)
+
+## Beispiel:
+
+```bash
+npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
+```
+
+Dieser Befehl übersetzt Inhalte von Englisch nach Französisch und Spanisch für alle Inhaltsdeklarationsdateien im Verzeichnis `src/home/` unter Verwendung des GPT-3.5 Turbo Modells.

package/docs/de/cli/index.md

@@ -0,0 +1,163 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+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:
+  - CLI
+  - Kommandozeilenschnittstelle
+  - Internationalisierung
+  - Dokumentation
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - cli
+history:
+  - version: 7.2.3
+    date: 2025-11-22
+    changes: Transform-Befehl hinzugefügt
+  - version: 7.1.0
+    date: 2025-11-05
+    changes: Option skipIfExists zum translate-Befehl hinzugefügt
+  - version: 6.1.4
+    date: 2025-01-27
+    changes: Aliase für CLI-Argumente und Befehle hinzugefügt
+  - version: 6.1.3
+    date: 2025-10-05
+    changes: Build-Option zu Befehlen hinzugefügt
+  - version: 6.1.2
+    date: 2025-09-26
+    changes: Versionsbefehl hinzugefügt
+  - version: 6.1.0
+    date: 2025-09-26
+    changes: Setze verbose-Option standardmäßig auf true über CLI
+  - version: 6.1.0
+    date: 2025-09-23
+    changes: Watch-Befehl und with-Option hinzugefügt
+  - version: 6.0.1
+    date: 2025-09-23
+    changes: Editor-Befehl hinzugefügt
+  - version: 6.0.0
+    date: 2025-09-17
+    changes: Content-Test- und Listen-Befehl hinzugefügt
+  - version: 5.5.11
+    date: 2025-07-11
+    changes: Dokumentation der CLI-Befehlsparameter aktualisiert
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Historie initialisiert
+---
+
+# Intlayer CLI
+
+---
+
+## Inhaltsverzeichnis
+
+<TOC/>
+
+---
+
+## Paket installieren
+
+Installieren Sie die notwendigen Pakete mit npm:
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+> Wenn das `intlayer`-Paket bereits installiert ist, wird die CLI automatisch installiert. Sie können diesen Schritt überspringen.
+
+## intlayer-cli Paket
+
+Das `intlayer-cli` Paket dient dazu, Ihre [Intlayer-Deklarationen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/content_file.md) in Wörterbücher zu transpilen.
+
+Dieses Paket transpiliert alle Intlayer-Dateien, wie z.B. `src/**/*.content.{ts|js|mjs|cjs|json}`. [Siehe, wie man Intlayer-Deklarationsdateien erstellt](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+
+Um Intlayer-Wörterbücher zu interpretieren, können Sie Interpreter verwenden, wie z.B. [react-intlayer](https://www.npmjs.com/package/react-intlayer) oder [next-intlayer](https://www.npmjs.com/package/next-intlayer).
+
+## Unterstützung von Konfigurationsdateien
+
+Intlayer akzeptiert mehrere Formate für Konfigurationsdateien:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Um zu sehen, wie verfügbare Sprachen oder andere Parameter konfiguriert werden, lesen Sie die [Konfigurationsdokumentation hier](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md).
+
+## Intlayer-Befehle ausführen
+
+### Kernbefehle
+
+- **[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
+
+### Wörterbuchverwaltung
+
+- **[Dictionaries pushen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/push.md)** – Pushen Sie Wörterbücher zum Intlayer-Editor und CMS
+- **[Dictionaries abrufen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/pull.md)** – Holen Sie Wörterbücher aus dem Intlayer-Editor und CMS
+- **[Dictionaries füllen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/fill.md)** – Füllen, prüfen und übersetzen Sie Wörterbücher mithilfe von KI
+- **[Fehlende Übersetzungen testen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/test.md)** – Testen und identifizieren Sie fehlende Übersetzungen
+- **[Inhaltsdeklarationsdateien auflisten](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/list.md)** – Listen Sie alle Inhaltsdeklarationsdateien in Ihrem Projekt auf
+
+### Komponentenverwaltung
+
+- **[Komponenten transformieren](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/transform.md)** – Bestehende Komponenten transformieren, um Intlayer zu verwenden
+
+### Konfiguration
+
+- **[Konfiguration verwalten](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/configuration.md)** – Ihre Intlayer-Konfiguration abrufen und ins CMS übertragen
+
+### Dokumentationsverwaltung
+
+- **[Dokument übersetzen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/doc-translate.md)** – Dokumentationsdateien automatisch mit KI übersetzen
+- **[Dokument überprüfen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/doc-review.md)** – Dokumentationsdateien auf Qualität und Konsistenz prüfen
+
+### Editor & Live Sync
+
+- **[Editor-Befehle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/editor.md)** – Verwenden Sie die Intlayer-Editor-Befehle
+- **[Live-Sync-Befehle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/live.md)** – Verwenden Sie Live Sync, um CMS-Inhaltsänderungen zur Laufzeit widerzuspiegeln
+
+### Entwicklungstools
+
+- **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/sdk.md)** – Verwenden Sie das Intlayer CLI SDK in Ihrem eigenen Code
+- **[Intlayer Debug-Befehl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/debug.md)** – Debuggen und beheben Sie Probleme mit dem Intlayer CLI
+
+## Verwenden Sie Intlayer-Befehle in Ihrer `package.json`
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:build": "npx intlayer build",
+  "intlayer:watch": "npx intlayer build --watch",
+  "intlayer:push": "npx intlayer push",
+  "intlayer:pull": "npx intlayer pull",
+  "intlayer:fill": "npx intlayer fill",
+  "intlayer:list": "npx intlayer content list",
+  "intlayer:test": "npx intlayer content test",
+  "intlayer:transform": "npx intlayer transform",
+  "intlayer:doc:translate": "npx intlayer doc translate",
+  "intlayer:doc:review": "npx intlayer doc review"
+}
+```
+
+> **Hinweis**: Sie können auch die kürzeren Aliase verwenden:
+>
+> - `npx intlayer list` anstelle von `npx intlayer content list`
+> - `npx intlayer test` anstelle von `npx intlayer content test`

package/docs/de/cli/list.md

@@ -0,0 +1,53 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Inhaltsdeklarationsdateien auflisten
+description: Erfahren Sie, wie Sie alle Inhaltsdeklarationsdateien in Ihrem Projekt auflisten können.
+keywords:
+  - Auflisten
+  - Inhaltsdeklaration
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - list
+---
+
+# Inhaltsdeklarationsdateien auflisten
+
+```bash
+npx intlayer content list
+```
+
+## Aliase:
+
+- `npx intlayer 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:
+
+```bash
+npx intlayer content list
+```
+
+## Beispielausgabe:
+
+```bash
+npx intlayer content list
+Inhaltsdeklarationsdateien:
+ - home-page        - src/components/HomePage/homePage.content.ts
+ - server-component - src/components/ServerComponent/serverComponent.content.ts
+ - client-component - src/components/ClientComponent/clientComponent.content.ts
+
+Gesamtanzahl der Inhaltsdeklarationsdateien: 3
+```
+
+Dieser Befehl gibt aus:
+
+- Eine formatierte Liste aller Inhaltsdeklarationsdateien mit ihren Schlüsseln und relativen Dateipfaden
+- Die Gesamtanzahl der gefundenen Inhaltsdeklarationsdateien
+
+Die Ausgabe hilft Ihnen zu überprüfen, ob alle Ihre Inhaltsdateien korrekt konfiguriert und vom Intlayer-System erkannt werden.

package/docs/de/cli/live.md

@@ -0,0 +1,41 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Live-Sync-Befehle
+description: Erfahren Sie, wie Sie Live Sync verwenden, um CMS-Inhaltsänderungen zur Laufzeit widerzuspiegeln.
+keywords:
+  - Live Sync
+  - CMS
+  - Laufzeit
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - live
+---
+
+# Live-Sync-Befehle
+
+Live Sync ermöglicht es Ihrer App, CMS-Inhaltsänderungen zur Laufzeit widerzuspiegeln. Kein Neuaufbau oder erneutes Bereitstellen erforderlich. Wenn aktiviert, werden Updates an einen Live-Sync-Server gestreamt, der die Wörterbücher aktualisiert, die Ihre Anwendung liest. Weitere Details finden Sie unter [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_CMS.md).
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:live:start": "npx intlayer live start --with 'next dev --turbopack'"
+}
+```
+
+## Argumente:
+
+**Konfigurationsoptionen:**
+
+- **`--base-dir`**: Geben Sie das Basisverzeichnis für das Projekt an. Um die Intlayer-Konfiguration abzurufen, sucht der Befehl im Basisverzeichnis nach der Datei `intlayer.config.{ts,js,json,cjs,mjs}`.
+
+- **`--no-cache`**: Deaktivieren Sie den Cache.
+
+  > Beispiel: `npx intlayer dictionary push --env-file .env.production.local`
+
+**Protokolloptionen:**
+
+- **`--verbose`**: Aktivieren Sie ausführliche Protokollierung zur Fehlerbehebung. (Standardmäßig über CLI auf true gesetzt)

package/docs/de/cli/pull.md

@@ -0,0 +1,78 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Wörterbücher herunterladen
+description: Erfahren Sie, wie Sie Wörterbücher aus dem Intlayer-Editor und CMS herunterladen.
+keywords:
+  - Herunterladen
+  - Wörterbücher
+  - CLI
+  - Intlayer
+  - Editor
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - pull
+---
+
+# Entfernte Wörterbücher herunterladen
+
+```bash
+npx intlayer pull
+```
+
+Wenn der [Intlayer Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_visual_editor.md) installiert ist, können Sie Wörterbücher auch direkt aus dem Editor herunterladen. Auf diese Weise können Sie den Inhalt Ihrer Wörterbücher für die Anforderungen Ihrer Anwendung überschreiben.
+
+## Aliase:
+
+- `npx intlayer dictionaries pull`
+- `npx intlayer dictionary pull`
+- `npx intlayer dic pull`
+
+## Argumente:
+
+**Wörterbuch-Optionen:**
+
+- **`-d, --dictionaries`**: IDs der Wörterbücher, die heruntergeladen werden sollen. Wenn nicht angegeben, werden alle Wörterbücher heruntergeladen.
+
+  > Beispiel: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: IDs der Wörterbücher, die heruntergeladen werden sollen (Alias für --dictionaries).
+
+  > Beispiel: `npx intlayer dictionary pull --dictionary my-dictionary-id my-other-dictionary-id`
+
+**Konfigurationsoptionen:**
+
+- **`--base-dir`**: Gibt das Basisverzeichnis für das Projekt an. Um die Intlayer-Konfiguration zu finden, sucht der Befehl im Basisverzeichnis nach der Datei `intlayer.config.{ts,js,json,cjs,mjs}`.
+
+  > Beispiel: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: Deaktiviert den Cache.
+
+  > Beispiel: `npx intlayer build --no-cache`
+
+**Umgebungsvariablen-Optionen:**
+
+- **`--env`**: Gibt die Umgebung an (z. B. `development`, `production`).
+- **`--env-file`**: Gibt eine benutzerdefinierte Umgebungsdatei an, aus der Variablen geladen werden.
+- **`--base-dir`**: Gibt das Basisverzeichnis für das Projekt an. Um die Intlayer-Konfiguration zu finden, sucht der Befehl im Basisverzeichnis nach der Datei `intlayer.config.{ts,js,json,cjs,mjs}`.
+
+  > Beispiel: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Beispiel: `npx intlayer dictionary push --env production`
+
+**Ausgabeoptionen:**
+
+- **`--new-dictionaries-path`** : Pfad zum Verzeichnis, in dem die neuen Wörterbücher gespeichert werden. Wenn nicht angegeben, werden die neuen Wörterbücher im Verzeichnis `./intlayer-dictionaries` des Projekts gespeichert. Wenn in Ihrem Wörterbuchinhalt ein `filePath`-Feld angegeben ist, wird dieses Argument von den Wörterbüchern nicht berücksichtigt und sie werden im angegebenen `filePath`-Verzeichnis gespeichert.
+
+**Protokollierungsoptionen:**
+
+- **`--verbose`**: Aktiviert ausführliche Protokollierung zur Fehlerbehebung. (Standardmäßig über CLI auf true gesetzt)
+
+## Beispiel:
+
+```bash
+npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
+```

package/docs/de/cli/push.md

@@ -0,0 +1,98 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Wörterbücher pushen
+description: Erfahren Sie, wie Sie Ihre Wörterbücher in den Intlayer-Editor und das CMS pushen.
+keywords:
+  - Push
+  - Wörterbücher
+  - CLI
+  - Intlayer
+  - Editor
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - push
+---
+
+# Wörterbücher pushen
+
+```bash
+npx intlayer dictionary push
+```
+
+Wenn der [intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_visual_editor.md) installiert ist, können Sie Wörterbücher auch in den Editor pushen. Dieser Befehl ermöglicht es, die Wörterbücher im [Editor](https://intlayer.org/dashboard) verfügbar zu machen. So können Sie Ihre Wörterbücher mit Ihrem Team teilen und Ihre Inhalte bearbeiten, ohne den Code Ihrer Anwendung zu ändern.
+
+## Aliase:
+
+- `npx intlayer dictionaries push`
+- `npx intlayer dictionary push`
+- `npx intlayer dic push`
+
+## Argumente:
+
+**Wörterbuch-Optionen:**
+
+- **`-d`, `--dictionaries`**: IDs der Wörterbücher, die gepusht werden sollen. Wenn nicht angegeben, werden alle Wörterbücher gepusht.
+
+  > Beispiel: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
+
+- **`--dictionary`**: IDs der Wörterbücher, die gepusht werden sollen (Alias für --dictionaries).
+
+  > Beispiel: `npx intlayer dictionary push --dictionary my-dictionary-id my-other-dictionary-id`
+
+**Konfigurationsoptionen:**
+
+- **`--base-dir`**: Gibt das Basisverzeichnis für das Projekt an. Um die Intlayer-Konfiguration zu laden, sucht der Befehl im Basisverzeichnis nach der Datei `intlayer.config.{ts,js,json,cjs,mjs}`.
+
+  > Beispiel: `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`**: Deaktiviert den Cache.
+
+  > Beispiel: `npx intlayer build --no-cache`
+
+**Optionen für Umgebungsvariablen:**
+
+- **`--env`**: Gibt die Umgebung an (z.B. `development`, `production`). Nützlich, wenn Sie Umgebungsvariablen in Ihrer Intlayer-Konfigurationsdatei verwenden.
+- **`--env-file`**: Gibt eine benutzerdefinierte Umgebungsdatei an, aus der Variablen geladen werden. Nützlich, wenn Sie Umgebungsvariablen in Ihrer Intlayer-Konfigurationsdatei verwenden.
+
+  > Beispiel: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Beispiel: `npx intlayer dictionary push --env production`
+
+**Ausgabeoptionen:**
+
+- **`-r`, `--delete-locale-dictionary`**: Überspringt die Frage, ob die Verzeichnisse der Sprachen gelöscht werden sollen, nachdem die Wörterbücher hochgeladen wurden, und entfernt diese. Standardmäßig wird, wenn das Wörterbuch lokal definiert ist, der Inhalt der entfernten Wörterbücher überschrieben.
+
+  > Beispiel: `npx intlayer dictionary push -r`
+
+  > Beispiel: `npx intlayer dictionary push --delete-locale-dictionary`
+
+- **`-k`, `--keep-locale-dictionary`**: Überspringt die Frage, ob die Verzeichnisse der Sprachen gelöscht werden sollen, nachdem die Wörterbücher hochgeladen wurden, und behält diese. Standardmäßig wird, wenn das Wörterbuch lokal definiert ist, der Inhalt der entfernten Wörterbücher überschrieben.
+
+  > Beispiel: `npx intlayer dictionary push -k`
+
+  > Beispiel: `npx intlayer dictionary push --keep-locale-dictionary`
+
+**Vorbereitungsoptionen:**
+
+- **`--build`**: Baut die Wörterbücher vor dem Hochladen, um sicherzustellen, dass der Inhalt aktuell ist. True erzwingt den Build, false überspringt den Build, undefined erlaubt die Verwendung des Build-Caches.
+
+**Protokollierungsoptionen:**
+
+- **`--verbose`**: Aktiviert ausführliche Protokollierung zur Fehlerbehebung. (Standardmäßig true bei Verwendung der CLI)
+
+**Git-Optionen:**
+
+- **`--git-diff`**: Führt den Vorgang nur für Wörterbücher aus, die Änderungen vom Basis-Branch (Standard `origin/main`) zum aktuellen Branch (Standard: `HEAD`) enthalten.
+- **`--git-diff-base`**: Gibt die Basisreferenz für den Git-Diff an (Standard `origin/main`).
+- **`--git-diff-current`**: Gibt die aktuelle Referenz für den Git-Diff an (Standard: `HEAD`).
+- **`--uncommitted`**: Bezieht nicht committete Änderungen mit ein.
+- **`--unpushed`**: Bezieht nicht gepushte Änderungen mit ein.
+- **`--untracked`**: Bezieht nicht verfolgte Dateien mit ein.
+
+  > Beispiel: `npx intlayer dictionary push --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Beispiel: `npx intlayer dictionary push --uncommitted --unpushed --untracked`

package/docs/de/cli/sdk.md

@@ -0,0 +1,67 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: CLI SDK
+description: Erfahren Sie, wie Sie das Intlayer CLI SDK in Ihrem eigenen Code verwenden.
+keywords:
+  - SDK
+  - CLI
+  - Intlayer
+  - Programmgesteuert
+slugs:
+  - doc
+  - concept
+  - cli
+  - sdk
+---
+
+# CLI SDK
+
+Das CLI SDK ist eine Bibliothek, die es Ihnen ermöglicht, das Intlayer CLI in Ihrem eigenen Code zu verwenden.
+
+```bash packageManager="npm"
+npm install @intlayer/cli --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli --save-dev
+```
+
+Beispiel für die Verwendung:
+
+```ts
+import {
+  push,
+  pull,
+  fill,
+  build,
+  listContentDeclaration,
+  testMissingTranslations,
+  docTranslate,
+  docReview,
+  transform,
+} from "@intlayer/cli";
+
+push();
+// ...
+pull();
+// ...
+fill();
+// ...
+build();
+// ...
+listContentDeclaration();
+// ...
+testMissingTranslations();
+// ...
+docTranslate();
+// ...
+docReview();
+// ...
+transform();
+// ...
+```