@intlayer/docs 8.1.6 → 8.1.8

package/docs/es/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-02-12
+updatedAt: 2026-02-25
 title: Configuración
 description: Aprende cómo configurar Intlayer para tu aplicación. Entiende las diversas configuraciones y opciones disponibles para personalizar Intlayer según tus necesidades.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.1.7
+    date: 2026-02-25
+    changes: Actualizar opciones del compilador
   - version: 8.0.6
     date: 2026-02-12
     changes: Add support for Open Router, Alibaba, Amazon, Google Vertex Bedrock, Fireworks, Groq, Hugging Face, and Together.ai providers
@@ -437,6 +440,17 @@ const config: IntlayerConfig = {
      * Output directory for the optimized dictionaries.
      */
     outputDir: "compiler",
+
+    /**
+     * Dictionary key prefix
+     */
+    dictionaryKeyPrefix: "", // Remove base prefix
+
+    /**
+     * Indicates if the components should be saved after being transformed.
+     * That way, the compiler can be run only once to transform the app, and then it can be removed.
+     */
+    saveComponents: false,
   },
 
   /**
@@ -982,6 +996,13 @@ Las opciones de compilación se aplican a los plugins `@intlayer/babel` y `@intl
   - _Nota_: El modo en vivo utilizará la API de sincronización en vivo para obtener los diccionarios. Si la llamada a la API falla, los diccionarios se importarán dinámicamente en modo "dynamic".
   - _Nota_: Esta opción no afectará a las funciones `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` y `useDictionaryDynamic`.
 
+- **outputFormat**:
+  - _Tipo_: `'esm' | 'cjs'`
+  - _Por defecto_: `'esm'`
+  - _Descripción_: Controla el formato de salida de los diccionarios.
+  - _Ejemplo_: `'cjs'`
+  - _Nota_: El formato de salida de los diccionarios.
+
 - **traversePattern**:
   - _Tipo_: `string[]`
   - _Por defecto_: `['**\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\/node_modules/**']`
@@ -990,3 +1011,49 @@ Las opciones de compilación se aplican a los plugins `@intlayer/babel` y `@intl
   - _Nota_: Utilice esto para limitar la optimización a archivos de código relevantes y mejorar el rendimiento de la compilación.
   - _Nota_: Esta opción será ignorada si `optimize` está deshabilitado.
   - _Nota_: Use patrón glob.
+
+---
+
+### Configuración del compilador
+
+Ajustes que controlan el compilador Intlayer, que extrae diccionarios directamente de sus componentes.
+
+#### Propiedades
+
+- **enabled**:
+  - _Tipo_: `boolean | 'build-only'`
+  - _Por defecto_: `true`
+  - _Descripción_: Indica si el compilador debe estar habilitado para extraer los diccionarios.
+  - _Ejemplo_: `'build-only'`
+  - _Nota_: Establecerlo en `'build-only'` saltará el compilador durante el modo de desarrollo para acelerar los tiempos de inicio. Solo se ejecutará en los comandos de construcción.
+
+- **dictionaryKeyPrefix**:
+  - _Tipo_: `string`
+  - _Por defecto_: `'comp-'`
+  - _Descripción_: Prefijo para las claves de diccionario extraídas.
+  - _Ejemplo_: `'my-key-'`
+  - _Nota_: Cuando se extraen diccionarios, la clave se genera a partir del nombre del archivo. Este prefijo se añade a la clave generada para evitar conflictos.
+
+- **saveComponents**:
+  - _Tipo_: `boolean`
+  - _Por defecto_: `false`
+  - _Descripción_: Indica si los componentes deben guardarse después de ser transformados.
+  - _Nota_: Si es verdadero, el compilador reemplazará los archivos originales con los archivos transformados. De esa manera, el compilador puede ejecutarse solo una vez para transformar la aplicación y luego puede eliminarse.
+
+- **transformPattern**:
+  - _Tipo_: `string | string[]`
+  - _Por defecto_: `['**/*.{ts,tsx,jsx,js,cjs,mjs,svelte,vue}', '!**/node_modules/**']`
+  - _Descripción_: Patrones que definen qué archivos deben ser recorridos durante la optimización.
+  - _Ejemplo_: `['src/**/*.{ts,tsx}', '!**/node_modules/**']`
+  - _Nota_: Use esto para limitar la optimización a archivos de código relevantes y mejorar el rendimiento de la construcción.
+
+- **excludePattern**:
+  - _Tipo_: `string | string[]`
+  - _Por defecto_: `['**/node_modules/**']`
+  - _Descripción_: Patrones que definen qué archivos deben excluirse durante la optimización.
+  - _Ejemplo_: `['**/node_modules/**', '!**/node_modules/react/**']`
+
+- **outputDir**:
+  - _Tipo_: `string`
+  - _Por defecto_: `'compiler'`
+  - _Descripción_: El directorio donde se almacenarán los diccionarios extraídos, relativo a la ruta base de su proyecto.

package/docs/es/dictionary/content_file.md

@@ -493,7 +493,7 @@ Indica la ubicación del diccionario y controla cómo se sincroniza con el CMS:
 
 - `'local'`: El diccionario se gestiona solo localmente. No se enviará al CMS remoto. Use esto para contenido que debe permanecer en su codebase.
 - `'remote'`: El diccionario se gestiona solo remotamente. Una vez enviado al CMS, se desvinculará del archivo local. En el momento de cargar el contenido, el diccionario remoto se obtendrá del CMS. Un archivo `.content` con ubicación `remote` será ignorado después del envío inicial.
-- `'hybrid'`: El diccionario se gestiona tanto localmente como remotamente. Una vez enviado al CMS, permanecerá sincronizado—los cambios del archivo local se envían al CMS, y los cambios remotos pueden recuperarse en el archivo local.
+- `'hybrid'`: El diccionario se gestiona tanto localmente como remotamente. Una vez enviado al CMS, permanecerá sincronizado, los cambios del archivo local se envían al CMS, y los cambios remotos pueden recuperarse en el archivo local.
 - `string` (p. ej., `'plugin'`): El diccionario es gestionado por un plugin o una fuente personalizada. Cuando intente enviarlo, el sistema le preguntará qué hacer.
 
 **Ejemplo:**

package/docs/es/index.md

@@ -65,7 +65,7 @@ Organiza tu contenido multilingüe cerca de tu código para mantener todo consis
 - **[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)**  
+- **[Condición](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/condition.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)**  
@@ -78,7 +78,7 @@ Organiza tu contenido multilingüe cerca de tu código para mantener todo consis
 - **[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)**  
+- **[Incrustaciones de archivos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/file.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)**  

package/docs/es/intlayer_with_adonisjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: AdonisJS i18n - Cómo traducir tu aplicación AdonisJS – guía 2026
+title: AdonisJS i18n - Cómo traducir una aplicación AdonisJS en 2026
 description: Descubre cómo hacer que tu backend de AdonisJS sea multilingüe. Sigue la documentación para internacionalizarlo (i18n) y traducirlo.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_analog.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Analog i18n - Cómo traducir tu aplicación Analog – guía 2026
+title: Analog i18n - Cómo traducir una aplicación Analog en 2026
 description: Descubre cómo hacer que tu aplicación Analog sea multilingüe. Sigue la documentación para internacionalizarla (i18n) y traducirla.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_angular.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-04-18
 updatedAt: 2025-12-30
-title: Angular i18n - Cómo traducir tu aplicación Angular – guía 2026
+title: Angular i18n - Cómo traducir una aplicación Angular en 2026
 description: Descubre cómo hacer que tu sitio web Angular sea multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_astro.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-03-07
 updatedAt: 2025-12-30
-title: Astro i18n - Cómo traducir su aplicación Astro – guía 2026
+title: Astro i18n - Cómo traducir una aplicación Astro en 2026
 description: Aprende cómo agregar internacionalización (i18n) a tu sitio web Astro usando Intlayer. Sigue esta guía para hacer tu sitio multilingüe.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_create_react_app.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2025-12-30
-title: Create React App i18n - Cómo traducir su aplicación React – guía 2026
+title: Create React App i18n - Cómo traducir una aplicación React en 2026
 description: Descubre cómo hacer que tu sitio web de Create React App (CRA) sea multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_express.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-08-11
 updatedAt: 2025-12-30
-title: Express i18n - Cómo traducir su aplicación Express – guía 2026
+title: Express i18n - Cómo traducir una aplicación Express en 2026
 description: Descubre cómo hacer que tu backend de Express sea multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_fastify.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-12-30
 updatedAt: 2025-12-30
-title: Fastify i18n - Cómo traducir su aplicación Fastify – guía 2026
+title: Fastify i18n - Cómo traducir una aplicación Fastify en 2026
 description: Descubre cómo hacer tu backend con Fastify multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_hono.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-08-23
 updatedAt: 2025-12-30
-title: i18n Hono - Cómo traducir su aplicación Hono – guía 2026
+title: i18n Hono - Cómo traducir una aplicación Hono en 2026
 description: Descubra cómo hacer que su backend Hono sea multilingüe. Siga la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_lynx+react.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-03-09
 updatedAt: 2025-12-30
-title: Lynx y React i18n - Cómo traducir su aplicación Lynx – guía 2026
+title: Lynx + React i18n - Cómo traducir una aplicación Lynx en 2026
 description: Descubre cómo hacer que tu aplicación móvil Lynx y React sea multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirla.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_nestjs.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-09-09
 updatedAt: 2025-12-30
-title: NestJS i18n - Cómo traducir su aplicación NestJS – guía 2026
+title: NestJS i18n - Cómo traducir una aplicación NestJS en 2026
 description: Descubre cómo hacer que tu backend NestJS sea multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_next-i18next.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js y next-i18next i18n - Cómo traducir su aplicación Next.js – guía 2026
+title: next-i18next - Cómo traducir una aplicación Next.js (i18n) en 2026
 description: Una guía práctica y lista para producción para internacionalizar una app Next.js 15 App Router con i18next/next-i18next y mejorarla con Intlayer.
 keywords:
   - Internacionalización
@@ -37,7 +37,7 @@ applicationTemplate: https://github.com/aymericzip/intlayer-next-i18next-templat
 - Integración con Intlayer para automatizar flujos de trabajo de traducción (tests, relleno con IA, sincronización JSON)
 
 > Nota: next-i18next está construido sobre i18next. Esta guía utiliza las primitivas de i18next compatibles con next-i18next en el App Router, manteniendo la arquitectura simple y lista para producción.
-> Para una comparación más amplia, consulta [next-i18next vs next-i18next vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/es/next-i18next_vs_next-i18next_vs_intlayer.md).
+> Para una comparación más amplia, consulta [next-i18next vs next-intl vs Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/blog/es/next-i18next_vs_next-intl_vs_intlayer.md).
 
 ---
 

package/docs/es/intlayer_with_next-intl.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2025-10-05
 updatedAt: 2025-10-05
-title: Next.js y next-intl i18n - Cómo traducir su aplicación Next.js – guía 2026
+title: next-intl - Cómo traducir una aplicación Next.js (i18n) en 2026
 description: Descubre cómo hacer tu sitio web Next.js 15 App Router multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_nextjs_14.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Cómo traducir su aplicación Next.js 14 – guía 2026
+title: Next.js i18n - Cómo traducir una aplicación Next.js 14 en 2026
 description: Descubre cómo hacer tu sitio web Next.js 14 App Router multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_nextjs_15.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Cómo traducir su aplicación Next.js 15 – guía 2026
+title: Next.js i18n - Cómo traducir una aplicación Next.js 15 en 2026
 description: Descubre cómo hacer tu sitio web Next.js 15 multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización

package/docs/es/intlayer_with_nextjs_16.md

@@ -1,7 +1,7 @@
 ---
 createdAt: 2024-12-06
 updatedAt: 2025-12-30
-title: Next.js i18n - Cómo traducir su aplicación Next.js 16 – guía 2026
+title: Next.js i18n - Cómo traducir una aplicación Next.js 16 en 2026
 description: Descubre cómo hacer que tu sitio web Next.js 16 sea multilingüe. Sigue la documentación para internacionalizar (i18n) y traducirlo.
 keywords:
   - Internacionalización
@@ -710,6 +710,8 @@ const ServerComponentExample = () => {
 
 > Para aprender más sobre el hook `useIntlayer`, consulta la [documentación](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/packages/next-intlayer/useIntlayer.md).
 
+> Si su aplicación ya existe, puede utilizar el [Compilador Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/compiler.md), así como el [comando de extracción](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/cli/extract.md), para transformar miles de componentes en un segundo.
+
 ### (Opcional) Paso 7: Configurar Proxy para la Detección de Idioma
 
 Configura un proxy para detectar el idioma preferido del usuario: