@intlayer/docs 9.4.1 → 9.4.3

package/docs/de/bundle_optimization.md

@@ -43,139 +43,6 @@ Beispielsweise könnte eine Anwendung mit 10 Seiten, die in 10 Sprachen überset
 
 <TOC />
 
-## Analysieren Sie Ihr Bundle
-
-Die Analyse Ihres Bundles ist der erste Schritt zur Identifizierung "schwerer" JSON-Dateien und Möglichkeiten zum Code-Splitting. Diese Tools generieren eine visuelle Treemap des kompilierten Codes Ihrer Anwendung, sodass Sie genau sehen können, welche Bibliotheken den meisten Platz beanspruchen.
-
-<Tabs>
- <Tab value="vite">
-
-### Vite / Rollup
-
-Vite verwendet Rollup im Hintergrund. Das Plugin `rollup-plugin-visualizer` generiert eine interaktive HTML-Datei, die die Größe jedes Moduls in Ihrem Diagramm anzeigt.
-
-```bash
-npm install -D rollup-plugin-visualizer
-```
-
-```typescript fileName="vite.config.ts"
-import { defineConfig } from "vite";
-import { visualizer } from "rollup-plugin-visualizer";
-
-export default defineConfig({
-  plugins: [
-    visualizer({
-      open: true, // Öffnet den Bericht automatisch in Ihrem Browser
-      filename: "stats.html",
-      gzipSize: true,
-      brotliSize: true,
-    }),
-  ],
-});
-```
-
- </Tab>
- <Tab value="nextjs (turbopack)">
-
-### Next.js (Turbopack)
-
-Für Projekte, die den App Router und Turbopack verwenden, bietet Next.js einen integrierten experimentellen Analyzer, der keine zusätzlichen Abhängigkeiten erfordert.
-
-```bash packageManager='npm'
-npx next experimental-analyze
-```
-
-```bash packageManager='yarn'
-yarn next experimental-analyze
-```
-
-```bash packageManager='pnpm'
-pnpm next experimental-analyze
-```
-
-```bash packageManager='bun'
-bun next experimental-analyze
-```
-
- </Tab>
- <Tab value="nextjs (Webpack)">
-
-### Next.js (Webpack)
-
-Wenn Sie den Standard-Webpack-Bundler in Next.js verwenden, verwenden Sie den offiziellen Bundle-Analyzer. Lösen Sie ihn aus, indem Sie während Ihres Builds eine Umgebungsvariable festlegen.
-
-```bash packageManager='npm'
-npm install -D @next/bundle-analyzer
-```
-
-```bash packageManager='yarn'
-yarn add -D @next/bundle-analyzer
-```
-
-```bash packageManager='pnpm'
-pnpm add -D @next/bundle-analyzer
-```
-
-```bash packageManager='bun'
-bun add -d @next/bundle-analyzer
-```
-
-```javascript fileName="next.config.js"
-const withBundleAnalyzer = require("@next/bundle-analyzer")({
-  enabled: process.env.ANALYZE === "true",
-});
-
-module.exports = withBundleAnalyzer({
-  // Ihre Next.js Konfiguration
-});
-```
-
-**Verwendung:**
-
-```bash
-ANALYZE=true npm run build
-```
-
- </Tab>
- <Tab value="Webpack (CRA / Angular / etc)">
-
-### Standard Webpack
-
-Verwenden Sie für Create React App (ejected), Angular oder benutzerdefinierte Webpack-Setups den branchenüblichen `webpack-bundle-analyzer`.
-
-```bash packageManager='npm'
-npm install -D webpack-bundle-analyzer
-```
-
-```bash packageManager='yarn'
-yarn add -D webpack-bundle-analyzer
-```
-
-```bash packageManager='pnpm'
-pnpm add -D webpack-bundle-analyzer
-```
-
-```bash packageManager='bun'
-bun add -d webpack-bundle-analyzer
-```
-
-```typescript fileName="webpack.config.ts"
-import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
-
-export default {
-  plugins: [
-    new BundleAnalyzerPlugin({
-      analyzerMode: "static",
-      reportFilename: "bundle-analyzer.html",
-      openAnalyzer: false,
-    }),
-  ],
-};
-```
-
- </Tab>
-</Tabs>
-
 ## Wie es funktioniert
 
 Intlayer verwendet einen **pro-Komponente-Ansatz**. Im Gegensatz zu globalen JSON-Dateien wird Ihr Inhalt neben oder in Ihren Komponenten definiert. Während des Build-Prozesses führt Intlayer Folgendes aus:
