@intlayer/docs 5.5.12 → 5.7.0

package/docs/de/intlayer_cli.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
+updatedAt: 2025-07-11
 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
-  - Befehlszeilenschnittstelle
+  - Kommandozeilenschnittstelle
   - Internationalisierung
   - Dokumentation
   - Intlayer
@@ -40,15 +40,15 @@ pnpm add intlayer-cli -g
 
 ## intlayer-cli Paket
 
-Das `intlayer-cli` Paket dient dazu, Ihre [intlayer-Deklarationen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/get_started.md) in Wörterbücher zu transpiliieren.
+Das `intlayer-cli` Paket dient dazu, Ihre [intlayer Deklarationen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/get_started.md) in Wörterbücher zu transpillieren.
 
-Dieses Paket transpiliert alle intlayer-Dateien, wie z.B. `src/**/*.content.{ts|js|mjs|cjs|json}`. [Siehe, wie Sie Ihre Intlayer-Deklarationsdateien deklarieren](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+Dieses Paket transpilliert alle Intlayer-Dateien, wie z.B. `src/**/*.content.{ts|js|mjs|cjs|json}`. [Siehe, wie Sie Ihre Intlayer-Deklarationsdateien deklarieren](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).
+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 für Konfigurationsdateien
+## Unterstützung von Konfigurationsdateien
 
-Intlayer akzeptiert mehrere Konfigurationsdateiformate:
+Intlayer akzeptiert mehrere Formate für Konfigurationsdateien:
 
 - `intlayer.config.ts`
 - `intlayer.config.js`
@@ -57,49 +57,7 @@ Intlayer akzeptiert mehrere Konfigurationsdateiformate:
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
-Um zu sehen, wie verfügbare Sprachen oder andere Parameter konfiguriert werden, siehe die [Konfigurationsdokumentation hier](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md).
-
-## CLI SDK
-
-Das CLI SDK ist eine Bibliothek, die es Ihnen ermöglicht, die Intlayer CLI in Ihrem eigenen Code zu verwenden.
-
-```bash packageManager="npm"
-npm install @intlayer/cli -D
-```
-
-```bash packageManager="yarn"
-yarn add @intlayer/cli -D
-```
-
-```bash packageManager="pnpm"
-pnpm add @intlayer/cli -D
-```
-
-Beispiel für die Verwendung:
-
-```ts
-import {
-  push,
-  pull,
-  fill,
-  build,
-  docTranslate,
-  docReview,
-} from "@intlayer/cli";
-
-push();
-// ...
-pull();
-// ...
-fill();
-// ...
-build();
-// ...
-docTranslate();
-// ...
-docReview();
-// ...
-```
+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
 
@@ -111,13 +69,13 @@ Um Ihre Wörterbücher zu erstellen, können Sie die folgenden Befehle ausführe
 npx intlayer build
 ```
 
-oder im Überwachungsmodus
+oder im Watch-Modus
 
 ```bash
 npx intlayer build --watch
 ```
 
-Dieser Befehl findet standardmäßig Ihre Deklarationsinhaltsdateien unter `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}` und erstellt die Wörterbücher im Verzeichnis `.intlayer`.
+Dieser Befehl findet standardmäßig Ihre Deklarations-Content-Dateien unter `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}` und erstellt die Wörterbücher im Verzeichnis `.intlayer`.
 
 ##### Aliase:
 
@@ -125,13 +83,14 @@ Dieser Befehl findet standardmäßig Ihre Deklarationsinhaltsdateien unter `./sr
 - `npx intlayer dictionary build`
 - `npx intlayer dic build`
 
