# General Translation Integrations: paraglide-context URL: https://generaltranslation.com/es/docs/integrations/paraglide/reference/paraglide-context.mdx Docs index: https://generaltranslation.com/llms.txt Description: Escribe en archivos de metadatos el código fuente que rodea cada uso de un mensaje de Paraglide JS. Referencia de la API del comando paraglide-context. El comando se instala con `@generaltranslation/paraglide-js`. Cada ejecución analiza la aplicación, escribe los archivos de metadatos y termina. Ejecútalo antes de [`gt translate`](/docs/cli/reference/commands/translate). ## Descripción general [#overview] ```bash npx paraglide-context [root] [options] ``` `root` es el proyecto o un directorio dentro de él. De forma predeterminada, es el directorio de trabajo. Todas las rutas que recibe una opción son relativas a la raíz del proyecto, es decir, al `package.json` más cercano en `root` o en un nivel superior. [`collectContext`](/docs/integrations/paraglide/reference/collect-context) hace lo mismo desde el código y acepta las mismas opciones. ## Cómo funciona [#how-it-works] * Selecciona los archivos de origen, resuelve sus importaciones y localiza todos los usos de mensajes de Paraglide JS. (Consulta [Detección de usos](/docs/integrations/paraglide/reference/usage-detection)). * Escribe un archivo de metadatos junto a cada archivo de mensajes de la configuración regional base, como `messages/en.metadata.json`. (Consulta [Archivos de metadatos](/docs/integrations/paraglide/reference/metadata-files)). * Nunca ejecuta el empaquetador de la aplicación. Los alias de importación se leen de `tsconfig.json`, `package.json` y de la configuración de Vite, webpack o rspack. * Muestra advertencias de todo lo que haya omitido. Las advertencias no modifican el código de salida. ## Opciones [#flags] Cada opción de línea de comandos configura una opción de [`collectContext`](/docs/integrations/paraglide/reference/collect-context#options), donde se documenta su comportamiento en detalle. Para pasar varios valores, repite la opción marcada como *repetible*. | Parámetro | Descripción | Tipo | Opcional | Predeterminado | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | -------- | ----------------------------------------- | | `[root]` | El proyecto o un directorio dentro de él. Establece [`root`](/docs/integrations/paraglide/reference/collect-context#root). | `string` | Sí | Directorio de trabajo | | `--include ` | Ruta o patrón glob que se analizará. Repetible. Establece [`include`](/docs/integrations/paraglide/reference/collect-context#include). | `string[]` | Sí | Todo el proyecto | | `--exclude ` | Ruta o patrón glob que se omitirá. Repetible. Establece [`exclude`](/docs/integrations/paraglide/reference/collect-context#exclude). | `string[]` | Sí | Pruebas y configuraciones de herramientas | | `--outdir ` | Directorio de salida de Paraglide JS que se usará sin verificación. Repetible. Establece [`outdirs`](/docs/integrations/paraglide/reference/collect-context#outdirs). | `string[]` | Sí | Detectado | | `--project ` | Proyecto de inlang para cuyos mensajes se generan archivos de metadatos. Repetible. Establece [`inlangProjects`](/docs/integrations/paraglide/reference/collect-context#inlang-projects). | `string[]` | Sí | Detectado | | `--alias ` | Alias de importación, como `~=./src`. Un reemplazo que empieza por `.` se resuelve desde la raíz del proyecto. Repetible. Establece [`alias`](/docs/integrations/paraglide/reference/collect-context#alias). | `string[]` | Sí | — | | `--no-bundler-config` | No lee alias de la configuración del empaquetador. Establece [`bundlerConfigs`](/docs/integrations/paraglide/reference/collect-context#bundler-configs) en `[]`. | `boolean` | Sí | `false` | | `--radius ` | Líneas de contexto por encima y por debajo de cada uso. Debe ser un entero no negativo. Establece [`radius`](/docs/integrations/paraglide/reference/collect-context#radius). | `number` | Sí | `10` | | `--verbose` | Muestra un resumen: los usos encontrados, los archivos analizados, los directorios de salida utilizados y la configuración de la que se leyeron los alias. | `boolean` | Sí | `false` | | `-h, --help` | Muestra el texto de uso. | `boolean` | Sí | `false` | Las opciones `targets`, `languages`, `autoImports`, `conditions` y `rootDirectory` no tienen equivalente en la línea de comandos. Configúralas con [`collectContext`](/docs/integrations/paraglide/reference/collect-context). ## Ejemplo [#example] ```bash # Analiza la aplicación del directorio de trabajo npx paraglide-context # Analiza una sola aplicación de un monorepo, con un resumen npx paraglide-context apps/web --verbose # Analiza src y un paquete compartido, con 5 líneas de contexto npx paraglide-context --include src --include ../shared --radius 5 # Declara un alias y omite la configuración del empaquetador npx paraglide-context --alias ~=./src --no-bundler-config ``` ## Otras notas [#notes] | Código de salida | Significado | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `0` | La ejecución terminó, con o sin advertencias. | | `1` | Un error detuvo la ejecución; por ejemplo, no se pudo escribir un archivo de metadatos. Se muestra el error. | | `2` | Opción desconocida, falta un valor, se indicó más de un `root` o el valor de `--radius` no es un entero no negativo. Se muestra el texto de uso. | * Las advertencias empiezan por `[paraglide-context]` y se envían a la salida de error estándar. * Un archivo de metadatos solo se escribe si su contenido cambia, de modo que una segunda ejecución sin cambios en el origen no escribe nada. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.