@intlayer/docs 8.1.6 → 8.1.8

package/docs/de/component_i18n.md

@@ -78,7 +78,7 @@ JSON wird ebenfalls unterstützt, wenn Sie Konfigurationsdateien bevorzugen.
 
 ## 2) Rufen Sie Ihren Inhalt ab
 
-### Fall A — React-App (Vite/SPA)
+### Fall A. React-App (Vite/SPA)
 
 Standardansatz: Verwenden Sie `useIntlayer`, um per Schlüssel abzurufen. Dies hält Komponenten schlank und typisiert.
 
@@ -129,7 +129,7 @@ export function ComponentWithDictionary() {
 }
 ```
 
-### Fall B — Next.js (App Router)
+### Fall B. Next.js (App Router)
 
 Bevorzugen Sie Server-Komponenten für Datensicherheit und Leistung. Verwenden Sie `useIntlayer` aus `next-intlayer/server` in Server-Dateien und `useIntlayer` aus `next-intlayer` in Client-Komponenten.
 

package/docs/de/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-12
+updatedAt: 2026-02-25
 title: Konfiguration
 description: Erfahren Sie, wie Sie Intlayer für Ihre Anwendung konfigurieren. Verstehen Sie die verschiedenen Einstellungen und Optionen, um Intlayer an Ihre Bedürfnisse anzupassen.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: Compiler-Optionen aktualisieren
   - version: 8.0.6
     date: 2026-02-12
     changes: Add support for Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, and Together.ai providers
@@ -437,6 +440,17 @@ const config: IntlayerConfig = {
      * Output directory for the optimized dictionaries.
      */
     outputDir: "compiler",
+
+    /**
+     * Dictionary key prefix
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
+
+    /**
+     * Indicates if the components should be saved after being transformed.
+     * That way, the compiler can be run only once to transform the app, and then it can be removed.
+     */
+    saveComponents: false,
   },
 
   /**
@@ -982,6 +996,13 @@ Build-Optionen gelten für die Plugins `@intlayer/babel` und `@intlayer/swc`.
   - _Hinweis_: Der Live-Modus verwendet die Live-Sync-API, um die Wörterbücher abzurufen. Wenn der API-Aufruf fehlschlägt, werden die Wörterbücher dynamisch im "dynamic"-Modus importiert.
   - _Hinweis_: Diese Option hat keine Auswirkungen auf die Funktionen `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` und `useDictionaryDynamic`.
 
+- **outputFormat**:
+  - _Typ_: `'esm' | 'cjs'`
+  - _Standard_: `'esm'`
+  - _Beschreibung_: Steuert das Ausgabeformat der Wörterbücher.
+  - _Beispiel_: `'cjs'`
+  - _Hinweis_: Das Ausgabeformat der Wörterbücher.
+
 - **traversePattern**:
   - _Typ_: `string[]`
   - _Standard_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
@@ -990,3 +1011,49 @@ Build-Optionen gelten für die Plugins `@intlayer/babel` und `@intlayer/swc`.
   - _Hinweis_: Verwenden Sie dies, um die Optimierung auf relevante Code-Dateien zu beschränken und die Build-Leistung zu verbessern.
   - _Hinweis_: Diese Option wird ignoriert, wenn `optimize` deaktiviert ist.
   - _Hinweis_: Verwenden Sie Glob-Muster.
+
+---
+
+### Compiler-Konfiguration
+
+Einstellungen zur Steuerung des Intlayer-Compilers, der Wörterbücher direkt aus Ihren Komponenten extrahiert.
+
+#### Eigenschaften
+
+- **enabled**:
+  - _Typ_: `boolean | 'build-only'`
+  - _Standard_: `true`
+  - _Beschreibung_: Gibt an, ob der Compiler aktiviert sein soll, um die Wörterbücher zu extrahieren.
+  - _Beispiel_: `'build-only'`
+  - _Hinweis_: Wenn Sie dies auf `'build-only'` setzen, wird der Compiler im Entwicklungsmodus übersprungen, um die Startzeiten zu beschleunigen. Er wird nur bei Build-Befehlen ausgeführt.
+
+- **dictionaryKeyPrefix**:
+  - _Typ_: `string`
+  - _Standard_: `'comp-'`
+  - _Beschreibung_: Präfix für die extrahierten Wörterbuchschlüssel.
+  - _Beispiel_: `'my-key-'`
+  - _Hinweis_: Wenn Wörterbücher extrahiert werden, wird der Schlüssel basierend auf dem Dateinamen generiert. Dieses Präfix wird dem generierten Schlüssel hinzugefügt, um Konflikte zu vermeiden.
+
+- **saveComponents**:
+  - _Typ_: `boolean`
+  - _Standard_: `false`
+  - _Beschreibung_: Gibt an, ob die Komponenten nach der Transformation gespeichert werden sollen.
+  - _Hinweis_: Wenn auf true gesetzt, ersetzt der Compiler die Originaldateien durch die transformierten Dateien. Auf diese Weise kann der Compiler nur einmal ausgeführt werden, um die App zu transformieren, und dann entfernt werden.
+
+- **transformPattern**:
+  - _Typ_: `string | string[]`
+  - _Standard_: `['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
+  - _Beschreibung_: Muster, die definieren, welche Dateien während der Optimierung durchlaufen werden sollen.
+  - _Beispiel_: `['src/**/*.{ts,tsx}', '!**/node_modules/**']`
+  - _Hinweis_: Verwenden Sie dies, um die Optimierung auf relevante Code-Dateien zu beschränken und die Build-Leistung zu verbessern.
+
+- **excludePattern**:
+  - _Typ_: `string | string[]`
+  - _Standard_: `['**/node_modules/**']`
+  - _Beschreibung_: Muster, die definieren, welche Dateien während der Optimierung ausgeschlossen werden sollen.
+  - _Beispiel_: `['**/node_modules/**', '!**/node_modules/react/**']`
+
+- **outputDir**:
+  - _Typ_: `string`
+  - _Standard_: `'compiler'`
+  - _Beschreibung_: Das Verzeichnis, in dem die extrahierten Wörterbücher gespeichert werden, relativ zum Basispfad Ihres Projekts.

package/docs/de/dictionary/content_file.md

@@ -495,7 +495,7 @@ Gibt den Speicherort des Wörterbuchs an und steuert, wie es mit dem CMS synchro
 
 - `'local'`: Das Wörterbuch wird nur lokal verwaltet. Es wird nicht zum entfernten CMS gepusht. Verwenden Sie dies für Inhalte, die in Ihrer Codebasis bleiben sollen.
 - `'remote'`: Das Wörterbuch wird nur remote verwaltet. Nach dem Push zum CMS wird es von der lokalen Datei getrennt. Zum Zeitpunkt des Ladens des Inhalts wird das Remote-Wörterbuch vom CMS abgerufen. Eine `.content`-Datei mit `remote`-Speicherort wird nach dem initialen Push ignoriert.
-- `'hybrid'`: Das Wörterbuch wird sowohl lokal als auch remote verwaltet. Nach dem Push zum CMS bleibt es synchronisiert—Änderungen von der lokalen Datei werden zum CMS gepusht, und Remote-Änderungen können in die lokale Datei zurückgeholt werden.
+- `'hybrid'`: Das Wörterbuch wird sowohl lokal als auch remote verwaltet. Nach dem Push zum CMS bleibt es synchronisiert, Änderungen von der lokalen Datei werden zum CMS gepusht, und Remote-Änderungen können in die lokale Datei zurückgeholt werden.
 - `string` (z. B. `'plugin'`): Das Wörterbuch wird von einem Plugin oder einer benutzerdefinierten Quelle verwaltet. Wenn Sie versuchen, es zu pushen, fragt Sie das System, was zu tun ist.
 
 **Beispiel:**

package/docs/de/index.md

@@ -66,7 +66,7 @@ Verstehen Sie, wie Übersetzungen generiert, gespeichert und in Ihrer Anwendung
 - **[Enumeration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/enumeration.md)**  
   Verwalten Sie einfach wiederholte oder feste Datensätze in verschiedenen Sprachen.
 
-- **[Condition](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/conditional.md)**  
+- **[Condition](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/condition.md)**  
   Lernen Sie, wie Sie bedingte Logik in Intlayer verwenden, um dynamische Inhalte zu erstellen.
 
 - **[Insertion](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/insertion.md)**  
@@ -79,7 +79,7 @@ Sehen Sie, wie Sie Inhalte mit benutzerdefinierter Logik dynamisch abrufen könn
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/markdown.md)**  
   Lernen Sie, wie Sie Markdown in Intlayer verwenden, um reichhaltige Inhalte zu erstellen.
 
-- **[Datei-Einbettungen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/file_embeddings.md)**  
+- **[Datei-Einbettungen](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/file.md)**  
   Entdecken Sie, wie Sie externe Dateien in Intlayer einbetten, um sie im Inhaltseditor zu verwenden.
 
 - **[Verschachtelung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dictionary/nesting.md)**  

package/docs/de/intlayer_with_adonisjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: AdonisJS i18n - So übersetzen Sie Ihre AdonisJS-App – Leitfaden 2026
+title: AdonisJS i18n - So übersetzen Sie eine AdonisJS-App in 2026
 description: Entdecken Sie, wie Sie Ihr AdonisJS-Backend mehrsprachig machen. Folgen Sie der Dokumentation zur Internationalisierung (i18n) und Übersetzung.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_analog.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Analog i18n - So übersetzen Sie Ihre Analog-App – Leitfaden 2026
+title: Analog i18n - So übersetzen Sie eine Analog-App in 2026
 description: Erfahren Sie, wie Sie Ihre Analog-App mehrsprachig machen. Folgen Sie der Dokumentation zur Internationalisierung (i18n) und Übersetzung.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Angular i18n - So übersetzen Sie Ihre Angular-App – Leitfaden 2026
+title: Angular i18n - So übersetzen Sie eine Angular-App in 2026
 description: Erfahren Sie, wie Sie Ihre Angular-Website mehrsprachig gestalten. Folgen Sie der Dokumentation zur Internationalisierung (i18n) und Übersetzung.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_astro.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
 updatedAt: 2025-12-30
-title: Astro i18n - Wie Sie Ihre Astro App übersetzen – Leitfaden 2026
+title: Astro i18n - Wie Sie eine Astro App übersetzen in 2026
 description: Erfahren Sie, wie Sie Internationalisierung (i18n) zu Ihrer Astro-Website mit Intlayer hinzufügen. Folgen Sie dieser Anleitung, um Ihre Website mehrsprachig zu machen.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_create_react_app.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2025-06-29
-title: Create React App i18n - Wie Sie Ihre React App übersetzen – Leitfaden 2026
+title: Create React App i18n - Wie Sie eine React App übersetzen in 2026
 description: Entdecken Sie, wie Sie Ihre Create React App (CRA)-Website mehrsprachig gestalten können. Befolgen Sie die Dokumentation, um sie zu internationalisieren (i18n) und zu übersetzen.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_express.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2025-12-30
-title: Express i18n - Wie Sie Ihre Express App übersetzen – Leitfaden 2026
+title: Express i18n - Wie Sie eine Express App übersetzen in 2026
 description: Entdecken Sie, wie Sie Ihre Express-Backend mehrsprachig gestalten können. Befolgen Sie die Dokumentation, um sie zu internationalisieren (i18n) und zu übersetzen.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_fastify.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-12-30
 updatedAt: 2025-12-30
-title: Fastify i18n - Wie Sie Ihre Fastify App übersetzen – Leitfaden 2026
+title: Fastify i18n - Wie Sie eine Fastify App übersetzen in 2026
 description: Erfahren Sie, wie Sie Ihr Fastify-Backend mehrsprachig machen. Folgen Sie der Dokumentation, um es zu internationalisieren (i18n) und zu übersetzen.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_hono.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: Hono i18n - So übersetzen Sie Ihre Hono-App – Leitfaden 2026
+title: Hono i18n - So übersetzen Sie eine Hono-App in 2026
 description: Entdecken Sie, wie Sie Ihr Hono-Backend mehrsprachig machen. Folgen Sie der Dokumentation, um es zu internationalisieren (i18n) und zu übersetzen.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_lynx+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-03-09
 updatedAt: 2025-12-30
-title: Lynx und React i18n - Wie Sie Ihre Lynx App übersetzen – Leitfaden 2026
+title: Lynx + React i18n - Wie Sie eine Lynx App übersetzen in 2026
 description: Entdecken Sie, wie Sie Ihre Lynx- und React-Mobile-App mehrsprachig gestalten können. Befolgen Sie die Dokumentation, um sie zu internationalisieren (i18n) und zu übersetzen.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_nestjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
 updatedAt: 2025-12-30
-title: NestJS i18n - Wie Sie Ihre NestJS App übersetzen – Leitfaden 2026
+title: NestJS i18n - Wie Sie eine NestJS App übersetzen in 2026
 description: Entdecken Sie, wie Sie Ihr NestJS-Backend mehrsprachig machen. Folgen Sie der Dokumentation, um es zu internationalisieren (i18n) und zu übersetzen.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_next-i18next.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js und next-i18next i18n - Wie Sie Ihre Next.js App übersetzen – Leitfaden 2026
+title: next-i18next - Wie man eine Next.js (i18n) App im Jahr 2026 übersetzt
 description: Eine praxisorientierte, produktionsreife Anleitung zur Internationalisierung einer Next.js 15 App Router App mit i18next/next-i18next und zur Erweiterung mit Intlayer.
 keywords:
   - Internationalisierung
@@ -37,7 +37,7 @@ applicationTemplate: https://github.com/aymericzip/intlayer-next-i18next-templat
 - Intlayer-Integration zur Automatisierung von Übersetzungs-Workflows (Tests, KI-Ausfüllung, JSON-Synchronisation)
 
 > Hinweis: next-i18next basiert auf i18next. Diese Anleitung verwendet die i18next-Primitiven, die mit next-i18next im App Router kompatibel sind, und hält dabei die Architektur einfach und produktionsbereit.
-> Für einen umfassenderen Vergleich siehe [next-i18next vs next-i18next vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/de/next-i18next_vs_next-i18next_vs_intlayer.md).
+> Für einen umfassenderen Vergleich siehe [next-i18next vs next-intl vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/de/next-i18next_vs_next-intl_vs_intlayer.md).
 
 ---
 

package/docs/de/intlayer_with_next-intl.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js und next-intl i18n - Wie Sie Ihre Next.js App übersetzen – Leitfaden 2026
+title: next-intl - Wie man eine Next.js (i18n) App im Jahr 2026 übersetzt
 description: Entdecken Sie, wie Sie Ihre Next.js 15 App Router Website mehrsprachig machen. Folgen Sie der Dokumentation zur Internationalisierung (i18n) und Übersetzung.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_nextjs_14.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-06-29
-title: Next.js i18n - Wie Sie Ihre Next.js 14 App übersetzen – Leitfaden 2026
+title: Next.js i18n - Wie Sie eine Next.js 14 App übersetzen in 2026
 description: Entdecken Sie, wie Sie Ihre Next.js 14 App Router-Website mehrsprachig gestalten. Befolgen Sie die Dokumentation, um sie zu internationalisieren (i18n) und zu übersetzen.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_nextjs_15.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Wie Sie Ihre Next.js 15 App übersetzen – Leitfaden 2026
+title: Next.js i18n - Wie Sie eine Next.js 15 App übersetzen in 2026
 description: Entdecken Sie, wie Sie Ihre Next.js 15 Website mehrsprachig machen. Folgen Sie der Dokumentation, um sie zu internationalisieren (i18n) und zu übersetzen.
 keywords:
   - Internationalisierung

package/docs/de/intlayer_with_nextjs_16.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-25
 updatedAt: 2025-12-30
-title: Next.js i18n - Wie Sie Ihre Next.js 16 App übersetzen – Leitfaden 2026
+title: Next.js i18n - Wie Sie eine Next.js 16 App übersetzen in 2026
 description: Entdecken Sie, wie Sie Ihre Next.js 16 Website mehrsprachig machen. Folgen Sie der Dokumentation, um sie zu internationalisieren (i18n) und zu übersetzen.
 keywords:
   - Internationalisierung
@@ -744,6 +744,8 @@ const ServerComponentExample = () => {
 
 > Um mehr über den `useIntlayer` Hook zu erfahren, lesen Sie die [Dokumentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/packages/next-intlayer/useIntlayer.md).
 
+> Wenn Ihre App bereits existiert, können Sie den [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/compiler.md) sowie den [Extraktionsbefehl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/extract.md) verwenden, um Tausende von Komponenten in einer Sekunde zu transformieren.
+
 ### (Optional) Schritt 7: Proxy für die Lokalerkennung konfigurieren
 
 Richten Sie einen Proxy ein, um die bevorzugte Sprache des Benutzers zu erkennen: