@intlayer/docs 8.3.0-canary.4 → 8.3.1

package/docs/fr/intlayer_with_vite+vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2025-12-30
+updatedAt: 2026-03-12
 title: Vite + Vue i18n - Comment traduire une application Vue en 2026
 description: Découvrez comment rendre votre site Vite et Vue multilingue. Suivez la documentation pour internationaliser (i18n) et traduire votre site.
 keywords:
@@ -25,7 +25,7 @@ history:
     changes: Historique initial
 ---
 
-# Traduire votre Vite and Vue avec Intlayer | Internationalisation (i18n)
+# Traduire votre Vite et Vue avec Intlayer | Internationalisation (i18n)
 
 ## Qu'est-ce que Intlayer ?
 
@@ -45,7 +45,7 @@ Avec Intlayer, vous pouvez :
 <Tabs defaultTab="video">
   <Tab label="Vidéo" value="video">
   
-<iframe title="The best i18n solution for Vite and Vue? Discover Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/IE3XWkZ6a5U?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+<iframe title="The best i18n solution for Vite et Vue? Discover Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/IE3XWkZ6a5U?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </Tab>
   <Tab label="Code" value="code">
@@ -53,7 +53,7 @@ Avec Intlayer, vous pouvez :
 <iframe
   src="https://stackblitz.com/github/aymericzip/intlayer-vite-vue-template?embed=1&ctl=1&file=intlayer.config.ts"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
+  title="Démo CodeSandbox - Comment internationaliser votre application avec Intlayer"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -237,7 +237,7 @@ const helloWorldContent = {
       es: "Vue Docs Scaling up Guide",
     }),
     readTheDocs: t({
-      en: "Click on the Vite and Vue logos to learn more",
+      en: "Click on the Vite et Vue logos to learn more",
       fr: "Cliquez sur les logos Vite et Vue pour en savoir plus",
       es: "Haga clic en los logotipos de Vite y Vue para obtener más información",
     }),
