@intlayer/docs 5.5.8

package/fr/vs_code_extension.md

@@ -0,0 +1,139 @@
+# Extension VS Code Officielle pour Intlayer
+
+## Aperçu
+
+**Intlayer** est l'extension officielle pour Visual Studio Code dédiée à **Intlayer**, conçue pour améliorer l'expérience des développeurs lorsqu'ils travaillent avec du contenu localisé dans des projets **React, Next.js et JavaScript**.
+
+Avec cette extension, les développeurs peuvent **naviguer rapidement** vers leurs dictionnaires de contenu, gérer les fichiers de localisation et optimiser leur flux de travail grâce à des commandes d'automatisation puissantes.
+
+![Intlayer VS Code Extension](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif)
+
+Lien de l'extension : [https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)
+
+## Fonctionnalités
+
+### Navigation Instantanée
+
+**Support Aller à la Définition** – Utilisez `Cmd+Click` (Mac) ou `Ctrl+Click` (Windows/Linux) sur une clé `useIntlayer` pour ouvrir instantanément le fichier de contenu correspondant.  
+**Intégration Transparente** – Fonctionne parfaitement avec les projets **react-intlayer** et **next-intlayer**.  
+**Support Multilingue** – Prend en charge le contenu localisé dans différentes langues.  
+**Intégration VS Code** – S'intègre harmonieusement avec la navigation et la palette de commandes de VS Code.
+
+### Commandes de Gestion des Dictionnaires
+
+Gérez vos dictionnaires de contenu directement depuis VS Code :
+
+- **Construire les Dictionnaires** (`extension.buildDictionaries`) – Générez des fichiers de contenu en fonction de la structure de votre projet.
+- **Envoyer les Dictionnaires** (`extension.pushDictionaries`) – Téléchargez le contenu le plus récent des dictionnaires vers votre dépôt.
+- **Récupérer les Dictionnaires** (`extension.pullDictionaries`) – Synchronisez le contenu le plus récent des dictionnaires depuis votre dépôt vers votre environnement local.
+
+### Générateur de Déclaration de Contenu
+
+Générez facilement des fichiers de dictionnaire structurés dans différents formats :
+
+- **TypeScript (`.ts`)** – `extension.createDictionaryFile.ts`
+- **Module ES (`.esm`)** – `extension.createDictionaryFile.esm`
+- **CommonJS (`.cjs`)** – `extension.createDictionaryFile.cjs`
+- **JSON (`.json`)** – `extension.createDictionaryFile.json`
+
+## Installation
+
+Vous pouvez installer **Intlayer** directement depuis le Marketplace de VS Code :
+
+1. Ouvrez **VS Code**.
+2. Accédez au **Marketplace des Extensions**.
+3. Recherchez **"Intlayer"**.
+4. Cliquez sur **Installer**.
+
+Alternativement, installez-le via la ligne de commande :
+
+```sh
+code --install-extension intlayer
+```
+
+## Utilisation
+
+### Navigation Rapide
+
+1. Ouvrez un projet utilisant **react-intlayer**.
+2. Localisez un appel à `useIntlayer()`, tel que :
+
+   ```tsx
+   const content = useIntlayer("app");
+   ```
+
+3. **Commandez-cliquez** (`⌘+Click` sur macOS) ou **Ctrl+Click** (sur Windows/Linux) sur la clé (par exemple, `"app"`).
+4. VS Code ouvrira automatiquement le fichier de dictionnaire correspondant, par exemple, `src/app.content.ts`.
+
+### Gestion des Dictionnaires de Contenu
+
+#### Construction des Dictionnaires
+
+Générez tous les fichiers de contenu des dictionnaires avec :
+
+```sh
+Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
+```
+
+Recherchez **Construire les Dictionnaires** et exécutez la commande.
+
+#### Envoi des Dictionnaires
+
+Téléchargez le contenu le plus récent des dictionnaires :
+
+1. Ouvrez la **Palette de Commandes**.
+2. Recherchez **Envoyer les Dictionnaires**.
+3. Sélectionnez les dictionnaires à envoyer et confirmez.
+
+#### Récupération des Dictionnaires
+
+Synchronisez le contenu le plus récent des dictionnaires :
+
+1. Ouvrez la **Palette de Commandes**.
+2. Recherchez **Récupérer les Dictionnaires**.
+3. Choisissez les dictionnaires à récupérer.
+
+### Personnalisation des Chemins des Fichiers de Dictionnaire
+
+Par défaut, l'extension suit la structure standard des projets **Intlayer**. Cependant, vous pouvez configurer des chemins personnalisés :
+
+1. Ouvrez **Paramètres (`Cmd + ,` sur macOS / `Ctrl + ,` sur Windows/Linux)`**.
+2. Recherchez `Intlayer`.
+3. Ajustez le paramètre du chemin des fichiers de contenu.
+
+## Développement & Contribution
+
+Vous souhaitez contribuer ? Nous accueillons les contributions de la communauté !
+
+URL du dépôt : https://github.com/aymericzip/intlayer-vs-code-extension
+
+### Premiers Pas
+
+Clonez le dépôt et installez les dépendances :
+
+```sh
+git clone https://github.com/aymericzip/intlayer-vs-code-extension.git
+cd intlayer-vs-code-extension
+npm install
+```
+
+> Utilisez le gestionnaire de paquets `npm` pour garantir la compatibilité avec le package `vsce` pour construire et publier l'extension.
+
+### Exécution en Mode Développement
+
+1. Ouvrez le projet dans **VS Code**.
+2. Appuyez sur `F5` pour lancer une nouvelle fenêtre **Extension Development Host**.
+
+### Soumettre une Pull Request
+
+Si vous améliorez l'extension, soumettez une PR sur [GitHub](https://github.com/aymericzip/intlayer-vs-code-extension).
+
+## Retours & Problèmes
+
+Vous avez trouvé un bug ou avez une demande de fonctionnalité ? Ouvrez une issue sur notre **dépôt GitHub** :
+
+[Issues GitHub](https://github.com/aymericzip/intlayer-vs-code-extension/issues)
+
+## Licence
+
+Intlayer est publié sous la **Licence MIT**.

package/hi/CI_CD.md

@@ -0,0 +1,149 @@
+# CI/CD पाइपलाइन में स्वचालित अनुवाद उत्पन्न करें
+
+Intlayer आपके सामग्री घोषणा फ़ाइलों के लिए अनुवादों को स्वचालित रूप से उत्पन्न करने की अनुमति देता है। इसे प्राप्त करने के लिए आपके वर्कफ़्लो के आधार पर कई तरीके हैं।
+
+## CMS का उपयोग करना
+
+Intlayer के साथ, आप एक वर्कफ़्लो अपना सकते हैं जहां केवल एक ही स्थानीय भाषा को स्थानीय रूप से घोषित किया जाता है, जबकि सभी अनुवाद CMS के माध्यम से दूरस्थ रूप से प्रबंधित किए जाते हैं। यह सामग्री और अनुवादों को कोडबेस से पूरी तरह से अलग करने की अनुमति देता है, सामग्री संपादकों के लिए अधिक लचीलापन प्रदान करता है और हॉट सामग्री रीलोडिंग को सक्षम करता है (परिवर्तनों को लागू करने के लिए एप्लिकेशन को पुनः निर्माण करने की आवश्यकता नहीं होती)।
+
+### उदाहरण कॉन्फ़िगरेशन
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.SPANISH, Locales.FRENCH],
+    requiredLocales: [Locales.ENGLISH], // वैकल्पिक भाषाओं को दूरस्थ रूप से प्रबंधित किया जाएगा
+    defaultLocale: Locales.ENGLISH,
+  },
+  editor: {
+    dictionaryPriorityStrategy: "distant_first", // दूरस्थ सामग्री को प्राथमिकता दी जाती है
+
+    applicationURL: process.env.APPLICATION_URL, // CMS द्वारा उपयोग किया जाने वाला एप्लिकेशन URL
+
+    clientId: process.env.INTLAYER_CLIENT_ID, // CMS क्रेडेंशियल्स
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+  ai: {
+    applicationContext: "यह एक परीक्षण एप्लिकेशन है", // सुनिश्चित करता है कि अनुवाद सुसंगत रूप से उत्पन्न हो
+  },
+};
+
+export default config;
+```
+
+CMS के बारे में अधिक जानने के लिए, [आधिकारिक दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/hi/intlayer_CMS.md) देखें।
+
+## Husky का उपयोग करना
+
+आप [Husky](https://typicode.github.io/husky/) का उपयोग करके अपने स्थानीय Git वर्कफ़्लो में अनुवाद उत्पन्न करने को एकीकृत कर सकते हैं।
+
+### उदाहरण कॉन्फ़िगरेशन
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.SPANISH, Locales.FRENCH],
+    requiredLocales: [Locales.ENGLISH], // वैकल्पिक भाषाओं को दूरस्थ रूप से प्रबंधित किया जाएगा
+    defaultLocale: Locales.ENGLISH,
+  },
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+  ai: {
+    provider: "openai",
+    apiKey: process.env.OPENAI_API_KEY, // अपना API कुंजी उपयोग करें
+
+    applicationContext: "यह एक परीक्षण एप्लिकेशन है", // सुनिश्चित करता है कि अनुवाद सुसंगत रूप से उत्पन्न हो
+  },
+};
+
+export default config;
+```
+
+```bash fileName=".husky/pre-push"
+npx intlayer build                          # सुनिश्चित करें कि शब्दकोश अद्यतन हैं
+npx intlayer fill --unpushed --mode fill    # केवल गायब सामग्री को भरें, मौजूदा को अपडेट न करें
+```
+
+> Intlayer CLI कमांड्स और उनके उपयोग के बारे में अधिक जानकारी के लिए, [CLI दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/hi/intlayer_cli.md) देखें।
+
+> यदि आपके रिपॉजिटरी में कई ऐप्स हैं जो अलग-अलग intlayer इंस्टेंस का उपयोग करते हैं, तो आप `--base-dir` तर्क का उपयोग इस प्रकार कर सकते हैं:
+
+```bash fileName=".husky/pre-push"
+# ऐप 1
+npx intlayer build --base-dir ./app1
+npx intlayer fill --base-dir ./app1 --unpushed --mode fill
+
+# ऐप 2
+npx intlayer build --base-dir ./app2
+npx intlayer fill --base-dir ./app2 --unpushed --mode fill
+```
+
+## GitHub Actions का उपयोग करना
+
+Intlayer एक CLI कमांड प्रदान करता है जो शब्दकोश सामग्री को स्वचालित रूप से भरने और समीक्षा करने की अनुमति देता है। इसे GitHub Actions का उपयोग करके आपके CI/CD वर्कफ़्लो में एकीकृत किया जा सकता है।
+
+```yaml fileName=".github/workflows/intlayer-translate.yml"
+name: Intlayer Auto-Fill
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'src/**'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'src/**'
+  workflow_dispatch: {}
+
+concurrency:
+  group: 'autofill-${{ github.ref }}'
+  cancel-in-progress: true
+
+jobs:
+  autofill:
+    runs-on: ubuntu-latest
+    env:
+      INTLAYER_CLIENT_ID: ${{ secrets.INTLAYER_CLIENT_ID }}
+      INTLAYER_CLIENT_SECRET: ${{ secrets.INTLAYER_CLIENT_SECRET }}
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+
+    steps:
+      - name: ⬇️ रिपॉजिटरी चेकआउट करें
+        uses: actions/checkout@v3
+        with:
+          persist-credentials: true
+
+      - name: 🟢 Node.js सेट करें
+        uses: actions/setup-node@v3
+        with:
+          node-version: 20
+
+      - name: 📦 निर्भरताएँ इंस्टॉल करें
+        run: npm ci
+
+      - name: ⚙️ Intlayer प्रोजेक्ट बनाएं
+        run: npx intlayer build
+
+      - name: 🤖 गायब अनुवाद स्वचालित रूप से भरें
+        run: npx intlayer fill --git-diff --mode fill
+
+      - name: 📤 अनुवाद PR बनाएँ या अपडेट करें
+        uses: peter-evans/create-pull-request@v4
+        with:
+          commit-message: chore: auto-fill missing translations [skip ci]
+          branch: auto-translations
+          title: chore: update missing translations
+          labels: translation, automated
+```
+
+> Husky के समान, यदि यह एक मोनोरिपो है, तो आप `--base-dir` तर्क का उपयोग करके प्रत्येक ऐप को क्रमिक रूप से संसाधित कर सकते हैं।
+
+> डिफ़ॉल्ट रूप से, `--git-diff` तर्क उन शब्दकोशों को फ़िल्टर करता है जिनमें बेस (डिफ़ॉल्ट `origin/main`) से वर्तमान शाखा (डिफ़ॉल्ट: `HEAD`) तक परिवर्तन शामिल हैं।
+
+> Intlayer CLI कमांड्स और उनके उपयोग के बारे में अधिक जानकारी के लिए, [CLI दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/hi/intlayer_cli.md) देखें।

package/hi/autoFill.md

@@ -0,0 +1,157 @@
+# स्वचालित भरण सामग्री घोषणा फ़ाइलें
+
+**स्वचालित भरण सामग्री घोषणा फ़ाइलें** आपके विकास वर्कफ़्लो को तेज़ करने का एक तरीका हैं।
+
+स्वचालित भरण तंत्र सामग्री घोषणा फ़ाइलों के बीच एक _मास्टर-स्लेव_ संबंध के माध्यम से काम करता है। जब मुख्य (मास्टर) फ़ाइल अपडेट होती है, तो Intlayer स्वचालित रूप से उन परिवर्तनों को व्युत्पन्न (स्वचालित रूप से भरी गई) घोषणा फ़ाइलों पर लागू करेगा।
+
+```ts fileName="src/components/example/example.content.ts"
+import { Locales, type Dictionary } from "intlayer";
+
+const exampleContent = {
+  key: "example",
+  locale: Locales.ENGLISH,
+  autoFill: "./example.content.json",
+  content: {
+    contentExample: "This is an example of content",
+  },
+} satisfies Dictionary;
+
+export default exampleContent;
+```
+
+यह `autoFill` निर्देश का उपयोग करने वाली [प्रति-भाषा सामग्री घोषणा फ़ाइल](https://github.com/aymericzip/intlayer/blob/main/docs/hi/per_locale_file.md) है।
+
+फिर, जब आप निम्न कमांड चलाते हैं:
+
+```bash
+npx intlayer fill --file 'src/components/example/example.content.ts'
+```
+
+Intlayer स्वचालित रूप से `src/components/example/example.content.json` में व्युत्पन्न घोषणा फ़ाइल उत्पन्न करेगा, मुख्य फ़ाइल में अभी तक घोषित नहीं की गई सभी भाषाओं को भरते हुए।
+
+```json5 fileName="src/components/example/example.content.json"
+{
+  "key": "example",
+  "content": {
+    "contentExample": {
+      "nodeType": "translation",
+      "translation": {
+        "fr": "Ceci est un exemple de contenu",
+        "es": "Este es un ejemplo de contenido",
+      },
+    },
+  },
+}
+```
+
+बाद में, दोनों घोषणा फ़ाइलें एक शब्दकोश में विलय हो जाएंगी, जिसे मानक `useIntlayer("example")` हुक (react) / कंपोज़ेबल (vue) का उपयोग करके एक्सेस किया जा सकता है।
+
+## स्वचालित भरण फ़ाइल प्रारूप
+
+स्वचालित भरण घोषणा फ़ाइलों के लिए अनुशंसित प्रारूप **JSON** है, जो प्रारूप प्रतिबंधों से बचने में मदद करता है। हालांकि, Intlayer `.ts`, `.js`, `.mjs`, `.cjs` और अन्य प्रारूपों का भी समर्थन करता है।
+
+```ts fileName="src/components/example/example.content.ts"
+const exampleContent = {
+  key: "example",
+  autoFill: "./example.filled.content.ts",
+  content: {
+    // आपकी सामग्री
+  },
+};
+```
+
+यह फ़ाइल को यहां उत्पन्न करेगा:
+
+```
+src/components/example/example.filled.content.ts
+```
+
+> `.js`, `.ts` आदि फ़ाइलों का उत्पादन निम्नानुसार काम करता है:
+
+> - यदि फ़ाइल पहले से मौजूद है, तो Intlayer AST (अमूर्त वाक्यविन्यास वृक्ष) का उपयोग करके प्रत्येक फ़ील्ड को खोजने और लुप्त अनुवादों को सम्मिलित करने के लिए इसका विश्लेषण करेगा।
+
+> - यदि फ़ाइल मौजूद नहीं है, तो Intlayer सामग्री घोषणा फ़ाइलों के लिए डिफ़ॉल्ट टेम्पलेट का उपयोग करके इसे उत्पन्न करेगा।
+
+## निरपेक्ष पथ
+
+`autoFill` फ़ील्ड निरपेक्ष पथों का भी समर्थन करता है।
+
+```ts fileName="src/components/example/example.content.ts"
+const exampleContent = {
+  key: "example",
+  autoFill: "/messages/example.content.json",
+  content: {
+    // आपकी सामग्री
+  },
+};
+```
+
+यह फ़ाइल को यहां उत्पन्न करेगा:
+
+```
+/messages/example.content.json
+```
+
+## प्रति-भाषा सामग्री घोषणा फ़ाइलों का स्वचालित उत्पादन
+
+`autoFill` फ़ील्ड **प्रति-भाषा** सामग्री घोषणा फ़ाइलों के उत्पादन का भी समर्थन करता है।
+
+```ts fileName="src/components/example/example.content.ts"
+const exampleContent = {
+  key: "example",
+  autoFill: {
+    fr: "./example.fr.content.json",
+    es: "./example.es.content.json",
+  },
+  content: {
+    // आपकी सामग्री
+  },
+};
+```
+
+यह दो अलग-अलग फ़ाइलें उत्पन्न करेगा:
+
+- `src/components/example/example.fr.content.json`
+- `src/components/example/example.es.content.json`
+
+## विशिष्ट भाषा स्वचालित भरण फ़िल्टरिंग
+
+`autoFill` फ़ील्ड के लिए एक वस्तु का उपयोग आपको फ़िल्टर लागू करने और केवल विशिष्ट भाषा फ़ाइलें उत्पन्न करने की अनुमति देता है।
+
+```ts fileName="src/components/example/example.content.ts"
+const exampleContent = {
+  key: "example",
+  autoFill: {
+    fr: "./example.fr.content.json",
+  },
+  content: {
+    // आपकी सामग्री
+  },
+};
+```
+
+यह केवल फ्रेंच अनुवाद फ़ाइल उत्पन्न करेगा।
+
+## पथ चर
+
+आप उत्पन्न फ़ाइलों के लक्ष्य पथों को गतिशील रूप से हल करने के लिए `autoFill` पथ के अंदर चर का उपयोग कर सकते हैं।
+
+**उपलब्ध चर:**
+
+- `{{locale}}` – भाषा कोड (उदाहरण: `fr`, `es`)
+- `{{key}}` – शब्दकोश कुंजी (उदाहरण: `example`)
+
+```ts fileName="src/components/example/example.content.ts"
+const exampleContent = {
+  key: "example",
+  autoFill: "/messages/{{locale}}/{{key}}.content.json",
+  content: {
+    // आपकी सामग्री
+  },
+};
+```
+
+यह उत्पन्न करेगा:
+
+- `/messages/fr/example.content.json`
+- `/messages/es/example.content.json`