@intlayer/docs 5.5.10 → 5.5.12

package/docs/es/introduction.md

@@ -0,0 +1,209 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-06-29
+title: Introducción
+description: Descubre cómo funciona Intlayer. Ve los pasos que usa Intlayer en tu aplicación. Descubre qué hacen los diferentes paquetes.
+keywords:
+  - Introducción
+  - Comenzar
+  - Intlayer
+  - Aplicación
+  - Paquetes
+slugs:
+  - doc
+  - get-started
+---
+
+# Documentación de Intlayer
+
+¡Bienvenido a la documentación oficial de Intlayer! Aquí encontrarás todo lo que necesitas para integrar, configurar y dominar Intlayer para todas tus necesidades de internacionalización (i18n), ya sea que trabajes con Next.js, React, Vite, Express u otro entorno de JavaScript.
+
+## Introducción
+
+### ¿Qué es Intlayer?
+
+**Intlayer** es una biblioteca de internacionalización diseñada específicamente para desarrolladores de JavaScript. Permite la declaración de tu contenido en cualquier parte de tu código. Convierte la declaración de contenido multilingüe en diccionarios estructurados para integrarlos fácilmente en tu código. Usando TypeScript, **Intlayer** hace que tu desarrollo sea más sólido y eficiente.
+
+Intlayer también proporciona un editor visual opcional que te permite editar y gestionar tu contenido fácilmente. Este editor es particularmente útil para desarrolladores que prefieren una interfaz visual para la gestión de contenido, o para equipos que generan contenido sin tener que preocuparse por el código.
+
+### Ejemplo de uso
+
+```bash
+.
+└── Components
+    └── MyComponent
+        ├── index.content.cjs
+        └── index.mjs
+```
+
+```tsx fileName="src/components/MyComponent/index.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+// contenidoDelComponente representa el contenido traducido del componente
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+};
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.cjs" contentDeclarationFormat="commonjs"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+// contenidoDelComponente representa el contenido traducido del componente
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+};
+
+module.exports = componentContent;
+```
+
+```json fileName="src/components/MyComponent/index.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "component-key",
+  "content": {
+    "myTranslatedContent": {
+      "nodeType": "translation",
+      "translation": {
+        "en": "Hello World",
+        "fr": "Bonjour le monde",
+        "es": "Hola Mundo"
+      }
+    }
+  }
+}
+```
+
+```tsx fileName="src/components/MyComponent/index.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+export const MyComponent: FC = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.csx" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+## Características Principales
+
+Intlayer ofrece una variedad de características diseñadas para satisfacer las necesidades del desarrollo web moderno. A continuación, se presentan las características clave, con enlaces a la documentación detallada de cada una:
+
+- **Soporte de Internacionalización**: Mejora el alcance global de tu aplicación con soporte integrado para internacionalización.
+- **Editor Visual**: Mejora tu flujo de trabajo de desarrollo con plugins de editor diseñados para Intlayer. Consulta la [Guía del Editor Visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md).
+- **Flexibilidad de Configuración**: Personaliza tu configuración con amplias opciones detalladas en la [Guía de Configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
+- **Herramientas Avanzadas de CLI**: Gestiona tus proyectos de manera eficiente usando la interfaz de línea de comandos de Intlayer. Explora las capacidades en la [Documentación de Herramientas CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_cli.md).
+
+## Conceptos Básicos
+
+### Diccionario
+
+Organiza tu contenido multilingüe cerca de tu código para mantener todo consistente y fácil de mantener.
+
+- **[Comenzando](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/get_started.md)**  
+  Aprende los conceptos básicos para declarar tu contenido en Intlayer.
+
+- **[Traducción](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/translation.md)**  
+  Comprende cómo se generan, almacenan y utilizan las traducciones en tu aplicación.
+
+- **[Enumeración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/enumeration.md)**  
+  Gestiona fácilmente conjuntos de datos repetidos o fijos en varios idiomas.
+
+- **[Condición](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/conditional.md)**  
+  Aprende a usar lógica condicional en Intlayer para crear contenido dinámico.
+
+- **[Inserción](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/insertion.md)**  
+  Descubre cómo insertar valores en una cadena usando marcadores de posición de inserción.
+
+- **[Obtención de Funciones](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/function_fetching.md)**  
+  Aprende cómo obtener contenido dinámicamente con lógica personalizada para adaptarse al flujo de trabajo de tu proyecto.
+
+- **[Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/markdown.md)**  
+  Aprende a usar Markdown en Intlayer para crear contenido enriquecido.
+
+- **[Incrustaciones de Archivos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/file_embeddings.md)**  
+  Descubre cómo incrustar archivos externos en Intlayer para usarlos en el editor de contenido.
+
+- **[Anidamiento](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/nesting.md)**  
+  Comprende cómo anidar contenido en Intlayer para crear estructuras complejas.
+
+### Entornos e Integraciones
+
+Hemos construido Intlayer pensando en la flexibilidad, ofreciendo una integración perfecta con los frameworks y herramientas de construcción más populares:
+
+- **[Intlayer con Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_nextjs_15.md)**
+- **[Intlayer con Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_nextjs_14.md)**
+- **[Intlayer con Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_nextjs_page_router.md)**
+- **[Intlayer con React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_create_react_app.md)**
+- **[Intlayer con Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_vite+react.md)**
+- **[Intlayer con React Native y Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_react_native+expo.md)**
+- **[Intlayer con Lynx y React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_lynx+react.md)**
+- **[Intlayer con Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_express.md)**
+
+Cada guía de integración incluye las mejores prácticas para usar las funcionalidades de Intlayer, como **renderizado del lado del servidor**, **enrutamiento dinámico** o **renderizado del lado del cliente**, para que puedas mantener una aplicación rápida, optimizada para SEO y altamente escalable.
+
+## Contribuciones y Retroalimentación
+
+Valoramos el poder del código abierto y el desarrollo impulsado por la comunidad. Si deseas proponer mejoras, agregar una nueva guía o corregir cualquier problema en nuestra documentación, no dudes en enviar un Pull Request o abrir un issue en nuestro [repositorio de GitHub](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+
+**¿Listo para traducir tu aplicación de manera más rápida y eficiente?** Sumérgete en nuestra documentación para comenzar a usar Intlayer hoy mismo. Experimenta un enfoque robusto y optimizado para la internacionalización que mantiene tu contenido organizado y a tu equipo más productivo.
+
+---
+
+## Historial de la documentación
+
+- 5.5.10 - 2025-06-29: Historial inicial

package/docs/es/mcp_server.md

@@ -0,0 +1,174 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2025-06-07
+title: Documentación del Servidor MCP
+description: Explora las características y configuración del Servidor MCP para optimizar la gestión y operaciones de tu servidor.
+keywords:
+  - Servidor MCP
+  - Gestión de Servidores
+  - Optimización
+  - Intlayer
+  - Documentación
+  - Configuración
+  - Características
+slugs:
+  - doc
+  - mcp-server
+---
+
+# Servidor MCP de Intlayer
+
+El **Servidor MCP (Model Context Protocol) de Intlayer** proporciona asistencia en el IDE potenciada por IA, adaptada al ecosistema de Intlayer. Diseñado para entornos modernos de desarrollo como **Cursor**, **GitHub Copilot workspace** y cualquier IDE que soporte el protocolo MCP, este servidor te ofrece soporte contextual y en tiempo real basado en la configuración de tu proyecto.
+
+## ¿Por qué usar el Servidor MCP de Intlayer?
+
+Al habilitar el Servidor MCP de Intlayer en tu IDE, desbloqueas:
+
+- **Integración inteligente con CLI**
+  Accede y ejecuta comandos de la CLI de Intlayer directamente desde la interfaz de tu IDE. Consulta la lista completa de comandos y opciones en la [documentación de la CLI de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_cli.md).
+
+- **Documentación con conciencia contextual**
+  El servidor MCP carga y expone la documentación que corresponde a la versión de Intlayer que estás utilizando en tu proyecto. Esto asegura que las sugerencias de código, opciones de comandos y explicaciones estén siempre actualizadas y sean relevantes.
+
+- **Desarrollo asistido por IA**
+  Con sugerencias y autocompletado conscientes del proyecto, el asistente de IA puede explicar tu código, recomendar el uso de la CLI o sugerir cómo usar características específicas de Intlayer basándose en tus archivos actuales.
+
+- **Ligero y configuración instantánea**
+  No se requiere mantenimiento del servidor ni instalaciones pesadas. Solo configura tu archivo `.cursor/mcp.json` o la configuración MCP equivalente y estarás listo para comenzar.
+
+---
+
+## Configurar Cursor
+
+En la raíz de tu proyecto, añade el siguiente archivo de configuración `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+Esto indica a tu IDE que inicie el servidor MCP de Intlayer usando `npx`, asegurando que siempre utilice la versión más reciente disponible a menos que la fijes.
+
+---
+
+## Configurar VS Code
+
+Para usar el servidor MCP de Intlayer con VS Code, necesitas configurarlo en los ajustes de tu espacio de trabajo o de usuario.
+
+### Configuración del espacio de trabajo
+
+Crea un archivo `.vscode/mcp.json` en la raíz de tu proyecto:
+
+```json
+{
+  "servers": {
+    "intlayer": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
+    }
+  }
+}
+```
+
+### Uso del servidor MCP en VS Code
+
+1. **Habilitar el modo Agente**: Abre la vista de Chat (⌃⌘I en Mac, Ctrl+Alt+I en Windows/Linux) y selecciona el modo **Agente** en el menú desplegable.
+
+2. **Acceder a las herramientas**: Haz clic en el botón **Herramientas** para ver las herramientas disponibles de Intlayer. Puedes seleccionar o deseleccionar herramientas específicas según sea necesario.
+
+3. **Referencia directa de herramientas**: Referencia las herramientas directamente en tus indicaciones escribiendo `#` seguido del nombre de la herramienta.
+
+4. **Confirmación de herramientas**: Por defecto, VS Code pedirá confirmación antes de ejecutar las herramientas. Usa las opciones del botón **Continuar** para confirmar automáticamente las herramientas para la sesión actual, el espacio de trabajo o todas las invocaciones futuras.
+
+### Gestión del servidor
+
+- Ejecuta **MCP: Listar servidores** desde la Paleta de Comandos para ver los servidores configurados
+- Inicia, detén o reinicia el servidor MCP de Intlayer según sea necesario
+- Visualiza los registros del servidor para solucionar problemas seleccionando el servidor y eligiendo **Mostrar salida**
+
+Para obtener información más detallada sobre la integración de MCP en VS Code, consulta la [documentación oficial de MCP para VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
+
+---
+
+## Uso del servidor MCP vía CLI
+
+También puedes ejecutar el servidor MCP de Intlayer directamente desde la línea de comandos para pruebas, depuración o integración con otras herramientas.
+
+### Instalar el servidor MCP
+
+Primero, instala el paquete del servidor MCP globalmente o úsalo mediante npx:
+
+```bash
+# Instalar globalmente
+npm install -g @intlayer/mcp
+
+# O usar directamente con npx (recomendado)
+npx @intlayer/mcp
+```
+
+### Iniciar el servidor
+
+Para iniciar el servidor MCP con el inspector para depuración y pruebas:
+
+```bash
+# Usando el comando start incorporado
+npm run start
+
+# O directamente con npx
+npx @modelcontextprotocol/inspector npx @intlayer/mcp
+```
+
+Esto iniciará el servidor MCP con una interfaz de inspector que te permite:
+
+- Probar las comunicaciones del protocolo MCP
+- Depurar las respuestas del servidor
+- Validar las implementaciones de herramientas y recursos
+- Monitorizar el rendimiento del servidor
+
+### Uso en Desarrollo
+
+Para propósitos de desarrollo y pruebas, puedes ejecutar el servidor en varios modos:
+
+```bash
+# Construir e iniciar en modo desarrollo
+npm run dev
+
+# Ejecutar con configuración personalizada
+node dist/cjs/index.cjs
+
+# Probar la funcionalidad del servidor
+npm test
+```
+
+El servidor expondrá herramientas y recursos específicos de Intlayer que pueden ser consumidos por cualquier cliente compatible con MCP, no solo Cursor u otros IDEs.
+
+---
+
+## Resumen de Funcionalidades
+
+| Feature                  | Description                                                                                     |
+| ------------------------ | ----------------------------------------------------------------------------------------------- |
+| Soporte CLI              | Ejecuta comandos `intlayer`, obtiene sugerencias de uso y argumentos en línea                   |
+| Documentación Versionada | Detecta y carga automáticamente la documentación que coincide con tu versión actual de Intlayer |
+| Autocompletado           | Sugerencias inteligentes de comandos y configuraciones mientras escribes                        |
+| Listo para Plugins       | Compatible con IDEs y herramientas que soportan el estándar MCP                                 |
+
+---
+
+## Enlaces Útiles
+
+- [Documentación CLI de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_cli.md)
+- [Repositorio GitHub de Intlayer](https://github.com/aymericzip/intlayer)
+
+---
+
+## Historial de Documentación
+
+- 5.5.10 - 2025-06-29: Historial inicial

package/docs/es/packages/@intlayer/api/index.md

@@ -0,0 +1,56 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/api - SDK para la integración con la API de Intlayer
+description: Paquete NPM que proporciona un Kit de Desarrollo de Software (SDK) para interactuar con la API de Intlayer para auditoría de contenido, organizaciones, proyectos y gestión de usuarios.
+keywords:
+  - intlayer
+  - API
+  - SDK
+  - integración
+  - auditoría de contenido
+  - organizaciones
+  - proyectos
+  - JavaScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - api
+---
+
+# @intlayer/api: Paquete NPM para interactuar con la API de Intlayer
+
+**Intlayer** es un conjunto de paquetes diseñados específicamente para desarrolladores de JavaScript. Es compatible con frameworks como React, React y Express.js.
+
+**`@intlayer/api`** es un SDK (Kit de Desarrollo de Software) para interactuar con la API de Intlayer. Proporciona un conjunto de funciones para auditar la declaración de contenido, interactuar con organizaciones, proyectos y usuarios, etc.
+
+## Uso
+
+```ts
+import { intlayerAPI } from "@intlayer/api";
+
+intlayerAPI.user.getUser({
+  ids: ["user-id-1", "user-id-2"],
+});
+```
+
+## Instalación
+
+Instale el paquete necesario usando su gestor de paquetes preferido:
+
+```bash packageManager="npm"
+npm install @intlayer/api
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/api
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/api
+```
+
+## Historial de la documentación
+
+- 5.5.10 - 2025-06-29: Historial inicial

package/docs/es/packages/@intlayer/chokidar/index.md

@@ -0,0 +1,56 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/chokidar - Observación de Archivos para i18n de Intlayer
+description: Paquete NPM que proporciona capacidades de observación de archivos para Intlayer, permitiendo actualizaciones automáticas y recarga en caliente para contenido de internacionalización.
+keywords:
+  - intlayer
+  - chokidar
+  - observación de archivos
+  - recarga en caliente
+  - i18n
+  - JavaScript
+  - NPM
+  - desarrollo
+slugs:
+  - doc
+  - package
+  - @intlayer_chokidar
+---
+
+# @intlayer/chokidar: Paquete NPM para escanear y construir archivos de declaración de Intlayer en diccionarios
+
+**Intlayer** es un conjunto de paquetes diseñados específicamente para desarrolladores de JavaScript. Es compatible con frameworks como React, React y Express.js.
+
+El paquete **`@intlayer/chokidar`** se utiliza para escanear y construir archivos de declaración de Intlayer en diccionarios usando [chokidar](https://github.com/paulmillr/chokidar) y de acuerdo con la [configuración de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
+
+## Uso
+
+```ts
+import { watch, prepareIntlayer } from "@intlayer/chokidar";
+
+await prepareIntlayer(); // Construir diccionarios de Intlayer
+
+watch({ persistent: true }); // Observar cambios en los archivos de configuración
+```
+
+## Instalación
+
+Instale el paquete necesario usando su gestor de paquetes preferido:
+
+```bash packageManager="npm"
+bash packageManager="npm"
+npm install @intlayer/chokidar
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/chokidar
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/chokidar
+```
+
+## Historial de Documentación
+
+- 5.5.10 - 2025-06-29: Historial inicial

package/docs/es/packages/@intlayer/cli/index.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/cli - Paquete de Interfaz de Línea de Comandos para Intlayer
+description: Paquete NPM que proporciona scripts para comandos CLI de Intlayer, asegurando uniformidad en todas las interfaces de línea de comandos para la gestión de internacionalización.
+keywords:
+  - intlayer
+  - CLI
+  - línea de comandos
+  - scripts
+  - i18n
+  - JavaScript
+  - NPM
+  - herramientas
+slugs:
+  - doc
+  - package
+  - @intlayer_cli
+---
+
+# @intlayer/cli: Paquete NPM para usar los scripts proporcionados por la CLI de intlayer
+
+**Intlayer** es un conjunto de paquetes diseñados específicamente para desarrolladores de JavaScript. Es compatible con frameworks como React, React y Express.js.
+
+El paquete **`@intlayer/cli`** es un paquete NPM que se utiliza para declarar el script relacionado con las interfaces de línea de comandos de intlayer. Asegura la uniformidad de todos los comandos CLI de intlayer. Este paquete es consumido notablemente por los paquetes [intlayer-cli](https://github.com/aymericzip/intlayer/tree/main/docs/es/packages/intlayer-cli/index.md) y [intlayer](https://github.com/aymericzip/intlayer/tree/main/docs/es/packages/intlayer/index.md).
+
+## Instalación
+
+Instale el paquete necesario usando su gestor de paquetes preferido:
+
+```bash packageManager="npm"
+npm install @intlayer/cli
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli
+```
+
+## Historial de Documentación
+
+- 5.5.10 - 2025-06-29: Historial inicial

package/docs/es/packages/@intlayer/config/index.md

@@ -0,0 +1,140 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: @intlayer/config - Gestión de Configuración para Intlayer
+description: Paquete NPM para obtener la configuración de Intlayer y definir variables de entorno para ajustes de internacionalización en diferentes entornos.
+keywords:
+  - intlayer
+  - configuración
+  - entorno
+  - ajustes
+  - i18n
+  - JavaScript
+  - NPM
+  - variables
+slugs:
+  - doc
+  - package
+  - @intlayer_config
+---
+
+# @intlayer/config: Paquete NPM para obtener la configuración de Intlayer
+
+**Intlayer** es un conjunto de paquetes diseñados específicamente para desarrolladores de JavaScript. Es compatible con frameworks como React, React y Express.js.
+
+El paquete **`@intlayer/config`** es un paquete NPM que te permite obtener la configuración de Intlayer y definir las variables de entorno relacionadas con el entorno actual.
+
+## Instalación
+
+Instala el paquete necesario usando tu gestor de paquetes preferido:
+
+```bash packageManager="npm"
+npm install @intlayer/config
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/config
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/config
+```
+
+## Uso
+
+### Leer la configuración de Intlayer usando el sistema de archivos
+
+Ejemplo:
+
+```ts
+import { getConfiguration, type IntlayerConfig } from "@intlayer/config";
+
+const config: IntlayerConfig = getConfiguration();
+
+console.log(config);
+// Salida:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+> Esta función usa el paquete `fs` y solo funcionará del lado del servidor.
+
+### Leer la configuración de Intlayer usando variables de entorno
+
+Ejemplo:
+
+```ts
+import { getConfiguration, type IntlayerConfig } from "@intlayer/config/client";
+
+const config: IntlayerConfig = getConfiguration({
+  env: "production",
+});
+
+console.log(config);
+// Salida:
+// {
+//   internationalization: { ... },
+//   middleware: { ... },
+//   content: { ... },
+//   editor: { ... }
+// }
+```
+
+> Esta función no devolverá nada si las variables de entorno no están definidas.
+
+### Definir las variables de entorno
+
+1. Crear un archivo de configuración.
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    /* ... */
+  },
+  middleware: {
+    /* ... */
+  },
+  content: {
+    /* ... */
+  },
+  editor: {
+    /* ... */
+  },
+};
+
+export default config;
+```
+
+> Consulte la [documentación de configuración de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md) para más detalles.
+
+2. Definir las variables de entorno.
+
+```ts
+import { getConfiguration } from "@intlayer/config";
+
+const intlayerConfig = getConfiguration();
+
+// Formatear todos los valores de configuración como variables de entorno
+const env = formatEnvVariable();
+
+// Establecer cada variable de entorno formateada en process.env
+Object.assign(process.env, env);
+```
+
+3. Importar el archivo de configuración.
+
+```ts
+import { getConfiguration } from "@intlayer/config/client";
+
+const intlayerConfig = getConfiguration();
+```
+
+## Historial del documento
+
+- 5.5.10 - 2025-06-29: Historial inicial