@intlayer/docs 7.2.3 → 7.3.0-canary.0

package/docs/fr/cli/doc-translate.md

@@ -0,0 +1,132 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Traduire un document
+description: Apprenez à traduire automatiquement des fichiers de documentation en utilisant des services de traduction IA.
+keywords:
+  - Traduire
+  - Document
+  - Documentation
+  - IA
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - doc-translate
+---
+
+# Traduire un document
+
+La commande `doc translate` traduit automatiquement les fichiers de documentation d'une locale de base vers des locales cibles en utilisant des services de traduction IA.
+
+```bash
+npx intlayer doc translate
+```
+
+## Arguments :
+
+**Options de liste de fichiers :**
+
+- **`--doc-pattern [docPattern...]`** : Motifs glob pour sélectionner les fichiers de documentation à traduire.
+
+  > Exemple : `npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`** : Motifs glob à exclure de la traduction.
+
+  > Exemple : `npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`** : Ignorer le fichier s'il a été modifié avant l'heure donnée.
+  - Peut être une heure absolue comme "2025-12-05" (string ou Date)
+  - Peut être un temps relatif en ms `1 * 60 * 60 * 1000` (1 heure)
+  - Cette option vérifie la date de mise à jour du fichier en utilisant la méthode `fs.stat`. Elle peut donc être impactée par Git ou d'autres outils qui modifient le fichier.
+
+  > Exemple : `npx intlayer doc translate --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`** : Ignorer le fichier s'il a été modifié dans le délai donné.
+  - Peut être une heure absolue comme "2025-12-05" (string ou Date)
+  - Peut être un temps relatif en ms `1 * 60 * 60 * 1000` (1 heure)
+  - Cette option vérifie la date de mise à jour du fichier en utilisant la méthode `fs.stat`. Elle peut donc être impactée par Git ou d'autres outils qui modifient le fichier.
+
+  > Exemple : `npx intlayer doc translate --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`** : Ignorer le fichier s'il existe déjà.
+
+  > Exemple : `npx intlayer doc translate --skip-if-exists`
+
+**Options de sortie des entrées :**
+
+- **`--locales [locales...]`** : Locales cibles vers lesquelles traduire la documentation.
+
+  > Exemple : `npx intlayer doc translate --locales fr es de`
+
+- **`--base-locale [baseLocale]`** : Locale source depuis laquelle traduire.
+
+  > Exemple : `npx intlayer doc translate --base-locale en`
+
+**Options de traitement des fichiers :**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`** : Nombre de fichiers à traiter simultanément pour la traduction.
+
+  > Exemple : `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+**Options AI :**
+
+- **`--model [model]`** : Modèle d'IA à utiliser pour la traduction (par exemple, `gpt-3.5-turbo`).
+- **`--provider [provider]`** : 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.
+- **`--application-context [applicationContext]`** : Fournir un contexte supplémentaire pour la traduction par IA.
+- **`--custom-prompt [prompt]`** : Personnalisez le prompt de base utilisé pour la traduction. (Remarque : Pour la plupart des cas d'utilisation, l'option `--custom-instructions` est recommandée car elle offre un meilleur contrôle sur le comportement de la traduction.)
+
+  > Exemple : `npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Mon application est une boutique de chats"`
+
+**Options des variables d'environnement :**
+
+- **`--env`** : Spécifiez l'environnement (par exemple, `development`, `production`).
+- **`--env-file [envFile]`** : Fournissez un fichier d'environnement personnalisé pour charger les variables.
+- **`--base-dir`** : Spécifiez le répertoire de base du projet.
+- **`--no-cache`** : Désactive le cache.
+
+  > Exemple : `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
+
+**Options de journalisation :**
+
+- **`--verbose`** : Active la journalisation détaillée pour le débogage. (par défaut à true en utilisant la CLI)
+
+  > Exemple : `npx intlayer doc translate --verbose`
+
+**Options d'instructions personnalisées :**
+
+- **`--custom-instructions [customInstructions]`** : Instructions personnalisées ajoutées au prompt. Utile pour appliquer des règles spécifiques concernant le formatage, la traduction des URLs, etc.
+  - Peut être une date absolue comme "2025-12-05" (string ou Date)
+  - Peut être un temps relatif en ms `1 * 60 * 60 * 1000` (1 heure)
+  - Cette option vérifie la date de mise à jour du fichier en utilisant la méthode `fs.stat`. Elle peut donc être impactée par Git ou d'autres outils qui modifient le fichier.
+
+  > Exemple : `npx intlayer doc translate --custom-instructions "Évitez de traduire les URLs et conservez le format markdown"`
+
+  > Exemple : `npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"`
+
+**Options Git :**
+
+- **`--git-diff`** : Ne s'exécute que sur les dictionnaires qui incluent des modifications depuis la base (par défaut `origin/main`) vers la branche courante (par défaut : `HEAD`).
+- **`--git-diff-base`** : Spécifie la référence de base pour le git diff (par défaut `origin/main`).
+- **`--git-diff-current`** : Spécifie la référence courante pour le git diff (par défaut : `HEAD`).
+- **`--uncommitted`** : Inclut les modifications non commises.
+- **`--unpushed`** : Inclut les modifications non poussées.
+- **`--untracked`** : Inclut les fichiers non suivis.
+
+  > Exemple : `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Exemple : `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+> Notez que le chemin du fichier de sortie sera déterminé en remplaçant les motifs suivants
+>
+> - `/{{baseLocale}}/` par `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` par `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` par `_{{locale}}.`
+> - `{{baseLocale}}_` par `{{locale}}_`
+> - `.{{baseLocaleName}}.` par `.{{localeName}}.`
+>
+> Si le motif n'est pas trouvé, le fichier de sortie ajoutera `.{{locale}}` à l'extension du fichier. Par exemple, `./my/file.md` sera traduit en `./my/file.fr.md` pour la locale française.

package/docs/fr/cli/editor.md

@@ -0,0 +1,28 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Commandes de l'éditeur
+description: Apprenez à utiliser les commandes de l'éditeur Intlayer.
+keywords:
+  - Éditeur
+  - Éditeur Visuel
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - editor
+---
+
+# Commandes de l'éditeur
+
+La commande `editor` encapsule à nouveau les commandes `intlayer-editor`.
+
+> Pour pouvoir utiliser la commande `editor`, le package `intlayer-editor` doit être installé. (Voir [Éditeur Visuel Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_visual_editor.md))
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:editor:start": "npx intlayer editor start --with 'next dev --turbopack'"
+}
+```

package/docs/fr/cli/fill.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Remplir les dictionnaires
+description: Apprenez à remplir, auditer et traduire vos dictionnaires en utilisant l'IA.
+keywords:
+  - Remplir
+  - Auditer
+  - Traduire
+  - Dictionnaires
+  - CLI
+  - Intlayer
+  - IA
+slugs:
+  - doc
+  - concept
+  - cli
+  - fill
+---
+
+# Remplir / auditer / traduire les dictionnaires
+
+```bash
+npx intlayer fill
+```
+
+Cette commande analyse vos fichiers de déclaration de contenu pour détecter d’éventuels problèmes tels que des traductions manquantes, des incohérences structurelles ou des incompatibilités de types. Si elle trouve des problèmes, **intlayer fill** proposera ou appliquera des mises à jour pour garder vos dictionnaires cohérents et complets.
+
+## Alias :
+
+- `npx intlayer dictionaries fill`
+- `npx intlayer dictionary fill`
+- `npx intlayer dic fill`
+
+## Arguments :
+
+**Options de liste de fichiers :**
+
+- **`-f, --file [files...]`** : Une liste de fichiers spécifiques de déclaration de contenu à auditer. Si non fourni, tous les fichiers `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` découverts en fonction de la configuration seront audités.
+
+  > Exemple : `npx intlayer dictionary fill -f src/home/app.content.ts`
+
+- **`-k, --keys [keys...]`** : Filtrer les dictionnaires en fonction des clés. Si non fourni, tous les dictionnaires seront audités.
+
+  > Exemple : `npx intlayer dictionary fill -k key1 key2`
+
+- **`--key [keys...]`** : Filtrer les dictionnaires en fonction des clés (alias de --keys).
+
+  > Exemple : `npx intlayer dictionary fill --key key1 key2`
+
+- **`--excluded-keys [excludedKeys...]`** : Exclure des dictionnaires en fonction des clés. Si non fourni, tous les dictionnaires seront audités.
+
+  > Exemple : `npx intlayer dictionary fill --excluded-keys key1 key2`
+
+- **`--excluded-key [excludedKeys...]`** : Exclure des dictionnaires en fonction des clés (alias de --excluded-keys).
+
+  > Exemple : `npx intlayer dictionary fill --excluded-key key1 key2`
+
+- **`--path-filter [pathFilters...]`** : Filtrer les dictionnaires en fonction d’un motif glob pour les chemins de fichiers.
+
+  > Exemple : `npx intlayer dictionary fill --path-filter "src/home/**"`
+
+**Options de sortie des entrées :**
+
+- **`--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é, toutes les locales de votre configuration seront utilisées sauf la locale source.
+
+- **`--mode [mode]`** : Mode de traduction : `complete`, `review`. Par défaut, c’est `complete`. `complete` remplira tout le contenu manquant, `review` remplira le contenu manquant et révisera les clés existantes.
+
+**Options Git :**
+
+- **`--git-diff`** : Ne s’exécute que sur les dictionnaires qui incluent des modifications depuis la base (par défaut `origin/main`) vers la branche courante (par défaut : `HEAD`).
+- **`--git-diff-base`** : Spécifie la référence de base pour le git diff (par défaut `origin/main`).
+- **`--git-diff-current`** : Spécifie la référence courante pour le git diff (par défaut `HEAD`).
+- **`--uncommitted`** : Inclut les modifications non commises.
+- **`--unpushed`** : Inclut les modifications non poussées.
+- **`--untracked`** : Inclut les fichiers non suivis.
+
+  > Exemple : `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Exemple : `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+**Options IA :**
+
+- **`--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]`** : Réglage de la 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 par IA.
+
+  > Exemple : `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "Mon application est une boutique de chats"`
+
+  **Options des variables d’environnement :**
+
+- **`--env`** : Spécifier l’environnement (par exemple, `development`, `production`).
+- **`--env-file [envFile]`** : Fournir un fichier d’environnement personnalisé pour charger les variables.
+
+  > Exemple : `npx intlayer fill --env-file .env.production.local`
+
+  > Exemple : `npx intlayer fill --env production`
+
+**Options de configuration :**
+
+- **`--base-dir`** : Spécifier le répertoire de base pour le projet.
+
+  > Exemple : `npx intlayer fill --base-dir ./src`
+
+- **`--no-cache`** : Désactiver le cache.
+
+  > Exemple : `npx intlayer build --no-cache`
+
+**Options de préparation :**
+
+- **`--build`** : Construire les dictionnaires avant de pousser pour s’assurer que le contenu est à jour. True forcera la construction, false sautera la construction, undefined permettra d’utiliser le cache de la construction.
+
+- **`--skip-metadata`** : Ignorer le remplissage des métadonnées manquantes (description, titre, tags) pour les dictionnaires.
+
+**Options de journalisation :**
+
+- **`--verbose`** : Activer la journalisation détaillée pour le débogage. (par défaut à true en utilisant la CLI)
+
+## 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.

package/docs/fr/cli/index.md

@@ -0,0 +1,163 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: CLI
+description: Découvrez comment utiliser le CLI Intlayer pour gérer votre site web multilingue. Suivez les étapes de cette documentation en ligne pour configurer votre projet en quelques minutes.
+keywords:
+  - CLI
+  - Interface en ligne de commande
+  - Internationalisation
+  - Documentation
+  - Intlayer
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - concept
+  - cli
+history:
+  - version: 7.2.3
+    date: 2025-11-22
+    changes: Ajout de la commande transform
+  - version: 7.1.0
+    date: 2025-11-05
+    changes: Ajout de l'option skipIfExists à la commande translate
+  - version: 6.1.4
+    date: 2025-01-27
+    changes: Ajout d'alias pour les arguments et commandes CLI
+  - version: 6.1.3
+    date: 2025-10-05
+    changes: Ajout de l'option build aux commandes
+  - version: 6.1.2
+    date: 2025-09-26
+    changes: Ajout de la commande version
+  - version: 6.1.0
+    date: 2025-09-26
+    changes: Définir l'option verbose par défaut à true via le CLI
+  - version: 6.1.0
+    date: 2025-09-23
+    changes: Ajout de la commande watch et de l'option with
+  - version: 6.0.1
+    date: 2025-09-23
+    changes: Ajout de la commande editor
+  - version: 6.0.0
+    date: 2025-09-17
+    changes: Ajout des commandes content test et list
+  - version: 5.5.11
+    date: 2025-07-11
+    changes: Mise à jour de la documentation des paramètres des commandes CLI
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: Initialisation de l'historique
+---
+
+# CLI Intlayer
+
+---
+
+## Table des matières
+
+<TOC/>
+
+---
+
+## 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 transpiler vos [déclarations intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/content_file.md) en dictionnaires.
+
+Ce package va transpiler 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/docs/fr/configuration.md).
+
+## Exécuter les commandes intlayer
+
+### Commandes principales
+
+- **[Construire les dictionnaires](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/build.md)** - Construisez vos dictionnaires à partir des fichiers de déclaration de contenu
+- **[Surveiller les dictionnaires](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/watch.md)** - Surveillez les changements et construisez automatiquement les dictionnaires
+- **[Vérifier la version CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/version.md)** - Vérifiez la version installée de la CLI Intlayer
+
+### Gestion des dictionnaires
+
+- **[Pousser les dictionnaires](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/push.md)** - Poussez les dictionnaires vers l'éditeur Intlayer et le CMS
+- **[Récupérer les dictionnaires](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/pull.md)** - Récupérez les dictionnaires depuis l'éditeur et le CMS Intlayer
+- **[Remplir les dictionnaires](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/fill.md)** - Remplissez, auditez et traduisez les dictionnaires à l'aide de l'IA
+- **[Tester les traductions manquantes](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/test.md)** - Testez et identifiez les traductions manquantes
+- **[Lister les fichiers de déclaration de contenu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/list.md)** - Listez tous les fichiers de déclaration de contenu dans votre projet
+
+### Gestion des composants
+
+- **[Transformer les composants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/transform.md)** - Transformer les composants existants pour utiliser Intlayer
+
+### Configuration
+
+- **[Gérer la configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/configuration.md)** - Récupérer et pousser votre configuration Intlayer vers le CMS
+
+### Gestion de la documentation
+
+- **[Traduire un document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/doc-translate.md)** - Traduire automatiquement les fichiers de documentation avec l'IA
+- **[Relire un document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/doc-review.md)** - Relire les fichiers de documentation pour la qualité et la cohérence
+
+### Éditeur & Synchronisation en direct
+
+- **[Commandes de l’éditeur](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/editor.md)** - Utilisez les commandes de l’éditeur Intlayer
+- **[Commandes Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/live.md)** - Utilisez Live Sync pour refléter les changements de contenu du CMS en temps réel
+
+### Outils de développement
+
+- **[SDK CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/sdk.md)** - Utilisez le SDK CLI Intlayer dans votre propre code
+- **[Commande Debug Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/debug.md)** - Déboguez et résolvez les problèmes du CLI Intlayer
+
+## Utilisez les commandes intlayer dans votre `package.json`
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:build": "npx intlayer build",
+  "intlayer:watch": "npx intlayer build --watch",
+  "intlayer:push": "npx intlayer push",
+  "intlayer:pull": "npx intlayer pull",
+  "intlayer:fill": "npx intlayer fill",
+  "intlayer:list": "npx intlayer content list",
+  "intlayer:test": "npx intlayer content test",
+  "intlayer:transform": "npx intlayer transform",
+  "intlayer:doc:translate": "npx intlayer doc translate",
+  "intlayer:doc:review": "npx intlayer doc review"
+}
+```
+
+> **Note** : Vous pouvez également utiliser les alias plus courts :
+>
+> - `npx intlayer list` au lieu de `npx intlayer content list`
+> - `npx intlayer test` au lieu de `npx intlayer content test`

package/docs/fr/cli/list.md

@@ -0,0 +1,53 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Lister les fichiers de déclaration de contenu
+description: Apprenez à lister tous les fichiers de déclaration de contenu dans votre projet.
+keywords:
+  - Liste
+  - Déclaration de contenu
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - list
+---
+
+# Lister les fichiers de déclaration de contenu
+
+```bash
+npx intlayer content list
+```
+
+## Alias :
+
+- `npx intlayer list`
+
+Cette commande affiche tous les fichiers de déclaration de contenu dans votre projet, en montrant leurs clés de dictionnaire et leurs chemins de fichiers. Elle est utile pour obtenir une vue d'ensemble de tous vos fichiers de contenu et vérifier qu'ils sont correctement découverts par Intlayer.
+
+## Exemple :
+
+```bash
+npx intlayer content list
+```
+
+## Exemple de sortie :
+
+```bash
+npx intlayer content list
+Fichiers de déclaration de contenu :
+ - home-page        - src/components/HomePage/homePage.content.ts
+ - server-component - src/components/ServerComponent/serverComponent.content.ts
+ - client-component - src/components/ClientComponent/clientComponent.content.ts
+
+Nombre total de fichiers de déclaration de contenu : 3
+```
+
+Cette commande affichera :
+
+- Une liste formatée de tous les fichiers de déclaration de contenu avec leurs clés et chemins de fichiers relatifs
+- Le nombre total de fichiers de déclaration de contenu trouvés
+
+La sortie vous aide à vérifier que tous vos fichiers de contenu sont correctement configurés et détectables par le système Intlayer.

package/docs/fr/cli/live.md

@@ -0,0 +1,41 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Commandes Live Sync
+description: Apprenez à utiliser Live Sync pour refléter les modifications de contenu CMS en temps réel.
+keywords:
+  - Live Sync
+  - CMS
+  - Runtime
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - live
+---
+
+# Commandes Live Sync
+
+Live Sync permet à votre application de refléter les modifications de contenu CMS en temps réel. Aucune reconstruction ou redéploiement n'est nécessaire. Lorsqu'il est activé, les mises à jour sont transmises à un serveur Live Sync qui actualise les dictionnaires que votre application lit. Voir [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md) pour plus de détails.
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:live:start": "npx intlayer live start --with 'next dev --turbopack'"
+}
+```
+
+## Arguments :
+
+**Options de configuration :**
+
+- **`--base-dir`** : Spécifie le répertoire de base pour le projet. Pour récupérer la configuration intlayer, la commande recherchera le fichier `intlayer.config.{ts,js,json,cjs,mjs}` dans le répertoire de base.
+
+- **`--no-cache`** : Désactive le cache.
+
+  > Exemple : `npx intlayer dictionary push --env-file .env.production.local`
+
+**Options de journalisation :**
+
+- **`--verbose`** : Active la journalisation détaillée pour le débogage. (activé par défaut via la CLI)

package/docs/fr/cli/pull.md

@@ -0,0 +1,78 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Récupérer des Dictionnaires
+description: Apprenez comment récupérer des dictionnaires depuis l'éditeur Intlayer et le CMS.
+keywords:
+  - Récupérer
+  - Dictionnaires
+  - CLI
+  - Intlayer
+  - Éditeur
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - pull
+---
+
+# Récupérer des Dictionnaires Distants
+
+```bash
+npx intlayer pull
+```
+
+Si l'[éditeur intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_visual_editor.md) est installé, vous pouvez également récupérer des dictionnaires depuis l'éditeur. De cette manière, vous pouvez écraser le contenu de vos dictionnaires selon les besoins de votre application.
+
+## Alias :
+
+- `npx intlayer dictionaries pull`
+- `npx intlayer dictionary pull`
+- `npx intlayer dic pull`
+
+## Arguments :
+
+**Options du dictionnaire :**
+
+- **`-d, --dictionaries`** : Identifiants 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`
+
+- **`--dictionary`** : Identifiants des dictionnaires à récupérer (alias de --dictionaries).
+
+  > Exemple : `npx intlayer dictionary pull --dictionary my-dictionary-id my-other-dictionary-id`
+
+**Options de configuration :**
+
+- **`--base-dir`** : Spécifie le répertoire de base du projet. Pour récupérer la configuration intlayer, la commande cherchera le fichier `intlayer.config.{ts,js,json,cjs,mjs}` dans le répertoire de base.
+
+  > Exemple : `npx intlayer dictionary push --env-file .env.production.local`
+
+- **`--no-cache`** : Désactive le cache.
+
+  > Exemple : `npx intlayer build --no-cache`
+
+**Options des variables d'environnement :**
+
+- **`--env`** : Spécifie l'environnement (par exemple, `development`, `production`).
+- **`--env-file`** : Fournit un fichier d'environnement personnalisé pour charger les variables.
+- **`--base-dir`** : Spécifie le répertoire de base du projet. Pour récupérer la configuration intlayer, la commande cherchera le fichier `intlayer.config.{ts,js,json,cjs,mjs}` dans le répertoire de base.
+
+  > Exemple : `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Exemple : `npx intlayer dictionary push --env production`
+
+**Options de sortie :**
+
+- **`--new-dictionaries-path`** : 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 prendront pas en compte cet argument et seront enregistrés dans le répertoire `filePath` spécifié.
+
+**Options de journalisation :**
+
+- **`--verbose`** : Active la journalisation détaillée pour le débogage. (activé par défaut via la CLI)
+
+## Exemple :
+
+```bash
+npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
+```