@intlayer/docs 5.5.10 → 5.5.12

package/docs/fr/introduction.md

@@ -0,0 +1,209 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-06-29
+title: Introduction
+description: Découvrez comment fonctionne Intlayer. Découvrez les étapes utilisées par Intlayer dans votre application. Découvrez ce que font les différents packages.
+keywords:
+  - Introduction
+  - Commencer
+  - Intlayer
+  - Application
+  - Packages
+slugs:
+  - doc
+  - get-started
+---
+
+# Documentation Intlayer
+
+Bienvenue dans la documentation officielle d'Intlayer ! Ici, vous trouverez tout ce dont vous avez besoin pour intégrer, configurer et maîtriser Intlayer pour tous vos besoins en internationalisation (i18n), que vous travailliez avec Next.js, React, Vite, Express ou un autre environnement JavaScript.
+
+## Introduction
+
+### Qu'est-ce qu'Intlayer ?
+
+**Intlayer** est une bibliothèque d'internationalisation conçue spécifiquement pour les développeurs JavaScript. Elle permet la déclaration de votre contenu partout dans votre code. Elle convertit la déclaration de contenu multilingue en dictionnaires structurés pour une intégration facile dans votre code. En utilisant TypeScript, **Intlayer** rend votre développement plus robuste et plus efficace.
+
+Intlayer propose également un éditeur visuel optionnel qui vous permet de modifier et de gérer facilement votre contenu. Cet éditeur est particulièrement utile pour les développeurs qui préfèrent une interface visuelle pour la gestion du contenu, ou pour les équipes générant du contenu sans avoir à se soucier du code.
+
+### Exemple d'utilisation
+
+```bash
+.
+└── Components
+    └── MyComponent
+        ├── index.content.cjs
+        └── index.mjs
+```
+
+```tsx fileName="src/components/MyComponent/index.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+// Déclaration du contenu du composant avec des traductions multilingues
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+};
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.cjs" contentDeclarationFormat="commonjs"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+// Déclaration du contenu du composant avec des traductions multilingues
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+};
+
+module.exports = componentContent;
+```
+
+```json fileName="src/components/MyComponent/index.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "component-key",
+  "content": {
+    "myTranslatedContent": {
+      "nodeType": "translation",
+      "translation": {
+        "en": "Hello World",
+        "fr": "Bonjour le monde",
+        "es": "Hola Mundo"
+      }
+    }
+  }
+}
+```
+
+```tsx fileName="src/components/MyComponent/index.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+export const MyComponent: FC = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.csx" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+## Fonctionnalités principales
+
+Intlayer offre une variété de fonctionnalités adaptées aux besoins du développement web moderne. Voici les principales fonctionnalités, avec des liens vers la documentation détaillée pour chacune :
+
+- **Support de l'internationalisation** : Améliorez la portée mondiale de votre application grâce au support intégré de l'internationalisation.
+- **Éditeur visuel** : Améliorez votre flux de développement avec des plugins d'éditeur conçus pour Intlayer. Consultez le [Guide de l'éditeur visuel](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_visual_editor.md).
+- **Flexibilité de configuration** : Personnalisez votre configuration avec de nombreuses options détaillées dans le [Guide de configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md).
+- **Outils CLI avancés** : Gérez vos projets efficacement grâce à l'interface en ligne de commande d'Intlayer. Découvrez les fonctionnalités dans la [Documentation des outils CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_cli.md).
+
+## Concepts clés
+
+### Dictionnaire
+
+Organisez votre contenu multilingue à proximité de votre code pour garder tout cohérent et facile à maintenir.
+
+- **[Commencer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/get_started.md)**  
+  Apprenez les bases de la déclaration de votre contenu dans Intlayer.
+
+- **[Traduction](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/translation.md)**  
+  Comprenez comment les traductions sont générées, stockées et utilisées dans votre application.
+
+- **[É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)**  
+  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)**  
+  Découvrez comment insérer des valeurs dans une chaîne en utilisant des espaces réservés d'insertion.
+
+- **[Récupération par fonction](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/function_fetching.md)**  
+  Découvrez comment récupérer dynamiquement du contenu avec une logique personnalisée pour correspondre au flux de travail de votre projet.
+
+- **[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)**  
+  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)**  
+  Comprenez comment imbriquer du contenu dans Intlayer pour créer des structures complexes.
+
+### Environnements & Intégrations
+
+Nous avons conçu Intlayer avec la flexibilité à l'esprit, offrant une intégration transparente avec les frameworks et outils de build populaires :
+
+- **[Intlayer avec Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_nextjs_15.md)**
+- **[Intlayer avec Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_nextjs_14.md)**
+- **[Intlayer avec Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_nextjs_page_router.md)**
+- **[Intlayer avec React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_create_react_app.md)**
+- **[Intlayer avec Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_vite+react.md)**
+- **[Intlayer avec React Native et Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_react_native+expo.md)**
+- **[Intlayer avec Lynx et React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_lynx+react.md)**
+- **[Intlayer avec Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_with_express.md)**
+
+Chaque guide d’intégration inclut les meilleures pratiques pour utiliser les fonctionnalités d’Intlayer, telles que le **rendu côté serveur**, le **routage dynamique** ou le **rendu côté client**, afin que vous puissiez maintenir une application rapide, optimisée pour le SEO et hautement évolutive.
+
+## Contribution & Retour d’expérience
+
+Nous valorisons la puissance de l'open-source et du développement communautaire. Si vous souhaitez proposer des améliorations, ajouter un nouveau guide ou corriger des problèmes dans notre documentation, n'hésitez pas à soumettre une Pull Request ou à ouvrir une issue sur notre [répertoire GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+
+**Prêt à traduire votre application plus rapidement et plus efficacement ?** Plongez dans notre documentation pour commencer à utiliser Intlayer dès aujourd'hui. Découvrez une approche robuste et simplifiée de l'internationalisation qui garde votre contenu organisé et votre équipe plus productive.
+
+---
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

package/docs/fr/mcp_server.md

@@ -0,0 +1,174 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2025-06-07
+title: Documentation du serveur MCP
+description: Découvrez les fonctionnalités et la configuration du serveur MCP pour optimiser la gestion et les opérations de votre serveur.
+keywords:
+  - Serveur MCP
+  - Gestion de serveur
+  - Optimisation
+  - Intlayer
+  - Documentation
+  - Configuration
+  - Fonctionnalités
+slugs:
+  - doc
+  - mcp-server
+---
+
+# Serveur MCP Intlayer
+
+Le **serveur Intlayer MCP (Model Context Protocol)** offre une assistance IDE alimentée par l'IA, spécialement conçue pour l'écosystème Intlayer. Conçu pour des environnements de développement modernes tels que **Cursor**, **GitHub Copilot workspace**, et tout IDE supportant le protocole MCP, ce serveur vous fournit un support contextuel en temps réel basé sur la configuration de votre projet.
+
+## Pourquoi utiliser le serveur Intlayer MCP ?
+
+En activant le serveur Intlayer MCP dans votre IDE, vous débloquez :
+
+- **Intégration intelligente de la CLI**
+  Accédez et exécutez les commandes CLI d'Intlayer directement depuis l'interface de votre IDE. Consultez la liste complète des commandes et options dans la [documentation CLI d'Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_cli.md).
+
+- **Documentation contextuelle**
+  Le serveur MCP charge et expose la documentation correspondant à la version d'Intlayer que vous utilisez dans votre projet. Cela garantit que les suggestions de code, les options de commande et les explications sont toujours à jour et pertinentes.
+
+- **Développement assisté par IA**
+  Grâce à des suggestions et une complétion automatique conscientes du projet, l'assistant IA peut expliquer votre code, recommander l'utilisation de la CLI ou suggérer comment utiliser des fonctionnalités spécifiques d'Intlayer en fonction de vos fichiers actuels.
+
+- **Installation légère et instantanée**
+  Aucune maintenance de serveur ni installation lourde requise. Il suffit de configurer votre fichier `.cursor/mcp.json` ou une configuration MCP équivalente, et vous êtes prêt à partir.
+
+---
+
+## Configuration de Cursor
+
+Dans la racine de votre projet, ajoutez le fichier de configuration `.cursor/mcp.json` suivant :
+
+```json
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+Cela indique à votre IDE de lancer le serveur MCP d'Intlayer en utilisant `npx`, garantissant qu'il utilise toujours la dernière version disponible sauf si vous la bloquez.
+
+---
+
+## Configuration de VS Code
+
+Pour utiliser le serveur MCP d'Intlayer avec VS Code, vous devez le configurer dans les paramètres de votre espace de travail ou utilisateur.
+
+### Configuration de l'espace de travail
+
+Créez un fichier `.vscode/mcp.json` à la racine de votre projet :
+
+```json
+{
+  "servers": {
+    "intlayer": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+### Utilisation du serveur MCP dans VS Code
+
+1. **Activer le mode Agent** : Ouvrez la vue Chat (⌃⌘I sur Mac, Ctrl+Alt+I sur Windows/Linux) et sélectionnez le mode **Agent** dans le menu déroulant.
+
+2. **Accéder aux outils** : Cliquez sur le bouton **Outils** pour voir les outils Intlayer disponibles. Vous pouvez sélectionner/désélectionner des outils spécifiques selon vos besoins.
+
+3. **Référence directe aux outils** : Référencez les outils directement dans vos invites en tapant `#` suivi du nom de l'outil.
+
+4. **Confirmation des outils** : Par défaut, VS Code demandera une confirmation avant d'exécuter les outils. Utilisez les options du bouton **Continuer** pour confirmer automatiquement les outils pour la session en cours, l'espace de travail ou toutes les exécutions futures.
+
+### Gestion du serveur
+
+- Exécutez **MCP : Lister les serveurs** depuis la palette de commandes pour voir les serveurs configurés
+- Démarrez, arrêtez ou redémarrez le serveur MCP d'Intlayer selon vos besoins
+- Consultez les journaux du serveur pour le dépannage en sélectionnant le serveur et en choisissant **Afficher la sortie**
+
+Pour plus d'informations détaillées sur l'intégration MCP dans VS Code, consultez la [documentation officielle MCP de VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
+
+---
+
+## Utilisation du serveur MCP via la CLI
+
+Vous pouvez également exécuter le serveur MCP Intlayer directement depuis la ligne de commande pour des tests, du débogage ou une intégration avec d'autres outils.
+
+### Installer le serveur MCP
+
+Tout d'abord, installez le paquet du serveur MCP globalement ou utilisez-le via npx :
+
+```bash
+# Installer globalement
+npm install -g @intlayer/mcp
+
+# Ou utiliser directement avec npx (recommandé)
+npx @intlayer/mcp
+```
+
+### Démarrer le serveur
+
+Pour démarrer le serveur MCP avec l'inspecteur pour le débogage et les tests :
+
+```bash
+# Utiliser la commande start intégrée
+npm run start
+
+# Ou directement avec npx
+npx @modelcontextprotocol/inspector npx @intlayer/mcp
+```
+
+Cela lancera le serveur MCP avec une interface d'inspecteur qui vous permet de :
+
+- Tester les communications du protocole MCP
+- Déboguer les réponses du serveur
+- Valider les implémentations des outils et ressources
+- Surveiller les performances du serveur
+
+### Utilisation en développement
+
+Pour les besoins de développement et de test, vous pouvez exécuter le serveur en différents modes :
+
+```bash
+# Compiler et démarrer en mode développement
+npm run dev
+
+# Exécuter avec une configuration personnalisée
+node dist/cjs/index.cjs
+
+# Tester les fonctionnalités du serveur
+npm test
+```
+
+Le serveur exposera des outils et ressources spécifiques à Intlayer qui peuvent être utilisés par tout client compatible MCP, pas seulement Cursor ou d'autres IDE.
+
+---
+
+## Aperçu des fonctionnalités
+
+| Fonctionnalité           | Description                                                                                               |
+| ------------------------ | --------------------------------------------------------------------------------------------------------- |
+| Support CLI              | Exécutez les commandes `intlayer`, obtenez des indices d'utilisation et des arguments en ligne            |
+| Documentation Versionnée | Détection automatique et chargement de la documentation correspondant à votre version actuelle d'Intlayer |
+| Autocomplétion           | Suggestions intelligentes de commandes et de configurations au fur et à mesure de la saisie               |
+| Prêt pour les Plugins    | Compatible avec les IDE et outils qui supportent la norme MCP                                             |
+
+---
+
+## Liens Utiles
+
+- [Documentation CLI Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_cli.md)
+- [Dépôt GitHub Intlayer](https://github.com/aymericzip/intlayer)
+
+---
+
+## Historique de la Documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

package/docs/fr/packages/@intlayer/api/index.md

@@ -0,0 +1,56 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/api - SDK pour l'intégration de l'API Intlayer
+description: Package NPM fournissant un kit de développement logiciel (SDK) pour interagir avec l'API Intlayer pour l'audit de contenu, les organisations, les projets et la gestion des utilisateurs.
+keywords:
+  - intlayer
+  - API
+  - SDK
+  - intégration
+  - audit de contenu
+  - organisations
+  - projets
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - api
+---
+
+# @intlayer/api : Package NPM pour interagir avec l'API Intlayer
+
+**Intlayer** est une suite de packages conçue spécifiquement pour les développeurs JavaScript. Il est compatible avec des frameworks comme React, React, et Express.js.
+
+**Le package `@intlayer/api` est un SDK (kit de développement logiciel) pour interagir avec l'API Intlayer. Il fournit un ensemble de fonctions pour auditer la déclaration de contenu, interagir avec les organisations, les projets, les utilisateurs, etc.**
+
+## Utilisation
+
+```ts
+import { intlayerAPI } from "@intlayer/api";
+
+intlayerAPI.user.getUser({
+  ids: ["user-id-1", "user-id-2"],
+});
+```
+
+## Installation
+
+Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :
+
+```bash packageManager="npm"
+npm install @intlayer/api
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/api
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/api
+```
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

package/docs/fr/packages/@intlayer/chokidar/index.md

@@ -0,0 +1,56 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/chokidar - Surveillance de fichiers pour l'i18n Intlayer
+description: Package NPM fournissant des capacités de surveillance de fichiers pour Intlayer, permettant des mises à jour automatiques et un rechargement à chaud du contenu d'internationalisation.
+keywords:
+  - intlayer
+  - chokidar
+  - surveillance de fichiers
+  - rechargement à chaud
+  - i18n
+  - JavaScript
+  - NPM
+  - développement
+slugs:
+  - doc
+  - package
+  - @intlayer_chokidar
+---
+
+# @intlayer/chokidar : Package NPM pour scanner et construire les fichiers de déclaration Intlayer en dictionnaires
+
+**Intlayer** est une suite de packages conçue spécifiquement pour les développeurs JavaScript. Elle est compatible avec des frameworks comme React, React Native, et Express.js.
+
+Le package **`@intlayer/chokidar`** est utilisé pour scanner et construire les fichiers de déclaration Intlayer en dictionnaires en utilisant [chokidar](https://github.com/paulmillr/chokidar) et selon la [configuration Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md).
+
+## Utilisation
+
+```ts
+import { watch, prepareIntlayer } from "@intlayer/chokidar";
+
+await prepareIntlayer(); // Construire les dictionnaires Intlayer
+
+watch({ persistent: true }); // Surveiller les changements dans les fichiers de configuration
+```
+
+## Installation
+
+Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :
+
+```bash packageManager="npm"
+bash packageManager="npm"
+npm install @intlayer/chokidar
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/chokidar
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/chokidar
+```
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

package/docs/fr/packages/@intlayer/cli/index.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/cli - Package d'Interface en Ligne de Commande pour Intlayer
+description: Package NPM fournissant des scripts pour les commandes CLI d'Intlayer, assurant l'uniformité de toutes les interfaces en ligne de commande pour la gestion de l'internationalisation.
+keywords:
+  - intlayer
+  - CLI
+  - ligne de commande
+  - scripts
+  - i18n
+  - JavaScript
+  - NPM
+  - outils
+slugs:
+  - doc
+  - package
+  - @intlayer_cli
+---
+
+# @intlayer/cli : Package NPM pour utiliser les scripts fournis par la CLI d'intlayer
+
+**Intlayer** est une suite de packages conçue spécifiquement pour les développeurs JavaScript. Elle est compatible avec des frameworks comme React, React, et Express.js.
+
+Le package **`@intlayer/cli`** est un package NPM utilisé pour déclarer les scripts liés aux interfaces en ligne de commande d'intlayer. Il assure l'uniformité de toutes les commandes CLI d'intlayer. Ce package est notamment utilisé par les packages [intlayer-cli](https://github.com/aymericzip/intlayer/tree/main/docs/fr/packages/intlayer-cli/index.md) et [intlayer](https://github.com/aymericzip/intlayer/tree/main/docs/fr/packages/intlayer/index.md).
+
+## Installation
+
+Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :
+
+```bash packageManager="npm"
+npm install @intlayer/cli
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli
+```
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

package/docs/fr/packages/@intlayer/config/index.md

@@ -0,0 +1,140 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/config - Gestion de la configuration pour Intlayer
+description: Package NPM pour récupérer la configuration d'Intlayer et définir les variables d'environnement pour les paramètres d'internationalisation à travers différents environnements.
+keywords:
+  - intlayer
+  - configuration
+  - environnement
+  - paramètres
+  - i18n
+  - JavaScript
+  - NPM
+  - variables
+slugs:
+  - doc
+  - package
+  - @intlayer_config
+---
+
+# @intlayer/config : Package NPM pour récupérer la configuration d'Intlayer
+
+**Intlayer** est une suite de packages conçue spécifiquement pour les développeurs JavaScript. Elle est compatible avec des frameworks comme React, React Native, et Express.js.
+
+Le package **`@intlayer/config`** est un package NPM qui vous permet de récupérer la configuration d'Intlayer et de définir les variables d'environnement liées à l'environnement actuel.
+
+## Installation
+
+Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :
+
+```bash packageManager="npm"
+npm install @intlayer/config
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/config
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/config
+```
+
+## Utilisation
+
+### Lire la configuration d'Intlayer en utilisant le système de fichiers
+
+Exemple :
+
+```ts
+import { getConfiguration, type IntlayerConfig } from "@intlayer/config";
+
+const config: IntlayerConfig = getConfiguration();
+
+console.log(config);
+// Sortie :
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+> Cette fonction utilise les packages `fs` et ne fonctionnera que côté serveur.
+
+### Lire la configuration d'Intlayer en utilisant les variables d'environnement
+
+Exemple :
+
+```ts
+import { getConfiguration, type IntlayerConfig } from "@intlayer/config/client";
+
+const config: IntlayerConfig = getConfiguration({
+  env: "production",
+});
+
+console.log(config);
+// Sortie :
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+> Cette fonction ne retournera rien si les variables d'environnement ne sont pas définies.
+
+### Définir les variables d'environnement
+
+1. Créez un fichier de configuration.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    /* ... */
+  },
+  middleware: {
+    /* ... */
+  },
+  content: {
+    /* ... */
+  },
+  editor: {
+    /* ... */
+  },
+};
+
+export default config;
+```
+
+> Voir la [documentation de configuration d'Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md) pour plus de détails.
+
+2. Définissez les variables d'environnement.
+
+```ts
+import { getConfiguration } from "@intlayer/config";
+
+const intlayerConfig = getConfiguration();
+
+// Formate toutes les valeurs de configuration en variables d'environnement
+const env = formatEnvVariable();
+
+// Définit chaque variable d'environnement formatée dans process.env
+Object.assign(process.env, env);
+```
+
+3. Importez le fichier de configuration.
+
+```ts
+import { getConfiguration } from "@intlayer/config/client";
+
+const intlayerConfig = getConfiguration();
+```
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial