@intlayer/docs 5.5.9 → 5.5.11

package/docs/es/roadmap.md

@@ -0,0 +1,337 @@
+---
+createdAt: 2025-03-01
+updatedAt: 2025-06-29
+title: Hoja de ruta
+description: Descubre la hoja de ruta de Intlayer. Consulta todas las funcionalidades que Intlayer ha implementado y las que planea implementar.
+keywords:
+  - Hoja de ruta
+  - Intlayer
+  - Internacionalización
+  - CMS
+  - Sistema de Gestión de Contenidos
+  - Editor Visual
+slugs:
+  - doc
+  - roadmap
+---
+
+# Intlayer: Resumen de funcionalidades y hoja de ruta
+
+Intlayer es una solución de gestión de contenido e internacionalización diseñada para optimizar cómo declaras, gestionas y actualizas contenido en tus aplicaciones. Ofrece potentes funcionalidades como la declaración de contenido centralizada o distribuida, amplias opciones de internacionalización, soporte para Markdown, renderizado condicional, integración con TypeScript/JavaScript/JSON, y más. A continuación, se presenta una visión general completa de lo que Intlayer ofrece actualmente, seguida de las funcionalidades previstas en la hoja de ruta.
+
+---
+
+## Funcionalidades Actuales
+
+### 1. Declaración de Contenido
+
+#### Centralizada o Distribuida
+
+- **Centralizada**: Declara todo tu contenido en un único archivo grande en la base de tu aplicación, similar a i18next, para que puedas gestionar todo en un solo lugar.
+- **Distribuida**: Alternativamente, divide tu contenido en archivos separados a nivel de componente o funcionalidad para una mejor mantenibilidad. Esto mantiene tu contenido cerca del código relevante (componentes, pruebas, Storybook, etc.). Eliminar un componente asegura que cualquier contenido asociado también se elimine, evitando que datos residuales saturen tu base de código.
+
+> Recursos:
+>
+> - [Declaración de Contenido](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/get_started.md)
+
+### 2. Internacionalización
+
+- Soporte para **230 idiomas y locales** (incluyendo variantes regionales como francés (Francia), inglés (Canadá), inglés (Reino Unido), portugués (Portugal), etc.).
+- Gestiona fácilmente las traducciones para todos estos locales desde un solo lugar.
+
+> Recursos:
+>
+> - [Internacionalización](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/translation.md)
+
+### 3. Soporte Markdown
+
+- Declara contenido usando **Markdown**, lo que te permite formatear automáticamente el texto con párrafos, encabezados, enlaces y más.
+- Ideal para publicaciones de blog, artículos, páginas de documentación o cualquier escenario donde se necesite formato de texto enriquecido.
+
+> Recursos:
+>
+> - [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/markdown.md)
+
+### 4. Soporte de archivos externos
+
+- Importa contenido desde archivos externos en formato de texto, como TXT, HTML, JSON, YAML o CSV.
+- Usa la función `file` en Intlayer para incrustar contenido de archivos externos en un diccionario, asegurando una integración fluida con el Editor Visual y CMS de Intlayer.
+- Soporta actualizaciones dinámicas de contenido, lo que significa que cuando el archivo fuente se modifica, el contenido se actualiza automáticamente dentro de Intlayer.
+- Permite la gestión de contenido multilingüe vinculando dinámicamente archivos Markdown específicos por idioma.
+
+> Recursos:
+>
+> - [Incrustación de contenido de archivos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/file.md)
+
+### 5. Contenido dinámico y obtención de funciones
+
+Intlayer proporciona varios métodos para insertar y gestionar contenido dinámico, asegurando flexibilidad y adaptabilidad en la entrega de contenido. Esto incluye funciones para la inserción dinámica de contenido, renderizado condicional, enumeración, anidamiento y obtención de funciones.
+
+1. Inserción de contenido dinámico
+
+   Usa la función insert para definir contenido con marcadores de posición ({{name}}, {{age}}, etc.).
+
+   Permite contenido tipo plantilla que se adapta según la entrada del usuario, respuestas de API u otras fuentes de datos dinámicas.
+
+   Funciona perfectamente con configuraciones de TypeScript, ESM, CommonJS y JSON.
+
+   Se integra fácilmente con React Intlayer y Next Intlayer usando useIntlayer.
+
+2. Renderizado Condicional
+
+   Define contenido que se adapta según condiciones específicas del usuario, como el idioma o el estado de autenticación.
+
+   Personaliza experiencias sin duplicar contenido en múltiples archivos.
+
+3. Enumeración y Pluralización
+
+   Usa la función enu para definir variaciones de contenido basadas en valores numéricos, rangos o claves personalizadas.
+
+   Garantiza la selección automática de la frase correcta según un valor dado.
+
+   Soporta reglas de ordenamiento, asegurando un comportamiento predecible.
+
+4. Anidamiento y Referencia de Sub-Contenido
+
+   Usa la función nest para referenciar y reutilizar contenido de otro diccionario, reduciendo la duplicación.
+
+   Soporta la gestión de contenido estructurado y jerárquico para una mejor mantenibilidad.
+
+5. Obtención mediante Funciones
+
+   Intlayer permite declarar contenido como funciones, habilitando la obtención de contenido tanto síncrona como asíncrona.
+
+   Funciones Síncronas: El contenido se genera dinámicamente en tiempo de compilación.
+
+   Funciones Asíncronas: Obtienen datos de fuentes externas (por ejemplo, APIs, bases de datos) de forma dinámica.
+
+   Integración: Funciona con TypeScript, ESM y CommonJS, pero no está soportado en archivos JSON o de contenido remoto.
+
+### 6. Formatos de Declaración de Contenido
+
+Intlayer soporta **TypeScript** (también JavaScript) y **JSON** para declarar contenido.
+
+- **TypeScript**:
+
+  - Garantiza que la estructura de tu contenido sea correcta y que no falten traducciones.
+  - Ofrece modos de validación estrictos o más flexibles.
+  - Permite la obtención dinámica de datos desde variables, funciones o APIs externas.
+
+- **JSON**:
+
+  - Facilita la integración con herramientas externas (como editores visuales) debido a su formato estandarizado.
+
+  > Recursos:
+  >
+  > - [Formatos de Declaración de Contenido](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/content_extention_customization.md)
+
+### 7. Purga, optimización del paquete e importaciones dinámicas
+
+- Intlayer integra plugins de `Babel` y `SWC` para optimizar tu paquete y mejorar el rendimiento. Reemplaza las importaciones para permitir importar solo los diccionarios que se usan en el paquete.
+- Al activar la opción, Intlayer también permite importar dinámicamente el contenido del diccionario solo para la configuración regional actual.
+
+> Recursos:
+>
+> - [Configuración de compilación](https://intlayer.org/doc/concept/configuration#build-configuration)
+
+---
+
+## Integración con Frameworks y Entornos
+
+### 1. Next.js
+
+#### a. Componentes de Servidor y Cliente
+
+- Proporciona un **enfoque unificado de gestión de contenido** para componentes tanto del servidor como del cliente.
+- Ofrece un contexto incorporado para componentes de servidor, simplificando la implementación en comparación con otras soluciones.
+
+#### b. Metadatos, Mapas del sitio y robots.txt
+
+- Obtiene e inyecta contenido dinámicamente para generar metadatos, mapas del sitio o archivos `robots.txt`.
+
+#### c. Middleware
+
+- Añade un middleware para **redirigir a los usuarios** al contenido basado en su idioma preferido.
+
+#### d. Compatibilidad con Turbopack y Webpack
+
+- Totalmente compatible con el nuevo Turbopack de Next.js así como con Webpack tradicional.
+
+> Recursos:
+>
+> - [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_nextjs_15.md)
+
+### 2. Vite
+
+- Similar a Next.js, puedes integrar Intlayer con Vite y usar un **middleware** para redirigir a los usuarios al contenido según su idioma preferido.
+
+> Recursos:
+>
+> - [Vite](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_vite+react.md)
+
+### 3. Express
+
+- Gestiona contenido e internacionaliza servicios backend construidos con Express.
+- Personaliza correos electrónicos, mensajes de error, notificaciones push y más con texto localizado.
+
+> Recursos:
+>
+> - [Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_express.md)
+
+### 4. React Native
+
+- Integra Intlayer con React Native para gestionar contenido e internacionalizar tus aplicaciones móviles.
+- Compatible con plataformas iOS y Android.
+
+> Recursos:
+>
+> - [React Native](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_react_native.md)
+
+### 5. Lynx
+
+- Integra Intlayer con Lynx para gestionar contenido e internacionalizar tus aplicaciones móviles.
+- Compatible con plataformas iOS y Android.
+
+> Recursos:
+>
+> - [Lynx](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_lynx.md)
+
+### 6. Vue
+
+- Integra Intlayer con Vue para gestionar contenido e internacionalizar tus aplicaciones Vite / Vue.js.
+
+> Recursos:
+>
+> - [Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_vue.md)
+
+### 7. Nuxt
+
+- Integra Intlayer con Nuxt para gestionar contenido e internacionalizar tus aplicaciones Nuxt / Vue.js.
+- Soporta componentes tanto del servidor como del cliente.
+- Integra enrutamiento y middleware para redirigir a los usuarios al contenido según su idioma preferido.
+
+> Recursos:
+>
+> - [Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_nuxt.md)
+
+### 8. Preact
+
+- Integra Intlayer con Preact para gestionar contenido e internacionalizar tus aplicaciones Preact.
+
+> Recursos:
+>
+> - [Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_preact.md)
+
+---
+
+## Editores Visuales y CMS
+
+### 1. Editor Visual Local
+
+- Un **editor visual local y gratuito** que te permite editar el contenido de tu aplicación seleccionando directamente los elementos en la página.
+- Integra funciones de IA para ayudar a:
+  - Generar o corregir traducciones
+  - Revisar sintaxis y ortografía
+  - Sugerir mejoras
+- Puede alojarse localmente o desplegarse en un servidor remoto.
+
+> Recursos:
+>
+> - [Editor Visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md)
+
+### 2. Intlayer CMS (Remoto)
+
+- Una solución de **CMS alojada** que te permite gestionar el contenido de la aplicación en línea, sin tocar tu base de código.
+- Proporciona funciones asistidas por IA para declarar contenido, gestionar traducciones y corregir errores de sintaxis u ortografía.
+- Interactúa con tu contenido a través de la interfaz de tu aplicación en vivo.
+
+> Recursos:
+>
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md)
+
+---
+
+## Extensiones para IDE
+
+- Extensiones para los principales IDEs que proporcionan una **interfaz gráfica** para gestionar traducciones locales y remotas.
+- Las funcionalidades podrían incluir la generación automática de archivos de declaración de contenido para componentes, integración directa con el CMS de Intlayer y validación en tiempo real.
+
+---
+
+## Servidor MCP
+
+- Un **servidor MCP** que te permite gestionar tu contenido y traducciones usando una herramienta integrada en tu IDE.
+
+---
+
+## Intlayer CLI
+
+- **Traducción y generación de archivos**: Ejecuta auditorías en tus archivos de contenido para generar traducciones faltantes y revisar inconsistencias.
+- **Interacción remota**: Envía tu contenido local al CMS remoto o extrae contenido remoto para integrarlo en tu aplicación local.
+- **Traducción y revisión de documentos**: Traduce y revisa tu documentación / archivos, etc.
+
+> Recursos:
+>
+> - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_cli.md)
+
+---
+
+## Entornos
+
+- Usa **variables de entorno** para configurar Intlayer de manera diferente en producción, pruebas y entornos locales.
+- Define qué editor visual o proyecto CMS remoto se debe usar según tu entorno.
+
+---
+
+## Actualizaciones de Contenido en Vivo
+
+- Al usar diccionarios remotos y el CMS de Intlayer, puedes **actualizar el contenido de tu aplicación al instante**, sin necesidad de redeployar.
+
+> Recursos:
+>
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_CMS.md)
+
+---
+
+## Funcionalidades Próximas
+
+### 1. Pruebas A/B y Personalización
+
+- **Pruebas multivariantes**: Prueba diferentes versiones de un contenido dado para ver cuál funciona mejor (por ejemplo, mayor tasa de clics).
+- **Personalización basada en datos**: Muestra contenido diferente según la demografía del usuario (género, edad, ubicación, etc.) u otros patrones de comportamiento.
+- **Iteración automatizada**: Permite que la IA pruebe automáticamente múltiples versiones y elija la de mejor rendimiento o recomiende opciones para la aprobación del administrador.
+
+### 2. Versionado
+
+- Restaura versiones anteriores de tu contenido con **versionado de contenido**.
+- Realiza un seguimiento de los cambios a lo largo del tiempo y vuelve a estados anteriores si es necesario.
+
+### 3. Traducción automática
+
+- Para usuarios de CMS remotos, **generación de traducción con un solo clic** para cualquier idioma compatible.
+- El sistema generaría traducciones en segundo plano y luego te solicitaría validación o ediciones.
+
+### 4. Mejoras SEO
+
+- Herramientas para **analizar palabras clave**, la intención de búsqueda del usuario y tendencias emergentes.
+- Sugerir contenido mejorado para obtener mejores posiciones y hacer seguimiento del rendimiento a largo plazo.
+
+### 5. Compatibilidad con Más Frameworks
+
+- Se están realizando esfuerzos para soportar **Solid, Svelte, Angular** y más.
+- El objetivo es hacer que Intlayer sea compatible con **cualquier aplicación basada en JavaScript**.
+
+---
+
+## Conclusión
+
+Intlayer tiene como objetivo ser una solución integral para la gestión de contenido e internacionalización. Se centra en la flexibilidad (archivos centralizados o distribuidos), amplio soporte de idiomas, fácil integración con frameworks y empaquetadores modernos, y potentes funciones impulsadas por IA. A medida que nuevas capacidades, como pruebas A/B, versionado y traducciones automáticas, estén disponibles, Intlayer continuará simplificando los flujos de trabajo de contenido y elevando la experiencia del usuario en diferentes plataformas.
+
+¡Manténgase atento a las próximas versiones y no dude en explorar las funciones existentes para ver cómo Intlayer puede ayudar a centralizar y optimizar sus procesos de gestión de contenido hoy mismo!
+
+---
+
+## Historial del Documento
+
+- 5.5.10 - 2025-06-30: Añadido soporte para Preact y Nuxt, servidor MCP, actualización de CLI
+- 5.5.10 - 2025-06-29: Historial inicial

package/docs/es/vs_code_extension.md

@@ -0,0 +1,152 @@
+---
+createdAt: 2025-03-17
+updatedAt: 2025-06-29
+title: Extensión Oficial de VS Code
+description: Aprende a usar la extensión Intlayer en VS Code para mejorar tu flujo de trabajo de desarrollo. Navega rápidamente entre contenido localizado y gestiona tus diccionarios de manera eficiente.
+keywords:
+  - Extensión VS Code
+  - Intlayer
+  - Localización
+  - Herramientas de Desarrollo
+  - React
+  - Next.js
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - vs-code-extension
+---
+
+# Extensión Oficial de VS Code
+
+## Resumen
+
+[**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension) es la extensión oficial de Visual Studio Code para **Intlayer**, diseñada para mejorar la experiencia del desarrollador al trabajar con contenido localizado en tus proyectos.
+
+![Extensión Intlayer para VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif)
+
+Enlace de la extensión: [https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)
+
+## Funcionalidades
+
+### Navegación Instantánea
+
+**Soporte para Ir a la Definición** – Usa `Cmd+Click` (Mac) o `Ctrl+Click` (Windows/Linux) en una clave `useIntlayer` para abrir instantáneamente el archivo de contenido correspondiente.  
+**Integración Perfecta** – Funciona sin esfuerzo con proyectos **react-intlayer** y **next-intlayer**.  
+**Soporte Multilingüe** – Soporta contenido localizado en diferentes idiomas.  
+**Integración con VS Code** – Se integra perfectamente con la navegación y la paleta de comandos de VS Code.
+
+### Comandos para Gestión de Diccionarios
+
+Gestiona tus diccionarios de contenido directamente desde VS Code:
+
+- **Construir Diccionarios** (`extension.buildDictionaries`) – Genera archivos de contenido basados en la estructura de tu proyecto.
+- **Subir Diccionarios** (`extension.pushDictionaries`) – Sube el contenido más reciente del diccionario a tu repositorio.
+- **Descargar Diccionarios** (`extension.pullDictionaries`) – Sincroniza el contenido más reciente del diccionario desde tu repositorio a tu entorno local.
+
+### Generador de Declaraciones de Contenido
+
+Genera fácilmente archivos de diccionario estructurados en diferentes formatos:
+
+- **TypeScript (`.ts`)** – `extension.createDictionaryFile.ts`
+- **ES Module (`.esm`)** – `extension.createDictionaryFile.esm`
+- **CommonJS (`.cjs`)** – `extension.createDictionaryFile.cjs`
+- **JSON (`.json`)** – `extension.createDictionaryFile.json`
+
+## Instalación
+
+Puedes instalar **Intlayer** directamente desde el Marketplace de VS Code:
+
+1. Abre **VS Code**.
+2. Ve al **Marketplace de Extensiones**.
+3. Busca **"Intlayer"**.
+4. Haz clic en **Instalar**.
+
+Alternativamente, instálalo desde la línea de comandos:
+
+```sh
+code --install-extension intlayer
+```
+
+## Uso
+
+### Navegación Rápida
+
+1. Abre un proyecto que use **react-intlayer**.
+2. Localiza una llamada a `useIntlayer()`, como:
+
+   ```tsx
+   const content = useIntlayer("app");
+   ```
+
+3. **Comando-clic** (`⌘+Click` en macOS) o **Ctrl+Click** (en Windows/Linux) sobre la clave (por ejemplo, `"app"`).
+4. VS Code abrirá automáticamente el archivo de diccionario correspondiente, por ejemplo, `src/app.content.ts`.
+
+### Gestión de Diccionarios de Contenido
+
+#### Construcción de Diccionarios
+
+Genera todos los archivos de contenido del diccionario con:
+
+```sh
+Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
+```
+
+Busca **Construir Diccionarios** y ejecuta el comando.
+
+#### Enviar Diccionarios
+
+Sube el contenido más reciente del diccionario:
+
+1. Abre la **Paleta de Comandos**.
+2. Busca **Enviar Diccionarios**.
+3. Selecciona los diccionarios a enviar y confirma.
+
+#### Descargar Diccionarios
+
+Sincroniza el contenido más reciente del diccionario:
+
+1. Abre la **Paleta de Comandos**.
+2. Busca **Descargar Diccionarios**.
+3. Elige los diccionarios a descargar.
+
+## Desarrollo y Contribución
+
+¿Quieres contribuir? ¡Damos la bienvenida a las contribuciones de la comunidad!
+
+URL del repositorio: https://github.com/aymericzip/intlayer-vs-code-extension
+
+### Primeros Pasos
+
+Clona el repositorio e instala las dependencias:
+
+```sh
+git clone https://github.com/aymericzip/intlayer-vs-code-extension.git
+cd intlayer-vs-code-extension
+npm install
+```
+
+> Usa el gestor de paquetes `npm` para compatibilidad con el paquete `vsce` para construir y publicar la extensión.
+
+### Ejecutar en Modo Desarrollo
+
+1. Abre el proyecto en **VS Code**.
+2. Presiona `F5` para lanzar una nueva ventana de **Host de Desarrollo de Extensión**.
+
+### Enviar una Pull Request
+
+Si mejoras la extensión, envía una PR en [GitHub](https://github.com/aymericzip/intlayer-vs-code-extension).
+
+## Comentarios y Problemas
+
+¿Encontraste un error o tienes una solicitud de función? Abre un issue en nuestro **repositorio de GitHub**:
+
+[GitHub Issues](https://github.com/aymericzip/intlayer-vs-code-extension/issues)
+
+## Licencia
+
+Intlayer se publica bajo la **Licencia MIT**.
+
+## Historial de Documentación
+
+- 5.5.10 - 2025-06-29: Historial inicial

package/docs/fr/CI_CD.md

@@ -0,0 +1,172 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Intégration CI/CD
+description: Apprenez comment intégrer Intlayer dans votre pipeline CI/CD pour la gestion et le déploiement automatisés du contenu.
+keywords:
+  - CI/CD
+  - Intégration Continue
+  - Déploiement Continu
+  - Automatisation
+  - Internationalisation
+  - Documentation
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - ci-cd
+---
+
+# Génération Automatique des Traductions dans un Pipeline CI/CD
+
+Intlayer permet la génération automatique des traductions pour vos fichiers de déclaration de contenu. Plusieurs méthodes existent selon votre flux de travail.
+
+## Utilisation du CMS
+
+Avec Intlayer, vous pouvez adopter un flux de travail où une seule locale est déclarée localement, tandis que toutes les traductions sont gérées à distance via le CMS. Cela permet de détacher complètement le contenu et les traductions de la base de code, offrant plus de flexibilité aux éditeurs de contenu et permettant le rechargement dynamique du contenu (pas besoin de reconstruire l'application pour appliquer les modifications).
+
+### Exemple de Configuration
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.SPANISH, Locales.FRENCH],
+    requiredLocales: [Locales.ENGLISH], // Les locales optionnelles seront gérées à distance
+    defaultLocale: Locales.ENGLISH,
+  },
+  editor: {
+    dictionaryPriorityStrategy: "distant_first", // Le contenu distant a la priorité
+
+    applicationURL: process.env.APPLICATION_URL, // URL de l'application utilisée par le CMS
+
+    clientId: process.env.INTLAYER_CLIENT_ID, // Identifiants du CMS
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+  ai: {
+    applicationContext: "This is a test application", // Aide à garantir une génération cohérente des traductions
+  },
+};
+
+export default config;
+```
+
+Pour en savoir plus sur le CMS, consultez la [documentation officielle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md).
+
+## Utilisation de Husky
+
+Vous pouvez intégrer la génération de traductions dans votre flux de travail Git local en utilisant [Husky](https://typicode.github.io/husky/).
+
+### Exemple de Configuration
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.SPANISH, Locales.FRENCH],
+    requiredLocales: [Locales.ENGLISH], // Les locales optionnelles sont gérées à distance
+    defaultLocale: Locales.ENGLISH,
+  },
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+  ai: {
+    provider: "openai",
+    apiKey: process.env.OPENAI_API_KEY, // Utilisez votre propre clé API
+
+    applicationContext: "This is a test application", // Aide à garantir une génération cohérente des traductions
+  },
+};
+
+export default config;
+```
+
+```bash fileName=".husky/pre-push"
+npx intlayer build                          # Pour s'assurer que les dictionnaires sont à jour
+npx intlayer fill --unpushed --mode fill    # Remplit uniquement le contenu manquant, ne met pas à jour les contenus existants
+```
+
+> Pour plus d'informations sur les commandes CLI d'Intlayer et leur utilisation, consultez la [documentation CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_cli.md).
+
+> Si vous avez plusieurs applications dans votre dépôt utilisant des instances intlayer séparées, vous pouvez utiliser l'argument `--base-dir` comme ceci :
+
+```bash fileName=".husky/pre-push"
+# Application 1
+npx intlayer build --base-dir ./app1
+npx intlayer fill --base-dir ./app1 --unpushed --mode fill
+
+# Application 2
+npx intlayer build --base-dir ./app2
+npx intlayer fill --base-dir ./app2 --unpushed --mode fill
+```
+
+## Utilisation de GitHub Actions
+
+Intlayer fournit une commande CLI pour remplir automatiquement et réviser le contenu du dictionnaire. Cela peut être intégré dans votre workflow CI/CD en utilisant GitHub Actions.
+
+```yaml fileName=".github/workflows/intlayer-translate.yml"
+name: Remplissage automatique Intlayer
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'src/**'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'src/**'
+  workflow_dispatch: {}
+
+concurrency:
+  group: 'autofill-${{ github.ref }}'
+  cancel-in-progress: true
+
+jobs:
+  autofill:
+    runs-on: ubuntu-latest
+    env:
+      INTLAYER_CLIENT_ID: ${{ secrets.INTLAYER_CLIENT_ID }}
+      INTLAYER_CLIENT_SECRET: ${{ secrets.INTLAYER_CLIENT_SECRET }}
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+
+    steps:
+      - name: ⬇️ Récupérer le dépôt
+        uses: actions/checkout@v3
+        with:
+          persist-credentials: true
+
+      - name: 🟢 Configurer Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: 20
+
+      - name: 📦 Installer les dépendances
+        run: npm ci
+
+      - name: ⚙️ Compiler le projet Intlayer
+        run: npx intlayer build
+
+      - name: 🤖 Remplir automatiquement les traductions manquantes
+        run: npx intlayer fill --git-diff --mode fill
+
+      - name: 📤 Créer ou mettre à jour la PR de traduction
+        uses: peter-evans/create-pull-request@v4
+        with:
+          commit-message: chore: remplissage automatique des traductions manquantes [skip ci]
+          branch: auto-translations
+          title: chore: mise à jour des traductions manquantes
+          labels: translation, automated
+```
+
+> Comme pour Husky, dans le cas d'un monorepo, vous pouvez utiliser l'argument `--base-dir` pour traiter séquentiellement chaque application.
+
+> Par défaut, l'argument `--git-diff` filtre les dictionnaires qui incluent les modifications de la base (par défaut `origin/main`) vers la branche courante (par défaut : `HEAD`).
+
+> Pour plus d'informations sur les commandes Intlayer CLI et leur utilisation, consultez la [documentation CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_cli.md).
+
+## Historique de la documentation
+
+- 5.5.10 - 2025-06-29 : Historique initial