@intlayer/docs 5.5.9 → 5.5.11

package/docs/fr/roadmap.md

@@ -0,0 +1,337 @@
+---
+createdAt: 2025-03-01
+updatedAt: 2025-06-29
+title: Feuille de route
+description: Découvrez la feuille de route d'Intlayer. Voyez toutes les fonctionnalités qu'Intlayer a mises en œuvre et prévoit d'implémenter.
+keywords:
+  - Feuille de route
+  - Intlayer
+  - Internationalisation
+  - CMS
+  - Système de gestion de contenu
+  - Éditeur visuel
+slugs:
+  - doc
+  - roadmap
+---
+
+# Intlayer : Aperçu des fonctionnalités & Feuille de route
+
+Intlayer est une solution de gestion de contenu et d'internationalisation conçue pour simplifier la manière dont vous déclarez, gérez et mettez à jour le contenu dans vos applications. Elle offre des fonctionnalités puissantes telles que la déclaration de contenu centralisée ou distribuée, de nombreuses options d'internationalisation, la prise en charge de Markdown, le rendu conditionnel, l'intégration TypeScript/JavaScript/JSON, et bien plus encore. Voici un aperçu complet de ce qu'Intlayer propose actuellement, suivi des fonctionnalités à venir dans la feuille de route.
+
+---
+
+## Fonctionnalités actuelles
+
+### 1. Déclaration de contenu
+
+#### Centralisée ou distribuée
+
+- **Centralisée** : Déclarez tout votre contenu dans un seul et grand fichier à la racine de votre application, similaire à i18next, afin de pouvoir tout gérer en un seul endroit.
+- **Distribué** : Vous pouvez également diviser votre contenu en fichiers séparés au niveau des composants ou des fonctionnalités pour une meilleure maintenabilité. Cela permet de garder votre contenu proche du code pertinent (composants, tests, Storybook, etc.). La suppression d’un composant garantit également la suppression de tout contenu associé, évitant ainsi que des données résiduelles encombrent votre base de code.
+
+> Ressources :
+>
+> - [Déclaration de contenu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/get_started.md)
+
+### 2. Internationalisation
+
+- Prise en charge de **230 langues et locales** (y compris les variantes régionales comme le français (France), l’anglais (Canada), l’anglais (Royaume-Uni), le portugais (Portugal), etc.).
+- Gérez facilement les traductions pour toutes ces locales depuis un seul endroit.
+
+> Ressources :
+>
+> - [Internationalisation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/translation.md)
+
+### 3. Support Markdown
+
+- Déclarez du contenu en utilisant **Markdown**, ce qui vous permet de formater automatiquement le texte avec des paragraphes, des titres, des liens, et plus encore.
+- Idéal pour les articles de blog, les articles, les pages de documentation ou tout scénario nécessitant une mise en forme riche du texte.
+
+> Ressources :
+>
+> - [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/markdown.md)
+
+### 4. Support des fichiers externes
+
+- Importez du contenu depuis des fichiers externes au format texte, tels que TXT, HTML, JSON, YAML ou CSV.
+- Utilisez la fonction `file` dans Intlayer pour intégrer le contenu de fichiers externes dans un dictionnaire, assurant une intégration fluide avec l’éditeur visuel Intlayer et le CMS.
+- Prend en charge les mises à jour dynamiques du contenu, ce qui signifie que lorsque le fichier source est modifié, le contenu se met à jour automatiquement dans Intlayer.
+- Permet la gestion multilingue du contenu en liant dynamiquement des fichiers Markdown spécifiques à chaque langue.
+
+> Ressources :
+>
+> - [Intégration de contenu de fichier](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/file.md)
+
+### 5. Contenu dynamique et récupération de fonctions
+
+Intlayer propose diverses méthodes pour insérer et gérer du contenu dynamique, garantissant flexibilité et adaptabilité dans la diffusion du contenu. Cela inclut des fonctions pour l'insertion de contenu dynamique, le rendu conditionnel, l'énumération, l'imbrication et la récupération de fonctions.
+
+1. Insertion de contenu dynamique
+
+   Utilisez la fonction insert pour définir du contenu avec des espaces réservés ({{name}}, {{age}}, etc.).
+
+   Permet un contenu de type modèle qui s’adapte en fonction des entrées utilisateur, des réponses d’API ou d’autres sources de données dynamiques.
+
+   Fonctionne parfaitement avec les configurations TypeScript, ESM, CommonJS et JSON.
+
+   S’intègre facilement avec React Intlayer et Next Intlayer en utilisant useIntlayer.
+
+2. Rendu Conditionnel
+
+   Définissez un contenu qui s’adapte en fonction des conditions spécifiques à l’utilisateur, telles que la langue ou le statut d’authentification.
+
+   Personnalisez les expériences sans dupliquer le contenu dans plusieurs fichiers.
+
+3. Énumération & Pluriel
+
+   Utilisez la fonction enu pour définir des variations de contenu basées sur des valeurs numériques, des plages ou des clés personnalisées.
+
+   Assure la sélection automatique de la phrase correcte en fonction d’une valeur donnée.
+
+   Prend en charge les règles d’ordre, garantissant un comportement prévisible.
+
+4. Imbrication et Référencement de Sous-Contenu
+
+   Utilisez la fonction nest pour référencer et réutiliser du contenu provenant d’un autre dictionnaire, réduisant ainsi la duplication.
+
+   Prend en charge une gestion de contenu structurée et hiérarchique pour une meilleure maintenabilité.
+
+5. Récupération par Fonction
+
+   Intlayer permet de déclarer le contenu sous forme de fonctions, autorisant à la fois la récupération de contenu synchrone et asynchrone.
+
+   Fonctions synchrones : Le contenu est généré dynamiquement au moment de la compilation.
+
+   Fonctions asynchrones : Récupèrent des données depuis des sources externes (par exemple, API, bases de données) de manière dynamique.
+
+   Intégration : Fonctionne avec TypeScript, ESM et CommonJS mais n’est pas supporté dans les fichiers JSON ou les fichiers de contenu distants.
+
+### 6. Formats de Déclaration de Contenu
+
+Intlayer supporte **TypeScript** (ainsi que JavaScript) et **JSON** pour la déclaration du contenu.
+
+- **TypeScript** :
+
+  - Assure que la structure de votre contenu est correcte et qu'aucune traduction n'est manquante.
+  - Offre des modes de validation stricts ou plus flexibles.
+  - Permet la récupération dynamique de données à partir de variables, fonctions ou API externes.
+
+- **JSON** :
+
+  - Facilite l'intégration avec des outils externes (comme les éditeurs visuels) grâce à son format standardisé.
+
+  > Ressources :
+  >
+  > - [Formats de déclaration de contenu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/content_extention_customization.md)
+
+### 7. Purge, optimisation du bundle et imports dynamiques
+
+- Intlayer intègre des plugins `Babel` et `SWC` pour optimiser votre bundle et améliorer les performances. Il remplace les imports, permettant d'importer uniquement les dictionnaires utilisés dans le bundle.
+- En activant cette option, Intlayer permet également d'importer dynamiquement le contenu du dictionnaire uniquement pour la locale courante.
+
+> Ressources :
+>
+> - [Configuration de la construction](https://intlayer.org/doc/concept/configuration#build-configuration)
+
+---
+
+## Intégration avec les Frameworks & Environnements
+
+### 1. Next.js
+
+#### a. Composants Serveur et Client
+
+- Fournit une **approche unifiée de gestion de contenu** pour les composants serveur et client.
+- Offre un contexte intégré pour les composants serveur, simplifiant la mise en œuvre par rapport à d'autres solutions.
+
+#### b. Métadonnées, Sitemaps et robots.txt
+
+- Récupère et injecte dynamiquement le contenu pour générer des métadonnées, des sitemaps ou des fichiers `robots.txt`.
+
+#### c. Middleware
+
+- Ajoute un middleware pour **rediriger les utilisateurs** vers le contenu en fonction de leur langue préférée.
+
+#### d. Compatibilité Turbopack et Webpack
+
+- Entièrement compatible avec le nouveau Turbopack de Next.js ainsi qu'avec Webpack traditionnel.
+
+> Ressources :
+>
+> - [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_nextjs_15.md)
+
+### 2. Vite
+
+- Comme avec Next.js, vous pouvez intégrer Intlayer avec Vite et utiliser un **middleware** pour rediriger les utilisateurs vers le contenu selon leur langue préférée.
+
+> Ressources :
+>
+> - [Vite](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_vite+react.md)
+
+### 3. Express
+
+- Gérez le contenu et internationalisez les services backend construits avec Express.
+- Personnalisez les emails, messages d'erreur, notifications push, et plus encore avec du texte localisé.
+
+> Ressources :
+>
+> - [Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_express.md)
+
+### 4. React Native
+
+- Intégrez Intlayer avec React Native pour gérer le contenu et internationaliser vos applications mobiles.
+- Prend en charge les plateformes iOS et Android.
+
+> Ressources :
+>
+> - [React Native](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_react_native.md)
+
+### 5. Lynx
+
+- Intégrez Intlayer avec Lynx pour gérer le contenu et internationaliser vos applications mobiles.
+- Prend en charge les plateformes iOS et Android.
+
+> Ressources :
+>
+> - [Lynx](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_lynx.md)
+
+### 6. Vue
+
+- Intégrez Intlayer avec Vue pour gérer le contenu et internationaliser vos applications Vite / Vue.js.
+
+> Ressources :
+>
+> - [Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_vue.md)
+
+### 7. Nuxt
+
+- Intégrez Intlayer avec Nuxt pour gérer le contenu et internationaliser vos applications Nuxt / Vue.js.
+- Prend en charge les composants serveur et client.
+- Intègre le routage et les middlewares pour rediriger les utilisateurs vers le contenu selon leur langue préférée.
+
+> Ressources :
+>
+> - [Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_nuxt.md)
+
+### 8. Preact
+
+- Intégrez Intlayer avec Preact pour gérer le contenu et internationaliser vos applications Preact.
+
+> Ressources :
+>
+> - [Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_preact.md)
+
+---
+
+## Éditeurs Visuels et CMS
+
+### 1. Éditeur Visuel Local
+
+- Un **éditeur visuel local gratuit** qui vous permet de modifier le contenu de votre application en sélectionnant directement les éléments sur la page.
+- Intègre des fonctionnalités d'IA pour aider à :
+  - Générer ou corriger des traductions
+  - Vérifier la syntaxe et l'orthographe
+  - Suggérer des améliorations
+- Peut être hébergé localement ou déployé sur un serveur distant.
+
+> Ressources :
+>
+> - [Éditeur Visuel](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_visual_editor.md)
+
+### 2. Intlayer CMS (à distance)
+
+- Une solution de **CMS hébergée** qui vous permet de gérer le contenu de l'application en ligne, sans toucher à votre base de code.
+- Offre des fonctionnalités assistées par IA pour déclarer le contenu, gérer les traductions et corriger les erreurs de syntaxe ou d'orthographe.
+- Interagissez avec votre contenu via l'interface de votre application en direct.
+
+> Ressources :
+>
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md)
+
+---
+
+## Extensions IDE
+
+- Extensions pour les principaux IDE offrant une **interface graphique** pour gérer les traductions locales et distantes.
+- Les fonctionnalités peuvent inclure la génération automatique de fichiers de déclaration de contenu pour les composants, l’intégration directe avec le CMS Intlayer, et la validation en temps réel.
+
+---
+
+## Serveur MCP
+
+- Un **serveur MCP** qui vous permet de gérer votre contenu et vos traductions via un outil intégré dans votre IDE.
+
+---
+
+## Intlayer CLI
+
+- **Traduction et génération de fichiers** : Effectuez des audits sur vos fichiers de contenu pour générer les traductions manquantes et vérifier les incohérences.
+- **Interaction distante** : Poussez votre contenu local vers le CMS distant ou récupérez le contenu distant pour l’intégrer dans votre application locale.
+- **Traduction et révision de documents** : Traduisez et révisez votre documentation / vos fichiers, etc.
+
+> Ressources :
+>
+> - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_cli.md)
+
+---
+
+## Environnements
+
+- Utilisez des **variables d’environnement** pour configurer Intlayer différemment selon les environnements de production, de test et locaux.
+- Définissez quel éditeur visuel ou projet CMS distant cibler en fonction de votre environnement.
+
+---
+
+## Mises à jour dynamiques du contenu
+
+- Lors de l’utilisation de dictionnaires distants et du CMS Intlayer, vous pouvez **mettre à jour le contenu de votre application à la volée**, sans avoir besoin de redéployer.
+
+> Ressources :
+>
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md)
+
+---
+
+## Fonctionnalités à venir
+
+### 1. Tests A/B & Personnalisation
+
+- **Test multivarié** : Testez différentes versions d’un contenu donné pour voir laquelle performe le mieux (par exemple, un taux de clic plus élevé).
+- **Personnalisation basée sur les données** : Affichez différents contenus en fonction des données démographiques des utilisateurs (sexe, âge, localisation, etc.) ou d’autres comportements.
+- **Itération automatisée** : Permettez à l’IA de tester automatiquement plusieurs versions et de choisir la meilleure ou de recommander des options pour approbation par l’administrateur.
+
+### 2. Gestion des versions
+
+- Restaurez les versions précédentes de votre contenu grâce à la **gestion des versions de contenu**.
+- Suivez les modifications au fil du temps et revenez à des états antérieurs si nécessaire.
+
+### 3. Traduction automatique
+
+- Pour les utilisateurs du CMS à distance, **génération de traduction en un clic** pour toute langue prise en charge.
+- Le système générerait les traductions en arrière-plan puis vous inviterait à les valider ou à les modifier.
+
+### 4. Améliorations SEO
+
+- Outils pour **analyser les mots-clés**, l'intention de recherche des utilisateurs et les tendances émergentes.
+- Suggérer un contenu amélioré pour un meilleur classement, et suivre la performance à long terme.
+
+### 5. Compatibilité avec Plus de Frameworks
+
+- Des efforts sont en cours pour supporter **Solid, Svelte, Angular**, et d'autres.
+- L'objectif est de rendre Intlayer compatible avec **toute application propulsée par JavaScript**.
+
+---
+
+## Conclusion
+
+Intlayer vise à être une solution tout-en-un pour la gestion de contenu et l'internationalisation. Il met l'accent sur la flexibilité (fichiers centralisés ou distribués), un large support linguistique, une intégration facile avec les frameworks et bundlers modernes, ainsi que des fonctionnalités puissantes pilotées par l'IA. À mesure que de nouvelles capacités, telles que les tests A/B, la gestion des versions et les traductions automatisées, seront disponibles, Intlayer continuera de simplifier les flux de travail de contenu et d'améliorer l'expérience utilisateur sur différentes plateformes.
+
+Restez à l'écoute des prochaines versions, et n'hésitez pas à explorer les fonctionnalités existantes pour voir comment Intlayer peut vous aider à centraliser et optimiser vos processus de gestion de contenu dès aujourd'hui !
+
+---
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-30 : Ajout du support Preact et Nuxt, serveur MCP, mise à jour du CLI
+- 5.5.10 - 2025-06-29 : Historique initial

package/docs/fr/vs_code_extension.md

@@ -0,0 +1,152 @@
+---
+createdAt: 2025-03-17
+updatedAt: 2025-06-29
+title: Extension officielle VS Code
+description: Apprenez à utiliser l'extension Intlayer dans VS Code pour améliorer votre flux de développement. Naviguez rapidement entre les contenus localisés et gérez efficacement vos dictionnaires.
+keywords:
+  - Extension VS Code
+  - Intlayer
+  - Localisation
+  - Outils de développement
+  - React
+  - Next.js
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - vs-code-extension
+---
+
+# Extension officielle VS Code
+
+## Vue d'ensemble
+
+[**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension) est l'extension officielle Visual Studio Code pour **Intlayer**, conçue pour améliorer l'expérience développeur lors du travail avec du contenu localisé dans vos projets.
+
+![Extension Intlayer VS Code](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 sans effort 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 parfaitement à 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ère les fichiers de contenu en fonction de la structure de votre projet.
+- **Pousser les Dictionnaires** (`extension.pushDictionaries`) – Télécharge le contenu le plus récent des dictionnaires vers votre dépôt.
+- **Tirer les Dictionnaires** (`extension.pullDictionaries`) – Synchronise 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. Allez dans le **Marketplace des Extensions**.
+3. Recherchez **"Intlayer"**.
+4. Cliquez sur **Installer**.
+
+Sinon, 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()`, par exemple :
+
+   ```tsx
+   const content = useIntlayer("app");
+   ```
+
+3. **Cliquez en maintenant la touche Commande** (`⌘+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
+
+#### Génération des dictionnaires
+
+Générez tous les fichiers de contenu des dictionnaires avec :
+
+```sh
+Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
+```
+
+Recherchez **Build Dictionaries** et exécutez la commande.
+
+#### Envoi des dictionnaires
+
+Téléversez le contenu le plus récent des dictionnaires :
+
+1. Ouvrez la **Palette de commandes**.
+2. Recherchez **Push Dictionaries**.
+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 **Pull Dictionaries**.
+3. Choisissez les dictionnaires à récupérer.
+
+## Développement & Contribution
+
+Vous souhaitez contribuer ? Nous accueillons avec plaisir les contributions de la communauté !
+
+URL du dépôt : https://github.com/aymericzip/intlayer-vs-code-extension
+
+### Pour commencer
+
+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 assurer la compatibilité avec le paquet `vsce` pour construire et publier l'extension.
+
+### Exécuter 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).
+
+## Retour d'expérience & Problèmes
+
+Vous avez trouvé un bug ou vous souhaitez proposer une fonctionnalité ? Ouvrez un ticket sur notre **dépôt GitHub** :
+
+[Problèmes GitHub](https://github.com/aymericzip/intlayer-vs-code-extension/issues)
+
+## Licence
+
+Intlayer est publié sous la **licence MIT**.
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

package/docs/hi/CI_CD.md

@@ -0,0 +1,173 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: CI/CD एकीकरण
+description: स्वचालित सामग्री प्रबंधन और परिनियोजन के लिए अपने CI/CD पाइपलाइन में Intlayer को एकीकृत करना सीखें।
+keywords:
+  - CI/CD
+  - सतत एकीकरण
+  - सतत परिनियोजन
+  - स्वचालन
+  - अंतरराष्ट्रीयकरण
+  - प्रलेखन
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - ci-cd
+---
+
+# 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: "This is a test application", // सुनिश्चित करता है कि अनुवाद सुसंगत रूप से उत्पन्न हो
+  },
+};
+
+export default config;
+```
+
+CMS के बारे में अधिक जानने के लिए, [आधिकारिक दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/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: "This is a test application", // सुनिश्चित करता है कि अनुवाद सुसंगत रूप से उत्पन्न हो
+  },
+};
+
+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/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: स्वचालित रूप से गायब अनुवाद भरें [skip ci]
+          branch: auto-translations
+          title: chore: गायब अनुवाद अपडेट करें
+          labels: translation, automated
+
+```
+
+> हस्की के लिए जैसा है, मोनोरिपो के मामले में, आप प्रत्येक ऐप को क्रमिक रूप से संसाधित करने के लिए `--base-dir` तर्क का उपयोग कर सकते हैं।
+
+> डिफ़ॉल्ट रूप से, `--git-diff` तर्क उन शब्दकोशों को फ़िल्टर करता है जिनमें बेस (डिफ़ॉल्ट `origin/main`) से वर्तमान शाखा (डिफ़ॉल्ट: `HEAD`) तक के परिवर्तन शामिल होते हैं।
+
+> Intlayer CLI कमांड और उनके उपयोग के बारे में अधिक जानकारी के लिए, [CLI दस्तावेज़](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_cli.md) देखें।
+
+## दस्तावेज़ इतिहास
+
+- 5.5.10 - 2025-06-29: इतिहास प्रारंभ किया गया