-### Wörterbücher hochladen
+### Wörterbücher pushen
 
 ```bash
+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 an den Editor senden. Dieser Befehl ermöglicht es, die Wörterbücher im [Editor](https://intlayer.org/dashboard) verfügbar zu machen. Auf diese Weise können Sie Ihre Wörterbücher mit Ihrem Team teilen und Ihre Inhalte bearbeiten, ohne den Code Ihrer Anwendung ändern zu müssen.
+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 an den Editor senden. 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 ändern zu müssen.
 
 ##### Aliase:
 
@@ -141,22 +100,57 @@ Wenn der [intlayer Editor](https://github.com/aymericzip/intlayer/blob/main/docs
 
 ##### Argumente:
 
-- `-d`, `--dictionaries`: IDs der Wörterbücher, die gepusht werden sollen. Wenn nicht angegeben, werden alle Wörterbücher gepusht.
+**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`
-- `-r`, `--deleteLocaleDictionary`: Überspringt die Frage, ob die Verzeichnisse der Sprachen gelöscht werden sollen, nachdem die Wörterbücher hochgeladen wurden, und entfernt sie. Standardmäßig wird, wenn das Wörterbuch lokal definiert ist, der Inhalt der entfernten Wörterbücher überschrieben.
+
+**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`
+
+**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 sollen. 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`
-- `-k`, `--keepLocaleDictionary`: Überspringt die Frage, ob die Verzeichnisse der Sprachen gelöscht werden sollen, nachdem die Wörterbücher hochgeladen wurden, und behält sie. Standardmäßig wird, wenn das Wörterbuch lokal definiert ist, der Inhalt der entfernten Wörterbücher überschrieben.
+
+  > 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 bei. Standardmäßig wird, wenn das Wörterbuch lokal definiert ist, der Inhalt der entfernten Wörterbücher überschrieben.
+
   > Beispiel: `npx intlayer dictionary push -k`
-- `--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.
-- `--verbose`: Aktiviert ausführliche Protokollierung zur Fehlerbehebung.
-- `--git-diff`: Führt den Befehl 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 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`: Bezieht nicht festgeschriebene Änderungen mit ein.
-- `--unpushed`: Bezieht nicht gepushte Änderungen mit ein.
-- `--untracked`: Bezieht nicht verfolgte Dateien mit ein.
+
+  > Beispiel: `npx intlayer dictionary push --keep-locale-dictionary`
+
+**Protokolloptionen:**
+
+- **`--verbose`**: Aktiviert ausführliche Protokollierung zur Fehlerbehebung.
+
+**Git-Optionen:**
+
+- **`--git-diff`**: Führt den Befehl 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 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`**: Bezieht nicht festgeschriebene Ä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`
 
 ### Entfernte Wörterbücher abrufen
 
@@ -164,7 +158,7 @@ Wenn der [intlayer Editor](https://github.com/aymericzip/intlayer/blob/main/docs
 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 auch Wörterbücher aus dem Editor abrufen. Auf diese Weise können Sie den Inhalt Ihrer Wörterbücher für die Bedürfnisse Ihrer Anwendung überschreiben.
+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 abrufen. Auf diese Weise können Sie den Inhalt Ihrer Wörterbücher für die Anforderungen Ihrer Anwendung überschreiben.
 
 ##### Aliase:
 
@@ -174,13 +168,35 @@ Wenn der [intlayer Editor](https://github.com/aymericzip/intlayer/blob/main/docs
 
 ##### Argumente:
 
-- `-d, --dictionaries`: IDs der abzurufenden Wörterbücher. Wenn nicht angegeben, werden alle Wörterbücher abgerufen.
+**Wörterbuch-Optionen:**
+
+- **`-d, --dictionaries`**: IDs der Wörterbücher, die abgerufen werden sollen. Wenn nicht angegeben, werden alle Wörterbücher abgerufen.
+
   > Beispiel: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
-- `--newDictionariesPath` : 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.
-- `--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.
-- `--verbose`: Aktiviert ausführliche Protokollierung zur Fehlerbehebung.
+
+**Konfigurationsoptionen:**
+
+- **`--base-dir`**: Gibt 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}`.
+
+  > Beispiel: `npx intlayer dictionary push --env-file .env.production.local`
+
+**Optionen für Umgebungsvariablen:**
+
+- **`--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 abzurufen, 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 die Wörterbücher werden im angegebenen `filePath`-Verzeichnis gespeichert.
+
+**Protokollierungsoptionen:**
+
+- **`--verbose`**: Aktiviert ausführliche Protokollierung zur Fehlerbehebung.
 
 ##### Beispiel:
 
@@ -194,7 +210,7 @@ npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
 npx intlayer fill
 ```
 
-Dieser Befehl analysiert Ihre Inhaltsdeklarationsdateien auf mögliche 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.
+Dieser Befehl analysiert Ihre Content-Deklarationsdateien auf potenzielle Probleme wie fehlende Übersetzungen, strukturelle Inkonsistenzen oder Typinkompatibilitäten. Wenn Probleme gefunden werden, wird **intlayer fill** Aktualisierungen vorschlagen oder anwenden, um Ihre Wörterbücher konsistent und vollständig zu halten.
 
 ##### Aliase:
 
@@ -204,76 +220,74 @@ Dieser Befehl analysiert Ihre Inhaltsdeklarationsdateien auf mögliche Probleme
 
 ##### Argumente:
 
-- `-f, --file [files...]`
-  Eine Liste spezifischer Inhaltsdeklarationsdateien, die geprüft werden sollen. Wenn nicht angegeben, werden alle gefundenen `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` Dateien geprüft.
+**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`
 
-- `--exclude [excludedGlobs...]`
-  Globs-Muster, die von der Prüfung ausgeschlossen werden sollen (z.B. `--exclude "src/test/**"`).
+- **`-k, --keys [keys...]`**: Filtert Wörterbücher basierend auf Schlüsseln. Wenn nicht angegeben, werden alle Wörterbücher geprüft.
 
-- `--source-locale [sourceLocale]`
-  Die Quellsprache, aus der übersetzt werden soll. Wenn nicht angegeben, wird die Standardsprache aus Ihrer Konfiguration verwendet.
+  > Beispiel: `npx intlayer dictionary fill -k key1 key2`
 
-- `--output-locales [outputLocales...]`
-  Zielsprachen, in die übersetzt werden soll. Wenn nicht angegeben, werden alle Sprachen aus Ihrer Konfiguration verwendet, außer der Quellsprache.
+- **`--excluded-keys [excludedKeys...]`**: Schließt Wörterbücher basierend auf Schlüsseln aus. Wenn nicht angegeben, werden alle Wörterbücher geprüft.
 
-- `--mode [mode]`
-  Übersetzungsmodus: 'complete', 'review' oder 'missing-only'. Standard ist 'missing-only'.
+  > Beispiel: `npx intlayer dictionary fill --excluded-keys key1 key2`
 
-- `--git-diff`
-  Filtert Wörterbücher, die Änderungen vom Basis-Branch (Standard `origin/main`) zum aktuellen Branch (Standard: `HEAD`) enthalten.
+- **`--path-filter [pathFilters...]`**: Filtert Wörterbücher basierend auf einem Glob-Muster für Dateipfade.
 
-- `--git-diff-base`
-  Gibt die Basisreferenz für den Git-Diff an (Standard `origin/main`).
+  > Beispiel: `npx intlayer dictionary fill --path-filter "src/home/**"`
 
-- `--git-diff-current`
-  Gibt die aktuelle Referenz für den Git-Diff an (Standard: `HEAD`).
+**Optionen für die Ausgabe der Einträge:**
 
-- `--uncommitted`
-  Filtert Wörterbücher, die nicht committete Änderungen enthalten.
+- **`--source-locale [sourceLocale]`**: Die Quellsprache, aus der übersetzt werden soll. Wenn nicht angegeben, wird die Standardsprache aus Ihrer Konfiguration verwendet.
 
-- `--unpushed`
-- Filtert Wörterbücher, die unübertragene Änderungen enthalten.
+- **`--output-locales [outputLocales...]`**: Ziel-Lokalisierungen, in die übersetzt werden soll. Wenn nicht angegeben, werden alle Lokalisierungen aus Ihrer Konfiguration verwendet, außer der Quell-Lokalisierung.
 
-- `--untracked`
-  Filtert Wörterbücher, die nicht verfolgte Dateien enthalten.
+- **`--mode [mode]`**: Übersetzungsmodus: 'complete' (vollständig), 'review' (Überprüfung) oder 'missing-only' (nur fehlende). Standard ist 'missing-only'.
 
-- `--keys [keys...]`
-  Filtert Wörterbücher basierend auf angegebenen Schlüsseln.
+**Git-Optionen:**
 
-- `--excluded-keys [excludedKeys...]`
-  Schließt Wörterbücher basierend auf angegebenen Schlüsseln aus.
+- **`--git-diff`**: Nur auf Wörterbücher anwenden, die Änderungen vom Basis-Branch (Standard `origin/main`) zum aktuellen Branch (Standard: `HEAD`) enthalten.
+- **`--git-diff-base`**: Basis-Referenz für den Git-Diff angeben (Standard `origin/main`).
+- **`--git-diff-current`**: Aktuelle Referenz für den Git-Diff angeben (Standard: `HEAD`).
+- **`--uncommitted`**: Uncommittete Änderungen einbeziehen.
+- **`--unpushed`**: Nicht gepushte Änderungen einbeziehen.
+- **`--untracked`**: Nicht verfolgte Dateien einbeziehen.
 
-- `--path-filter [pathFilters...]`
-  Filtert Wörterbücher basierend auf einem Glob-Muster für Dateipfade.
+  > Beispiel: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
 
-- `--model [model]`
-  Das KI-Modell, das für die Übersetzung verwendet wird (z. B. `gpt-3.5-turbo`).
+  > Beispiel: `npx intlayer doc translate --uncommitted --unpushed --untracked`
 
-- `--provider [provider]`
-  Der KI-Anbieter, der für die Übersetzung verwendet wird.
+**KI-Optionen:**
 
-- `--temperature [temperature]`
-  Temperatureinstellung für das KI-Modell.
+- **`--model [model]`**: Das KI-Modell, das für die Übersetzung verwendet werden soll (z.B. `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Der KI-Anbieter, der für die Übersetzung verwendet werden soll.
+- **`--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:**
 
-- `--api-key [apiKey]`
-  Geben Sie Ihren eigenen API-Schlüssel für den KI-Dienst an.
+- **`--env`**: Gibt die Umgebung an (z. B. `development`, `production`).
+- **`--env-file [envFile]`**: Gibt eine benutzerdefinierte Umgebungsdatei an, aus der Variablen geladen werden.
 
-- `--custom-prompt [prompt]`
-  Geben Sie eine benutzerdefinierte Eingabeaufforderung für Ihre Übersetzungsanweisungen an.
-- `--application-context [applicationContext]`  
-  Zusätzlichen Kontext für die KI-Übersetzung bereitstellen.
+  > Beispiel: `npx intlayer fill --env-file .env.production.local`
 
-- `--env`  
-  Die Umgebung angeben (z.B. `development`, `production`).
+  > Beispiel: `npx intlayer fill --env production`
 
-- `--env-file [envFile]`  
-  Eine benutzerdefinierte Umgebungsdatei zum Laden von Variablen bereitstellen.
+**Konfigurationsoptionen:**
 
-- `--base-dir`  
-  Das Basisverzeichnis für das Projekt angeben.
+- **`--base-dir`**: Gibt das Basisverzeichnis für das Projekt an.
 
-- `--verbose`  
-  Ausführliche Protokollierung zur Fehlerbehebung aktivieren.
+  > Beispiel: `npx intlayer fill --base-dir ./src`
+
+**Protokollierungsoptionen:**
+
+- **`--verbose`**: Aktiviert ausführliche Protokollierung zur Fehlerbehebung.
 
 ##### Beispiel:
 
@@ -281,13 +295,13 @@ Dieser Befehl analysiert Ihre Inhaltsdeklarationsdateien auf mögliche Probleme
 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.
+Dieser Befehl übersetzt Inhalte von Englisch ins Französische und Spanische für alle Inhaltsdeklarationsdateien im Verzeichnis `src/home/` unter Verwendung des GPT-3.5 Turbo Modells.
 
 ### Konfiguration verwalten
 
 #### Konfiguration abrufen
 
-Der Befehl `configuration get` ruft die aktuelle Konfiguration für Intlayer ab, insbesondere die Locale-Einstellungen. Dies ist nützlich, um Ihre Einrichtung zu überprüfen.
+Der Befehl `configuration get` ruft die aktuelle Konfiguration von Intlayer ab, insbesondere die Locale-Einstellungen. Dies ist nützlich, um Ihre Einrichtung zu überprüfen.
 
 ```bash
 npx intlayer configuration get
@@ -300,12 +314,12 @@ npx intlayer configuration get
 
 ##### Argumente:
 
-- **`--env`**: Gibt die Umgebung an (z. B. `development`, `production`).
-- **`--env-file`**: Gibt eine benutzerdefinierte Umgebungsdatei an, aus der Variablen geladen werden.
+- **`--env`**: Geben Sie die Umgebung an (z.B. `development`, `production`).
+- **`--env-file`**: Geben Sie eine benutzerdefinierte Umgebungsdatei an, aus der Variablen geladen werden.
 - **`--base-dir`**: Gibt das Basisverzeichnis für das Projekt an.
 - **`--verbose`**: Aktiviert ausführliche Protokollierung zur Fehlerbehebung.
 
-#### Konfiguration hochladen
+#### Konfiguration pushen
 
 Der Befehl `configuration push` lädt Ihre Konfiguration in das Intlayer CMS und den Editor hoch. Dieser Schritt ist notwendig, um die Verwendung entfernter Wörterbücher im Intlayer Visual Editor zu ermöglichen.
 
@@ -329,11 +343,11 @@ Durch das Pushen der Konfiguration ist Ihr Projekt vollständig in das Intlayer
 
 ### Dokumentationsverwaltung
 
-Die `doc`-Befehle bieten Werkzeuge zur Verwaltung und Übersetzung von Dokumentationsdateien in mehreren Sprachen.
+Die `doc`-Befehle bieten Werkzeuge zur Verwaltung und Übersetzung von Dokumentationsdateien in mehreren Sprachversionen.
 
 #### Dokumentation übersetzen
 
-Der Befehl `doc translate` übersetzt automatisch Dokumentationsdateien von einer Basissprache in Zielsprachen mithilfe von KI-Übersetzungsdiensten.
+Der Befehl `doc translate` übersetzt Dokumentationsdateien automatisch von einer Basissprache in Zielsprachen mithilfe von KI-Übersetzungsdiensten.
 
 ```bash
 npx intlayer doc translate
@@ -341,47 +355,107 @@ npx intlayer doc translate
 
 ##### Argumente:
 
-- **`--doc-pattern [docPattern...]`**: Glob-Muster, um die zu übersetzenden Dokumentationsdateien auszuwählen.
+**Optionen für die Dateiliste:**
+
+- **`--doc-pattern [docPattern...]`**: Glob-Muster, um Dokumentationsdateien zum Übersetzen auszuwählen.
+
   > Beispiel: `npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
-- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Glob-Muster, um Dateien von der Übersetzung auszuschließen.
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Glob-Muster, die von der Übersetzung ausgeschlossen werden sollen.
+
   > Beispiel: `npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"`
-- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Anzahl der Dateien, die gleichzeitig zur Übersetzung verarbeitet werden.
-  > Beispiel: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Überspringe die Datei, wenn sie vor dem angegebenen Zeitpunkt geändert wurde.
+
+  - Kann eine absolute Zeit wie "2025-12-05" sein (String oder Date)
+  - Kann eine relative Zeit in ms sein `1 * 60 * 60 * 1000` (1 Stunde)
+  - Diese Option prüft die Aktualisierungszeit der Datei mit der Methode `fs.stat`. Daher kann sie durch Git oder andere Tools, die die Datei ändern, beeinflusst werden.
+
+  > Beispiel: `npx intlayer doc translate --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Überspringe die Datei, wenn sie innerhalb des angegebenen Zeitraums geändert wurde.
+
+  - Kann eine absolute Zeit sein wie "2025-12-05" (String oder Date)
+  - Kann eine relative Zeit in ms sein `1 * 60 * 60 * 1000` (1 Stunde)
+  - Diese Option überprüft die Aktualisierungszeit der Datei mit der Methode `fs.stat`. Daher kann sie durch Git oder andere Tools, die die Datei ändern, beeinflusst werden.
+
+  > Beispiel: `npx intlayer doc translate --skip-if-modified-after "2025-12-05"`
+
+**Optionen für die Ausgabe:**
+
 - **`--locales [locales...]`**: Ziel-Lokalisierungen, in die die Dokumentation übersetzt werden soll.
+
   > Beispiel: `npx intlayer doc translate --locales fr es de`
-- **`--base-locale [baseLocale]`**: Ausgangslokalisierung, von der übersetzt wird.
+
+- **`--base-locale [baseLocale]`**: Quell-Lokalisierung, aus der übersetzt werden soll.
+
   > Beispiel: `npx intlayer doc translate --base-locale en`
-- **`--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.
+
+**Optionen zur Dateiverarbeitung:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Anzahl der Dateien, die gleichzeitig für die Übersetzung verarbeitet werden sollen.
+
+  > Beispiel: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+**KI-Optionen:**
+
+- **`--model [model]`**: Das KI-Modell, das für die Übersetzung verwendet werden soll (z. B. `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Der KI-Anbieter, der für die Übersetzung verwendet werden soll.
 - **`--temperature [temperature]`**: Temperatureinstellung für das KI-Modell.
 - **`--api-key [apiKey]`**: Eigener API-Schlüssel für den KI-Dienst.
-- **`--custom-prompt [prompt]`**: Eigene Eingabeaufforderung für Übersetzungsanweisungen.
 - **`--application-context [applicationContext]`**: Zusätzlicher Kontext für die KI-Übersetzung.
-- **`--env`**: Gibt die Umgebung an (z.B. `development`, `production`).
-- **`--env-file [envFile]`**: Gibt eine benutzerdefinierte Umgebungsdatei an, aus der Variablen geladen werden.
-- **`--base-dir`**: Gibt das Basisverzeichnis für das Projekt an.
-- **`--verbose`**: Aktiviert ausführliche Protokollierung zur Fehlerbehebung.
+- **`--custom-prompt [prompt]`**: Passen Sie den Basis-Prompt für die Übersetzung an. (Hinweis: Für die meisten Anwendungsfälle wird stattdessen die Option `--custom-instructions` empfohlen, da sie eine bessere Kontrolle über das Übersetzungsverhalten bietet.)
+
+  > Beispiel: `npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Meine Anwendung ist ein Katzenladen"`
+
+**Optionen für Umgebungsvariablen:**
+
+- **`--env`**: Geben Sie die Umgebung an (z. B. `development`, `production`).
+- **`--env-file [envFile]`**: Geben Sie eine benutzerdefinierte Umgebungsdatei an, aus der Variablen geladen werden.
+- **`--base-dir`**: Geben Sie das Basisverzeichnis für das Projekt an.
+
+  > Beispiel: `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
+
+**Protokollierungsoptionen:**
+
+- **`--verbose`**: Aktivieren Sie ausführliche Protokollierung zur Fehlerbehebung.
+
+  > Beispiel: `npx intlayer doc translate --verbose`
+
+**Optionen für benutzerdefinierte Anweisungen:**
+
 - **`--custom-instructions [customInstructions]`**: Benutzerdefinierte Anweisungen, die dem Prompt hinzugefügt werden. Nützlich, um spezifische Regeln bezüglich Formatierung, URL-Übersetzung usw. anzuwenden.
 
-##### Beispiel:
+  - Kann eine absolute Zeit wie "2025-12-05" (String oder Datum) sein
+  - Kann eine relative Zeit in ms `1 * 60 * 60 * 1000` (1 Stunde) sein
+  - Diese Option überprüft die Aktualisierungszeit der Datei mit der Methode `fs.stat`. Daher kann sie von Git oder anderen Tools beeinflusst werden, die die Datei ändern.
 
-```bash
-npx intlayer doc translate
-  --doc-pattern "docs/en/**/*.md"
-  --base-locale en --locales fr es
-  --model chatgpt-4o-latest
-  --custom-instructions "$(cat ./instructions.md)"
-```
+  > Beispiel: `npx intlayer doc translate --custom-instructions "Vermeide die Übersetzung von URLs und behalte das Markdown-Format bei"`
+
+  > Beispiel: `npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"`
+
+**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`**: Basis-Referenz für den Git-Diff angeben (Standard `origin/main`).
+- **`--git-diff-current`**: Aktuelle Referenz für den Git-Diff angeben (Standard: `HEAD`).
+- **`--uncommitted`**: Uncommittete Änderungen einbeziehen.
+- **`--unpushed`**: Nicht gepushte Änderungen einbeziehen.
+- **`--untracked`**: Nicht verfolgte Dateien einbeziehen.
+
+  > Beispiel: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Beispiel: `npx intlayer doc translate --uncommitted --unpushed --untracked`
 
 > Beachten Sie, dass der Ausgabedateipfad durch Ersetzen der folgenden Muster bestimmt wird
 >
-> - `/{{baseLocale}}/` durch `/{{locale}}/` (Unix)
-> - `\{{baseLocale}}\` durch `\{{locale}}\` (Windows)
-> - `_{{baseLocale}}.` durch `_{{locale}}.`
-> - `{{baseLocale}}_` durch `{{locale}}_`
-> - `.{{baseLocaleName}}.` durch `.{{localeName}}.`
+> - `/{{baseLocale}}/` wird durch `/{{locale}}/` ersetzt (Unix)
+> - `\{{baseLocale}}\` wird durch `\{{locale}}\` ersetzt (Windows)
+> - `_{{baseLocale}}.` wird durch `_{{locale}}.` ersetzt
+> - `{{baseLocale}}_` wird durch `{{locale}}_` ersetzt
+> - `.{{baseLocaleName}}.` wird durch `.{{localeName}}.` ersetzt
 >
-> Wenn das Muster nicht gefunden wird, fügt die Ausgabedatei die Endung `.{{locale}}` an den Dateiendungen hinzu. `./my/file.md` wird für die französische Locale zu `./my/file.fr.md` übersetzt.
+> Wenn das Muster nicht gefunden wird, wird die Ausgabedatei die Endung `.{{locale}}` erhalten. `./my/file.md` wird für die französische Locale zu `./my/file.fr.md` übersetzt.
 
 #### Dokumentation überprüfen
 
@@ -391,21 +465,22 @@ Der Befehl `doc review` analysiert Dokumentationsdateien auf Qualität, Konsiste
 npx intlayer doc review
 ```
 
+Er kann verwendet werden, um bereits übersetzte Dateien zu überprüfen und zu kontrollieren, ob die Übersetzung korrekt ist.
+
+Für die meisten Anwendungsfälle,
+
+- Verwenden Sie bevorzugt den Befehl `doc translate`, wenn die übersetzte Version dieser Datei nicht verfügbar ist.
+- Verwenden Sie bevorzugt den Befehl `doc review`, wenn die übersetzte Version dieser Datei bereits existiert.
+
+> Beachten Sie, dass der Überprüfungsprozess mehr Eingabetoken verbraucht als der Übersetzungsprozess, um dieselbe Datei vollständig zu überprüfen. Der Überprüfungsprozess optimiert jedoch die zu überprüfenden Abschnitte und überspringt die Teile, die nicht geändert wurden.
+
 ##### Argumente:
 
 Der Befehl `doc review` akzeptiert dieselben Argumente wie `doc translate`, sodass Sie bestimmte Dokumentationsdateien überprüfen und Qualitätsprüfungen anwenden können.
 
-##### Beispiel:
-
-```bash
-npx intlayer doc review
- --doc-pattern "docs/de/**/*.md"
- --locales fr es de
- --model chatgpt-4o-latest
- --custom-instructions "$(cat ./instructions.md)"
-```
+Wenn Sie eine der Git-Optionen aktiviert haben, überprüft der Befehl nur den Teil der Dateien, der geändert wird. Das Skript verarbeitet die Datei, indem es sie in Abschnitte unterteilt, und überprüft jeden Abschnitt. Wenn es in einem Abschnitt keine Änderungen gibt, überspringt das Skript diesen, um den Überprüfungsprozess zu beschleunigen und die Kosten für die AI-Provider-API zu begrenzen.
 
-## Verwenden von intlayer-Befehlen in Ihrer `package.json`
+## Verwendung der Intlayer-Befehle in Ihrer `package.json`
 
 ```json fileName="package.json"
 "scripts": {
@@ -419,6 +494,48 @@ npx intlayer doc review
 }
 ```
 
+## 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,
+  docTranslate,
+  docReview,
+} from "@intlayer/cli";
+
+push();
+// ...
+pull();
+// ...
+fill();
+// ...
+build();
+// ...
+docTranslate();
+// ...
+docReview();
+// ...
+```
+
 ## Intlayer-Befehl debuggen
 
 ### 1. **Stellen Sie sicher, dass Sie die neueste Version verwenden**
@@ -426,8 +543,8 @@ npx intlayer doc review
 Führen Sie aus:
 
 ```bash
-npx intlayer --version                  # aktuelle lokale intlayer-Version
-npx intlayer@latest --version           # aktuellste intlayer-Version
+npx intlayer --version                  # aktuelle lokale Intlayer-Version
+npx intlayer@latest --version           # aktuellste Intlayer-Version
 ```
 
 ### 2. **Überprüfen, ob der Befehl registriert ist**
@@ -435,7 +552,7 @@ npx intlayer@latest --version           # aktuellste intlayer-Version
 Sie können dies überprüfen mit:
 
 ```bash
-npx intlayer --help                     # Zeigt die Liste der verfügbaren Befehle und Nutzungsinformationen an
+npx intlayer --help                     # Zeigt die Liste der verfügbaren Befehle und Nutzungshinweise an
 npx intlayer dictionary build --help    # Zeigt die Liste der verfügbaren Optionen für einen Befehl an
 ```
 
@@ -443,7 +560,7 @@ npx intlayer dictionary build --help    # Zeigt die Liste der verfügbaren Optio
 
 Manchmal ist ein Neustart des Terminals erforderlich, damit neue Befehle erkannt werden.
 
-### 4. **Leeren Sie den npx-Cache (wenn Sie mit einer älteren Version feststecken)**
+### 4. **Leeren Sie den npx-Cache (wenn Sie bei einer älteren Version hängen bleiben)**
 
 ```bash
 npx clear-npx-cache
@@ -451,4 +568,7 @@ npx clear-npx-cache
 
 ## Dokumentationsverlauf
 
-- 5.5.10 - 2025-06-29: Historie initialisiert
+| Version | Datum      | Änderungen                                                |
+| ------- | ---------- | --------------------------------------------------------- |
+| 5.5.11  | 2025-07-11 | Aktualisierung der Dokumentation zu CLI-Befehlsparametern |
+| 5.5.10  | 2025-06-29 | Historie initialisiert                                    |