@intlayer/docs 5.5.8

package/fr/intlayer_cli.md

@@ -0,0 +1,274 @@
+# Intlayer CLI
+
+## Installer le package
+
+Installez les packages nécessaires en utilisant npm :
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+> Si le package `intlayer` est déjà installé, le CLI est automatiquement installé. Vous pouvez passer cette étape.
+
+## Package intlayer-cli
+
+Le package `intlayer-cli` a pour but de transcrire vos [déclarations intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/fr/dictionary/get_started.md) en dictionnaires.
+
+Ce package transcrira tous les fichiers intlayer, tels que `src/**/*.content.{ts|js|mjs|cjs|json}`. [Voir comment déclarer vos fichiers de déclaration Intlayer](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+
+Pour interpréter les dictionnaires intlayer, vous pouvez utiliser des interpréteurs, tels que [react-intlayer](https://www.npmjs.com/package/react-intlayer), ou [next-intlayer](https://www.npmjs.com/package/next-intlayer).
+
+## Support des fichiers de configuration
+
+Intlayer accepte plusieurs formats de fichiers de configuration :
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Pour voir comment configurer les locales disponibles ou d'autres paramètres, référez-vous à la [documentation de configuration ici](https://github.com/aymericzip/intlayer/blob/main/docs/fr/configuration.md).
+
+## Exécuter les commandes intlayer
+
+### Construire les dictionnaires
+
+Pour construire vos dictionnaires, vous pouvez exécuter les commandes :
+
+```bash
+npx intlayer dictionaries build
+```
+
+ou en mode watch
+
+```bash
+npx intlayer dictionaries build --watch
+```
+
+Cette commande trouvera vos fichiers de contenu de déclaration par défaut comme `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}`. Et construira les dictionnaires dans le répertoire `.intlayer`.
+
+### Pousser les dictionnaires
+
+```bash
+npx intlayer dictionary push
+```
+
+Si [l'éditeur intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/fr/intlayer_visual_editor.md) est installé, vous pouvez également pousser les dictionnaires vers l'éditeur. Cette commande permettra de rendre les dictionnaires disponibles dans [l'éditeur](https://intlayer.org/dashboard). De cette manière, vous pouvez partager vos dictionnaires avec votre équipe et éditer votre contenu sans modifier le code de votre application.
+
+##### Arguments :
+
+- `-d`, `--dictionaries` : ids des dictionnaires à pousser. Si non spécifié, tous les dictionnaires seront poussés.
+  > Exemple : `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
+- `-r`, `--deleteLocaleDictionary` : Passez la question demandant de supprimer les répertoires des locales une fois les dictionnaires poussés, et supprimez-les. Par défaut, si le dictionnaire est défini localement, il écrasera le contenu des dictionnaires distants.
+  > Exemple : `npx intlayer dictionary push -r`
+- `-k`, `--keepLocaleDictionary` : Passez la question demandant de supprimer les répertoires des locales une fois les dictionnaires poussés, et conservez-les. Par défaut, si le dictionnaire est défini localement, il écrasera le contenu des dictionnaires distants.
+  > Exemple : `npx intlayer dictionary push -k`
+- `--env` : Spécifiez l'environnement (par exemple, `development`, `production`).
+- `--env-file` : Fournir un fichier d'environnement personnalisé pour charger les variables.
+- `--base-dir` : Spécifiez le répertoire de base du projet.
+- `--verbose` : Activer la journalisation détaillée pour le débogage.
+- `--git-diff` : Exécuter uniquement sur les dictionnaires avec des modifications non poussées.
+- `--git-diff-base` : Spécifiez la référence de base pour git diff.
+- `--git-diff-current` : Spécifiez la référence actuelle pour git diff.
+- `--uncommitted` : Inclure les modifications non validées.
+- `--unpushed` : Inclure les modifications non poussées.
+- `--untracked` : Inclure les fichiers non suivis.
+
+### Récupérer les dictionnaires distants
+
+```bash
+npx intlayer dictionary pull
+```
+
+Si [l'éditeur intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/fr/intlayer_visual_editor.md) est installé, vous pouvez également récupérer les dictionnaires depuis l'éditeur. De cette manière, vous pouvez écraser le contenu de vos dictionnaires pour les besoins de votre application.
+
+##### Arguments :
+
+- `-d, --dictionaries` : Ids des dictionnaires à récupérer. Si non spécifié, tous les dictionnaires seront récupérés.
+  > Exemple : `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
+- `--newDictionariesPath` : Chemin vers le répertoire où les nouveaux dictionnaires seront enregistrés. Si non spécifié, les nouveaux dictionnaires seront enregistrés dans le répertoire `./intlayer-dictionaries` du projet. Si un champ `filePath` est spécifié dans le contenu de votre dictionnaire, les dictionnaires ne tiendront pas compte de cet argument et seront enregistrés dans le répertoire spécifié par `filePath`.
+- `--env` : Spécifiez l'environnement (par exemple, `development`, `production`).
+- `--env-file` : Fournir un fichier d'environnement personnalisé pour charger les variables.
+- `--base-dir` : Spécifiez le répertoire de base du projet.
+- `--verbose` : Activer la journalisation détaillée pour le débogage.
+
+##### Exemple :
+
+```bash
+npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
+```
+
+### Auditer les dictionnaires
+
+```bash
+npx intlayer audit
+```
+
+Cette commande analyse vos fichiers de déclaration de contenu pour détecter des problèmes potentiels tels que des traductions manquantes, des incohérences structurelles ou des incompatibilités de type. Si des problèmes sont détectés, **intlayer audit** proposera ou appliquera des mises à jour pour maintenir vos dictionnaires cohérents et complets.
+
+##### Arguments :
+
+- **`-f, --files [files...]`**  
+  Une liste de fichiers de déclaration de contenu spécifiques à auditer. Si non fourni, tous les fichiers `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` découverts seront audités.
+
+- **`--exclude [excludedGlobs...]`**  
+  Modèles globaux à exclure de l'audit (par exemple, `--exclude "src/test/**"`).
+
+- **`--source-locale [sourceLocale]`**  
+  La locale source à partir de laquelle traduire. Si non spécifiée, la locale par défaut de votre configuration sera utilisée.
+
+- **`--output-locales [outputLocales...]`**  
+  Locales cibles vers lesquelles traduire. Si non spécifiées, toutes les locales de votre configuration seront utilisées sauf la locale source.
+
+- **`--mode [mode]`**  
+  Mode de traduction : 'complete', 'review', ou 'missing-only'. Par défaut, 'missing-only'.
+
+- **`--git-diff`**  
+  Exécuter uniquement sur les dictionnaires avec des modifications non poussées dans le dépôt git.
+
+- **`--git-diff-base`**  
+  Spécifiez la référence de base pour git diff.
+
+- **`--git-diff-current`**  
+  Spécifiez la référence actuelle pour git diff.
+
+- **`--uncommitted`**  
+  Inclure les modifications non validées.
+
+- **`--unpushed`**  
+  Inclure les modifications non poussées.
+
+- **`--untracked`**  
+  Inclure les fichiers non suivis.
+
+- **`--keys [keys...]`**  
+  Filtrer les dictionnaires en fonction des clés spécifiées.
+
+- **`--excluded-keys [excludedKeys...]`**  
+  Exclure les dictionnaires en fonction des clés spécifiées.
+
+- **`--path-filter [pathFilters...]`**  
+  Filtrer les dictionnaires en fonction du modèle glob pour les chemins de fichiers.
+
+- **`--model [model]`**  
+  Le modèle d'IA à utiliser pour la traduction (par exemple, `gpt-3.5-turbo`).
+
+- **`--provider [provider]`**  
+  Le fournisseur d'IA à utiliser pour la traduction.
+
+- **`--temperature [temperature]`**  
+  Paramètre de température pour le modèle d'IA.
+
+- **`--api-key [apiKey]`**  
+  Fournir votre propre clé API pour le service d'IA.
+
+- **`--custom-prompt [prompt]`**  
+  Fournir une invite personnalisée pour vos instructions de traduction.
+
+- **`--application-context [applicationContext]`**  
+  Fournir un contexte supplémentaire pour la traduction IA.
+
+- **`--env`**  
+  Spécifiez l'environnement (par exemple, `development`, `production`).
+
+- **`--env-file [envFile]`**  
+  Fournir un fichier d'environnement personnalisé pour charger les variables.
+
+- **`--base-dir`**  
+  Spécifiez le répertoire de base du projet.
+
+- **`--verbose`**  
+  Activer la journalisation détaillée pour le débogage.
+
+##### Exemple :
+
+```bash
+npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
+```
+
+Cette commande traduira le contenu de l'anglais vers le français et l'espagnol pour tous les fichiers de déclaration de contenu dans le répertoire `src/home/` en utilisant le modèle GPT-3.5 Turbo.
+
+### Gérer la configuration
+
+#### Obtenir la configuration
+
+La commande `get configuration` récupère la configuration actuelle pour Intlayer, en particulier les paramètres de locale. Cela est utile pour vérifier votre configuration.
+
+```bash
+npx intlayer config get
+```
+
+##### Arguments :
+
+- **`--env`** : Spécifiez l'environnement (par exemple, `development`, `production`).
+- **`--env-file`** : Fournir un fichier d'environnement personnalisé pour charger les variables.
+- **`--base-dir`** : Spécifiez le répertoire de base du projet.
+- **`--verbose`** : Activer la journalisation détaillée pour le débogage.
+
+#### Pousser la configuration
+
+La commande `push configuration` télécharge votre configuration vers le CMS et l'éditeur Intlayer. Cette étape est nécessaire pour activer l'utilisation des dictionnaires distants dans l'éditeur visuel Intlayer.
+
+```bash
+npx intlayer config push
+```
+
+##### Arguments :
+
+- **`--env`** : Spécifiez l'environnement (par exemple, `development`, `production`).
+- **`--env-file`** : Fournir un fichier d'environnement personnalisé pour charger les variables.
+- **`--base-dir`** : Spécifiez le répertoire de base du projet.
+- **`--verbose`** : Activer la journalisation détaillée pour le débogage.
+
+En poussant la configuration, votre projet est entièrement intégré au CMS Intlayer, permettant une gestion fluide des dictionnaires entre les équipes.
+
+## Utiliser les commandes intlayer dans votre `package.json`
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:build": "npx intlayer dictionaries build",
+  "intlayer:watch": "npx intlayer dictionaries build --watch",
+  "intlayer:push": "npx intlayer dictionary push",
+  "intlayer:pull": "npx intlayer dictionary pull",
+  "intlayer:audit": "npx intlayer audit"
+}
+```
+
+## Déboguer la commande intlayer
+
+### 1. **Assurez-vous d'utiliser la dernière version**
+
+Exécutez :
+
+```bash
+npx intlayer --version                  # version locale actuelle d'intlayer
+npx intlayer@latest --version          # dernière version d'intlayer
+```
+
+### 2. **Vérifiez si la commande est enregistrée**
+
+Vous pouvez vérifier avec :
+
+```bash
+npx intlayer --help      # Affiche une liste des commandes disponibles et les informations d'utilisation
+```
+
+### 3. **Redémarrez votre terminal**
+
+Parfois, un redémarrage du terminal est nécessaire pour reconnaître les nouvelles commandes.
+
+### 4. **Effacez le cache npx (si vous êtes bloqué avec une ancienne version)**
+
+```bash
+npx clear-npx-cache
+```

package/fr/intlayer_visual_editor.md

@@ -0,0 +1,210 @@
+# Documentation de l'Éditeur Visuel Intlayer
+
+<iframe title="Visual Editor + CMS for Your Web App: Intlayer Explained" 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/UDDTnirwi_4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+
+L'Éditeur Visuel Intlayer est un outil qui enveloppe votre site web pour interagir avec vos fichiers de déclaration de contenu à l'aide d'un éditeur visuel.
+
+![Interface de l'Éditeur Visuel Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif)
+
+Le package `intlayer-editor` est basé sur Intlayer et est disponible pour les applications JavaScript, telles que React (Create React App), Vite + React, et Next.js.
+
+## Éditeur visuel vs CMS
+
+L'Éditeur Visuel Intlayer est un outil qui vous permet de gérer votre contenu dans un éditeur visuel pour des dictionnaires locaux. Une fois une modification effectuée, le contenu sera remplacé dans la base de code. Cela signifie que l'application sera reconstruite et la page sera rechargée pour afficher le nouveau contenu.
+
+En revanche, le [CMS Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/fr/intlayer_CMS.md) est un outil qui vous permet de gérer votre contenu dans un éditeur visuel pour des dictionnaires distants. Une fois une modification effectuée, le contenu **n'affectera pas** votre base de code. Et le site web affichera automatiquement le contenu modifié.
+
+## Intégrer Intlayer dans votre application
+
+Pour plus de détails sur l'intégration d'Intlayer, consultez la section correspondante ci-dessous :
+
+### Intégration avec Next.js
+
+Pour l'intégration avec Next.js, consultez le [guide d'installation](https://github.com/aymericzip/intlayer/blob/main/docs/fr/intlayer_with_nextjs_15.md).
+
+### Intégration avec Create React App
+
+Pour l'intégration avec Create React App, consultez le [guide d'installation](https://github.com/aymericzip/intlayer/blob/main/docs/fr/intlayer_with_create_react_app.md).
+
+### Intégration avec Vite + React
+
+Pour l'intégration avec Vite + React, consultez le [guide d'installation](https://github.com/aymericzip/intlayer/blob/main/docs/fr/intlayer_with_vite+react.md).
+
+## Comment fonctionne l'Éditeur Intlayer
+
+L'éditeur visuel dans une application comprend deux éléments :
+
+- Une application frontend qui affichera votre site web dans une iframe. Si votre site web utilise Intlayer, l'éditeur visuel détectera automatiquement votre contenu et vous permettra d'interagir avec lui. Une fois une modification effectuée, vous pourrez télécharger vos changements.
+
+- Une fois que vous avez cliqué sur le bouton de téléchargement, l'éditeur visuel enverra une requête au serveur pour remplacer vos fichiers de déclaration de contenu par le nouveau contenu (où que ces fichiers soient déclarés dans votre projet).
+
+> Notez que pour l'instant, l'Éditeur Intlayer écrira vos fichiers de déclaration de contenu sous forme de fichiers JSON.
+
+## Installation
+
+Une fois Intlayer configuré dans votre projet, installez simplement `intlayer-editor` en tant que dépendance de développement :
+
+```bash packageManager="npm"
+npm install intlayer-editor --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-editor --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-editor --save-dev
+```
+
+## Configuration
+
+Dans votre fichier de configuration Intlayer, vous pouvez personnaliser les paramètres de l'éditeur :
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... autres paramètres de configuration
+  editor: {
+    /**
+     * Obligatoire
+     * L'URL de l'application.
+     * C'est l'URL ciblée par l'éditeur visuel.
+     * Exemple : 'http://localhost:3000'
+     */
+    applicationURL: process.env.INTLAYER_APPLICATION_URL,
+    /**
+     * Optionnel
+     * Par défaut à `true`. Si `false`, l'éditeur est inactif et ne peut pas être accessible.
+     * Peut être utilisé pour désactiver l'éditeur pour des environnements spécifiques pour des raisons de sécurité, comme la production.
+     */
+    enabled: process.env.INTLAYER_ENABLED,
+    /**
+     * Optionnel
+     * Par défaut à `8000`.
+     * Le port du serveur de l'éditeur.
+     */
+    port: process.env.INTLAYER_PORT,
+    /**
+     * Optionnel
+     * Par défaut à "http://localhost:8000"
+     * L'URL du serveur de l'éditeur.
+     */
+    editorURL: process.env.INTLAYER_EDITOR_URL,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... autres paramètres de configuration
+  editor: {
+    /**
+     * Obligatoire
+     * L'URL de l'application.
+     * C'est l'URL ciblée par l'éditeur visuel.
+     * Exemple : 'http://localhost:3000'
+     */
+    applicationURL: process.env.INTLAYER_APPLICATION_URL,
+    /**
+     * Optionnel
+     * Par défaut à `true`. Si `false`, l'éditeur est inactif et ne peut pas être accessible.
+     * Peut être utilisé pour désactiver l'éditeur pour des environnements spécifiques pour des raisons de sécurité, comme la production.
+     */
+    enabled: process.env.INTLAYER_ENABLED,
+    /**
+     * Optionnel
+     * Par défaut à `8000`.
+     * Le port utilisé par le serveur de l'éditeur visuel.
+     */
+    port: process.env.INTLAYER_PORT,
+    /**
+     * Optionnel
+     * Par défaut à "http://localhost:8000"
+     * L'URL du serveur de l'éditeur pour accéder depuis l'application. Utilisé pour restreindre les origines pouvant interagir avec l'application pour des raisons de sécurité. Si défini à `'*'`, l'éditeur est accessible depuis n'importe quelle origine. Devrait être défini si le port est modifié ou si l'éditeur est hébergé sur un domaine différent.
+     */
+    editorURL: process.env.INTLAYER_EDITOR_URL,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... autres paramètres de configuration
+  editor: {
+    /**
+     * Obligatoire
+     * L'URL de l'application.
+     * C'est l'URL ciblée par l'éditeur visuel.
+     */
+    applicationURL: process.env.INTLAYER_APPLICATION_URL,
+    /**
+     * Optionnel
+     * Par défaut à `8000`.
+     * Le port du serveur de l'éditeur.
+     */
+    port: process.env.INTLAYER_PORT,
+    /**
+     * Optionnel
+     * Par défaut à "http://localhost:8000"
+     * L'URL du serveur de l'éditeur.
+     */
+    editorURL: process.env.INTLAYER_EDITOR_URL,
+    /**
+     * Optionnel
+     * Par défaut à `true`. Si `false`, l'éditeur est inactif et ne peut pas être accessible.
+     * Peut être utilisé pour désactiver l'éditeur pour des environnements spécifiques pour des raisons de sécurité, comme la production.
+     */
+    enabled: process.env.INTLAYER_ENABLED,
+  },
+};
+
+module.exports = config;
+```
+
+> Pour voir tous les paramètres disponibles, consultez la [documentation de configuration](https://github.com/aymericzip/intlayer/blob/main/docs/fr/configuration.md).
+
+## Utilisation de l'Éditeur
+
+1. Une fois l'éditeur installé, vous pouvez démarrer l'éditeur en utilisant la commande suivante :
+
+   ```bash packageManager="npm"
+   npx intlayer-editor start
+   ```
+
+   ```bash packageManager="yarn"
+   yarn intlayer-editor start
+   ```
+
+   ```bash packageManager="pnpm"
+   pnpm intlayer-editor start
+   ```
+
+   > **Notez que vous devez exécuter votre application en parallèle.** L'URL de l'application doit correspondre à celle que vous avez définie dans la configuration de l'éditeur (`applicationURL`).
+
+2. Ensuite, ouvrez l'URL fournie. Par défaut `http://localhost:8000`.
+
+   Vous pouvez visualiser chaque champ indexé par Intlayer en survolant votre contenu avec votre curseur.
+
+   ![Survoler le contenu](https://github.com/aymericzip/intlayer/blob/main/docs/assets/intlayer_editor_hover_content.png)
+
+3. Si votre contenu est encadré, vous pouvez effectuer un appui long pour afficher le tiroir d'édition.
+
+## Débogage
+
+Si vous rencontrez des problèmes avec l'éditeur visuel, vérifiez les points suivants :
+
+- L'éditeur visuel et l'application sont en cours d'exécution.
+
+- La [configuration de l'éditeur](https://intlayer.org/doc/concept/configuration#editor-configuration) est correctement définie dans votre fichier de configuration Intlayer.
+
+  - Champs obligatoires :
+    - L'URL de l'application doit correspondre à celle que vous avez définie dans la configuration de l'éditeur (`applicationURL`).
+
+- L'éditeur visuel utilise une iframe pour afficher votre site web. Assurez-vous que la politique de sécurité du contenu (CSP) de votre site web autorise l'URL du CMS en tant que `frame-ancestors` ('http://localhost:8000' par défaut). Vérifiez la console de l'éditeur pour toute erreur.

package/fr/intlayer_with_angular.md

@@ -0,0 +1,3 @@
+this doc will be automatically generated translated from the english doc
+
+see /docs/en/intlayer_with_vite+preact.md