@intlayer/docs 8.1.6 → 8.1.8

package/docs/fr/compiler.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
-title: Intlayer Compiler | Extraction Automatisée de Contenu pour i18n
-description: Automatisez votre processus d'internationalisation avec l'Intlayer Compiler. Extrayez le contenu directement de vos composants pour une i18n plus rapide et plus efficace dans Vite, Next.js, et plus encore.
+updatedAt: 2026-02-25
+title: Compilateur Intlayer | Extraction automatique de contenu pour l'i18n
+description: Automatisez votre processus d'internationalisation avec le compilateur Intlayer. Extrayez le contenu directement de vos composants pour une i18n plus rapide et plus efficace dans Vite, Next.js, et plus encore.
 keywords:
   - Intlayer
-  - Compiler
+  - Compilateur
   - Internationalisation
   - i18n
   - Automatisation
@@ -20,6 +20,9 @@ slugs:
   - doc
   - compiler
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: Mise à jour des options du compilateur
   - version: 7.3.1
     date: 2025-11-27
     changes: Sortie du Compiler
@@ -53,6 +56,9 @@ Comme alternative, pour automatiser votre processus i18n tout en gardant un cont
 
 ## Utilisation
 
+<Tabs>
+ <Tab value='vite'>
+
 ### Vite
 
 Pour les applications basées sur Vite (React, Vue, Svelte, etc.), la manière la plus simple d'utiliser le compilateur est via le plugin `vite-intlayer`.
@@ -79,6 +85,8 @@ export default defineConfig({
 });
 ```
 
+See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
+
 #### Support des frameworks
 
 Le plugin Vite détecte et gère automatiquement différents types de fichiers :
@@ -97,6 +105,9 @@ npm install @intlayer/vue-compiler
 npm install @intlayer/svelte-compiler
 ```
 
+ </Tab>
+ <Tab value='nextjs'>
+
 ### Next.js (Babel)
 
 Pour Next.js ou d'autres applications basées sur Webpack utilisant Babel, vous pouvez configurer le compilateur en utilisant le plugin `@intlayer/babel`.
