@intlayer/docs 8.3.0-canary.4 → 8.3.1

package/docs/fr/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-10
+updatedAt: 2026-03-12
 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:
@@ -149,73 +149,85 @@ Cette configuration garantit que le contenu déclaré dans vos composants est au
 See complete tutorial: [Intlayer Compiler with Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_compiler.md)
 
  </Tab>
+</Tabs>
 
 ### 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"
+````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.
+     * Définit le chemin des fichiers de sortie. Remplace `outputDir`.
+     *
+     * - Les chemins `./` sont résolus par rapport au répertoire du composant.
+     * - Les chemins `/` sont résolus par rapport à la racine du projet (`baseDir`).
+     *
+     * - L'inclusion de la variable `{{locale}}` dans le chemin déclenchera la génération de dictionnaires séparés par locale.
+     *
+     * Exemple :
+     * ```ts
+     * {
+     *   // Créer des fichiers .content.ts multilingues proches du composant
+     *   output: ({ fileName, extension }) => `./${fileName}${extension}`,
+     *
+     *   // output: './{{fileName}}{{extension}}', // Équivalent utilisant une chaîne de caractères
+     * }
+     * ```
+     *
+     * ```ts
+     * {
+     *   // Créer des JSON centralisés par locale à la racine du projet
+     *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
+     *
+     *   // output: '/locales/{{locale}}/{{key}}.content.json', // Équivalent utilisant une chaîne de caractères
+     * }
+     * ```
+     *
+     * Liste des variables :
+     *   - `fileName`: Le nom du fichier.
+     *   - `key`: La clé du contenu.
+     *   - `locale`: La locale du contenu.
+     *   - `extension`: L'extension du fichier.
+     *   - `componentFileName`: Le nom du fichier du composant.
+     *   - `componentExtension`: L'extension du fichier du composant.
+     *   - `format`: Le format du dictionnaire.
+     *   - `componentFormat`: Le format du dictionnaire du composant.
+     *   - `componentDirPath`: Le chemin du répertoire du composant.
      */
-    transformPattern: [
-      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
-      "!**/node_modules/**",
-    ],
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
 
     /**
-     * Modèle à exclure de l'optimisation.
-     */
-    excludePattern: ["**/node_modules/**"],
-
-    /**
-     * Répertoire de sortie pour les dictionnaires optimisés.
+     * Indique si les composants doivent être sauvegardé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é.
      */
-    output: ({ locale, key }) => `compiler/${locale}/${key}.json`,
+    saveComponents: false,
 
     /**
-     * Insérer uniquement le contenu dans le fichier généré, sans clé.
+     * Insérer uniquement le contenu dans le fichier généré. Utile pour les sorties JSON i18next ou ICU MessageFormat par locale.
+     *
+     * - `output: ({ locale, key }) => `./locale/${locale}/${key}.json`,`
      */
     noMetadata: false,
 
     /**
      * Préfixe de clé de dictionnaire
      */
-    dictionaryKeyPrefix: "", // Supprimer le préfixe de base
-
-    /**
-     * Indique si les composants doivent être sauvegardé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,
+    dictionaryKeyPrefix: "", // Ajouter un préfixe optionnel pour les clés de dictionnaire extraites
   },
 };
 
 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)
+````
 
 ### Référence de la configuration du compilateur
 
@@ -225,36 +237,37 @@ Les propriétés suivantes peuvent être configurées dans le bloc `compiler` de
   - _Type_: `boolean | 'build-only'`
   - _Par défaut_: `true`
   - _Description_: Indique si le compilateur doit être activé.
+
 - **dictionaryKeyPrefix**:
   - _Type_: `string`
-  - _Par défaut_: `'comp-'`
+  - _Par défaut_: `''`
   - _Description_: Préfixe pour les clés de dictionnaire extraites.
+
 - **transformPattern**:
   - _Type_: `string | string[]`
   - _Par défaut_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
-  - _Description_: Modèles pour parcourir le code à optimiser.
+  - _Description_: (Obsolète : utilisez `build.traversePattern` à la place) Modèles pour parcourir le code à optimiser.
+
 - **excludePattern**:
   - _Type_: `string | string[]`
   - _Par défaut_: `['**/node_modules/**']`
-  - _Description_: Modèles à exclure de l'optimisation.
-- **outputDir** (Deprecated):
-  - _Type_: `string`
-  - _Par défaut_: `'compiler'`
-  - _Description_: Le répertoire où les dictionnaires extraits seront stockés.
+  - _Description_: (Obsolète : utilisez `build.traversePattern` à la place) Modèles à exclure de l'optimisation.
 
 - **output**:
   - _Type_: `FilePathPattern`
   - _Par défaut_: `({ key }) => 'compiler/${key}.content.json'`
   - _Description_: Définit le chemin des fichiers de sortie. Remplace `outputDir`. Gère les variables dynamiques telles que `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, `{{componentFormat}}`. Peut être configuré sous forme de chaîne à l'aide du format `'my/{{var}}/path'` ou sous forme de fonction.
   - _Note_: `./**/*` Les chemins sont résolus par rapport au composant. `/**/*` les chemins sont résolus par rapport au `baseDir` d'Intlayer.
+  - _Note_: Si la locale est définie dans le chemin, cela générera des dictionnaires par locale.
   - _Exemple_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
 
 - **noMetadata**:
   - _Type_: `boolean`
   - _Par défaut_: `false`
-  - _Description_: Indique si les métadonnées doivent être enregistrées dans le fichier. Si vrai, le compilateur n'enregistrera pas les métadonnées des dictionnaires (clé, enveloppe de contenu).
+  - _Description_: Indique si les métadonnées doivent être enregistrées dans le fichier. Si vrai, le compilateur n'enregistrera pas les métadonnées des dictionnaires (clé, enveloppe de contenu). Utile pour les sorties JSON i18next ou ICU MessageFormat par locale.
   - _Note_: Utile si utilisé avec le plugin `loadJSON`.
-  - _Exemple_: Si `true` :
+  - _Exemple_:
+    Si `true` :
     ```json
     {
       "key": "value"
@@ -274,3 +287,25 @@ Les propriétés suivantes peuvent être configurées dans le bloc `compiler` de
   - _Type_: `boolean`
   - _Par défaut_: `false`
   - _Description_: Indique si les composants doivent être sauvegardés après avoir été transformés.
+
+### 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
+```
+
+### Extraction
+
+Intlayer propose un outil CLI pour extraire le contenu de votre code. Vous pouvez utiliser la commande `intlayer extract` pour extraire le contenu de votre code.
+
+```bash
+npx intlayer extract
+```
+
+> Pour plus de détails, consultez la [documentation CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/index.md)