@@ -189,59 +56,6 @@ Dies stellt sicher, dass:
 - Wenn eine Komponente nicht importiert wird, deren Inhalt nicht im Bundle enthalten ist (Dead Code Elimination).
 - Wenn eine Komponente verzögert geladen wird (lazy loaded), ihr Inhalt ebenfalls verzögert geladen wird.
 
-## Plugin-Referenz
-
-Die Build-Optimierung von Intlayer ist auf mehrere diskrete Plugins aufgeteilt, von denen jedes eine einzige Aufgabe hat. Zu verstehen, was jedes Plugin tut, verhindert Verwirrung beim Einrichten.
-
-### Babel Plugins (`@intlayer/babel`)
-
-Diese werden direkt in der `babel.config.js` für Webpack-basierte Setups verwendet (Next.js mit Babel, CRA, benutzerdefiniertes Webpack usw.).
-
-Die folgende Tabelle listet sie in der erforderlichen Pipeline-Reihenfolge auf (dieselbe Reihenfolge, in der sie in `babel.config.js` erscheinen müssen):
-
-| Plugin                        | Was es tut                                                                                                                  |
-| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------- |
-| `intlayerExtractBabelPlugin`  | Scannt `.content.ts`-Dateien und schreibt kompilierte Wörterbücher nach `.intlayer/`                                        |
-| `intlayerPurgeBabelPlugin`    | Scannt alle Quelldateien und entfernt **nicht verwendete Inhaltsfelder** aus den kompilierten `.intlayer/**/*.json`-Dateien |
-| `intlayerMinifyBabelPlugin`   | **Benennt Inhaltsfeld-Schlüssel um** in kurze alphabetische Aliase (`title` → `a`) in JSON-Dateien und im Quellcode         |
-| `intlayerOptimizeBabelPlugin` | Schreibt `useIntlayer('key')` → `useDictionary(hash)` um und fügt den passenden `import` des Wörterbuchs ein                |
-
-> **Die Reihenfolge der Plugins ist wichtig.** In Ihrer `babel.config.js` müssen das Purge- und Minify-Plugin **vor** dem Optimize-Plugin aufgeführt sein. Der Optimize-Pass ersetzt `useIntlayer('key')` durch einen undurchsichtigen `useDictionary(hash)`-Aufruf, wodurch die Information über den Wörterbuchschlüssel gelöscht wird, die der Purge- und Minify-Pass benötigen, um zu identifizieren, welche Felder verwendet werden.
-
-Jedes Babel-Plugin verfügt über einen entsprechenden Options-Helfer, der Ihre `intlayer.config.ts` einmal zur Konfigurationsladezeit liest und vorab aufgelöste Werte zurückgibt:
-
-| Options-Helfer               | Verwendet mit                 |
-| :--------------------------- | :---------------------------- |
-| `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
-| `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
-| `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
-| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
-
-### Vite Plugins (`vite-intlayer`)
-
-Vite-Benutzer **konfigurieren diese nie direkt**. Sie werden automatisch eingerichtet, wenn Sie `withIntlayer()` in der `vite.config.ts` aufrufen. Die Flags `build.purge` und `build.minify` in der `intlayer.config.ts` schalten das entsprechende Verhalten ohne zusätzliche Plugin-Registrierung um.
-
-| Internes Vite Plugin | Äquivalentes Verhalten                                                                               |
-| :------------------- | :--------------------------------------------------------------------------------------------------- |
-| Usage analyzer       | Gleich wie die Analysephase des `intlayerPurgeBabelPlugin`                                           |
-| Dictionary prune     | Gleich wie die JSON-Schreibphase des `intlayerPurgeBabelPlugin`                                      |
-| Dictionary minify    | Gleich wie die JSON-Schreibphase des `intlayerMinifyBabelPlugin`                                     |
-| Babel transform      | Gleich wie die Quellcode-Umbenennung des `intlayerMinifyBabelPlugin` + `intlayerOptimizeBabelPlugin` |
-
-### SWC-Plugin (`@intlayer/swc`)
-
-Auch Next.js-Nutzer **konfigurieren diese nie direkt**. Seit **v9.2.1** führt `withIntlayer()` in `next.config.ts` die vollständige Pipeline aus — Purge, Minify und Import-Umschreibung — allein anhand der Flags `build.purge` und `build.minify`.
-
-Die Arbeit ist zweigeteilt, denn ein SWC-Wasm-Plugin transformiert jeweils nur eine Datei und hat keinen Dateisystemzugriff:
-
-| Durchlauf                                       | Wo er läuft                          | Was er tut                                                                                              |
-| :---------------------------------------------- | :----------------------------------- | :------------------------------------------------------------------------------------------------------ |
-| Nutzungsanalyse + JSON-Purge/Minify             | Node, innerhalb von `withIntlayer()` | Liest jede Komponenten-Quelldatei, schreibt `.intlayer/**/*.json` neu, erzeugt die Umbenennungstabellen |
-| Quellcode-Umschreibung (`content.title` → `.a`) | `@intlayer/swc` (Wasm)               | Wendet die Umbenennungstabellen auf die passenden Eigenschaftszugriffe in Ihrem Code an                 |
-| Import-Umschreibung (`useIntlayer` → dict)      | `@intlayer/swc` (Wasm)               | Wie `intlayerOptimizeBabelPlugin`                                                                       |
-
-Zu entscheiden, _welche_ Felder ungenutzt sind und _welchen_ Alias jedes erhält, erfordert dateiübergreifenden Zustand und Datei-I/O; diese Hälfte läuft daher in Node, und das SWC-Plugin erhält nur die resultierenden Tabellen.
-
 ## Setup nach Plattform
 
 <Tabs>
@@ -405,6 +219,59 @@ module.exports = {
  </Tab>
 </Tabs>
 
+## Plugin-Referenz
+
+Die Build-Optimierung von Intlayer ist auf mehrere diskrete Plugins aufgeteilt, von denen jedes eine einzige Aufgabe hat. Zu verstehen, was jedes Plugin tut, verhindert Verwirrung beim Einrichten.
+
+### Babel Plugins (`@intlayer/babel`)
+
+Diese werden direkt in der `babel.config.js` für Webpack-basierte Setups verwendet (Next.js mit Babel, CRA, benutzerdefiniertes Webpack usw.).
+
+Die folgende Tabelle listet sie in der erforderlichen Pipeline-Reihenfolge auf (dieselbe Reihenfolge, in der sie in `babel.config.js` erscheinen müssen):
+
+| Plugin                        | Was es tut                                                                                                                  |
+| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------- |
+| `intlayerExtractBabelPlugin`  | Scannt `.content.ts`-Dateien und schreibt kompilierte Wörterbücher nach `.intlayer/`                                        |
+| `intlayerPurgeBabelPlugin`    | Scannt alle Quelldateien und entfernt **nicht verwendete Inhaltsfelder** aus den kompilierten `.intlayer/**/*.json`-Dateien |
+| `intlayerMinifyBabelPlugin`   | **Benennt Inhaltsfeld-Schlüssel um** in kurze alphabetische Aliase (`title` → `a`) in JSON-Dateien und im Quellcode         |
+| `intlayerOptimizeBabelPlugin` | Schreibt `useIntlayer('key')` → `useDictionary(hash)` um und fügt den passenden `import` des Wörterbuchs ein                |
+
+> **Die Reihenfolge der Plugins ist wichtig.** In Ihrer `babel.config.js` müssen das Purge- und Minify-Plugin **vor** dem Optimize-Plugin aufgeführt sein. Der Optimize-Pass ersetzt `useIntlayer('key')` durch einen undurchsichtigen `useDictionary(hash)`-Aufruf, wodurch die Information über den Wörterbuchschlüssel gelöscht wird, die der Purge- und Minify-Pass benötigen, um zu identifizieren, welche Felder verwendet werden.
+
+Jedes Babel-Plugin verfügt über einen entsprechenden Options-Helfer, der Ihre `intlayer.config.ts` einmal zur Konfigurationsladezeit liest und vorab aufgelöste Werte zurückgibt:
+
+| Options-Helfer               | Verwendet mit                 |
+| :--------------------------- | :---------------------------- |
+| `getExtractPluginOptions()`  | `intlayerExtractBabelPlugin`  |
+| `getPurgePluginOptions()`    | `intlayerPurgeBabelPlugin`    |
+| `getMinifyPluginOptions()`   | `intlayerMinifyBabelPlugin`   |
+| `getOptimizePluginOptions()` | `intlayerOptimizeBabelPlugin` |
+
+### Vite Plugins (`vite-intlayer`)
+
+Vite-Benutzer **konfigurieren diese nie direkt**. Sie werden automatisch eingerichtet, wenn Sie `withIntlayer()` in der `vite.config.ts` aufrufen. Die Flags `build.purge` und `build.minify` in der `intlayer.config.ts` schalten das entsprechende Verhalten ohne zusätzliche Plugin-Registrierung um.
+
+| Internes Vite Plugin | Äquivalentes Verhalten                                                                               |
+| :------------------- | :--------------------------------------------------------------------------------------------------- |
+| Usage analyzer       | Gleich wie die Analysephase des `intlayerPurgeBabelPlugin`                                           |
+| Dictionary prune     | Gleich wie die JSON-Schreibphase des `intlayerPurgeBabelPlugin`                                      |
+| Dictionary minify    | Gleich wie die JSON-Schreibphase des `intlayerMinifyBabelPlugin`                                     |
+| Babel transform      | Gleich wie die Quellcode-Umbenennung des `intlayerMinifyBabelPlugin` + `intlayerOptimizeBabelPlugin` |
+
+### SWC-Plugin (`@intlayer/swc`)
+
+Auch Next.js-Nutzer **konfigurieren diese nie direkt**. Seit **v9.2.1** führt `withIntlayer()` in `next.config.ts` die vollständige Pipeline aus — Purge, Minify und Import-Umschreibung — allein anhand der Flags `build.purge` und `build.minify`.
+
+Die Arbeit ist zweigeteilt, denn ein SWC-Wasm-Plugin transformiert jeweils nur eine Datei und hat keinen Dateisystemzugriff:
+
+| Durchlauf                                       | Wo er läuft                          | Was er tut                                                                                              |
+| :---------------------------------------------- | :----------------------------------- | :------------------------------------------------------------------------------------------------------ |
+| Nutzungsanalyse + JSON-Purge/Minify             | Node, innerhalb von `withIntlayer()` | Liest jede Komponenten-Quelldatei, schreibt `.intlayer/**/*.json` neu, erzeugt die Umbenennungstabellen |
+| Quellcode-Umschreibung (`content.title` → `.a`) | `@intlayer/swc` (Wasm)               | Wendet die Umbenennungstabellen auf die passenden Eigenschaftszugriffe in Ihrem Code an                 |
+| Import-Umschreibung (`useIntlayer` → dict)      | `@intlayer/swc` (Wasm)               | Wie `intlayerOptimizeBabelPlugin`                                                                       |
+
+Zu entscheiden, _welche_ Felder ungenutzt sind und _welchen_ Alias jedes erhält, erfordert dateiübergreifenden Zustand und Datei-I/O; diese Hälfte läuft daher in Node, und das SWC-Plugin erhält nur die resultierenden Tabellen.
+
 ## Konfiguration
 
 Sie können steuern, wie Intlayer Ihr Bundle optimiert, über die Eigenschaft `build` in Ihrer `intlayer.config.ts`.
@@ -650,3 +517,136 @@ const content = useDictionaryAsync({
 | **Netzwerkanfragen**      | 0 zusätzliche Anfragen                            | 1 Anfrage pro Wörterbuch-Schlüssel     |
 | **Tree Shaking**          | Auf Komponentenebene                              | Auf Komponenten- + Länderebene         |
 | **Bester Anwendungsfall** | UI-Komponenten, Kleine Apps                       | Textreiche Seiten, Viele Sprachen      |
+
+## Analysieren Sie Ihr Bundle
+
+Die Analyse Ihres Bundles ist der direkteste Weg, um "schwere" JSON-Dateien und Möglichkeiten zum Code-Splitting zu identifizieren. Diese Tools generieren eine visuelle Treemap des kompilierten Codes Ihrer Anwendung, sodass Sie genau sehen können, welche Bibliotheken den meisten Platz beanspruchen.
+
+<Tabs>
+ <Tab value="vite">
+
+### Vite / Rollup
+
+Vite verwendet Rollup im Hintergrund. Das Plugin `rollup-plugin-visualizer` generiert eine interaktive HTML-Datei, die die Größe jedes Moduls in Ihrem Diagramm anzeigt.
+
+```bash
+npm install -D rollup-plugin-visualizer
+```
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { visualizer } from "rollup-plugin-visualizer";
+
+export default defineConfig({
+  plugins: [
+    visualizer({
+      open: true, // Öffnet den Bericht automatisch in Ihrem Browser
+      filename: "stats.html",
+      gzipSize: true,
+      brotliSize: true,
+    }),
+  ],
+});
+```
+
+ </Tab>
+ <Tab value="nextjs (turbopack)">
+
+### Next.js (Turbopack)
+
+Für Projekte, die den App Router und Turbopack verwenden, bietet Next.js einen integrierten experimentellen Analyzer, der keine zusätzlichen Abhängigkeiten erfordert.
+
+```bash packageManager='npm'
+npx next experimental-analyze
+```
+
+```bash packageManager='yarn'
+yarn next experimental-analyze
+```
+
+```bash packageManager='pnpm'
+pnpm next experimental-analyze
+```
+
+```bash packageManager='bun'
+bun next experimental-analyze
+```
+
+ </Tab>
+ <Tab value="nextjs (Webpack)">
+
+### Next.js (Webpack)
+
+Wenn Sie den Standard-Webpack-Bundler in Next.js verwenden, verwenden Sie den offiziellen Bundle-Analyzer. Lösen Sie ihn aus, indem Sie während Ihres Builds eine Umgebungsvariable festlegen.
+
+```bash packageManager='npm'
+npm install -D @next/bundle-analyzer
+```
+
+```bash packageManager='yarn'
+yarn add -D @next/bundle-analyzer
+```
+
+```bash packageManager='pnpm'
+pnpm add -D @next/bundle-analyzer
+```
+
+```bash packageManager='bun'
+bun add -d @next/bundle-analyzer
+```
+
+```javascript fileName="next.config.js"
+const withBundleAnalyzer = require("@next/bundle-analyzer")({
+  enabled: process.env.ANALYZE === "true",
+});
+
+module.exports = withBundleAnalyzer({
+  // Ihre Next.js Konfiguration
+});
+```
+
+**Verwendung:**
+
+```bash
+ANALYZE=true npm run build
+```
+
+ </Tab>
+ <Tab value="Webpack (CRA / Angular / etc)">
+
+### Standard Webpack
+
+Verwenden Sie für Create React App (ejected), Angular oder benutzerdefinierte Webpack-Setups den branchenüblichen `webpack-bundle-analyzer`.
+
+```bash packageManager='npm'
+npm install -D webpack-bundle-analyzer
+```
+
+```bash packageManager='yarn'
+yarn add -D webpack-bundle-analyzer
+```
+
+```bash packageManager='pnpm'
+pnpm add -D webpack-bundle-analyzer
+```
+
+```bash packageManager='bun'
+bun add -d webpack-bundle-analyzer
+```
+
+```typescript fileName="webpack.config.ts"
+import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
+
+export default {
+  plugins: [
+    new BundleAnalyzerPlugin({
+      analyzerMode: "static",
+      reportFilename: "bundle-analyzer.html",
+      openAnalyzer: false,
+    }),
+  ],
+};
+```
+
+ </Tab>
+</Tabs>

package/docs/de/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-08-22
+updatedAt: 2026-08-30
 title: Konfiguration (Configuration)
 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:
@@ -1124,3 +1124,101 @@ Einstellungen, die den Intlayer-Compiler steuern, der Wörterbücher direkt aus
 | Feld      | Beschreibung                                 | Typ                |
 | --------- | -------------------------------------------- | ------------------ |
 | `plugins` | Liste der zu aktivierenden Intlayer-Plugins. | `IntlayerPlugin[]` |
+
+## Häufig gestellte Fragen
+
+<FAQ>
+
+<Question title="Wo sollte die Datei intlayer.config.ts liegen?">
+
+Im Stammverzeichnis Ihres Projekts, neben `package.json`. Intlayer akzeptiert auch `intlayer.config.js`, `intlayer.config.mjs`, `intlayer.config.cjs` und JSON, sodass die Datei zu dem Modulsystem passt, das Ihr Projekt verwendet.
+
+</Question>
+
+<Question title="Wie viel trägt i18n zu meiner Bundle-Größe bei?">
+
+Viel weniger als bei einem Namespace-basierten Setup, denn eine Seite lädt niemals einen Katalog herunter, den sie nicht rendert. Serverseitig gerendertes Markup löst seinen Inhalt auf dem Server auf, und der Build-Zeit-Compiler ersetzt `useIntlayer`-Aufrufe durch genau die Wörterbucheinträge, die eine Komponente verwendet, sodass ungenutzte Schlüssel und ungenutzte Sprachen entfernt werden. [Dynamische Wörterbücher](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/index.md) teilen den Rest pro Locale auf. Gemessen an den üblichen Alternativen reduziert Intlayer die Bundle- und Seitengröße um bis zu 50 %. Siehe [Bundle-Optimierung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/bundle_optimization.md) und den [Benchmark](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/benchmark/index.md).
+
+</Question>
+
+<Question title="Kann ich von `i18next`, `next-intl` oder `react-i18next` migrieren, ohne meine Komponenten neu zu schreiben?">
+
+Ja, und es gibt zwei Wege. Sie können die Inhalte schrittweise migrieren mit dem [i18next-Migrationsleitfaden](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/migration_from_i18next_to_intlayer.md) oder dem [next-intl-Migrationsleitfaden](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/migration_from_next-intl_to_intlayer.md). Oder Sie behalten Ihre aktuelle API vollständig bei: Die [Kompatibilitätsadapter](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/compat/index.md) stellen genau dieselbe API wie `i18next`, `react-i18next`, `next-intl`, `next-i18next`, `react-intl`, `use-intl`, `vue-i18n` und `Lingui` bereit, aber aus Intlayer-Wörterbüchern bedient, sodass sich Importe ändern und der Komponentencode nicht.
+
+</Question>
+
+<Question title="Kann ich meine vorhandenen JSON-Übersetzungsdateien behalten?">
+
+Ja. Das [sync-JSON-Plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/plugins/sync-json.md) behält Ihre `/messages/{locale}/{namespace}.json`-Dateien als Single Source of Truth und generiert daraus Intlayer-Wörterbücher, in beide Richtungen. Ein [sync-PO-Plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/plugins/sync-po.md) macht dasselbe für gettext-Kataloge, und [Dateien pro Locale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/per_locale_file.md) lassen Sie Inhalte nach Sprache aufteilen, statt Locales in einer Datei zu gruppieren.
+
+</Question>
+
+<Question title="Muss ich meine Inhalte Schlüssel für Schlüssel umziehen?">
+
+Nein. Führen Sie `npx intlayer extract` aus; Intlayer liest Ihre Quelldateien, zieht die für den Nutzer sichtbaren Strings heraus und schreibt neben jede eine `.content`-Datei, sodass Sie ein Diff prüfen, statt Strings einzeln in einen Katalog zu kopieren. Siehe den [extract-Befehl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/extract.md).
+
+Für eine vollständig automatisierte Pipeline macht der [Intlayer-Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/compiler.md) dasselbe zur Build-Zeit auf JSX-, TSX-, Vue- und Svelte-Quellcode und generiert die Wörterbücher bei jeder Änderung, sodass es keine von Hand zu pflegenden Schlüssel gibt. Er arbeitet mit statischer Analyse, sodass Strings, die nur zur Laufzeit existieren, unerreichbar bleiben, und er braucht einige Annotationen, um für den Nutzer sichtbaren Text von Anwendungslogik zu unterscheiden.
+
+</Question>
+
+<Question title="Welches Editor- und KI-Agenten-Tooling ist verfügbar?">
+
+Fünf Bausteine, alle optional:
+
+- **[VS-Code-Erweiterung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/vs_code_extension.md)**: von einem `useIntlayer`-Schlüssel zur Inhaltsdatei springen, die ihn deklariert, Inhalte aus einer Komponente extrahieren und build, fill, test, push und pull über die Befehlspalette oder einen eigenen Intlayer-Tab ausführen.
+- **[LSP-Server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/lsp.md)**: dieselbe Wahrnehmung in jedem Editor, der LSP spricht, mit „Gehe zu Definition“, „Alle Referenzen suchen“, Hover-Vorschauen eines übersetzten Werts, Autovervollständigung von Schlüsseln und Feldern sowie einer Warnung, wenn ein Schlüssel nirgends deklariert ist. Es löst außerdem `i18next`-, `react-i18next`-, `next-intl`- und `use-intl`-Aufrufe auf, was bei der Migration hilft.
+- **[MCP-Server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/mcp_server.md)**: stellt die Intlayer-Dokumentation und -CLI für Cursor, VS Code, Claude Desktop, Claude Code und ChatGPT bereit, sodass ein Assistent aus der aktuellen Doku antwortet statt zu raten und Befehle wie `intlayer fill` selbst ausführen kann.
+- **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/agent_skills.md)**: fokussierte Skills wie `intlayer-config`, `intlayer-cli` und `intlayer-content` sowie eines pro Framework, die einem Agenten Ihr Routing-Setup und die Inhaltsknoten-Typen beibringen.
+- **[ESLint-Plugin](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/eslint.md)**: `no-raw-text` markiert fest kodierte Strings, mit weiteren Regeln für statische Wörterbuchschlüssel und ungenutzte Inhalte.
+
+</Question>
+
+<Question title="Wie füge ich meiner App eine neue Sprache hinzu?">
+
+Fügen Sie die Locale zu `internationalization.locales` hinzu und führen Sie dann `npx intlayer fill` aus, um die vorhandenen Inhalte darin zu übersetzen. Die generierten Typen werden gleichzeitig aktualisiert, sodass jede Inhaltsdatei, der die neue Locale fehlt, zu einem Typfehler wird statt zu einem stillen Fallback.
+
+</Question>
+
+<Question title="Wie entferne ich das Locale-Präfix aus meinen URLs?">
+
+Setzen Sie `routing.mode`. Die Voreinstellung `"prefix-no-default"` ergibt `/about` für die Standard-Locale und `/fr/about` für die anderen. `"prefix-all"` stellt jeder Locale ein Präfix voran. `"no-prefix"` hält die Locale vollständig aus dem Pfad heraus und löst sie aus einem Cookie, einem Header oder einer Domain auf. `"search-params"` legt sie als `/about?locale=fr` in den Query-String.
+
+</Question>
+
+<Question title="Kann ich jede Sprache von ihrer eigenen Domain ausliefern?">
+
+Ja. `routing.domains` ordnet eine Locale einem Hostnamen zu, zum Beispiel `{ fr: 'example.fr', en: 'example.com' }`. Die Domain identifiziert die Locale, sodass dem Pfad kein Präfix hinzugefügt wird, und `getLocalizedUrl` gibt eine absolute URL auf der richtigen Domain zurück.
+
+</Question>
+
+<Question title="Wie wird die Sprache des Nutzers erkannt?">
+
+Über `routing.storage`, das die zu lesenden Quellen der Reihe nach auflistet, typischerweise die URL, dann ein Cookie, dann den `Accept-Language`-Header. Eine ausdrückliche Wahl des Nutzers wird persistiert, sodass sie beim nächsten Besuch gewinnt.
+
+</Question>
+
+<Question title="Was macht routing.enableProxy?">
+
+Es steuert den Locale-Routing-Proxy, die Middleware, die Präfixe und Weiterleitungen auflöst. Ohne gesetzten Wert läuft der Proxy, aber Entwicklungs- und Preview-Server ignorieren die gespeicherte Locale als Weiterleitungsquelle, was verhindert, in eine Sprache umgeleitet zu werden, die Sie nicht testen; die Produktion verhält sich, als wäre er `true`. Setzen Sie ihn auf `false`, um das Locale-Routing selbst zu übernehmen.
+
+</Question>
+
+<Question title="Was ist der Unterschied zwischen importMode static, dynamic und fetch?">
+
+`"static"`, die Voreinstellung, importiert Wörterbücher statisch, sodass sie gebündelt und synchron gelesen werden. `"dynamic"` importiert sie über Suspense, sodass eine Locale nur heruntergeladen wird, wenn eine Komponente sie rendert, was Sie bei großen Inhaltsmengen wollen. `"fetch"` ruft sie über die Live-Sync-API ab und fällt bei einem Fehler auf `"dynamic"` zurück. Siehe [Bundle-Optimierung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/bundle_optimization.md) und [dynamische Wörterbücher](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/index.md).
+
+</Question>
+
+<Question title="Wo lege ich den KI-Anbieter und den API-Schlüssel für die automatische Übersetzung fest?">
+
+Entweder in der Konfigurationsdatei oder auf der Kommandozeile mit `--provider`, `--model` und `--api-key`. Der Schlüssel bleibt Ihrer: Die Übersetzungsaufrufe gehen von Ihrer Maschine oder Ihrem CI-Runner an den von Ihnen gewählten Anbieter, sodass nichts über einen Dritten geleitet wird. Siehe den [fill-Befehl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/cli/fill.md).
+
+</Question>
+
+<Question title="Muss ich den Dev-Server nach einer Änderung der Konfiguration neu starten?">
+
+Normalerweise nicht. Der Intlayer-Watcher überwacht `intlayer.config.ts` selbst: Beim Speichern lädt er die Konfiguration neu und bereitet die Wörterbücher erneut vor, sodass das Hinzufügen einer Locale oder das Ändern eines Routing-Modus wie eine Inhaltsänderung erkannt wird. Die Konfiguration kann jedoch von den Systemen zwischengespeichert werden. Ein Neustart Ihrer App kann eine gute Lösung sein.
+
+</Question>
+
+</FAQ>

