@intlayer/docs 7.2.2 → 7.3.0-canary.0

package/docs/ar/cli/watch.md

@@ -0,0 +1,37 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: مراقبة القواميس
+description: تعلّم كيفية مراقبة التغييرات في ملفات إعلان المحتوى الخاصة بك وبناء القواميس تلقائيًا.
+keywords:
+  - مراقبة
+  - قواميس
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - watch
+---
+
+# مراقبة القواميس
+
+```bash
+npx intlayer watch
+```
+
+هذا الأمر سيراقب التغييرات في ملفات إعلان المحتوى الخاصة بك ويبني القواميس في دليل `.intlayer`.
+هذا الأمر يعادل `npx intlayer build --watch --skip-prepare`.
+
+## الأسماء المستعارة:
+
+- `npx intlayer dictionaries watch`
+- `npx intlayer dictionary watch`
+- `npx intlayer dic watch`
+
+## الوسائط:
+
+- **`--with`**: بدء أمر بالتوازي مع المراقبة.
+
+> مثال: `npx intlayer watch --with "next dev --turbopack"`

package/docs/ar/intlayer_with_svelte_kit.md

@@ -555,8 +555,9 @@ export const load: Load = ({ params }) => {
 	let { children, data }: { children: Snippet, data: LayoutData } = $props();
 
 	// تهيئة Intlayer باستخدام اللغة من المسار
-	setupIntlayer(data.locale);
-
+  $effect(() => {
+      setupIntlayer(data.locale);
+  });
 	// استخدام قاموس محتوى التخطيط
 	const layoutContent = useIntlayer('layout');
 </script>

package/docs/ar/packages/intlayer/getPrefix.md

@@ -0,0 +1,210 @@
+---
+createdAt: 2025-11-16
+updatedAt: 2025-11-16
+title: توثيق دالة getPrefix | intlayer
+description: تعرف على كيفية استخدام دالة getPrefix لحزمة intlayer
+keywords:
+  - getPrefix
+  - prefix
+  - Intlayer
+  - intlayer
+  - التدويل
+  - التوثيق
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getPrefix
+history:
+  - version: 7.1.0
+    date: 2025-11-16
+    changes: التوثيق الأولي
+---
+
+# التوثيق: دالة `getPrefix` في `intlayer`
+
+## الوصف
+
+تقوم دالة `getPrefix` بتحديد بادئة URL للغة معينة بناءً على إعدادات وضع التوجيه. تقارن اللغة مع اللغة الافتراضية وتعيد كائن يحتوي على ثلاثة تنسيقات مختلفة للبادئة لتوفير مرونة في بناء عناوين URL.
+
+**الميزات الرئيسية:**
+
+- تأخذ اللغة كمعامل أول (مطلوب)
+- كائن `options` اختياري يحتوي على `defaultLocale` و `mode`
+- تعيد كائن يحتوي على خصائص `prefix` و `localePrefix`
+- تدعم جميع أوضاع التوجيه: `prefix-no-default`، `prefix-all`، `no-prefix`، و `search-params`
+- أداة خفيفة لتحديد متى يجب إضافة بادئات اللغة
+
+---
+
+## توقيع الدالة
+
+```typescript
+getPrefix(
+  locale: Locales,               // مطلوب
+  options?: {                    // اختياري
+    defaultLocale?: Locales;
+    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';
+  }
+): GetPrefixResult
+
+type GetPrefixResult = {
+  prefix: string;   // مثال: 'fr/' أو ''
+  localePrefix?: Locale; // مثال: 'fr' أو undefined
+}
+```
+
+---
+
+## المعاملات
+
+- `locale: Locales`
+  - **الوصف**: اللغة التي سيتم توليد البادئة لها. إذا كانت القيمة خاطئة (undefined، null، سلسلة فارغة)، تُرجع الدالة سلسلة فارغة.
+  - **النوع**: `Locales`
+  - **مطلوب**: نعم
+
+- `options?: object`
+  - **الوصف**: كائن التهيئة لتحديد البادئة.
+  - **النوع**: `object`
+  - **مطلوب**: لا (اختياري)
+
+  - `options.defaultLocale?: Locales`
+    - **الوصف**: اللغة الافتراضية للتطبيق. إذا لم يتم توفيرها، يتم استخدام اللغة الافتراضية المهيأة في تكوين المشروع الخاص بك.
+    - **النوع**: `Locales`
+    - **الافتراضي**: [`تكوين المشروع`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **الوصف**: وضع توجيه URL لمعالجة اللغة. إذا لم يتم توفيره، يستخدم الوضع المهيأ في تكوين المشروع الخاص بك.
+    - **النوع**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **الافتراضي**: [`تكوين المشروع`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md#middleware)
+    - **الأوضاع**:
+      - `prefix-no-default`: يعيد سلاسل فارغة عندما تتطابق اللغة مع اللغة الافتراضية
+      - `prefix-all`: يعيد بادئة لجميع اللغات بما في ذلك الافتراضية
+      - `no-prefix`: يعيد سلاسل فارغة (لا توجد بادئة في عناوين URL)
+      - `search-params`: يعيد سلاسل فارغة (اللغة في معلمات الاستعلام)
+
+### Returns
+
+- **النوع**: `GetPrefixResult`
+- **الوصف**: كائن يحتوي على ثلاثة تنسيقات مختلفة للبادئة:
+  - `prefix`: بادئة المسار مع شرطة مائلة في النهاية (مثال: `'fr/'`، `''`)
+  - `localePrefix`: معرف اللغة بدون شرطات مائلة (مثال: `'fr'`، `undefined`)
+
+---
+
+## مثال على الاستخدام
+
+### الاستخدام الأساسي
+
+```typescript codeFormat="typescript"
+import { getPrefix, Locales } from "intlayer";
+
+// تحقق من البادئة للغة الإنجليزية
+getPrefix(Locales.ENGLISH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// يعيد: { prefix: 'en/', localePrefix: 'en' }
+
+// تحقق من البادئة للغة الفرنسية
+getPrefix(Locales.FRENCH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// يعيد: { prefix: 'fr/', localePrefix: 'fr' }
+```
+
+```javascript codeFormat="esm"
+import { getPrefix, Locales } from "intlayer";
+
+getPrefix(Locales.ENGLISH, { mode: "prefix-all" });
+javascript codeFormat="commonjs"
+const { getPrefix, Locales } = require("intlayer");
+
+getPrefix(Locales.ENGLISH, { mode: "prefix-all" });
+// يعيد: { prefix: '', localePrefix: undefined }
+```
+
+### أوضاع التوجيه المختلفة
+
+```typescript
+import { getPrefix, Locales } from "intlayer";
+
+// prefix-all: يعيد البادئة دائمًا
+getPrefix(Locales.ENGLISH, {
+  mode: "prefix-all",
+  defaultLocale: Locales.ENGLISH,
+});
+// يعيد: { prefix: '/en', localePrefix: 'en' }
+
+// prefix-no-default: لا يعيد بادئة عندما تتطابق اللغة مع الافتراضية
+getPrefix(Locales.ENGLISH, {
+  mode: "prefix-no-default",
+  defaultLocale: Locales.ENGLISH,
+});
+// يعيد: { prefix: '', localePrefix: undefined }
+
+// prefix-no-default: يعيد البادئة عندما تختلف اللغة عن اللغة الافتراضية
+getPrefix(Locales.FRENCH, {
+  mode: "prefix-no-default",
+  defaultLocale: Locales.ENGLISH,
+});
+// يعيد: { prefix: 'fr/', localePrefix: 'fr' }
+
+// no-prefix & search-params: لا يعيد البادئة أبدًا
+getPrefix(Locales.ENGLISH, { mode: "no-prefix" });
+// يعيد: { prefix: '', localePrefix: undefined }
+
+getPrefix(Locales.ENGLISH, { mode: "search-params" });
+// يعيد: { prefix: '', localePrefix: undefined }
+```
+
+### مثال عملي
+
+```typescript
+import { getPrefix, Locales } from "intlayer";
+
+// بناء عناوين URL مع البادئة المناسبة للغة معينة
+const locale = Locales.FRENCH;
+const { prefix, localePrefix } = getPrefix(locale, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+
+// استخدام البادئة لبناء المسار
+const url1 = `/${prefix}about`.replace(/\/+/g, "/");
+// النتيجة: "/fr/about"
+
+// استخدام localePrefix لتحديد اللغة
+console.log(`Current locale: ${localePrefix}`);
+// المخرجات: "Current locale: fr"
+```
+
+---
+
+## الدوال المرتبطة
+
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocalizedUrl.md): ينشئ عنوان URL محلي للغة معينة
+- [`getMultilingualUrls`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getMultilingualUrls.md): ينشئ عناوين URL لجميع اللغات المكونة
+
+---
+
+## TypeScript
+
+```typescript
+type GetPrefixResult = {
+  prefix: string; // بادئة المسار مع الشرطة المائلة النهائية (مثلاً 'fr/' أو '')
+  localePrefix?: Locale; // معرف اللغة بدون شرطات مائلة (مثلاً 'fr' أو غير معرف)
+};
+
+function getPrefix(
+  locale: Locales,
+  options?: {
+    defaultLocale?: Locales;
+    mode?: "prefix-no-default" | "prefix-all" | "no-prefix" | "search-params";
+  }
+): GetPrefixResult;
+```

package/docs/de/cli/build.md

@@ -0,0 +1,64 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Wörterbücher erstellen
+description: Erfahren Sie, wie Sie Ihre Intlayer-Wörterbücher aus Inhaltsdeklarationsdateien erstellen.
+keywords:
+  - Erstellen
+  - Wörterbücher
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - build
+---
+
+# Wörterbücher erstellen
+
+Um Ihre Wörterbücher zu erstellen, können Sie die folgenden Befehle ausführen:
+
+```bash
+npx intlayer build
+```
+
+oder im Watch-Modus
+
+```bash
+npx intlayer build --watch
+```
+
+Dieser Befehl findet standardmäßig Ihre Deklarations-Inhaltsdateien unter `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}` und erstellt die Wörterbücher im Verzeichnis `.intlayer`.
+
+## Aliase:
+
+- `npx intlayer dictionaries build`
+- `npx intlayer dictionary build`
+- `npx intlayer dic build`
+
+## Argumente:
+
+- **`--base-dir`**: Geben Sie 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 build --base-dir ./src`
+
+- **`--env`**: Geben Sie die Umgebung an (z. B. `development`, `production`). Nützlich, wenn Sie Umgebungsvariablen in Ihrer Intlayer-Konfigurationsdatei verwenden.
+
+  > Beispiel: `npx intlayer build --env production`
+
+- **`--env-file`**: Geben Sie eine benutzerdefinierte Umgebungsdatei an, aus der Variablen geladen werden sollen. Nützlich, wenn Sie Umgebungsvariablen in Ihrer Intlayer-Konfigurationsdatei verwenden.
+
+  > Beispiel: `npx intlayer build --env-file .env.production.local`
+
+- **`--with`**: Startet einen Befehl parallel zum Build-Prozess.
+
+  > Beispiel: `npx intlayer build --with "next dev --turbopack"`
+
+- **`--skip-prepare`**: Überspringen Sie den Prepare-Schritt.
+
+  > Beispiel: `npx intlayer build --skip-prepare`
+
+- **`--no-cache`**: Deaktivieren Sie den Cache.
+
+  > Beispiel: `npx intlayer build --no-cache`

package/docs/de/cli/configuration.md

@@ -0,0 +1,63 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Konfiguration verwalten
+description: Erfahren Sie, wie Sie Ihre Intlayer-Konfiguration abrufen und in das CMS hochladen.
+keywords:
+  - Konfiguration
+  - Config
+  - CLI
+  - Intlayer
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - configuration
+---
+
+# 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.
+
+```bash
+npx intlayer configuration get
+```
+
+## Aliase:
+
+- `npx intlayer config get`
+- `npx intlayer conf get`
+
+## Argumente:
+
+- **`--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. (Standardmäßig über CLI auf true gesetzt)
+- **`--no-cache`**: Deaktiviert den Cache.
+
+## Konfiguration hochladen
+
+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.
+
+```bash
+npx intlayer configuration push
+```
+
+## Aliase:
+
+- `npx intlayer config push`
+- `npx intlayer conf push`
+
+## Argumente:
+
+- **`--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. (Standardmäßig über CLI auf true gesetzt)
+- **`--no-cache`**: Deaktiviert den Cache.
+
+Durch das Hochladen der Konfiguration ist Ihr Projekt vollständig in das Intlayer CMS integriert, was eine nahtlose Verwaltung von Wörterbüchern über Teams hinweg ermöglicht.

package/docs/de/cli/debug.md

@@ -0,0 +1,46 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Intlayer-Befehl debuggen
+description: Erfahren Sie, wie Sie Intlayer CLI-Probleme debuggen und beheben können.
+keywords:
+  - Debuggen
+  - Fehlerbehebung
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - debug
+---
+
+# Intlayer-Befehl debuggen
+
+## 1. **Stellen Sie sicher, dass Sie die neueste Version verwenden**
+
+Führen Sie aus:
+
+```bash
+npx intlayer --version                  # aktuelle lokale Intlayer-Version
+npx intlayer@latest --version           # aktuellste Intlayer-Version
+```
+
+## 2. **Überprüfen Sie, ob der Befehl registriert ist**
+
+Sie können dies überprüfen mit:
+
+```bash
+npx intlayer --help                     # Zeigt die Liste der verfügbaren Befehle und Nutzungsinformationen
+npx intlayer dictionary build --help    # Zeigt die Liste der verfügbaren Optionen für einen Befehl
+```
+
+## 3. **Starten Sie Ihr Terminal neu**
+
+Manchmal ist ein Neustart des Terminals erforderlich, damit neue Befehle erkannt werden.
+
+## 4. **Leeren Sie den npx-Cache (wenn Sie mit einer älteren Version festhängen)**
+
+```bash
+npx clear-npx-cache
+```

package/docs/de/cli/doc-review.md

@@ -0,0 +1,43 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Dokument überprüfen
+description: Erfahren Sie, wie Sie Dokumentationsdateien auf Qualität, Konsistenz und Vollständigkeit in verschiedenen Sprachversionen überprüfen.
+keywords:
+  - Überprüfung
+  - Dokument
+  - Dokumentation
+  - KI
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - doc-review
+---
+
+# Dokument überprüfen
+
+Der Befehl `doc review` analysiert Dokumentationsdateien auf Qualität, Konsistenz und Vollständigkeit in verschiedenen Sprachversionen.
+
+```bash
+npx intlayer doc review
+```
+
+Er kann verwendet werden, um bereits übersetzte Dateien zu überprüfen und zu prüfen, ob die Übersetzung korrekt ist.
+
+Für die meisten Anwendungsfälle,
+
+- verwenden Sie bevorzugt `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.
+
+Wenn Sie eine der Git-Optionen aktiviert haben, überprüft der Befehl nur die Teile der Dateien, die geändert werden. Das Skript verarbeitet die Datei in Abschnitten (Chunks) und überprüft jeden Abschnitt. Wenn in einem Abschnitt keine Änderungen vorhanden sind, überspringt das Skript diesen, um den Überprüfungsprozess zu beschleunigen und die Kosten für die AI-Provider-API zu begrenzen.
+
+Für eine vollständige Liste der Argumente siehe die [Dokumentation zum Befehl „Translate Document“](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/doc-translate.md).

package/docs/de/cli/doc-translate.md

@@ -0,0 +1,132 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Dokument übersetzen
+description: Erfahren Sie, wie Sie Dokumentationsdateien automatisch mit KI-Übersetzungsdiensten übersetzen können.
+keywords:
+  - Übersetzen
+  - Dokument
+  - Dokumentation
+  - KI
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - doc-translate
+---
+
+# Dokument übersetzen
+
+Der Befehl `doc translate` übersetzt Dokumentationsdateien automatisch von einer Basissprache in Zielsprachen mithilfe von KI-Übersetzungsdiensten.
+
+```bash
+npx intlayer doc translate
+```
+
+## Argumente:
+
+**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, die von der Übersetzung ausgeschlossen werden sollen.
+
+  > Beispiel: `npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"`
+
+- **`--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 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-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Überspringe die Datei, wenn sie bereits existiert.
+
+  > Beispiel: `npx intlayer doc translate --skip-if-exists`
+
+**Optionen für die Ausgabe der Einträge:**
+
+- **`--locales [locales...]`**: Ziel-Lokalisierungen, in die die Dokumentation übersetzt werden soll.
+
+  > Beispiel: `npx intlayer doc translate --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Quell-Lokalisierung, aus der übersetzt werden soll.
+
+  > Beispiel: `npx intlayer doc translate --base-locale en`
+
+**Optionen zur Dateiverarbeitung:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Anzahl der Dateien, die gleichzeitig für die Übersetzung verarbeitet werden.
+
+  > Beispiel: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+**KI-Optionen:**
+
+- **`--model [model]`**: Das für die Übersetzung zu verwendende KI-Modell (z. B. `gpt-3.5-turbo`).
+- **`--provider [provider]`**: Der für die Übersetzung zu verwendende KI-Anbieter.
+- **`--temperature [temperature]`**: Temperatureinstellung für das KI-Modell.
+- **`--api-key [apiKey]`**: Eigener API-Schlüssel für den KI-Dienst.
+- **`--application-context [applicationContext]`**: Zusätzlicher Kontext für die KI-Übersetzung.
+- **`--custom-prompt [prompt]`**: Passen Sie den Basis-Prompt an, der für die Übersetzung verwendet wird. (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.
+- **`--no-cache`**: Deaktivieren Sie den Cache.
+
+  > Beispiel: `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
+
+**Protokollierungsoptionen:**
+
+- **`--verbose`**: Aktiviert ausführliche Protokollierung zur Fehlerbehebung. (Standardmäßig über CLI auf true gesetzt)
+
+  > 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.
+  - 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 überprüft die Aktualisierungszeit der Datei mittels der `fs.stat`-Methode. Daher kann sie durch Git oder andere Tools, die die Datei verändern, beeinflusst werden.
+
+  > Beispiel: `npx intlayer doc translate --custom-instructions "URLs nicht übersetzen und das Markdown-Format beibehalten"`
+
+  > Beispiel: `npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"`
+
+**Git-Optionen:**
+
+- **`--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.
+
+  > 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 Ausgabepfad der Datei durch Ersetzen der folgenden Muster bestimmt wird
+>
+> - `/{{baseLocale}}/` durch `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` durch `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` durch `_{{locale}}.`
+> - `{{baseLocale}}_` durch `{{locale}}_`
+> - `.{{baseLocaleName}}.` durch `.{{localeName}}.`
+>
+> 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.

package/docs/de/cli/editor.md

@@ -0,0 +1,28 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Editor-Befehle
+description: Erfahren Sie, wie Sie die Intlayer-Editor-Befehle verwenden.
+keywords:
+  - Editor
+  - Visueller Editor
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - editor
+---
+
+# Editor-Befehle
+
+Der Befehl `editor` kapselt die `intlayer-editor` Befehle neu ein.
+
+> Um den Befehl `editor` verwenden zu können, muss das Paket `intlayer-editor` installiert sein. (Siehe [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_visual_editor.md))
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:editor:start": "npx intlayer editor start --with 'next dev --turbopack'"
+}
+```