@@ -131,3 +142,70 @@ module.exports = {
 ```
 
 Cette configuration garantit que le contenu déclaré dans vos composants est automatiquement extrait et utilisé pour générer les dictionnaires lors de votre processus de build.
+
+See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_compiler.md)
+
+ </Tab>
+
+### Configuration personnalisée
+
+Pour personnaliser le comportement du compilateur, vous pouvez mettre à jour le fichier `intlayer.config.ts` à la racine de votre projet.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    /**
+     * Indique si le compilateur doit être activé.
+     * Réglez sur 'build-only' pour ignorer le compilateur pendant le développement et accélérer les temps de démarrage.
+     */
+    enabled: true,
+
+    /**
+     * Modèle pour parcourir le code à optimiser.
+     */
+    transformPattern: [
+      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
+      "!**/node_modules/**",
+    ],
+
+    /**
+     * Modèle à exclure de l'optimisation.
+     */
+    excludePattern: ["**/node_modules/**"],
+
+    /**
+     * Répertoire de sortie pour les dictionnaires optimisés.
+     */
+    outputDir: "i18n",
+
+    /**
+     * Préfixe de clé de dictionnaire
+     */
+    dictionaryKeyPrefix: "", // Supprimer le préfixe de base
+
+    /**
+     * Indique si les composants doivent être enregistrés après avoir été transformés.
+     * De cette façon, le compilateur peut être exécuté une seule fois pour transformer l'application, puis il peut être supprimé.
+     */
+    saveComponents: false,
+  },
+};
+
+export default config;
+```
+
+### Remplir les traductions manquantes
+
+Intlayer fournit un outil CLI pour vous aider à remplir les traductions manquantes. Vous pouvez utiliser la commande `intlayer` pour tester et remplir les traductions manquantes à partir de votre code.
+
+```bash
+npx intlayer test         # Tester s'il y a des traductions manquantes
+```
+
+```bash
+npx intlayer fill         # Remplir les traductions manquantes
+```
+
+> Pour plus de détails, consultez la [documentation CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/ci.md)

package/docs/fr/component_i18n.md

@@ -78,7 +78,7 @@ Le JSON est également supporté si vous préférez les fichiers de configuratio
 
 ## 2) Récupérez votre contenu
 
-### Cas A — Application React (Vite/SPA)
+### Cas A. Application React (Vite/SPA)
 
 Approche par défaut : utilisez `useIntlayer` pour récupérer par clé. Cela permet de garder les composants légers et typés.
 
@@ -129,7 +129,7 @@ export function ComponentWithDictionary() {
 }
 ```
 
-### Cas B — Next.js (App Router)
+### Cas B. Next.js (App Router)
 
 Privilégiez les composants serveur pour la sécurité des données et la performance. Utilisez `useIntlayer` depuis `next-intlayer/server` dans les fichiers serveur, et `useIntlayer` depuis `next-intlayer` dans les composants clients.
 

package/docs/fr/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-12
+updatedAt: 2026-02-25
 title: Configuration
 description: Apprenez à configurer Intlayer pour votre application. Comprenez les différents paramètres et options disponibles pour personnaliser Intlayer selon vos besoins.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: Mise à jour des options du compilateur
   - 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
@@ -440,6 +443,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,
   },
 
   /**
@@ -990,6 +1004,13 @@ Les options de compilation s'appliquent aux plugins `@intlayer/babel` et `@intla
   - _Note_ : Le mode live utilisera l'API de synchronisation live pour récupérer les dictionnaires. Si l'appel API échoue, les dictionnaires seront importés dynamiquement en mode "dynamic".
   - _Note_ : Cette option n'affectera pas les fonctions `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` et `useDictionaryDynamic`.
 
+- **outputFormat** :
+  - _Type_ : `'esm' | 'cjs'`
+  - _Par défaut_ : `'esm'`
+  - _Description_ : Contrôle le format de sortie des dictionnaires.
+  - _Exemple_ : `'cjs'`
+  - _Note_ : Le format de sortie des dictionnaires.
+
 - **traversePattern** :
   - _Type_ : `string[]`
   - _Par défaut_ : `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
@@ -998,3 +1019,49 @@ Les options de compilation s'appliquent aux plugins `@intlayer/babel` et `@intla
   - _Note_ : Utilisez ceci pour limiter l'optimisation aux fichiers de code pertinents et améliorer les performances de construction.
   - _Note_ : Cette option sera ignorée si `optimize` est désactivé.
   - _Note_ : Utilisez un motif glob.
+
+---
+
+### Configuration du compilateur
+
+Paramètres qui contrôlent le compilateur Intlayer, qui extrait les dictionnaires directement de vos composants.
+
+#### Propriétés
+
+- **enabled** :
+  - _Type_ : `boolean | 'build-only'`
+  - _Par défaut_ : `true`
+  - _Description_ : Indique si le compilateur doit être activé pour extraire les dictionnaires.
+  - _Exemple_ : `'build-only'`
+  - _Note_ : Le régler sur `'build-only'` ignorera le compilateur en mode développement pour accélérer les temps de démarrage. Il ne s'exécutera que sur les commandes de build.
+
+- **dictionaryKeyPrefix** :
+  - _Type_ : `string`
+  - _Par défaut_ : `'comp-'`
+  - _Description_ : Préfixe pour les clés de dictionnaire extraites.
+  - _Exemple_ : `'my-key-'`
+  - _Note_ : Lorsque les dictionnaires sont extraits, la clé est générée à partir du nom du fichier. Ce préfixe est ajouté à la clé générée pour éviter les conflits.
+
+- **saveComponents** :
+  - _Type_ : `boolean`
+  - _Par défaut_ : `false`
+  - _Description_ : Indique si les composants doivent être sauvegardés après avoir été transformés.
+  - _Note_ : Si vrai, le compilateur remplacera les fichiers originaux par les fichiers transformés. De cette façon, le compilateur ne peut être exécuté qu'une seule fois pour transformer l'application, puis il peut être supprimé.
+
+- **transformPattern** :
+  - _Type_ : `string | string[]`
+  - _Par défaut_ : `['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
+  - _Description_ : Modèles qui définissent quels fichiers doivent être parcourus lors de l'optimisation.
+  - _Exemple_ : `['src/**/*.{ts,tsx}', '!**/node_modules/**']`
+  - _Note_ : Utilisez ceci pour limiter l'optimisation aux fichiers de code pertinents et améliorer les performances de build.
+
+- **excludePattern** :
+  - _Type_ : `string | string[]`
+  - _Par défaut_ : `['**/node_modules/**']`
+  - _Description_ : Modèles qui définissent quels fichiers doivent être exclus lors de l'optimisation.
+  - _Exemple_ : `['**/node_modules/**', '!**/node_modules/react/**']`
+
+- **outputDir** :
+  - _Type_ : `string`
+  - _Par défaut_ : `'compiler'`
+  - _Description_ : Le répertoire où les dictionnaires extraits seront stockés, relatif au chemin de base de votre projet.

package/docs/fr/dictionary/content_file.md

@@ -490,7 +490,7 @@ Indique l'emplacement du dictionnaire et contrôle la façon dont il se synchron
 
 - `'local'` : Le dictionnaire est géré localement uniquement. Il ne sera pas poussé vers le CMS distant. Utilisez ceci pour le contenu qui doit rester dans votre codebase.
 - `'remote'` : Le dictionnaire est géré à distance uniquement. Une fois poussé vers le CMS, il sera détaché du fichier local. Au moment du chargement du contenu, le dictionnaire distant sera récupéré depuis le CMS. Un fichier `.content` avec l'emplacement `remote` sera ignoré après le push initial.
-- `'hybrid'` : Le dictionnaire est géré à la fois localement et à distance. Une fois poussé vers le CMS, il restera synchronisé—les modifications du fichier local sont poussées vers le CMS, et les modifications distantes peuvent être récupérées dans le fichier local.
+- `'hybrid'` : Le dictionnaire est géré à la fois localement et à distance. Une fois poussé vers le CMS, il restera synchronisé, les modifications du fichier local sont poussées vers le CMS, et les modifications distantes peuvent être récupérées dans le fichier local.
 - `string` (par ex., `'plugin'`) : Le dictionnaire est géré par un plugin ou une source personnalisée. Lorsque vous essayez de le pousser, le système vous demandera quoi faire.
 
 **Exemple :**

package/docs/fr/index.md

@@ -64,7 +64,7 @@ Organisez votre contenu multilingue proche de votre code pour garder tout cohér
 - **[Énumération](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/enumeration.md)**  
   Gérez facilement des ensembles de données répétées ou fixes dans plusieurs langues.
 
-- **[Condition](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/conditional.md)**  
+- **[Condition](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/condition.md)**  
   Apprenez à utiliser la logique conditionnelle dans Intlayer pour créer du contenu dynamique.
 
 - **[Insertion](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/insertion.md)**  
@@ -76,7 +76,7 @@ Organisez votre contenu multilingue proche de votre code pour garder tout cohér
 - **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/markdown.md)**  
   Apprenez à utiliser Markdown dans Intlayer pour créer du contenu enrichi.
 
-- **[Inclusions de fichiers](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/file_embeddings.md)**  
+- **[Inclusions de fichiers](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/file.md)**  
   Découvrez comment intégrer des fichiers externes dans Intlayer pour les utiliser dans l’éditeur de contenu.
 
 - **[Imbrication](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/nesting.md)**  

package/docs/fr/intlayer_CMS.md

@@ -447,7 +447,7 @@ Exemple avec Vite :
 
 Le serveur Live Sync enveloppe votre application et applique automatiquement le contenu mis à jour dès son arrivée.
 
-Pour recevoir les notifications de changement depuis le CMS, le serveur Live Sync maintient une connexion SSE avec le backend. Lorsque le contenu change dans le CMS, le backend transmet la mise à jour au serveur Live Sync, qui écrit les nouveaux dictionnaires. Votre application reflétera la mise à jour lors de la prochaine navigation ou du rechargement du navigateur — aucune reconstruction n’est nécessaire.
+Pour recevoir les notifications de changement depuis le CMS, le serveur Live Sync maintient une connexion SSE avec le backend. Lorsque le contenu change dans le CMS, le backend transmet la mise à jour au serveur Live Sync, qui écrit les nouveaux dictionnaires. Votre application reflétera la mise à jour lors de la prochaine navigation ou du rechargement du navigateur, aucune reconstruction n’est nécessaire.
 
 Organigramme (CMS/Backend -> Serveur Live Sync -> Serveur d’application -> Frontend) :
 

package/docs/fr/intlayer_with_adonisjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: AdonisJS i18n - Comment traduire votre application AdonisJS – guide 2026
+title: AdonisJS i18n - Comment traduire une application AdonisJS en 2026
 description: Découvrez comment rendre votre backend AdonisJS multilingue. Suivez la documentation pour l'internationaliser (i18n) et le traduire.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_analog.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Analog i18n - Comment traduire votre application Analog – guide 2026
+title: Analog i18n - Comment traduire une application Analog en 2026
 description: Découvrez comment rendre votre application Analog multilingue. Suivez la documentation pour l'internationaliser (i18n) et la traduire.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Angular i18n - Comment traduire votre application Angular – guide 2026
+title: Angular i18n - Comment traduire une application Angular en 2026
 description: Découvrez comment rendre votre site web Angular multilingue. Suivez la documentation pour l'internationaliser (i18n) et le traduire.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_astro.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
 updatedAt: 2025-12-30
-title: Astro i18n - Comment traduire votre application Astro – guide 2026
+title: Astro i18n - Comment traduire une application Astro en 2026
 description: Apprenez à ajouter l'internationalisation (i18n) à votre site web Astro en utilisant Intlayer. Suivez ce guide pour rendre votre site multilingue.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_create_react_app.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2025-12-30
-title: Create React App i18n - Comment traduire votre application React – guide 2026
+title: Create React App i18n - Comment traduire une application React en 2026
 description: Découvrez comment rendre votre site Create React App (CRA) multilingue. Suivez la documentation pour l’internationaliser (i18n) et le traduire.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_express.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2025-12-30
-title: Express i18n - Comment traduire votre application Express – guide 2026
+title: Express i18n - Comment traduire une application Express en 2026
 description: Découvrez comment rendre votre backend Express multilingue. Suivez la documentation pour l’internationaliser (i18n) et le traduire.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_fastify.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-12-30
 updatedAt: 2025-12-30
-title: Fastify i18n - Comment traduire votre application Fastify – guide 2026
+title: Fastify i18n - Comment traduire une application Fastify en 2026
 description: Découvrez comment rendre votre backend Fastify multilingue. Suivez la documentation pour internationaliser (i18n) et traduire.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_hono.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: i18n Hono - Comment traduire votre application Hono – guide 2026
+title: i18n Hono - Comment traduire une application Hono en 2026
 description: Découvrez comment rendre votre backend Hono multilingue. Suivez la documentation pour l'internationaliser (i18n) et le traduire.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_lynx+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-03-09
 updatedAt: 2025-12-30
-title: Lynx et React i18n - Comment traduire votre application Lynx – guide 2026
+title: Lynx + React i18n - Comment traduire une application Lynx en 2026
 description: Découvrez comment rendre votre application mobile Lynx et React multilingue. Suivez la documentation pour l’internationaliser (i18n) et le traduire.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_nestjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
 updatedAt: 2025-12-30
-title: NestJS i18n - Comment traduire votre application NestJS – guide 2026
+title: NestJS i18n - Comment traduire une application NestJS en 2026
 description: Découvrez comment rendre votre backend NestJS multilingue. Suivez la documentation pour internationaliser (i18n) et traduire.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_next-i18next.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js et next-i18next i18n - Comment traduire votre application Next.js – guide 2026
+title: next-i18next - Comment traduire une application Next.js (i18n) en 2026
 description: Un guide pratique et prêt pour la production pour internationaliser une application Next.js 15 App Router avec i18next/next-i18next et l'améliorer avec Intlayer.
 keywords:
   - Internationalisation
@@ -37,7 +37,7 @@ applicationTemplate: https://github.com/aymericzip/intlayer-next-i18next-templat
 - Intégration Intlayer pour automatiser les workflows de traduction (tests, remplissage IA, synchronisation JSON)
 
 > Note : next-i18next est construit sur i18next. Ce guide utilise les primitives i18next compatibles avec next-i18next dans l’App Router, tout en gardant une architecture simple et prête pour la production.
-> Pour une comparaison plus large, voir [next-i18next vs next-i18next vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/fr/next-i18next_vs_next-i18next_vs_intlayer.md).
+> Pour une comparaison plus large, voir [next-i18next vs next-intl vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/fr/next-i18next_vs_next-intl_vs_intlayer.md).
 
 ---
 

package/docs/fr/intlayer_with_next-intl.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js et next-intl i18n - Comment traduire votre application Next.js – guide 2026
+title: next-intl - Comment traduire une application Next.js (i18n) en 2026
 description: Découvrez comment rendre votre site Next.js 15 App Router multilingue. Suivez la documentation pour internationaliser (i18n) et traduire votre application.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_nextjs_14.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-06-29
-title: Next.js i18n - Comment traduire votre application Next.js 14 – guide 2026
+title: Next.js i18n - Comment traduire une application Next.js 14 en 2026
 description: Découvrez comment rendre votre site Next.js 14 App Router multilingue. Suivez la documentation pour l’internationaliser (i18n) et le traduire.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_nextjs_15.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Comment traduire votre application Next.js 15 – guide 2026
+title: Next.js i18n - Comment traduire une application Next.js 15 en 2026
 description: Découvrez comment rendre votre site Next.js 15 multilingue. Suivez la documentation pour internationaliser (i18n) et traduire votre site.
 keywords:
   - Internationalisation

package/docs/fr/intlayer_with_nextjs_16.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Comment traduire votre application Next.js 16 – guide 2026
+title: Next.js i18n - Comment traduire une application Next.js 16 en 2026
 description: Découvrez comment rendre votre site Next.js 16 multilingue. Suivez la documentation pour internationaliser (i18n) et traduire votre site.
 keywords:
   - Internationalisation
@@ -712,6 +712,8 @@ const ServerComponentExample = () => {
 
 > Pour en savoir plus sur le hook `useIntlayer`, consultez la [documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/next-intlayer/useIntlayer.md).
 
+> Si votre application existe déjà, vous pouvez utiliser le [Compilateur Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compiler.md), ainsi que la [commande d'extraction](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/extract.md), pour transformer des milliers de composants en une seconde.
+
 ### (Optionnel) Étape 7 : Configurer le proxy pour la détection de la langue
 
 Configurez un proxy pour détecter la langue préférée de l'utilisateur :