@intlayer/docs 5.5.12 → 5.7.0

package/docs/es/intlayer_cli.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
+updatedAt: 2025-07-11
 title: CLI
 description: Descubre cómo usar el CLI de Intlayer para gestionar tu sitio web multilingüe. Sigue los pasos en esta documentación en línea para configurar tu proyecto en pocos minutos.
 keywords:
@@ -18,7 +18,7 @@ slugs:
   - cli
 ---
 
-# CLI de Intlayer
+# Intlayer CLI
 
 ## Instalar Paquete
 
@@ -42,11 +42,11 @@ pnpm add intlayer-cli -g
 
 El paquete `intlayer-cli` tiene como objetivo transpilar tus [declaraciones de intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/dictionary/get_started.md) en diccionarios.
 
-Este paquete transpilará todos los archivos de intlayer, como `src/**/*.content.{ts|js|mjs|cjs|json}`. [Consulta cómo declarar tus archivos de declaración de Intlayer](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+Este paquete transpilará todos los archivos de intlayer, tales como `src/**/*.content.{ts|js|mjs|cjs|json}`. [Consulta cómo declarar tus archivos de declaración Intlayer](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
 
-Para interpretar los diccionarios de intlayer puedes usar intérpretes, como [react-intlayer](https://www.npmjs.com/package/react-intlayer) o [next-intlayer](https://www.npmjs.com/package/next-intlayer).
+Para interpretar los diccionarios de intlayer puedes usar intérpretes, como [react-intlayer](https://www.npmjs.com/package/react-intlayer), o [next-intlayer](https://www.npmjs.com/package/next-intlayer).
 
-## Soporte para Archivo de Configuración
+## Soporte para Archivos de Configuración
 
 Intlayer acepta múltiples formatos de archivo de configuración:
 
@@ -59,48 +59,6 @@ Intlayer acepta múltiples formatos de archivo de configuración:
 
 Para ver cómo configurar los locales disponibles u otros parámetros, consulta la [documentación de configuración aquí](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md).
 
-## SDK de CLI
-
-El SDK de CLI es una biblioteca que te permite usar la CLI de Intlayer en tu propio código.
-
-```bash packageManager="npm"
-npm install @intlayer/cli -D
-```
-
-```bash packageManager="yarn"
-yarn add @intlayer/cli -D
-```
-
-```bash packageManager="pnpm"
-pnpm add @intlayer/cli -D
-```
-
-Ejemplo de uso:
-
-```ts
-import {
-  push,
-  pull,
-  fill,
-  build,
-  docTranslate,
-  docReview,
-} from "@intlayer/cli";
-
-push();
-// ...
-pull();
-// ...
-fill();
-// ...
-build();
-// ...
-docTranslate();
-// ...
-docReview();
-// ...
-```
-
 ## Ejecutar comandos de intlayer
 
 ### Construir diccionarios
@@ -125,13 +83,13 @@ Este comando buscará tus archivos de contenido de declaración por defecto en `
 - `npx intlayer dictionary build`
 - `npx intlayer dic build`
 
-### Empujar diccionarios
+### Enviar diccionarios
 
 ```bash
 npx intlayer dictionary push
 ```
 
-Si tienes instalado el [editor de intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md), también puedes subir los diccionarios al editor. Este comando permitirá poner los diccionarios a disposición de [el editor](https://intlayer.org/dashboard). De esta manera, puedes compartir tus diccionarios con tu equipo y editar tu contenido sin modificar el código de tu aplicación.
+Si tienes instalado el [editor de intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md), también puedes enviar los diccionarios al editor. Este comando permitirá que los diccionarios estén disponibles en [el editor](https://intlayer.org/dashboard). De esta manera, puedes compartir tus diccionarios con tu equipo y editar tu contenido sin modificar el código de tu aplicación.
 
 ##### Alias:
 
@@ -141,30 +99,65 @@ Si tienes instalado el [editor de intlayer](https://github.com/aymericzip/intlay
 
 ##### Argumentos:
 
-- `-d`, `--dictionaries`: IDs de los diccionarios que se desean subir. Si no se especifica, se subirán todos los diccionarios.
+**Opciones de diccionario:**
+
+- **`-d`, `--dictionaries`**: IDs de los diccionarios a enviar. Si no se especifica, se enviarán todos los diccionarios.
+
   > Ejemplo: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
-- `-r`, `--deleteLocaleDictionary`: Omitir la pregunta que solicita eliminar los directorios de locales una vez que los diccionarios son enviados, y eliminarlos. Por defecto, si el diccionario está definido localmente, sobrescribirá el contenido de los diccionarios remotos.
+
+**Opciones de configuración:**
+
+- **`--base-dir`**: Especifica el directorio base del proyecto. Para obtener la configuración de intlayer, el comando buscará el archivo `intlayer.config.{ts,js,json,cjs,mjs}` en el directorio base.
+
+  > Ejemplo: `npx intlayer dictionary push --env-file .env.production.local`
+
+**Opciones de variables de entorno:**
+
+- **`--env`**: Especifica el entorno (por ejemplo, `development`, `production`). Útil en caso de que uses variables de entorno en tu archivo de configuración de intlayer.
+- **`--env-file`**: Proporciona un archivo de entorno personalizado desde el cual cargar variables. Útil en caso de que uses variables de entorno en tu archivo de configuración de intlayer.
+
+  > Ejemplo: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Ejemplo: `npx intlayer dictionary push --env production`
+
+**Opciones de salida:**
+
+- **`-r`, `--delete-locale-dictionary`**: Omitir la pregunta que solicita eliminar los directorios de locales una vez que los diccionarios se han enviado, y eliminarlos. Por defecto, si el diccionario está definido localmente, sobrescribirá el contenido de los diccionarios remotos.
+
   > Ejemplo: `npx intlayer dictionary push -r`
-- `-k`, `--keepLocaleDictionary`: Omitir la pregunta que solicita eliminar los directorios de locales una vez que los diccionarios son enviados, y conservarlos. Por defecto, si el diccionario está definido localmente, sobrescribirá el contenido de los diccionarios remotos.
+
+  > Ejemplo: `npx intlayer dictionary push --delete-locale-dictionary`
+
+- **`-k`, `--keep-locale-dictionary`**: Omitir la pregunta que solicita eliminar los directorios de locales una vez que los diccionarios se han enviado, y mantenerlos. Por defecto, si el diccionario está definido localmente, sobrescribirá el contenido de los diccionarios remotos.
+
   > Ejemplo: `npx intlayer dictionary push -k`
-- `--env`: Especificar el entorno (por ejemplo, `development`, `production`).
-- `--env-file`: Proporcionar un archivo de entorno personalizado para cargar variables.
-- `--base-dir`: Especificar el directorio base para el proyecto.
-- `--verbose`: Habilita el registro detallado para depuración.
-- `--git-diff`: Ejecuta solo en diccionarios que incluyen cambios desde la base (por defecto `origin/main`) hasta la rama actual (por defecto: `HEAD`).
-- `--git-diff-base`: Especifica la referencia base para git diff (por defecto `origin/main`).
-- `--git-diff-current`: Especifica la referencia actual para git diff (por defecto: `HEAD`).
-- `--uncommitted`: Incluye cambios no confirmados.
-- `--unpushed`: Incluye cambios no enviados.
-- `--untracked`: Incluye archivos no rastreados.
-
-### Extraer diccionarios remotos
+
+  > Ejemplo: `npx intlayer dictionary push --keep-locale-dictionary`
+
+**Opciones de registro:**
+
+- **`--verbose`**: Habilitar el registro detallado para depuración.
+
+**Opciones de Git:**
+
+- **`--git-diff`**: Ejecutar solo en diccionarios que incluyan cambios desde la base (por defecto `origin/main`) hasta la rama actual (por defecto: `HEAD`).
+- **`--git-diff-base`**: Especificar la referencia base para el diff de git (por defecto `origin/main`).
+- **`--git-diff-current`**: Especificar la referencia actual para el diff de git (por defecto `HEAD`).
+- **`--uncommitted`**: Incluir cambios no confirmados.
+- **`--unpushed`**: Incluir cambios no enviados.
+- **`--untracked`**: Incluir archivos no rastreados.
+
+  > Ejemplo: `npx intlayer dictionary push --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Ejemplo: `npx intlayer dictionary push --uncommitted --unpushed --untracked`
+
+### Descargar diccionarios remotos
 
 ```bash
 npx intlayer pull
 ```
 
-Si el [editor intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md) está instalado, también puedes extraer diccionarios desde el editor. De esta manera, puedes sobrescribir el contenido de tus diccionarios según las necesidades de tu aplicación.
+Si el [editor de intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/intlayer_visual_editor.md) está instalado, también puedes descargar diccionarios desde el editor. De esta manera, puedes sobrescribir el contenido de tus diccionarios según las necesidades de tu aplicación.
 
 ##### Alias:
 
@@ -174,13 +167,35 @@ Si el [editor intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/do
 
 ##### Argumentos:
 
-- `-d, --dictionaries`: IDs de los diccionarios a extraer. Si no se especifica, se extraerán todos los diccionarios.
+**Opciones de diccionario:**
+
+- **`-d, --dictionaries`**: IDs de los diccionarios a descargar. Si no se especifica, se descargarán todos los diccionarios.
+
   > Ejemplo: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
-- `--newDictionariesPath`: Ruta al directorio donde se guardarán los nuevos diccionarios. Si no se especifica, los nuevos diccionarios se guardarán en el directorio `./intlayer-dictionaries` del proyecto. Si en el contenido de tu diccionario se especifica un campo `filePath`, los diccionarios no considerarán este argumento y se guardarán en el directorio `filePath` especificado.
-- `--env`: Especifica el entorno (por ejemplo, `development`, `production`).
-- `--env-file`: Proporciona un archivo de entorno personalizado para cargar variables.
-- `--base-dir`: Especifica el directorio base para el proyecto.
-- `--verbose`: Habilita el registro detallado para depuración.
+
+**Opciones de configuración:**
+
+- **`--base-dir`**: Especifica el directorio base para el proyecto. Para obtener la configuración de intlayer, el comando buscará el archivo `intlayer.config.{ts,js,json,cjs,mjs}` en el directorio base.
+
+  > Ejemplo: `npx intlayer dictionary push --env-file .env.production.local`
+
+**Opciones de variables de entorno:**
+
+- **`--env`**: Especifica el entorno (por ejemplo, `development`, `production`).
+- **`--env-file`**: Proporciona un archivo de entorno personalizado para cargar variables.
+- **`--base-dir`**: Especifica el directorio base para el proyecto. Para obtener la configuración de intlayer, el comando buscará el archivo `intlayer.config.{ts,js,json,cjs,mjs}` en el directorio base.
+
+  > Ejemplo: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > Ejemplo: `npx intlayer dictionary push --env production`
+
+**Opciones de salida:**
+
+- **`--new-dictionaries-path`**: Ruta al directorio donde se guardarán los nuevos diccionarios. Si no se especifica, los nuevos diccionarios se guardarán en el directorio `./intlayer-dictionaries` del proyecto. Si en el contenido de tu diccionario se especifica un campo `filePath`, los diccionarios no considerarán este argumento y se guardarán en el directorio `filePath` especificado.
+
+**Opciones de registro:**
+
+- **`--verbose`**: Habilita el registro detallado para depuración.
 
 ##### Ejemplo:
 
@@ -194,7 +209,7 @@ npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
 npx intlayer fill
 ```
 
-Este comando analiza tus archivos de declaración de contenido en busca de posibles problemas, como traducciones faltantes, inconsistencias estructurales o incompatibilidades de tipo. Si encuentra algún problema, **intlayer fill** propondrá o aplicará actualizaciones para mantener tus diccionarios consistentes y completos.
+Este comando analiza tus archivos de declaración de contenido en busca de posibles problemas como traducciones faltantes, inconsistencias estructurales o incompatibilidades de tipos. Si encuentra algún problema, **intlayer fill** propondrá o aplicará actualizaciones para mantener tus diccionarios consistentes y completos.
 
 ##### Alias:
 
@@ -204,76 +219,74 @@ Este comando analiza tus archivos de declaración de contenido en busca de posib
 
 ##### Argumentos:
 
-- `-f, --file [files...]`
-  Una lista de archivos específicos de declaración de contenido para auditar. Si no se proporciona, se auditarán todos los archivos `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` descubiertos.
+**Opciones de lista de archivos:**
+
+- **`-f, --file [files...]`**: Una lista de archivos específicos de declaración de contenido para auditar. Si no se proporciona, se auditarán todos los archivos `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` descubiertos según la configuración de tu archivo.
+
+  > Ejemplo: `npx intlayer dictionary fill -f src/home/app.content.ts`
 
-- `--exclude [excludedGlobs...]`
-  Patrón de globs para excluir de la auditoría (por ejemplo, `--exclude "src/test/**"`).
+- **`-k, --keys [keys...]`**: Filtra los diccionarios basándose en claves. Si no se proporciona, se auditarán todos los diccionarios.
 
-- `--source-locale [sourceLocale]`
-  El locale de origen desde el cual traducir. Si no se especifica, se usará el locale predeterminado de tu configuración.
+  > Ejemplo: `npx intlayer dictionary fill -k key1 key2`
 
-- `--output-locales [outputLocales...]`
-  Locales de destino a los cuales traducir. Si no se especifica, se usarán todos los locales de tu configuración excepto el locale de origen.
+- **`--excluded-keys [excludedKeys...]`**: Excluye diccionarios basándose en claves. Si no se proporciona, se auditarán todos los diccionarios.
 
-- `--mode [mode]`
-  Modo de traducción: 'complete', 'review' o 'missing-only'. El valor predeterminado es 'missing-only'.
+  > Ejemplo: `npx intlayer dictionary fill --excluded-keys key1 key2`
 
-- `--git-diff`
-  Filtra los diccionarios que incluyen cambios desde la base (por defecto `origin/main`) hasta la rama actual (por defecto: `HEAD`).
+- **`--path-filter [pathFilters...]`**: Filtra diccionarios basándose en un patrón glob para rutas de archivos.
 
-- `--git-diff-base`
-  Especifica la referencia base para git diff (por defecto `origin/main`).
+  > Ejemplo: `npx intlayer dictionary fill --path-filter "src/home/**"`
 
-- `--git-diff-current`
-  Especifica la referencia actual para git diff (por defecto: `HEAD`).
+**Opciones de salida de entrada:**
 
-- `--uncommitted`
-  Filtra los diccionarios que incluyen cambios no confirmados.
+- **`--source-locale [sourceLocale]`**: La localización origen desde la cual traducir. Si no se especifica, se usará la localización predeterminada de tu configuración.
 
-- `--unpushed`
-  Filtra diccionarios que incluyen cambios no enviados.
+- **`--output-locales [outputLocales...]`**: Locales de destino para traducir. Si no se especifica, se usarán todas las locales de tu configuración excepto la local de origen.
 
-- `--untracked`
-  Filtra diccionarios que incluyen archivos no rastreados.
+- **`--mode [mode]`**: Modo de traducción: 'complete' (completo), 'review' (revisión) o 'missing-only' (solo faltantes). El valor predeterminado es 'missing-only'.
 
-- `--keys [keys...]`
-  Filtra diccionarios basados en claves especificadas.
+**Opciones de Git:**
 
-- `--excluded-keys [excludedKeys...]`
-  Excluye diccionarios basados en claves especificadas.
+- **`--git-diff`**: Ejecutar solo en diccionarios que incluyan cambios desde la base (por defecto `origin/main`) hasta la rama actual (por defecto: `HEAD`).
+- **`--git-diff-base`**: Especificar la referencia base para el diff de git (por defecto `origin/main`).
+- **`--git-diff-current`**: Especificar la referencia actual para el diff de git (por defecto: `HEAD`).
+- **`--uncommitted`**: Incluir cambios no confirmados.
+- **`--unpushed`**: Incluir cambios no enviados.
+- **`--untracked`**: Incluir archivos no rastreados.
 
-- `--path-filter [pathFilters...]`
-  Filtra diccionarios basados en un patrón glob para rutas de archivos.
+  > Ejemplo: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
 
-- `--model [model]`
-  El modelo de IA a usar para la traducción (por ejemplo, `gpt-3.5-turbo`).
+  > Ejemplo: `npx intlayer doc translate --uncommitted --unpushed --untracked`
 
-- `--provider [provider]`
-  El proveedor de IA a usar para la traducción.
+**Opciones de IA:**
 
-- `--temperature [temperature]`
-  Configuración de temperatura para el modelo de IA.
+- **`--model [model]`**: El modelo de IA a utilizar para la traducción (por ejemplo, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: El proveedor de IA a utilizar para la traducción.
+- **`--temperature [temperature]`**: Configuración de temperatura para el modelo de IA.
+- **`--api-key [apiKey]`**: Proporciona tu propia clave API para el servicio de IA.
+- **`--custom-prompt [prompt]`**: Proporciona un prompt personalizado para tus instrucciones de traducción.
+- **`--application-context [applicationContext]`**: Proporciona contexto adicional para la traducción de IA.
+
+  > Ejemplo: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "Mi aplicación es una tienda de gatos"`
+
+**Opciones de variables de entorno:**
+
+- **`--env`**: Especificar el entorno (por ejemplo, `development`, `production`).
+- **`--env-file [envFile]`**: Proporcionar un archivo de entorno personalizado para cargar variables.
+
+  > Ejemplo: `npx intlayer fill --env-file .env.production.local`
 
-- `--api-key [apiKey]`
-  Proporciona tu propia clave API para el servicio de IA.
+  > Ejemplo: `npx intlayer fill --env production`
 
-- `--custom-prompt [prompt]`
-  Proporciona un prompt personalizado para tus instrucciones de traducción.
-- `--application-context [applicationContext]`
-  Proporciona contexto adicional para la traducción por IA.
+**Opciones de configuración:**
 
-- `--env`
-  Especifica el entorno (por ejemplo, `development`, `production`).
+- **`--base-dir`**: Especificar el directorio base para el proyecto.
 
-- `--env-file [envFile]`
-  Proporciona un archivo de entorno personalizado para cargar variables.
+  > Ejemplo: `npx intlayer fill --base-dir ./src`
 
-- `--base-dir`
-  Especifica el directorio base para el proyecto.
+**Opciones de registro:**
 
-- `--verbose`
-  Activa el registro detallado para depuración.
+- **`--verbose`**: Habilitar registros detallados para depuración.
 
 ##### Ejemplo:
 
@@ -287,7 +300,7 @@ Este comando traducirá el contenido del inglés al francés y español para tod
 
 #### Obtener Configuración
 
-El comando `configuration get` recupera la configuración actual para Intlayer, particularmente los ajustes de localización. Esto es útil para verificar tu configuración.
+El comando `configuration get` recupera la configuración actual de Intlayer, particularmente las configuraciones de localización. Esto es útil para verificar tu configuración.
 
 ```bash
 npx intlayer configuration get
@@ -300,8 +313,8 @@ npx intlayer configuration get
 
 ##### Argumentos:
 
-- **`--env`**: Especifica el entorno (por ejemplo, `development`, `production`).
-- **`--env-file`**: Proporciona un archivo de entorno personalizado para cargar variables.
+- **`--env`**: Especificar el entorno (por ejemplo, `development`, `production`).
+- **`--env-file`**: Proporcionar un archivo de entorno personalizado para cargar variables desde él.
 - **`--base-dir`**: Especifica el directorio base para el proyecto.
 - **`--verbose`**: Habilita el registro detallado para depuración.
 
@@ -322,10 +335,10 @@ npx intlayer configuration push
 
 - **`--env`**: Especifica el entorno (por ejemplo, `development`, `production`).
 - **`--env-file`**: Proporciona un archivo de entorno personalizado para cargar variables.
-- **`--base-dir`**: Especifica el directorio base del proyecto.
-- **`--verbose`**: Activa el registro detallado para depuración.
+- **`--base-dir`**: Especifica el directorio base para el proyecto.
+- **`--verbose`**: Habilita el registro detallado para depuración.
 
-Al enviar la configuración, tu proyecto queda completamente integrado con el CMS de Intlayer, permitiendo una gestión fluida del diccionario entre equipos.
+Al enviar la configuración, su proyecto queda completamente integrado con el CMS de Intlayer, lo que permite una gestión fluida de los diccionarios entre equipos.
 
 ### Gestión de Documentación
 
@@ -333,7 +346,7 @@ Los comandos `doc` proporcionan herramientas para gestionar y traducir archivos
 
 #### Traducir Documentación
 
-El comando `doc translate` traduce automáticamente los archivos de documentación desde una localidad base a localidades objetivo utilizando servicios de traducción AI.
+El comando `doc translate` traduce automáticamente archivos de documentación desde un locale base a locales destino utilizando servicios de traducción por IA.
 
 ```bash
 npx intlayer doc translate
@@ -341,39 +354,99 @@ npx intlayer doc translate
 
 ##### Argumentos:
 
+**Opciones de lista de archivos:**
+
 - **`--doc-pattern [docPattern...]`**: Patrones glob para coincidir con los archivos de documentación a traducir.
+
   > Ejemplo: `npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
 - **`--excluded-glob-pattern [excludedGlobPattern...]`**: Patrones glob para excluir de la traducción.
+
   > Ejemplo: `npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"`
-- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Número de archivos a procesar simultáneamente para la traducción.
-  > Ejemplo: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Omitir el archivo si ha sido modificado antes del tiempo dado.
+
+  - Puede ser un tiempo absoluto como "2025-12-05" (cadena o Date)
+  - Puede ser un tiempo relativo en ms `1 * 60 * 60 * 1000` (1 hora)
+  - Esta opción verifica la hora de actualización del archivo usando el método `fs.stat`. Por lo tanto, podría verse afectada por Git u otras herramientas que modifiquen el archivo.
+
+  > Ejemplo: `npx intlayer doc translate --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Omitir el archivo si ha sido modificado dentro del tiempo dado.
+
+  - Puede ser una hora absoluta como "2025-12-05" (cadena o Date)
+  - Puede ser una hora relativa en ms `1 * 60 * 60 * 1000` (1 hora)
+  - Esta opción verifica la hora de actualización del archivo usando el método `fs.stat`. Por lo tanto, podría verse afectada por Git u otras herramientas que modifiquen el archivo.
+
+  > Ejemplo: `npx intlayer doc translate --skip-if-modified-after "2025-12-05"`
+
+**Opciones de salida de entrada:**
+
 - **`--locales [locales...]`**: Locales de destino para traducir la documentación.
+
   > Ejemplo: `npx intlayer doc translate --locales fr es de`
+
 - **`--base-locale [baseLocale]`**: Locale de origen desde el cual traducir.
+
   > Ejemplo: `npx intlayer doc translate --base-locale en`
-- **`--model [model]`**: El modelo de IA a usar para la traducción (por ejemplo, `gpt-3.5-turbo`).
-- **`--provider [provider]`**: El proveedor de IA a usar para la traducción.
+
+**Opciones de procesamiento de archivos:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Número de archivos a procesar simultáneamente para la traducción.
+
+  > Ejemplo: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+**Opciones de IA:**
+
+- **`--model [model]`**: El modelo de IA a utilizar para la traducción (por ejemplo, `gpt-3.5-turbo`).
+- **`--provider [provider]`**: El proveedor de IA a utilizar para la traducción.
 - **`--temperature [temperature]`**: Configuración de temperatura para el modelo de IA.
 - **`--api-key [apiKey]`**: Proporciona tu propia clave API para el servicio de IA.
-- **`--custom-prompt [prompt]`**: Proporciona un prompt personalizado para las instrucciones de traducción.
-- **`--application-context [applicationContext]`**: Proporciona contexto adicional para la traducción por IA.
+- **`--application-context [applicationContext]`**: Proporciona contexto adicional para la traducción de IA.
+- **`--custom-prompt [prompt]`**: Personaliza el prompt base utilizado para la traducción. (Nota: Para la mayoría de los casos de uso, se recomienda en su lugar la opción `--custom-instructions`, ya que proporciona un mejor control sobre el comportamiento de la traducción).
+
+  > Ejemplo: `npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "Mi aplicación es una tienda de gatos"`
+
+**Opciones de variables de entorno:**
+
 - **`--env`**: Especifica el entorno (por ejemplo, `development`, `production`).
-- **`--env-file [envFile]`**: Proporciona un archivo de entorno personalizado para cargar variables.
+- **`--env-file [envFile]`**: Proporciona un archivo de entorno personalizado desde el cual cargar variables.
 - **`--base-dir`**: Especifica el directorio base para el proyecto.
-- **`--verbose`**: Habilita el registro detallado para depuración.
+
+  > Ejemplo: `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
+
+**Opciones de registro:**
+
+- **`--verbose`**: Habilitar el registro detallado para depuración.
+
+  > Ejemplo: `npx intlayer doc translate --verbose`
+
+**Opciones de instrucciones personalizadas:**
+
 - **`--custom-instructions [customInstructions]`**: Instrucciones personalizadas añadidas al prompt. Útil para aplicar reglas específicas respecto al formato, traducción de URLs, etc.
 
-##### Ejemplo:
+  - Puede ser un tiempo absoluto como "2025-12-05" (cadena o Date)
+  - Puede ser un tiempo relativo en ms `1 * 60 * 60 * 1000` (1 hora)
+  - Esta opción verifica la hora de actualización del archivo usando el método `fs.stat`. Por lo tanto, podría verse afectada por Git u otras herramientas que modifiquen el archivo.
 
-```bash
-npx intlayer doc translate
-  --doc-pattern "docs/en/**/*.md"
-  --base-locale en --locales fr es
-  --model chatgpt-4o-latest
-  --custom-instructions "$(cat ./instructions.md)"
-```
+  > Ejemplo: `npx intlayer doc translate --custom-instructions "Evitar traducir URLs y mantener el formato markdown"`
+
+  > Ejemplo: `npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"`
+
+**Opciones de Git:**
+
+- **`--git-diff`**: Ejecutar solo en diccionarios que incluyan cambios desde la base (por defecto `origin/main`) hasta la rama actual (por defecto: `HEAD`).
+- **`--git-diff-base`**: Especificar la referencia base para el git diff (por defecto `origin/main`).
+- **`--git-diff-current`**: Especificar la referencia actual para el git diff (por defecto: `HEAD`).
+- **`--uncommitted`**: Incluir cambios no confirmados.
+- **`--unpushed`**: Incluir cambios no enviados.
+- **`--untracked`**: Incluir archivos no rastreados.
 
-> Nota que la ruta del archivo de salida se determinará reemplazando los siguientes patrones
+  > Ejemplo: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Ejemplo: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+> Ten en cuenta que la ruta del archivo de salida se determinará reemplazando los siguientes patrones
 >
 > - `/{{baseLocale}}/` por `/{{locale}}/` (Unix)
 > - `\{{baseLocale}}\` por `\{{locale}}\` (Windows)
@@ -381,31 +454,32 @@ npx intlayer doc translate
 > - `{{baseLocale}}_` por `{{locale}}_`
 > - `.{{baseLocaleName}}.` por `.{{localeName}}.`
 >
-> Si el patrón no se encuentra, el archivo de salida añadirá `.{{locale}}` en la extensión del archivo. Por ejemplo, `./my/file.md` se traducirá a `./my/file.fr.md` para la configuración regional francesa.
+> Si no se encuentra el patrón, el archivo de salida añadirá `.{{locale}}` en la extensión del archivo. Por ejemplo, `./my/file.md` se traducirá a `./my/file.fr.md` para el idioma francés.
 
 #### Revisar Documentación
 
-El comando `doc review` analiza los archivos de documentación para verificar calidad, consistencia y completitud en diferentes configuraciones regionales.
+El comando `doc review` analiza los archivos de documentación para verificar la calidad, consistencia y completitud entre diferentes locales.
 
 ```bash
 npx intlayer doc review
 ```
 
-##### Argumentos:
+Puede usarse para revisar archivos que ya están traducidos y para comprobar si la traducción es correcta.
 
-El comando `doc review` acepta los mismos argumentos que `doc translate`, permitiéndote revisar archivos de documentación específicos y aplicar controles de calidad.
+Para la mayoría de los casos de uso,
 
-##### Ejemplo:
+- prefiera usar `doc translate` cuando la versión traducida de este archivo no esté disponible.
+- prefiera usar `doc review` cuando la versión traducida de este archivo ya exista.
 
-```bash
-npx intlayer doc review
- --doc-pattern "docs/es/**/*.md"
- --locales fr es de
- --model chatgpt-4o-latest
- --custom-instructions "$(cat ./instructions.md)"
-```
+> Tenga en cuenta que el proceso de revisión consume más tokens de entrada que el proceso de traducción para revisar el mismo archivo en su totalidad. Sin embargo, el proceso de revisión optimizará los fragmentos a revisar y omitirá las partes que no hayan cambiado.
+
+##### Argumentos:
+
+El comando `doc review` acepta los mismos argumentos que `doc translate`, permitiéndole revisar archivos de documentación específicos y aplicar controles de calidad.
+
+Si activaste una de las opciones de git, el comando solo revisará la parte de los archivos que están siendo modificados. El script procesará dividiendo el archivo en fragmentos y revisará cada fragmento. Si no hay cambios en el fragmento, el script lo omitirá para acelerar el proceso de revisión y limitar el costo de la API del proveedor de IA.
 
-## Usar comandos de intlayer en tu `package.json`
+## Usa los comandos de intlayer en tu `package.json`
 
 ```json fileName="package.json"
 "scripts": {
@@ -419,18 +493,60 @@ npx intlayer doc review
 }
 ```
 
+## SDK de CLI
+
+El SDK de CLI es una biblioteca que te permite usar el CLI de Intlayer en tu propio código.
+
+```bash packageManager="npm"
+npm install @intlayer/cli --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli --save-dev
+```
+
+Ejemplo de uso:
+
+```ts
+import {
+  push,
+  pull,
+  fill,
+  build,
+  docTranslate,
+  docReview,
+} from "@intlayer/cli";
+
+push();
+// ...
+pull();
+// ...
+fill();
+// ...
+build();
+// ...
+docTranslate();
+// ...
+docReview();
+// ...
+```
+
 ## Depurar comando intlayer
 
-### 1. **Asegúrate de usar la última versión**
+### 1. **Asegúrate de estar usando la última versión**
 
 Ejecuta:
 
 ```bash
-npx intlayer --version                  # versión actual de intlayer para la configuración regional
-npx intlayer@latest --version           # última versión disponible de intlayer
+npx intlayer --version                  # versión actual de intlayer en el locale
+npx intlayer@latest --version           # versión más reciente de intlayer
 ```
 
-### 2. **Verificar si el comando está registrado**
+### 2. **Verifica si el comando está registrado**
 
 Puedes verificar con:
 
@@ -441,7 +557,7 @@ npx intlayer dictionary build --help    # Muestra la lista de opciones disponibl
 
 ### 3. **Reinicia tu terminal**
 
-A veces es necesario reiniciar el terminal para que reconozca los nuevos comandos.
+A veces es necesario reiniciar el terminal para que reconozca nuevos comandos.
 
 ### 4. **Limpia la caché de npx (si estás atascado con una versión antigua)**
 
@@ -449,6 +565,9 @@ A veces es necesario reiniciar el terminal para que reconozca los nuevos comando
 npx clear-npx-cache
 ```
 
-## Historial de la documentación
+## Historial del documento
 
-- 5.5.10 - 2025-06-29: Historial inicial
+| Versión | Fecha      | Cambios                                                         |
+| ------- | ---------- | --------------------------------------------------------------- |
+| 5.5.11  | 2025-07-11 | Actualización de la documentación de parámetros de comandos CLI |
+| 5.5.10  | 2025-06-29 | Historial inicial                                               |

package/docs/es/intlayer_visual_editor.md

@@ -15,6 +15,7 @@ slugs:
   - doc
   - concept
   - editor
+youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 ---
 
 # Documentación del Editor Visual de Intlayer

package/docs/es/intlayer_with_angular.md

@@ -13,6 +13,7 @@ slugs:
   - doc
   - environment
   - angular
+# applicationTemplate: https://github.com/aymericzip/intlayer-angular-template
 ---
 
 # Primeros pasos con la internacionalización (i18n) en Angular usando Intlayer