@intlayer/docs 7.5.10 → 7.5.11

package/docs/es/cli/list_projects.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Listar proyectos de Intlayer
+description: Aprende cómo listar todos los proyectos de Intlayer en un directorio o repositorio git.
+keywords:
+  - Lista
+  - Proyectos
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Agregar opción de salida absoluta al comando list projects
+---
+
+# Listar proyectos de Intlayer
+
+```bash
+npx intlayer projects list
+```
+
+Este comando busca y lista todos los proyectos de Intlayer encontrando directorios que contienen archivos de configuración de Intlayer. Es útil para descubrir todos los proyectos de Intlayer en un monorepo, workspace o repositorio git.
+
+## Alias:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Argumentos:
+
+- **`--base-dir [path]`**: Especifica el directorio base desde el cual buscar. Por defecto es el directorio de trabajo actual.
+
+  > Ejemplo: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > Ejemplo: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--git-root`**: Buscar desde el directorio raíz de git en lugar del directorio base. Esto es útil para encontrar todos los proyectos de Intlayer en un monorepo o repositorio git.
+
+  > Ejemplo: `npx intlayer projects list --git-root`
+
+- **`--json`**: Muestra los resultados como JSON en lugar de texto formateado. Útil para scripting y acceso programático.
+
+  > Ejemplo: `npx intlayer projects list --json`
+
+- **`--absolute`**: Muestra los resultados como rutas absolutas en lugar de rutas relativas.
+
+  > Ejemplo: `npx intlayer projects list --absolute`
+
+## Cómo funciona:
+
+El comando busca archivos de configuración de Intlayer en el directorio especificado (o en la raíz del git si se usa `--git-root`). Busca los siguientes patrones de archivos de configuración:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Cada directorio que contenga uno de estos archivos se considera un proyecto de Intlayer y se listará en la salida.
+
+## Ejemplos:
+
+### Listar proyectos en el directorio actual:
+
+```bash
+npx intlayer projects list
+```
+
+### Listar proyectos en un directorio específico:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Listar todos los proyectos en el repositorio git:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Usar el alias corto:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Salida como JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Ejemplo de salida:
+
+### Salida formateada:
+
+```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
+```
+
+### Salida JSON:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Casos de uso:
+
+- **Gestión de monorepos**: Descubrir todos los proyectos Intlayer en una estructura monorepo
+- **Descubrimiento de proyectos**: Encontrar todos los proyectos habilitados con Intlayer en un workspace
+- **CI/CD**: Verificar proyectos Intlayer en flujos de trabajo automatizados
+- **Documentación**: Generar documentación que liste todos los proyectos que usan Intlayer
+
+La salida proporciona rutas absolutas a cada directorio de proyecto, lo que facilita la navegación hacia ellos o la automatización de operaciones sobre múltiples proyectos Intlayer.

package/docs/es/intlayer_CMS.md

@@ -71,6 +71,26 @@ Para la integración con Vite + React, consulta la [guía de configuración](htt
 
 ## Configuración
 
+Ejecuta el siguiente comando para iniciar sesión en el 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
+```
+
+Esto abrirá tu navegador predeterminado para completar el proceso de autenticación y recibir las credenciales necesarias (Client ID y Client Secret) para usar los servicios de Intlayer.
+
 En tu archivo de configuración de Intlayer, puedes personalizar los ajustes del CMS:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

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"