package/docs/de/dictionary/content_file.md

@@ -367,15 +367,15 @@ Wandelt das Wörterbuch in ein pro-Locale-Wörterbuch um, bei dem jedes im Inhal
 
 **Beispiel:**
 
-```json
+```jsonc
 // Einsprachiges Wörterbuch
 {
   "key": "about-page",
   "locale": "en",
   "content": {
     "title": "About Us", // Dies wird zu einem Übersetzungsknoten für 'en'
-    "description": "Learn more about our company"
-  }
+    "description": "Learn more about our company",
+  },
 }
 ```
 
@@ -444,7 +444,7 @@ Anweisungen zum automatischen Ausfüllen von Wörterbuchinhalten aus externen Qu
 
 **Beispiele:**
 
-```json
+```jsonc
 // Für alle Sprachen aktivieren
 {
   "autoFill": true

package/docs/de/dictionary/markdown.md

@@ -51,6 +51,7 @@ Sie können Markdown-Inhalte mithilfe der Funktion `md` oder einfach als Zeichen
 
 <Tabs>
   <Tab label=".content.md" value=".content.md">
+
     Ab Version `8.10.0` können Sie Markdown-Inhalte direkt in `.content.md`-Dateien deklarieren. Intlayer erkennt und analysiert den Markdown-Inhalt automatisch.
 
     ```md fileName="markdown-file.en.content.md"
@@ -96,6 +97,7 @@ Sie können Markdown-Inhalte mithilfe der Funktion `md` oder einfach als Zeichen
     ```
 
   </Tab>
+
   <Tab label="Externe Dateien" value="external-files">
     Importieren Sie `.md`-Dateien direkt mit der `file`-Funktion.
 
@@ -129,6 +131,7 @@ Sie können Markdown-Inhalte mithilfe der Funktion `md` oder einfach als Zeichen
     ```
 
   </Tab>
+
 </Tabs>
 
 ## Markdown rendern

package/docs/de/dictionary/plurial.md

@@ -33,11 +33,14 @@ To use plural content in Next.js Client Components, retrieve it via the `useIntl
 
 To use plural content in Angular components, retrieve it via the `useIntlayer` hook and call it with a count. Here's an example:
 
-## Wann man `plural` vs `enu` verwendet
+## Wann man `plural` vs `enu` verwenden sollte
 
-To use plural content inside a React component, retrieve it via the `useIntlayer` hook and call it with a count. The active locale and the count are combined to pick the matching CLDR category.
+| Anwendungsfall                                                           | Helper   |
+| ------------------------------------------------------------------------ | -------- |
+| Sprachspezifische grammatikalische Pluralformen (ein Apfel / zwei Äpfel) | `plural` |
+| Benutzerdefinierte Zahlenbereiche (`<5`, `>=10`) oder Nicht-CLDR-Gruppen | `enu`    |
 
-To use plural content in Next.js Client Components, retrieve it via the `useIntlayer` hook and call it with a count. Here's an example:
+Wenn Sie nur Englisch unterstützen (das nur `one` / `other` hat), funktioniert beides. Für jede Sprache mit `few` / `many` / `two` Unterscheidungen ist `plural` vorzuziehen.
 
 ## Pluralinhalt einrichten