@intlayer/docs 5.5.10 → 5.5.12

package/docs/es/how_works_intlayer.md

@@ -0,0 +1,256 @@
+---
+createdAt: 2024-08-12
+updatedAt: 2025-06-29
+title: Cómo funciona Intlayer
+description: Aprenda cómo funciona Intlayer internamente. Comprenda la arquitectura y los componentes que hacen que Intlayer sea potente.
+keywords:
+  - Intlayer
+  - Cómo funciona
+  - Arquitectura
+  - Componentes
+  - Funcionamiento interno
+slugs:
+  - doc
+  - concept
+  - how-works-intlayer
+---
+
+# Cómo funciona Intlayer
+
+## Resumen
+
+La idea principal detrás de Intlayer es adoptar una gestión de contenido por componente. Entonces, la idea detrás de Intlayer es permitirte declarar tu contenido en cualquier lugar de tu base de código, como en el mismo directorio que tu componente.
+
+```bash
+.
+└── Components
+    └── MyComponent
+        ├── index.content.cjs
+        └── index.mjs
+```
+
+Para ello, el papel de Intlayer es encontrar todos tus `archivos de declaración de contenido`, en todos los formatos diferentes presentes en tu proyecto, y luego generará los `diccionarios` a partir de ellos.
+
+Por lo tanto, hay dos pasos principales:
+
+- Paso de construcción
+- Paso de interpretación
+
+### Paso de construcción de diccionarios
+
+El paso de construcción se puede realizar de tres maneras:
+
+- usando la CLI con `npx intlayer build`
+- usando [extensión de vscode](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/vs_code_extension.md)
+- usando los plugins de la aplicación como el paquete [`vite-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/vite-intlayer/index.md), o sus equivalentes para [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/next-intlayer/index.md). Cuando usas uno de estos plugins, Intlayer construirá automáticamente tus diccionarios cuando inicies (dev) o construyas (prod) tu aplicación.
+
+1. Declaración de archivos de contenido
+
+   - Los archivos de contenido pueden definirse en varios formatos, como TypeScript, ECMAScript, CommonJS o JSON.
+   - Los archivos de contenido pueden definirse en cualquier lugar del proyecto, lo que permite un mejor mantenimiento y escalabilidad. Es importante respetar las convenciones de extensión de archivo para los archivos de contenido. Esta extensión es por defecto `*.content.{js|cjs|mjs|ts|tsx|json}`, pero puede modificarse en el [archivo de configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
+
+2. Generación de `diccionarios`
+
+   - Los diccionarios se generan a partir de los archivos de contenido. Por defecto, los diccionarios de Intlayer se generan en el directorio `.intlayer/dictionaries` del proyecto.
+   - Esos diccionarios se generan en diferentes formatos para satisfacer todas las necesidades y optimizar el rendimiento de la aplicación.
+
+3. Generación de tipos de diccionario
+
+Basado en tus `diccionarios`, Intlayer generará tipos para hacerlos utilizables en tu aplicación.
+
+- Los tipos de diccionario se generan a partir de los `archivos de declaración de contenido` de Intlayer. Por defecto, los tipos de diccionario de Intlayer se generan en el directorio `.intlayer/types` del proyecto.
+
+- La [ampliación de módulos](https://www.typescriptlang.org/docs/handbook/declaration-merging.html) de Intlayer es una característica de TypeScript que te permite definir tipos adicionales para Intlayer. Esto facilita la experiencia de desarrollo al sugerir argumentos disponibles o requeridos.
+  Entre los tipos generados, los tipos de diccionario de Intlayer o incluso los tipos de configuración de idioma se añaden al archivo `types/intlayer.d.ts`, y son utilizados por otros paquetes. Para hacer esto, es necesario que el archivo `tsconfig.json` esté configurado para incluir el directorio `types` del proyecto.
+
+### Paso de interpretación de diccionarios
+
+Usando Intlayer, accederás a tu contenido en tu aplicación usando el hook `useIntlayer`.
+
+```tsx
+const MyComponent = () => {
+  const content = useIntlayer("my-component");
+  return <div>{content.title}</div>;
+};
+```
+
+Este hook gestionará la detección del idioma por ti y devolverá el contenido para el idioma actual. Usando este hook, también podrás interpretar markdown, gestionar pluralización y más.
+
+> Para ver todas las características de Intlayer, puedes leer la [documentación de diccionarios](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/get_started.md).
+
+## Contenido remoto
+
+Intlayer te permite declarar contenido localmente y luego exportarlo al CMS para que sea editable por tu equipo no técnico.
+
+Así podrás enviar y recibir contenido del CMS a tu aplicación, de manera similar a lo que haces con Git para tu código.
+
+Para los diccionarios externalizados que usan el CMS, Intlayer realiza una operación básica de fetch para recuperar los diccionarios remotos y los combina con los locales. Si está configurado en tu proyecto, Intlayer gestionará automáticamente la obtención del contenido desde el CMS cuando la aplicación inicie (dev) o se construya (prod).
+
+## Editor visual
+
+Intlayer también proporciona un editor visual para permitirte editar tu contenido de manera visual. Este [editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md) está disponible en el paquete externo `intlayer-editor`.
+
+![editor visual](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif)
+
+- El servidor es una aplicación simple de Express que escucha las solicitudes del cliente y recupera el contenido de tu aplicación, como los `dictionaries` y la configuración para hacerlo accesible en el lado del cliente.
+- Por otro lado, el cliente es una aplicación React que se usa para interactuar con tu contenido mediante una interfaz visual.
+  Cuando llamas a tu contenido usando `useIntlayer` y el editor está habilitado, automáticamente envuelve tus cadenas con un objeto Proxy llamado `IntlayerNode`. Este nodo utiliza `window.sendMessage` para comunicarse con un iframe envuelto que contiene la interfaz del editor visual.  
+  En el lado del editor, este escucha estos mensajes y simula una interacción real con tu contenido, permitiéndote editar el texto directamente en el contexto de tu aplicación.
+
+## Optimización de la construcción de la aplicación
+
+Para optimizar el tamaño del paquete de tu aplicación, Intlayer proporciona dos plugins para optimizar la construcción de tu aplicación: los plugins `@intlayer/babel` y `@intlayer/swc`.
+Los plugins de Babel y SWC funcionan analizando el Árbol de Sintaxis Abstracta (AST) de tu aplicación para reemplazar las llamadas a las funciones de Intlayer con código optimizado. Este proceso hace que tu paquete final sea más ligero en producción al asegurar que solo se importen los diccionarios que realmente se usan, optimizando la división en fragmentos y reduciendo el tamaño del paquete.
+
+En modo de desarrollo, Intlayer utiliza una importación estática centralizada para los diccionarios para simplificar la experiencia de desarrollo.
+
+Al activar la opción `activateDynamicImport` en la [configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md), Intlayer usará la importación dinámica para cargar los diccionarios. Esta opción está desactivada por defecto para evitar el procesamiento asíncrono al renderizar la aplicación.
+
+> `@intlayer/babel` está disponible por defecto en el paquete `vite-intlayer`,
+
+> `@intlayer/swc` no está instalado por defecto en el paquete `next-intlayer` ya que los plugins SWC aún son experimentales en Next.js.
+
+Para ver cómo configurar la construcción de tu aplicación, puedes leer la [documentación de configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
+
+## Paquetes
+
+Intlayer está compuesto por varios paquetes, cada uno con un rol específico en el proceso de traducción. Aquí hay una representación gráfica de la estructura de este paquete:
+
+![paquetes de intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/assets/packages_dependency_graph.svg)
+
+### intlayer
+
+El paquete `intlayer` se utiliza en aplicaciones para declarar contenido en archivos de contenido.
+
+### react-intlayer
+
+El paquete `react-intlayer` se utiliza para interpretar los diccionarios de Intlayer y hacerlos utilizables en aplicaciones React.
+
+### next-intlayer
+
+El paquete `next-intlayer` se utiliza como una capa sobre `react-intlayer` para hacer que los diccionarios de Intlayer sean utilizables en aplicaciones Next.js. Integra características esenciales para que Intlayer funcione en un entorno Next.js, como middleware de traducción, enrutamiento o la configuración del archivo `next.config.js`.
+
+### vue-intlayer
+
+El paquete `vue-intlayer` se utiliza para interpretar los diccionarios de Intlayer y hacerlos utilizables en aplicaciones Vue.
+
+### nuxt-intlayer
+
+### nuxt-intlayer
+
+El paquete `nuxt-intlayer` es un módulo de Nuxt para hacer que los diccionarios de Intlayer sean utilizables en aplicaciones Nuxt. Integra características esenciales para que Intlayer funcione en un entorno Nuxt, como middleware de traducción, enrutamiento o la configuración del archivo `nuxt.config.js`.
+
+### svelte-intlayer (WIP)
+
+El paquete `svelte-intlayer` se utiliza para interpretar los diccionarios de Intlayer y hacerlos utilizables en aplicaciones Svelte.
+
+### solid-intlayer (WIP)
+
+El paquete `solid-intlayer` se utiliza para interpretar los diccionarios de Intlayer y hacerlos utilizables en aplicaciones Solid.js.
+
+### preact-intlayer
+
+El paquete `preact-intlayer` se utiliza para interpretar los diccionarios de Intlayer y hacerlos utilizables en aplicaciones Preact.
+
+### angular-intlayer (WIP)
+
+### angular-intlayer (WIP)
+
+El paquete `angular-intlayer` se utiliza para interpretar los diccionarios de Intlayer y hacerlos utilizables en aplicaciones Angular.
+
+### express-intlayer
+
+El paquete `express-intlayer` se utiliza para usar Intlayer en un backend de Express.js.
+
+### react-native-intlayer
+
+El paquete `react-native-intlayer` proporciona herramientas que integran plugins para que Intlayer funcione con el empaquetador Metro.
+
+### lynx-intlayer
+
+El paquete `lynx-intlayer` proporciona herramientas que integran plugins para que Intlayer funcione con el empaquetador Lynx.
+
+### vite-intlayer
+
+Incluye el plugin de Vite para integrar Intlayer con el [empaquetador Vite](https://vite.dev/guide/why.html#why-bundle-for-production), así como middleware para detectar el idioma preferido del usuario, gestionar cookies y manejar redirecciones de URL.
+
+### react-scripts-intlayer
+
+Incluye los comandos y plugins de `react-scripts-intlayer` para integrar Intlayer con aplicaciones basadas en Create React App. Estos plugins están basados en [craco](https://craco.js.org/) e incluyen configuración adicional para el empaquetador [Webpack](https://webpack.js.org/).
+
+### intlayer-editor
+
+El paquete `intlayer-editor` se utiliza para permitir el uso del editor visual. Este paquete, opcional, puede instalarse en aplicaciones y será utilizado por el paquete `react-intlayer`.
+Consiste en dos partes: el servidor y el cliente.
+
+El cliente contiene elementos de interfaz de usuario que serán utilizados por `react-intlayer`.
+
+El servidor, basado en Express, se utiliza para recibir solicitudes del editor visual y gestionar o modificar archivos de contenido.
+
+### intlayer-cli
+
+El paquete `intlayer-cli` puede ser utilizado para generar diccionarios usando el comando `npx intlayer dictionaries build`. Si `intlayer` ya está instalado, la CLI se instala automáticamente y este paquete no es necesario.
+
+### @intlayer/core
+
+El paquete `@intlayer/core` es el paquete principal de Intlayer. Contiene funciones de traducción y gestión de diccionarios. `@intlayer/core` es multiplataforma y es utilizado por otros paquetes para realizar la interpretación de diccionarios.
+
+### @intlayer/config
+
+El paquete `@intlayer/config` se utiliza para configurar los ajustes de Intlayer, como los idiomas disponibles, los parámetros del middleware de Next.js o los ajustes del editor integrado.
+
+### @intlayer/webpack
+
+El paquete `@intlayer/webpack` se utiliza para proporcionar una configuración de Webpack que permita que una aplicación basada en Webpack funcione con Intlayer. El paquete también proporciona un plugin para añadir a una aplicación existente de Webpack.
+
+### @intlayer/cli
+
+El paquete `@intlayer/cli` es un paquete de NPM que se utiliza para declarar los scripts relacionados con las interfaces de línea de comandos de Intlayer. Garantiza 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).
+
+### @intlayer/mcp
+
+El paquete `@intlayer/mcp` proporciona un servidor MCP (Model Context Protocol) que ofrece asistencia para IDE potenciada por IA, adaptada al ecosistema Intlayer. Carga automáticamente la documentación e integra con la CLI de Intlayer.
+
+### @intlayer/dictionaries-entry & @intlayer/unmerged-dictionaries-entry & @intlayer/dynamic-dictionaries-entry
+
+Los paquetes `@intlayer/dictionaries-entry`, `@intlayer/unmerged-dictionaries-entry` y `@intlayer/dynamic-dictionaries-entry` devuelven la ruta de entrada de los diccionarios de Intlayer. Dado que buscar en el sistema de archivos desde el navegador es imposible, no es posible usar empaquetadores como Webpack o Rollup para obtener la ruta de entrada de los diccionarios. Estos paquetes están diseñados para ser aliasados, lo que permite la optimización del empaquetado en varios empaquetadores como Vite, Webpack y Turbopack.
+
+### @intlayer/chokidar
+
+El paquete `@intlayer/chokidar` se utiliza para monitorizar archivos de contenido y regenerar el diccionario modificado en cada modificación.
+
+### @intlayer/editor
+
+El paquete `@intlayer/editor` proporciona las utilidades relacionadas con el editor de diccionarios. Incluye notablemente la API para conectar una aplicación con el editor de Intlayer, y utilidades para manipular diccionarios. Este paquete es multiplataforma.
+
+### @intlayer/editor-react
+
+El paquete `@intlayer/editor-react` proporciona estados, contextos, hooks y componentes para conectar una aplicación React con el editor de Intlayer.
+
+### @intlayer/babel
+
+El paquete `@intlayer/babel` proporciona herramientas que optimizan el empaquetado de diccionarios para aplicaciones basadas en Vite y Webpack.
+
+### @intlayer/swc
+
+El paquete `@intlayer/swc` proporciona herramientas que optimizan el empaquetado de diccionarios para aplicaciones Next.js.
+
+### @intlayer/api
+
+El paquete `@intlayer/api` es un SDK de API para interactuar con el backend.
+
+### @intlayer/design-system
+
+El paquete `@intlayer/design-system` se utiliza para compartir elementos de diseño entre el CMS y el editor visual.
+
+### @intlayer/backend
+
+El paquete `@intlayer/backend` exporta tipos de backend y eventualmente ofrecerá el backend como un paquete independiente en el futuro.
+
+## Chatea con nuestra documentación inteligente
+
+- [Haz tus preguntas a nuestra documentación inteligente](https://intlayer.org/es/doc/chat)
+
+## Historial de la documentación
+
+- 5.5.10 - 2025-06-29: Historial inicial

package/docs/es/index.md

@@ -0,0 +1,165 @@
+---
+createdAt: 2025-02-07
+updatedAt: 2025-06-29
+title: Documentación de Intlayer - Guía completa de i18n para JavaScript
+description: Documentación completa de Intlayer, la moderna biblioteca de internacionalización para JavaScript, React, Next.js, Express y más frameworks.
+keywords:
+  - intlayer
+  - internacionalización
+  - i18n
+  - JavaScript
+  - React
+  - Next.js
+  - documentación
+  - traducción
+  - multilingüe
+slugs:
+  - doc
+  - index
+---
+
+# 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.
+
+Intlayer ofrece un enfoque flexible y moderno para traducir tu aplicación. Nuestra documentación te guiará desde la instalación y configuración hasta funciones avanzadas como la **traducción impulsada por IA**, definiciones de **TypeScript** y soporte para **componentes del servidor**, permitiéndote crear una experiencia multilingüe fluida.
+
+---
+
+## Primeros Pasos
+
+- **[Introducción](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/introduction.md)**  
+  Obtén una visión general de cómo funciona Intlayer, sus características principales y por qué es un cambio radical para la i18n.
+
+- **[Cómo Funciona Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/how_works_intlayer.md)**  
+  Profundiza en el diseño arquitectónico y aprende cómo Intlayer maneja todo, desde la declaración de contenido hasta la entrega de traducciones.
+
+- **[Configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md)**  
+  Personaliza Intlayer para adaptarlo a las necesidades de tu proyecto. Explora opciones de middleware, estructuras de directorios y configuraciones avanzadas.
+
+- **[Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_cli.md)**  
+  Gestiona contenido y traducciones usando nuestra herramienta de línea de comandos. Descubre cómo enviar y recibir contenido, automatizar traducciones y más.
+
+- **[Editor de Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md)**  
+  Simplifica la colaboración con personas no desarrolladoras y potencia tus traducciones con IA, directamente en nuestro CMS gratuito e intuitivo.
+
+---
+
+## Conceptos Básicos
+
+### Diccionario
+
+Organiza tu contenido multilingüe cerca de tu código para mantener todo consistente y fácil de mantener.
+
+- **[Comenzar](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)**
+
+  Entiende 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)**
+
+  Descubre cómo obtener contenido dinámicamente con lógica personalizada para adaptarlo 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)**  
+  Entiende 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**, **ruteo dinámico** o **renderizado del lado del cliente**, para que puedas mantener una aplicación rápida, amigable para SEO y altamente escalable.
+
+---
+
+## Paquetes
+
+El diseño modular de Intlayer ofrece paquetes dedicados para entornos y necesidades específicas:
+
+### `intlayer`
+
+Funciones utilitarias principales para configurar y gestionar tu configuración i18n.
+
+- **[getConfiguration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getConfiguration.md)**
+- **[getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getHTMLTextDir.md)**
+- **[getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocaleLang.md)**
+- **[getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocaleName.md)**
+- **[getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getLocalizedUrl.md)**
+- **[getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getMultilingualUrls.md)**
+- **[getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getPathWithoutLocale.md)**
+- **[getTranslation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getTranslation.md)**
+- **[getEnumeration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/intlayer/getEnumeration.md)**
+
+### `express-intlayer`
+
+Aprovecha Intlayer dentro de aplicaciones basadas en **Express**:
+
+- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/express-intlayer/t.md)**  
+  Un ayudante de traducción minimalista y sencillo para tus rutas y vistas del servidor.
+
+### `react-intlayer`
+
+Mejore sus aplicaciones **React** con potentes hooks:
+
+- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/react-intlayer/t.md)**
+- **[useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/react-intlayer/useIntlayer.md)**
+- **[useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/react-intlayer/useDictionary.md)**
+- **[useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/react-intlayer/useLocale.md)**
+
+### `next-intlayer`
+
+Integración perfecta con **Next.js**:
+
+- **[t](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/next-intlayer/t.md)**
+- **[useIntlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/next-intlayer/useIntlayer.md)**
+- **[useDictionary](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/next-intlayer/useDictionary.md)**
+- **[useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/next-intlayer/useLocale.md)**
+
+---
+
+## Recursos Adicionales
+
+- **[Blog: Intlayer e i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_i18next.md)**  
+  Aprende cómo Intlayer complementa y se compara con la popular librería **i18next**.
+
+- **[Tutorial en Vivo en YouTube](https://youtu.be/W2G7KxuSD4c?si=GyU_KpVhr61razRw)**  
+  Mira una demostración completa y aprende cómo integrar Intlayer en tiempo real.
+
+---
+
+## Contribuciones y Comentarios
+
+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/interest_of_intlayer.md

@@ -0,0 +1,157 @@
+---
+createdAt: 2024-08-14
+updatedAt: 2025-06-29
+title: Interés de Intlayer
+description: Descubre los beneficios y ventajas de usar Intlayer en tus proyectos. Entiende por qué Intlayer destaca entre otros frameworks.
+keywords:
+  - Beneficios
+  - Ventajas
+  - Intlayer
+  - Framework
+  - Comparación
+slugs:
+  - doc
+  - concept
+  - interest
+---
+
+# Intlayer: Una forma personalizada de traducir tu sitio web
+
+**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.
+
+## Ejemplo de uso
+
+```bash codeFormat="typescript"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.ts
+        └── index.tsx
+```
+
+```bash codeFormat="commonjs"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.cjs
+        └── index.mjs
+```
+
+```bash codeFormat="esm"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.mjs
+        └── index.js
+```
+
+```tsx fileName="./Components/MyComponent/index.content.ts" codeFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const componentExampleContent = {
+  key: "component-example",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentExampleContent;
+```
+
+```jsx fileName="./Components/MyComponent/index.mjx" codeFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+// Contenido de ejemplo del componente con traducciones
+const componentExampleContent = {
+  key: "component-example",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+};
+
+export default componentExampleContent;
+```
+
+```jsx fileName="./Components/MyComponent/index.csx" codeFormat="commonjs"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+// Contenido de ejemplo del componente con traducciones
+const componentExampleContent = {
+  key: "component-example",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      fr: "Bonjour le monde",
+      es: "Hola Mundo",
+    }),
+  },
+};
+
+module.exports = componentExampleContent;
+```
+
+```tsx fileName="./Components/MyComponent/index.tsx" codeFormat="typescript"
+import { useIntlayer } from "react-intlayer";
+
+// Componente de ejemplo que utiliza la traducción desde Intlayer
+export const ComponentExample = () => {
+  const { myTranslatedContent } = useIntlayer("component-example");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="./Components/MyComponent/index.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const ComponentExample = () => {
+  const { myTranslatedContent } = useIntlayer("component-example");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="./Components/MyComponent/index.csx" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const ComponentExample = () => {
+  const { myTranslatedContent } = useIntlayer("component-example");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+## ¿Por qué elegir Intlayer?
+
+| Característica                                    | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **Gestión de Contenido Impulsada por JavaScript** | Aprovecha la flexibilidad de JavaScript para definir y gestionar tu contenido de manera eficiente.                                                                                                                                                                                                                                                                                                                                                                             |
+| **Entorno con Tipos Seguros**                     | Aprovecha TypeScript para garantizar que todas tus definiciones de contenido sean precisas y sin errores.                                                                                                                                                                                                                                                                                                                                                                      |
+| **Archivos de Contenido Integrados**              | Mantenga sus traducciones cerca de sus respectivos componentes, mejorando la mantenibilidad y claridad.                                                                                                                                                                                                                                                                                                                                                                        |
+| **Configuración Simplificada**                    | Comience rápidamente con una configuración mínima, especialmente optimizada para proyectos Next.js.                                                                                                                                                                                                                                                                                                                                                                            |
+| **Soporte para Componentes del Servidor**         | Perfectamente adecuado para componentes del servidor de Next.js, asegurando una renderización fluida del lado del servidor.                                                                                                                                                                                                                                                                                                                                                    |
+| **Enrutamiento Mejorado**                         | Soporte completo para el enrutamiento de aplicaciones Next.js, adaptándose sin problemas a estructuras de aplicación complejas.                                                                                                                                                                                                                                                                                                                                                |
+| **Base de código organizada**                     | Mantén tu base de código más organizada: 1 componente = 1 diccionario en la misma carpeta.                                                                                                                                                                                                                                                                                                                                                                                     |
+| **Auto-traducción en CI**                         | Rellena automáticamente tus traducciones en tu CI usando tu propia clave API de OpenAI, eliminando la necesidad de una plataforma de localización (L10n).                                                                                                                                                                                                                                                                                                                      |
+| **Integración del Servidor MCP**                  | Proporciona un servidor MCP (Protocolo de Contexto de Modelo) para la automatización en el IDE, permitiendo una gestión de contenido y flujos de trabajo de i18n sin interrupciones directamente dentro de tu entorno de desarrollo. [Aprende más](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/mcp_server.md).                                                                                                                                               |
+| **Soporte para Markdown**                         | Importa e interpreta archivos markdown para contenido multilingüe como políticas de privacidad.                                                                                                                                                                                                                                                                                                                                                                                |
+| **Editor Visual Gratuito y CMS**                  | Un editor visual gratuito y un CMS están disponibles si necesitas trabajar con redactores de contenido para tus traducciones, eliminando nuevamente la necesidad de una plataforma de localización y permitiendo la externalización del contenido fuera de la base de código.                                                                                                                                                                                                  |
+| **Recuperación Simplificada de Contenido**        | No es necesario llamar a tu función `t` para cada fragmento de contenido; recupera todo tu contenido directamente usando un solo hook.                                                                                                                                                                                                                                                                                                                                         |
+| **Implementación Consistente**                    | La misma implementación para componentes cliente y servidor, sin necesidad de pasar tu función `t` a través de cada componente servidor.                                                                                                                                                                                                                                                                                                                                       |
+| **Contenido Tree-shakable**                       | El contenido es tree-shakable, lo que aligera el paquete final.                                                                                                                                                                                                                                                                                                                                                                                                                |
+| **Renderizado Estático No Bloqueante**            | Intlayer no bloquea el Renderizado Estático como lo hace `next-intl`.                                                                                                                                                                                                                                                                                                                                                                                                          |
+| **Interoperabilidad**                             | Permite la interoperabilidad con [react-i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_react-i18next.md), [next-i18next](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_next-i18next.md), [next-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_next-intl.md), y [react-intl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_with_react-intl.md). |
+
+## Historial de Documentación
+
+- 5.5.10 - 2025-06-29: Historial inicial