@@ -277,7 +277,7 @@ const helloWorldContent = {
       es: "Vue Docs Scaling up Guide",
     }),
     readTheDocs: t({
-      en: "Click on the Vite and Vue logos to learn more",
+      en: "Click on the Vite et Vue logos to learn more",
       fr: "Cliquez sur les logos Vite et Vue pour en savoir plus",
       fr: "Cliquez sur les logos Vite et Vue pour en savoir plus",
       es: "Haga clic en los logotipos de Vite y Vue para obtener más información",
@@ -318,7 +318,7 @@ const appContent = {
       es: "Vue Docs Scaling up Guide",
     }),
     readTheDocs: t({
-      en: "Click on the Vite and Vue logos to learn more",
+      en: "Click on the Vite et Vue logos to learn more",
       fr: "Cliquez sur les logos Vite et Vue pour en savoir plus",
       es: "Haga clic en los logotipos de Vite y Vue para obtener más información",
     }),
@@ -384,7 +384,7 @@ module.exports = appContent;
     "readTheDocs": {
       "nodeType": "translation",
       "translation": {
-        "en": "Click on the Vite and Vue logos to learn more",
+        "en": "Click on the Vite et Vue logos to learn more",
         "fr": "Cliquez sur les logos Vite et Vue pour en savoir plus",
         "es": "Haga clic en los logotipos de Vite y Vue para obtener más información"
       }
@@ -1010,6 +1010,162 @@ const { myMarkdownContent } = useIntlayer("my-component");
 </script>
 ```
 
+### (Optionnel) Étape 12 : Extraire le contenu de vos composants
+
+Si vous avez une base de code existante, transformer des milliers de fichiers peut prendre beaucoup de temps.
+
+Pour faciliter ce processus, Intlayer propose un [compilateur](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compiler.md) / [extracteur](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/extract.md) pour transformer vos composants et extraire le contenu.
+
+Pour le configurer, vous pouvez ajouter une section `compiler` dans votre fichier `intlayer.config.ts` :
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... Reste de votre configuration
+  compiler: {
+    /**
+     * Indique si le compilateur doit être activé.
+     */
+    enabled: true,
+
+    /**
+     * Définit le chemin des fichiers de sortie
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * 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,
+
+    /**
+     * Préfixe de clé de dictionnaire
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Reste de votre configuration
+  compiler: {
+    /**
+     * Indique si le compilateur doit être activé.
+     */
+    enabled: true,
+
+    /**
+     * Définit le chemin des fichiers de sortie
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * 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,
+
+    /**
+     * Préfixe de clé de dictionnaire
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Reste de votre configuration
+  compiler: {
+    /**
+     * Indique si le compilateur doit être activé.
+     */
+    enabled: true,
+
+    /**
+     * Définit le chemin des fichiers de sortie
+     */
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
+
+    /**
+     * 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,
+
+    /**
+     * Préfixe de clé de dictionnaire
+     */
+    dictionaryKeyPrefix: "",
+  },
+};
+
+module.exports = config;
+```
+
+<Tabs>
+ <Tab value='Commande d'extraction'>
+
+Exécutez l'extracteur pour transformer vos composants et extraire le contenu
+
+```bash packageManager="npm"
+npx intlayer extract
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer extract
+```
+
+```bash packageManager="yarn"
+yarn intlayer extract
+```
+
+```bash packageManager="bun"
+bunx intlayer extract
+```
+
+ </Tab>
+ <Tab value='Compilateur Babel'>
+
+Mettez à jour votre fichier `vite.config.ts` pour inclure le plugin `intlayerCompiler` :
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer, intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [
+    intlayer(),
+    intlayerCompiler(), // Ajoute le plugin du compilateur
+  ],
+});
+```
+
+```bash packageManager="npm"
+npm run build # Ou npm run dev
+```
+
+```bash packageManager="pnpm"
+pnpm run build # Ou pnpm run dev
+```
+
+```bash packageManager="yarn"
+yarn build # Ou yarn dev
+```
+
+```bash packageManager="bun"
+bun run build # Or bun run dev
+```
+
+ </Tab>
+</Tabs>
+
 ### Configurer TypeScript
 
 Intlayer utilise l'augmentation de module pour tirer parti de TypeScript et renforcer votre base de code.

package/docs/hi/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-10
+updatedAt: 2026-03-12
 title: Intlayer Compiler | i18n के लिए स्वचालित सामग्री निष्कर्षण
 description: Intlayer Compiler के साथ अपने अंतरराष्ट्रीयकरण प्रक्रिया को स्वचालित करें। Vite, Next.js, और अन्य में तेज़, अधिक कुशल i18n के लिए सीधे अपने कंपोनेंट्स से सामग्री निकालें।
 keywords:
@@ -149,73 +149,85 @@ module.exports = {
 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>
 
 ### कस्टम कॉन्फ़िगरेशन
 
 कंपाइलर व्यवहार को अनुकूलित करने के लिए, आप अपने प्रोजेक्ट के रूट में `intlayer.config.ts` फ़ाइल को अपडेट कर सकते हैं।
 
-```ts fileName="intlayer.config.ts"
+````ts fileName="intlayer.config.ts"
 import { type IntlayerConfig, Locales } from "intlayer";
 
 const config: IntlayerConfig = {
   compiler: {
     /**
+     * इंगित करता है कि क्या कंपाइलर सक्षम होना चाहिए।
      * विकास के दौरान कंपाइलर को छोड़ने और स्टार्टअप समय को तेज करने के लिए 'build-only' पर सेट करें।
      */
     enabled: true,
 
     /**
-     * Pattern to traverse the code to optimize.
+     * आउटपुट फ़ाइल पथ को परिभाषित करता है। `outputDir` को प्रतिस्थापित करता है।
+     *
+     * - `./` पथ घटक निर्देशिका के सापेक्ष हल किए जाते हैं।
+     * - `/` पथ प्रोजेक्ट रूट (`baseDir`) के सापेक्ष हल किए जाते हैं।
+     *
+     * - पथ में `{{locale}}` चर डालने से भाषा द्वारा अलग किए गए शब्दकोश निर्माण सक्षम हो जाएंगे।
+     *
+     * उदाहरण:
+     * ```ts
+     * {
+     *   // घटक के बगल में बहुभाषी .content.ts फ़ाइलें बनाएँ
+     *   output: ({ fileName, extension }) => `./${fileName}${extension}`,
+     *
+     *   // output: './{{fileName}}{{extension}}', // स्ट्रिंग टेम्प्लेट का उपयोग करके समकक्ष
+     * }
+     * ```
+     *
+     * ```ts
+     * {
+     *   // प्रोजेक्ट रूट पर भाषा द्वारा केंद्रीकृत JSON फ़ाइलें बनाएँ
+     *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,
+     *
+     *   // output: '/locales/{{locale}}/{{key}}.content.json', // स्ट्रिंग टेम्प्लेट का उपयोग करके समकक्ष
+     * }
+     * ```
+     *
+     * चर सूची:
+     *   - `fileName`: फ़ाइल का नाम।
+     *   - `key`: सामग्री की कुंजी।
+     *   - `locale`: सामग्री का स्थानीय मान (लोकल)।
+     *   - `extension`: फ़ाइल एक्सटेंशन।
+     *   - `componentFileName`: घटक फ़ाइल का नाम।
+     *   - `componentExtension`: घटक फ़ाइल एक्सटेंशन।
+     *   - `format`: शब्दकोश प्रारूप।
+     *   - `componentFormat`: घटक शब्दकोश प्रारूप।
+     *   - `componentDirPath`: घटक निर्देशिका पथ।
      */
-    transformPattern: [
-      "**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}",
-      "!**/node_modules/**",
-    ],
+    output: ({ fileName, extension }) => `./${fileName}${extension}`,
 
     /**
-     * Pattern to exclude from the optimization.
-     */
-    excludePattern: ["**/node_modules/**"],
-
-    /**
-     * अनुकूलित शब्दकोशों के लिए आउटपुट निर्देशिका।
+     * इंगित करता है कि क्या घटकों को रूपांतरित होने के बाद सहेजा जाना चाहिए।
+     * इस तरह, कंपाइलर को ऐप को रूपांतरित करने के लिए केवल एक बार चलाया जा सकता है, और फिर इसे हटाया जा सकता है।
      */
-    output: ({ key }) => `compiler/${key}.content.json`,
+    saveComponents: false,
 
     /**
-     * उत्पन्न फ़ाइल में केवल सामग्री डालें, बिना कुंजी के।
+     * उत्पन्न फ़ाइल में केवल सामग्री डालें। i18next या ICU MessageFormat JSON आउटपुट प्रति लोकल के लिए उपयोगी।
+     *
+     * - `output: ({ locale, key }) => `./locale/${locale}/${key}.json`,`
      */
     noMetadata: false,
 
     /**
      * शब्दकोश कुंजी उपसर्ग
      */
-    dictionaryKeyPrefix: "", // Remove base prefix
-
-    /**
-     * इंगित करता है कि क्या घटकों को रूपांतरित होने के बाद सहेजा जाना चाहिए।
-     * इस तरह, कंपाइलer को ऐप को रूपांतरित करने के लिए केवल एक बार चलाया जा सकता है, और फिर इसे हटाया जा सकता है।
-     */
-    saveComponents: false,
+    dictionaryKeyPrefix: "", // निकाली गई शब्दकोश कुंजियों के लिए वैकल्पिक उपसर्ग जोड़ें
   },
 };
 
 export default config;
-```
-
-### लापता अनुवाद भरें
-
-Intlayer अनुवादों को भरने में आपकी सहायता के लिए एक CLI टूल प्रदान करता है। आप अपने कोड से लापता अनुवादों का परीक्षण करने और उन्हें भरने के लिए `intlayer` कमांड का उपयोग कर सकते हैं।
-
-```bash
-npx intlayer test         # परीक्षण करें कि क्या कोई अनुवाद लापता है
-```
-
-```bash
-npx intlayer fill         # लापता अनुवाद भरें
-```
-
-> अधिक विवरण के लिए, [CLI दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/cli/ci.md) देखें।
+````
 
 ### कंपाइलर कॉन्फ़िगरेशन संदर्भ
 
@@ -225,36 +237,37 @@ npx intlayer fill         # लापता अनुवाद भरें
   - _प्रकार_: `boolean | 'build-only'`
   - _डिफ़ॉल्ट_: `true`
   - _विवरण_: इंगित करता है कि क्या कंपाइलर सक्षम होना चाहिए।
+
 - **dictionaryKeyPrefix**:
   - _प्रकार_: `string`
-  - _डिफ़ॉल्ट_: `'comp-'`
+  - _डिफ़ॉल्ट_: `''`
   - _विवरण_: निकाली गई शब्दकोश कुंजियों के लिए उपसर्ग।
+
 - **transformPattern**:
   - _प्रकार_: `string | string[]`
   - _डिफ़ॉल्ट_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,vue,svelte}', '!**/node_modules/**']`
-  - _विवरण_: ऑप्टिमाइज़ करने के लिए कोड को पार करने के पैटर्न।
+  - _विवरण_: (पुराना (Deprecated): इसके बजाय `build.traversePattern` का उपयोग करें) ऑप्टिमाइज़ करने के लिए कोड को पार करने के पैटर्न।
+
 - **excludePattern**:
   - _प्रकार_: `string | string[]`
   - _डिफ़ॉल्ट_: `['**/node_modules/**']`
-  - _विवरण_: ऑप्टिमाइज़ेशन से बाहर रखने के पैटर्न।
-- **outputDir** (Deprecated):
-  - _प्रकार_: `string`
-  - _डिफ़ॉल्ट_: `'compiler'`
-  - _विवरण_: वह निर्देशिका जहाँ निकाली गई शब्दकोश सामग्री संग्रहीत की जाएगी।
+  - _विवरण_: (पुराना (Deprecated): इसके बजाय `build.traversePattern` का उपयोग करें) ऑप्टिमाइज़ेशन से बाहर रखने के पैटर्न।
 
 - **output**:
   - _प्रकार_: `FilePathPattern`
   - _डिफ़ॉल्ट_: `({ key }) => 'compiler/${key}.content.json'`
   - _विवरण_: आउटपुट फ़ाइल पथ को परिभाषित करता है। `outputDir` को प्रतिस्थापित करता है। `{{locale}}`, `{{key}}`, `{{fileName}}`, `{{extension}}`, `{{format}}`, `{{dirPath}}`, `{{componentFileName}}`, `{{componentExtension}}`, और `{{componentFormat}}` जैसे गतिशील चरों को संभालता है। इसे `'my/{{var}}/path'` प्रारूप का उपयोग करके एक स्ट्रिंग के रूप में, या एक फ़ंक्शन के रूप में सेट किया जा सकता है।
   - _नोट_: `./**/*` पथ घटक के सापेक्ष हल किए जाते हैं। `/**/*` पथ Intlayer `baseDir` के सापेक्ष हल किए जाते हैं।
+  - _नोट_: यदि पथ में लोकेल (locale) परिभाषित है, तो शब्दकोश लोकेल द्वारा उत्पन्न किए जाएंगे।
   - _उदाहरण_: `output: ({ locale, key }) => 'compiler/${locale}/${key}.json'`
 
 - **noMetadata**:
   - _प्रकार_: `boolean`
   - _डिफ़ॉल्ट_: `false`
-  - _विवरण_: इंगित करता है कि फ़ाइल में मेटाडेटा सहेजा जाना चाहिए या नहीं। यदि सही है, तो कंपाइलर शब्दकोशों (कुंजी, सामग्री रैपर) के मेटाडेटा को नहीं बचाएगा।
+  - _विवरण_: इंगित करता है कि फ़ाइल में मेटाडेटा सहेजा जाना चाहिए या नहीं। यदि सही है, तो कंपाइलर शब्दकोशों (कुंजी, सामग्री रैपर) के मेटाडेटा को नहीं बचाएगा। प्रति-लोकल i18next या ICU MessageFormat JSON आउटपुट के लिए उपयोगी।
   - _नोट_: `loadJSON` प्लगइन के साथ उपयोग किए जाने पर उपयोगी।
-  - _उदाहरण_: यदि `सही` है:
+  - _उदाहरण_:
+    यदि `सही` है:
     ```json
     {
       "key": "value"
@@ -274,3 +287,25 @@ npx intlayer fill         # लापता अनुवाद भरें
   - _प्रकार_: `boolean`
   - _डिफ़ॉल्ट_: `false`
   - _विवरण_: इंगित करता है कि क्या घटकों को रूपांतरित होने के बाद सहेजा जाना चाहिए।
+
+### लापता अनुवाद भरें
+
+Intlayer अनुवादों को भरने में आपकी सहायता के लिए एक CLI टूल प्रदान करता है। आप अपने कोड से लापता अनुवादों का परीक्षण करने और उन्हें भरने के लिए `intlayer` कमांड का उपयोग कर सकते हैं।
+
+```bash
+npx intlayer test         # परीक्षण करें कि क्या कोई अनुवाद लापता है
+```
+
+```bash
+npx intlayer fill         # लापता अनुवाद भरें
+```
+
+### निष्कर्षण
+
+Intlayer आपके कोड से सामग्री निकालने के लिए एक CLI टूल प्रदान करता है। आप अपने कोड से सामग्री निकालने के लिए `intlayer extract` कमांड का उपयोग कर सकते हैं।
+
+```bash
+npx intlayer extract
+```
+
+> अधिक विवरण के लिए, [CLI दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/cli/index.md) देखें।