@intlayer/docs 5.5.10 → 5.5.11

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

@@ -0,0 +1,49 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/core - Fonctions principales pour l'i18n Intlayer
+description: Package NPM contenant les fonctions principales pour Intlayer, incluant les fonctions de traduction, les fonctions de dictionnaire, et les fonctions utilitaires pour l'internationalisation.
+keywords:
+  - intlayer
+  - core
+  - traduction
+  - dictionnaire
+  - utilitaires
+  - i18n
+  - JavaScript
+  - NPM
+slugs:
+  - doc
+  - package
+  - @intlayer_core
+---
+
+# @intlayer/core : Package NPM contenant les fonctions principales d'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/core` est un package NPM incluant les fonctions principales d'Intlayer partagées par plusieurs packages. Il comprend notamment :**
+
+- Fonctions de traduction
+- Fonctions de dictionnaire
+- Fonctions utilitaires
+
+## Installation
+
+Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :
+
+```bash packageManager="npm"
+npm install @intlayer/core
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/core
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/core
+```
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

package/docs/fr/packages/@intlayer/design-system/index.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/design-system - Composants UI pour Intlayer
+description: Package NPM contenant des composants du système de design et des éléments UI pour construire des interfaces utilisateur cohérentes avec l'internationalisation Intlayer.
+keywords:
+  - intlayer
+  - système de design
+  - composants UI
+  - interface
+  - i18n
+  - JavaScript
+  - NPM
+  - stylisation
+slugs:
+  - doc
+  - package
+  - @intlayer_design-system
+---
+
+# @intlayer/design-system : Package NPM contenant la bibliothèque UI 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/design-system`** est un package NPM incluant le système de design d'Intlayer. Ce package est notamment utilisé par l’[éditeur Intlayer](https://github.com/aymericzip/intlayer/tree/main/docs/fr/packages/intlayer-editor/index.md), sur le [site web](https://intlayer.org) et dans l’[éditeur visuel / CMS](https://intlayer.org/dashboard).
+
+## Installation
+
+Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :
+
+```bash packageManager="npm"
+npm install @intlayer/design-system
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/design-system
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/design-system
+```
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

package/docs/fr/packages/@intlayer/dictionary-entry/index.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/dictionary-entry - Gestion des dictionnaires pour Intlayer
+description: Package NPM pour gérer les entrées de dictionnaire dans Intlayer, fournissant des utilitaires pour créer, mettre à jour et organiser les dictionnaires de traduction.
+keywords:
+  - intlayer
+  - dictionnaire
+  - entrées
+  - gestion
+  - traduction
+  - i18n
+  - JavaScript
+  - NPM
+slugs:
+  - doc
+  - package
+  - @intlayer_dictionary-entry
+---
+
+# @intlayer/dictionary-entry : Package NPM pour récupérer les dictionnaires 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/dictionary-entry`** est un package NPM qui ne retourne que le chemin d'entrée des dictionnaires Intlayer. Comme la recherche dans le système de fichiers est impossible depuis le navigateur, l'utilisation de bundlers comme Webpack ou Rollup pour récupérer le chemin d'entrée des dictionnaires n'est pas possible. Ce package est destiné à être aliasé.
+
+## Installation
+
+Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :
+
+```bash packageManager="npm"
+npm install @intlayer/dictionary-entry
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/dictionary-entry
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/dictionary-entry
+```
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

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

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/editor - Package d'interface de l'éditeur Intlayer
+description: Package NPM fournissant des utilitaires pour interfacer les applications avec l'éditeur Intlayer et manipuler des dictionnaires dans tous les frameworks JavaScript.
+keywords:
+  - intlayer
+  - éditeur
+  - dictionnaire
+  - interface
+  - NPM
+  - JavaScript
+  - utilitaires
+  - multiplateforme
+slugs:
+  - doc
+  - package
+  - @intlayer_editor
+---
+
+# @intlayer/editor : Package NPM fournissant des utilitaires pour interfacer l'application avec l'éditeur Intlayer et manipuler des dictionnaires
+
+**Intlayer** est une suite de packages conçue spécifiquement pour les développeurs JavaScript. Elle est compatible avec des frameworks tels que React, Next.js et Express.js.
+
+Le package **`intlayer-editor`** fournit des utilitaires pour interfacer l'application avec l'éditeur Intlayer. Il inclut l'API pour interagir avec l'éditeur, ainsi que des utilitaires pour manipuler des dictionnaires. Ce package est multiplateforme.
+
+## Installation
+
+Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :
+
+```bash
+npm install @intlayer/editor
+```
+
+```bash
+yarn add @intlayer/editor
+```
+
+```bash
+pnpm add @intlayer/editor
+```
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

package/docs/fr/packages/@intlayer/editor-react/index.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/editor-react - Composants React pour l'éditeur Intlayer
+description: Package NPM fournissant des composants et hooks React pour intégrer l'éditeur visuel Intlayer dans des applications React pour l'internationalisation.
+keywords:
+  - intlayer
+  - éditeur
+  - React
+  - composants
+  - hooks
+  - i18n
+  - JavaScript
+  - NPM
+slugs:
+  - doc
+  - package
+  - @intlayer_editor-react
+---
+
+# @intlayer/editor-react : Package NPM fournissant des états, contextes, hooks et composants React pour interagir avec l'éditeur Intlayer
+
+**Intlayer** est une suite de packages conçue spécifiquement pour les développeurs JavaScript. Elle est compatible avec des frameworks tels que React, Next.js et Express.js.
+
+Le package **`@intlayer/editor-react`** fournit des états, contextes, hooks et composants pour interagir avec l'éditeur Intlayer dans une application React.
+
+## Installation
+
+Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :
+
+```bash
+npm install @intlayer/editor-react
+```
+
+```bash
+yarn add @intlayer/editor-react
+```
+
+```bash
+pnpm add @intlayer/editor-react
+```
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

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

@@ -0,0 +1,59 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/webpack - Plugin Webpack pour Intlayer i18n
+description: Package NPM fournissant une configuration Webpack et un plugin pour une intégration transparente de l'internationalisation Intlayer avec les applications basées sur Webpack.
+keywords:
+  - intlayer
+  - webpack
+  - plugin
+  - configuration
+  - i18n
+  - JavaScript
+  - NPM
+  - bundler
+slugs:
+  - doc
+  - package
+  - @intlayer_webpack
+---
+
+# @intlayer/webpack : Package NPM pour utiliser le plugin Webpack Intlayer dans votre application
+
+**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/webpack`** est utilisé pour fournir une configuration Webpack afin de faciliter le travail avec une application basée sur Webpack utilisant Intlayer. Le package fournit également un plugin à intégrer dans une application Webpack existante.
+
+## Utilisation
+
+```ts
+import { IntlayerPlugin } from "@intlayer/webpack";
+
+export default {
+  plugins: [
+    new IntlayerPlugin({
+      // Options
+    }),
+  ],
+};
+```
+
+## Installation
+
+Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :
+
+```bash packageManager="npm"
+npm install @intlayer/webpack
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/webpack
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/webpack
+```
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

package/docs/fr/packages/angular-intlayer/index.md

@@ -0,0 +1,53 @@
+---
+createdAt: 2025-04-18
+updatedAt: 2025-06-29
+title: Documentation du package | angular-intlayer
+description: Découvrez comment utiliser le package angular-intlayer
+keywords:
+  - Intlayer
+  - angular-intlayer
+  - Internationalisation
+  - Documentation
+  - JavaScript
+  - Angular
+slugs:
+  - doc
+  - packages
+  - angular-intlayer
+---
+
+# angular-intlayer : Package NPM pour internationaliser (i18n) une application Angular
+
+**Intlayer** est une suite de packages conçue spécifiquement pour les développeurs JavaScript. Il est compatible avec des frameworks comme Angular, Angular, et Express.js.
+
+**Le package `angular-intlayer`** vous permet d'internationaliser votre application Angular. Il fournit des fournisseurs de contexte et des hooks pour l'internationalisation dans Angular.
+
+## Pourquoi internationaliser votre application Angular ?
+
+Internationaliser votre application Angular est essentiel pour servir efficacement un public mondial. Cela permet à votre application de délivrer du contenu et des messages dans la langue préférée de chaque utilisateur. Cette capacité améliore l'expérience utilisateur et élargit la portée de votre application en la rendant plus accessible et pertinente pour des personnes issues de différents horizons linguistiques.
+
+## Pourquoi intégrer Intlayer ?
+
+- **Gestion de contenu propulsée par JavaScript** : Exploitez la flexibilité de JavaScript pour définir et gérer votre contenu de manière efficace.
+- **Environnement typé** : Profitez de TypeScript pour garantir que toutes vos définitions de contenu sont précises et sans erreur.
+- **Fichiers de contenu intégrés** : Gardez vos traductions proches de leurs composants respectifs, améliorant ainsi la maintenabilité et la clarté.
+
+## Installation
+
+Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :
+
+```bash packageManager="npm"
+npm install angular-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add angular-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add angular-intlayer
+```
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial

package/docs/fr/packages/express-intlayer/index.md

@@ -0,0 +1,284 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-06-29
+title: Documentation du package | express-intlayer
+description: Voir comment utiliser le package express-intlayer
+keywords:
+  - Intlayer
+  - express-intlayer
+  - Internationalisation
+  - Documentation
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - express-intlayer
+---
+
+# express-intlayer : Package JavaScript pour internationaliser (i18n) une application Express.js
+
+**Intlayer** est une suite de packages conçue spécifiquement pour les développeurs JavaScript. Il est compatible avec des frameworks comme React, Next.js et Express.js.
+
+**Le package `express-intlayer`** vous permet d’internationaliser votre application Express.js. Il fournit un middleware pour détecter la locale préférée de l’utilisateur, et retourne le dictionnaire approprié pour cet utilisateur.
+
+## Pourquoi internationaliser votre backend ?
+
+Internationaliser votre backend est essentiel pour servir efficacement une audience mondiale. Cela permet à votre application de délivrer du contenu et des messages dans la langue préférée de chaque utilisateur. Cette capacité améliore l’expérience utilisateur et élargit la portée de votre application en la rendant plus accessible et pertinente pour des personnes issues de différents horizons linguistiques.
+
+### Cas d’utilisation pratiques
+
+- **Afficher les erreurs du backend dans la langue de l’utilisateur** : Lorsqu’une erreur survient, afficher les messages dans la langue maternelle de l’utilisateur améliore la compréhension et réduit la frustration. Ceci est particulièrement utile pour les messages d’erreur dynamiques qui pourraient être affichés dans des composants frontaux tels que des toasts ou des modales.
+
+- **Récupérer du contenu multilingue** : Pour les applications qui extraient du contenu d’une base de données, l’internationalisation garantit que vous pouvez fournir ce contenu en plusieurs langues. Cela est crucial pour des plateformes comme les sites e-commerce ou les systèmes de gestion de contenu qui doivent afficher des descriptions de produits, des articles et d’autres contenus dans la langue préférée de l’utilisateur.
+
+- **Envoyer des e-mails multilingues** : Qu’il s’agisse d’e-mails transactionnels, de campagnes marketing ou de notifications, envoyer des e-mails dans la langue du destinataire peut considérablement augmenter l’engagement et l’efficacité.
+
+- **Notifications push multilingues** : Pour les applications mobiles, envoyer des notifications push dans la langue préférée de l’utilisateur peut améliorer l’interaction et la rétention. Cette touche personnelle rend les notifications plus pertinentes et exploitables.
+
+- **Autres communications** : Toute forme de communication provenant du backend, comme les messages SMS, les alertes système ou les mises à jour de l’interface utilisateur, bénéficie d’être dans la langue de l’utilisateur, garantissant ainsi la clarté et améliorant l’expérience utilisateur globale.
+
+En internationalisant le backend, votre application respecte non seulement les différences culturelles, mais s’aligne également mieux sur les besoins du marché mondial, ce qui en fait une étape clé pour étendre vos services à l’échelle mondiale.
+
+## Pourquoi intégrer Intlayer ?
+
+- **Environnement typé** : Profitez de TypeScript pour garantir que toutes vos définitions de contenu sont précises et sans erreur.
+
+## Installation
+
+Installez le package nécessaire en utilisant votre gestionnaire de paquets préféré :
+
+```bash
+npm install express-intlayer
+```
+
+```bash
+yarn add express-intlayer
+```
+
+```bash
+pnpm add express-intlayer
+```
+
+### Configurer Intlayer
+
+Intlayer fournit un fichier de configuration pour configurer votre projet. Placez ce fichier à la racine de votre projet.
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+module.exports = config;
+```
+
+> Pour une liste complète des paramètres disponibles, référez-vous à la [documentation de configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md).
+
+## Exemple d'utilisation
+
+Configurez votre application Express pour utiliser `express-intlayer` :
+
+```typescript fileName="src/index.ts" codeFormat="typescript"
+import express, { type Express } from "express";
+import { intlayer, t } from "express-intlayer";
+
+const app: Express = express();
+
+// Charge le gestionnaire de requêtes d'internationalisation
+app.use(intlayer());
+
+// Routes
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      "es-ES": "Ejemplo de contenido devuelto en español (España)",
+      "es-MX": "Ejemplo de contenido devuelto en español (México)",
+    })
+  );
+});
+
+// Démarrer le serveur
+app.listen(3000, () => console.log(`Écoute sur le port 3000`));
+```
+
+```javascript fileName="src/index.mjs" codeFormat="esm"
+import express from "express";
+import { intlayer, t } from "express-intlayer";
+
+const app = express();
+
+// Charger le gestionnaire de requêtes d'internationalisation
+app.use(intlayer());
+
+// Routes
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      "es-MX": "Ejemplo de contenido devuelto en español (México)",
+      "es-ES": "Ejemplo de contenido devuelto en español (España)",
+    })
+  );
+});
+
+// Démarrer le serveur
+app.listen(3000, () => console.log(`Écoute sur le port 3000`));
+```
+
+```javascript fileName="src/index.cjs" codeFormat="commonjs"
+const express = require("express");
+const { intlayer, t } = require("express-intlayer");
+
+const app = express();
+
+// Charger le gestionnaire de requêtes d'internationalisation
+app.use(intlayer());
+
+// Routes
+app.get("/", (_req, res) => {
+  res.send(
+    t({
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      "es-MX": "Ejemplo de contenido devuelto en español (México)",
+      "es-ES": "Ejemplo de contenido devuelto en español (España)",
+    })
+  );
+});
+
+// Démarrer le serveur
+app.listen(3000, () => console.log(`Écoute sur le port 3000`));
+```
+
+### Compatibilité
+
+`express-intlayer` est entièrement compatible avec :
+
+- [`react-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/react-intlayer/index.md) pour les applications React
+- [`next-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/next-intlayer/index.md) pour les applications Next.js
+- [`vite-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/vite-intlayer/index.md) pour les applications Vite
+
+Il fonctionne également parfaitement avec toute solution d'internationalisation dans divers environnements, y compris les navigateurs et les requêtes API. Vous pouvez personnaliser le middleware pour détecter la locale via les en-têtes ou les cookies :
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... Autres options de configuration
+  middleware: {
+    headerName: "my-locale-header",
+    cookieName: "my-locale-cookie",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Autres options de configuration
+  middleware: {
+    headerName: "my-locale-header",
+    cookieName: "my-locale-cookie",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... Autres options de configuration
+  middleware: {
+    headerName: "my-locale-header",
+    cookieName: "my-locale-cookie",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Autres options de configuration
+  middleware: {
+    headerName: "my-locale-header",
+    cookieName: "my-locale-cookie",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Autres options de configuration
+  middleware: {
+    headerName: "my-locale-header",
+    cookieName: "my-locale-cookie",
+  },
+};
+
+module.exports = config;
+```
+
+Par défaut, `express-intlayer` interprétera l'en-tête `Accept-Language` pour déterminer la langue préférée du client.
+
+## Fonctions fournies par le package `express-intlayer`
+
+- [`t()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/express-intlayer/t.md)
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial