@intlayer/docs 7.5.10 → 7.5.12

package/docs/es/plugins/sync-json.md

@@ -108,18 +108,22 @@ syncJSON({
   source: ({ key, locale }) => string, // requerido
   location?: string, // etiqueta opcional, por defecto: "plugin"
   priority?: number, // prioridad opcional para resolución de conflictos, por defecto: 0
-  format?: 'intlayer' | 'icu' | 'i18next', // formateador opcional, por defecto: 'intlayer'
+  format?: 'intlayer' | 'icu' | 'i18next', // formateador opcional, usado para compatibilidad con el runtime de Intlayer
 });
 ```
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-Especifica el formateador a utilizar para el contenido del diccionario al sincronizar archivos JSON. Esto permite usar diferentes sintaxis de formateo de mensajes compatibles con varias bibliotecas i18n.
+Especifica el formateador a utilizar para el contenido del diccionario al sincronizar archivos JSON. Esto permite usar diferentes sintaxis de formateo de mensajes compatibles con el runtime de Intlayer.
 
+- `undefined`: No se usará ningún formateador, el contenido JSON se usará tal cual.
 - `'intlayer'`: El formateador Intlayer por defecto (por defecto).
 - `'icu'`: Usa el formateo de mensajes ICU (compatible con bibliotecas como react-intl, vue-i18n).
 - `'i18next'`: Usa el formateo de mensajes i18next (compatible con i18next, next-i18next, Solid-i18next).
 
+> Ten en cuenta que usar un formateador transformará tu contenido JSON en entrada y salida. Para reglas JSON complejas como plurales ICU, el parsing puede no garantizar un mapeo 1 a 1 entre entrada y salida.
+> Si no usas el runtime de Intlayer, podrías preferir no establecer un formateador.
+
 **Ejemplo:**
 
 ```ts

package/docs/fr/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: Commande CI
+description: Apprenez à utiliser la commande Intlayer CI pour exécuter des commandes Intlayer avec des identifiants auto-injectés dans les pipelines CI/CD et les monorepos.
+keywords:
+  - CI
+  - CI/CD
+  - Automatisation
+  - Monorepo
+  - Identifiants
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Ajouter la commande CI
+---
+
+# Commande CI
+
+```bash
+npx intlayer ci <command...>
+```
+
+La commande CI est conçue pour l'automatisation et les pipelines CI/CD. Elle injecte automatiquement les identifiants à partir de la variable d'environnement `INTLAYER_PROJECT_CREDENTIALS` et peut exécuter des commandes Intlayer sur plusieurs projets dans un monorepo.
+
+## Fonctionnement
+
+La commande CI fonctionne en deux modes :
+
+1. **Mode projet unique** : Si le répertoire de travail actuel correspond à l'un des chemins de projet dans `INTLAYER_PROJECT_CREDENTIALS`, elle exécute la commande uniquement pour ce projet spécifique.
+
+2. **Mode itération** : Si aucun contexte de projet spécifique n'est détecté, elle itère sur tous les projets configurés et exécute la commande pour chacun d'eux.
+
+## Variable d'environnement
+
+La commande nécessite que la variable d'environnement `INTLAYER_PROJECT_CREDENTIALS` soit définie. Cette variable doit contenir un objet JSON mappant les chemins de projet à leurs identifiants :
+
+```json
+{
+  "packages/app": {
+    "clientId": "your-client-id-1",
+    "clientSecret": "your-client-secret-1"
+  },
+  "packages/admin": {
+    "clientId": "your-client-id-2",
+    "clientSecret": "your-client-secret-2"
+  }
+}
+```
+
+## Détection du gestionnaire de paquets
+
+La commande CI détecte automatiquement le gestionnaire de paquets utilisé (npm, yarn, pnpm ou bun) en fonction de la variable d'environnement `npm_config_user_agent` et utilise la commande appropriée pour exécuter Intlayer.
+
+## Arguments
+
+- **`<command...>`** : La commande Intlayer à exécuter (par exemple, `fill`, `push`, `build`). Vous pouvez passer n'importe quelle commande Intlayer et ses arguments.
+
+  > Exemple : `npx intlayer ci fill --verbose`
+  >
+  > Exemple : `npx intlayer ci push`
+  >
+  > Exemple : `npx intlayer ci build`
+
+## Exemples
+
+### Exécuter une commande en mode projet unique
+
+Si vous êtes dans un répertoire de projet qui correspond à l'un des chemins dans `INTLAYER_PROJECT_CREDENTIALS` :
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+Cela exécutera la commande `fill` avec les identifiants automatiquement injectés pour le projet `packages/app`.
+
+### Exécuter une commande sur tous les projets
+
+Si vous êtes dans un répertoire qui ne correspond à aucun chemin de projet, la commande itérera sur tous les projets configurés :
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+Cela exécutera la commande `push` pour chaque projet configuré dans `INTLAYER_PROJECT_CREDENTIALS`.
+
+### Passer des drapeaux supplémentaires
+
+Vous pouvez passer n'importe quels drapeaux à la commande Intlayer sous-jacente :
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### Utilisation dans les pipelines CI/CD
+
+Dans votre configuration CI/CD (par exemple, GitHub Actions, GitLab CI), définissez `INTLAYER_PROJECT_CREDENTIALS` comme secret :
+
+```yaml
+# Exemple GitHub Actions
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: Remplir les dictionnaires
+    run: npx intlayer ci fill
+```
+
+## Gestion des erreurs
+
+- Si `INTLAYER_PROJECT_CREDENTIALS` n'est pas définie, la commande se terminera avec une erreur.
+- Si `INTLAYER_PROJECT_CREDENTIALS` n'est pas un JSON valide, la commande se terminera avec une erreur.
+- Si un chemin de projet n'existe pas, il sera ignoré avec un avertissement.
+- Si un projet échoue, la commande se terminera avec un code de statut non nul.
+
+## Cas d'utilisation
+
+- **Automatisation de monorepo** : Exécuter des commandes Intlayer sur plusieurs projets dans un monorepo
+- **Pipelines CI/CD** : Automatiser la gestion des dictionnaires dans les workflows d'intégration continue
+- **Opérations en masse** : Effectuer la même opération sur plusieurs projets Intlayer à la fois
+- **Gestion des secrets** : Gérer de manière sécurisée les identifiants pour plusieurs projets en utilisant des variables d'environnement
+
+## Bonnes pratiques de sécurité
+
+- Stockez `INTLAYER_PROJECT_CREDENTIALS` comme secrets chiffrés dans votre plateforme CI/CD
+- Ne commitez jamais les identifiants dans le contrôle de version
+- Utilisez des identifiants spécifiques à l'environnement pour différents environnements de déploiement
+- Faites tourner les identifiants régulièrement

package/docs/fr/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 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:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Ajout de la commande projects list
   - version: 7.5.9
     date: 2025-12-30
     changes: Ajout de la commande init
@@ -119,6 +122,7 @@ Pour voir comment configurer les locales disponibles, ou d'autres paramètres, r
 - **[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
+- **[Lister les projets](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/cli/list_projects.md)** - Listez tous les projets Intlayer dans un répertoire ou un dépôt git
 
 ### Gestion des dictionnaires
 
@@ -166,6 +170,7 @@ Pour voir comment configurer les locales disponibles, ou d'autres paramètres, r
   "intlayer:list": "npx intlayer content list",
   "intlayer:test": "npx intlayer content test",
   "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
   "intlayer:doc:review": "npx intlayer doc review"
 }
@@ -175,3 +180,4 @@ Pour voir comment configurer les locales disponibles, ou d'autres paramètres, r
 >
 > - `npx intlayer list` au lieu de `npx intlayer content list`
 > - `npx intlayer test` au lieu de `npx intlayer content test`
+> - `npx intlayer projects-list` ou `npx intlayer pl` au lieu de `npx intlayer projects list`

package/docs/fr/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: Lister les fichiers de déclaration de contenu
 description: Apprenez à lister tous les fichiers de déclaration de contenu dans votre projet.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Ajouter l'option de sortie absolue à la commande list
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Ajouter l'option de sortie JSON à la commande list
 ---
 
 # Lister les fichiers de déclaration de contenu
@@ -27,14 +34,36 @@ npx intlayer content 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 :
+## Arguments :
+
+- **`--json`** : Affiche les résultats au format JSON au lieu de texte formaté. Utile pour le scripting et l'accès programmatique.
+
+  > Exemple : `npx intlayer content list --json`
+
+## Exemples :
+
+### Lister les fichiers de déclaration de contenu :
 
 ```bash
 npx intlayer content list
 ```
 
+### Sortie au format JSON :
+
+```bash
+npx intlayer content list --json
+```
+
+### Sortie en tant que chemins absolus :
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Exemple de sortie :
 
+### Sortie formatée :
+
 ```bash
 npx intlayer content list
 Fichiers de déclaration de contenu :
@@ -45,6 +74,14 @@ Fichiers de déclaration de contenu :
 Nombre total de fichiers de déclaration de contenu : 3
 ```
 
+### Sortie JSON :
+
+```bash
+$ npx intlayer content list --json
+
+[{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
+```
+
 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

package/docs/fr/cli/list_projects.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Lister les projets Intlayer
+description: Apprenez comment lister tous les projets Intlayer dans un répertoire ou un dépôt git.
+keywords:
+  - Liste
+  - Projets
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Ajouter l'option de sortie absolue à la commande list projects
+---
+
+# Lister les projets Intlayer
+
+```bash
+npx intlayer projects list
+```
+
+Cette commande recherche et liste tous les projets Intlayer en trouvant les répertoires qui contiennent des fichiers de configuration Intlayer. Elle est utile pour découvrir tous les projets Intlayer dans un monorepo, un workspace ou un dépôt git.
+
+## Alias :
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Arguments :
+
+- **`--base-dir [path]`** : Spécifiez le répertoire de base à partir duquel effectuer la recherche. Par défaut, le répertoire de travail courant est utilisé.
+
+  > Exemple : `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > Exemple : `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`** : Rechercher à partir du répertoire racine git au lieu du répertoire de base. Ceci est utile pour trouver tous les projets Intlayer dans un monorepo ou un dépôt git.
+
+  > Exemple : `npx intlayer projects list --git-root`
+
+- **`--json`** : Affiche les résultats au format JSON au lieu de texte formaté. Utile pour le scripting et l'accès programmatique.
+
+  > Exemple : `npx intlayer projects list --json`
+
+- **`--absolute`** : Affiche les résultats en tant que chemins absolus au lieu de chemins relatifs.
+
+  > Exemple : `npx intlayer projects list --absolute`
+
+## Comment ça fonctionne :
+
+La commande recherche les fichiers de configuration Intlayer dans le répertoire spécifié (ou la racine git si `--git-root` est utilisé). Elle recherche les modèles de fichiers de configuration suivants :
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Chaque répertoire contenant un de ces fichiers est considéré comme un projet Intlayer et sera listé dans la sortie.
+
+## Exemples :
+
+### Lister les projets dans le répertoire courant :
+
+```bash
+npx intlayer projects list
+```
+
+### Lister les projets dans un répertoire spécifique :
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Lister tous les projets dans le dépôt git :
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Utiliser l'alias raccourci :
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Sortie au format JSON :
+
+```bash
+npx intlayer projects list --json
+```
+
+## Exemple de sortie :
+
+### Sortie formatée :
+
+```bash
+$ npx intlayer projects list --git-root
+
+Found 3 Intlayer project(s):
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### Sortie JSON :
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Cas d'utilisation :
+
+- **Gestion de monorepo** : Découvrir tous les projets Intlayer dans une structure monorepo
+- **Découverte de projets** : Trouver tous les projets utilisant Intlayer dans un workspace
+- **CI/CD** : Vérifier les projets Intlayer dans les workflows automatisés
+- **Documentation** : Générer une documentation listant tous les projets utilisant Intlayer
+- **Documentation** : Générer une documentation listant tous les projets utilisant Intlayer
+
+La sortie fournit des chemins absolus vers chaque répertoire de projet, ce qui facilite la navigation ou l'automatisation d'opérations sur plusieurs projets Intlayer.

package/docs/fr/intlayer_CMS.md

@@ -71,6 +71,26 @@ Pour l’intégration avec Vite + React, référez-vous au [guide d’installati
 
 ## Configuration
 
+Exécutez la commande suivante pour vous connecter à l'Intlayer CMS :
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+Cela ouvrira votre navigateur par défaut pour compléter le processus d'authentification et recevoir les identifiants nécessaires (Client ID et Client Secret) pour utiliser les services Intlayer.
+
 Dans votre fichier de configuration Intlayer, vous pouvez personnaliser les paramètres du CMS :
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/fr/intlayer_with_next-i18next.md

@@ -593,7 +593,6 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
-      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/fr/intlayer_with_nextjs_14.md

@@ -74,6 +74,34 @@ bunx intlayer init
 
 ### Étape 2 : Configurer votre projet
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Créez un fichier de configuration pour configurer les langues de votre application :
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/fr/intlayer_with_nextjs_15.md

@@ -84,6 +84,34 @@ bunx intlayer init
 
 ### Étape 2 : Configurez votre projet
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Créez un fichier de configuration pour configurer les langues de votre application :
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/fr/intlayer_with_nextjs_16.md

@@ -104,6 +104,34 @@ Le package qui intègre Intlayer avec Next.js. Il fournit des fournisseurs de co
 
 ### Étape 2 : Configurez votre projet
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── proxy.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Créez un fichier de configuration pour configurer les langues de votre application :
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"