# General Translation Integrations: paraglide-context URL: https://generaltranslation.com/it/docs/integrations/paraglide/reference/paraglide-context.mdx Docs index: https://generaltranslation.com/llms.txt Description: Scrive nei file di metadati il codice sorgente che circonda ogni utilizzo di un messaggio Paraglide JS. Riferimento API per il comando paraglide-context. Il comando viene installato insieme a `@generaltranslation/paraglide-js`. Ogni esecuzione analizza l'app, scrive i file di metadati e termina. Eseguilo prima di [`gt translate`](/docs/cli/reference/commands/translate). ## Panoramica [#overview] ```bash npx paraglide-context [root] [options] ``` `root` è il progetto, o una sua directory. Il valore predefinito è la directory di lavoro. Ogni percorso passato a un flag è relativo alla radice del progetto, ovvero il `package.json` più vicino a partire da `root`, risalendo verso l'alto. [`collectContext`](/docs/integrations/paraglide/reference/collect-context) fa lo stesso dal codice e accetta le stesse opzioni. ## Come funziona [#how-it-works] * Seleziona i file sorgente, ne risolve le importazioni e individua ogni utilizzo di un messaggio Paraglide JS. (Vedi [Rilevamento degli utilizzi](/docs/integrations/paraglide/reference/usage-detection)). * Scrive un file di metadati accanto a ogni file di messaggi dell'impostazione regionale di base, ad esempio `messages/en.metadata.json`. (Vedi [File di metadati](/docs/integrations/paraglide/reference/metadata-files)). * Non esegue mai il bundler dell'app. Gli alias di importazione vengono letti da `tsconfig.json`, `package.json` e dalla config di Vite, webpack o rspack. * Mostra un avviso per ogni elemento ignorato. Gli avvisi non influiscono sul codice di uscita. ## Flag [#flags] Ogni flag imposta un'opzione di [`collectContext`](/docs/integrations/paraglide/reference/collect-context#options), dove il relativo comportamento è documentato in modo completo. Per passare più valori, ripeti un flag contrassegnato come *ripetibile*. | Parametro | Descrizione | Tipo | Facoltativo | Predefinito | | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ----------- | --------------------------------------------- | | `[root]` | Il progetto o una sua directory. Imposta [`root`](/docs/integrations/paraglide/reference/collect-context#root). | `string` | Sì | Directory di lavoro | | `--include ` | Percorso o glob da analizzare. Ripetibile. Imposta [`include`](/docs/integrations/paraglide/reference/collect-context#include). | `string[]` | Sì | L'intero progetto | | `--exclude ` | Percorso o glob da escludere. Ripetibile. Imposta [`exclude`](/docs/integrations/paraglide/reference/collect-context#exclude). | `string[]` | Sì | Test e file di configurazione degli strumenti | | `--outdir ` | Directory di output di Paraglide JS da usare senza verifica. Ripetibile. Imposta [`outdirs`](/docs/integrations/paraglide/reference/collect-context#outdirs). | `string[]` | Sì | Rilevata automaticamente | | `--project ` | Progetto inlang per i cui messaggi vengono generati file di metadati. Ripetibile. Imposta [`inlangProjects`](/docs/integrations/paraglide/reference/collect-context#inlang-projects). | `string[]` | Sì | Rilevato automaticamente | | `--alias ` | Alias di importazione, ad esempio `~=./src`. Una sostituzione che inizia con `.` si risolve a partire dalla radice del progetto. Ripetibile. Imposta [`alias`](/docs/integrations/paraglide/reference/collect-context#alias). | `string[]` | Sì | — | | `--no-bundler-config` | Non legge gli alias dalla config di un bundler. Imposta [`bundlerConfigs`](/docs/integrations/paraglide/reference/collect-context#bundler-configs) su `[]`. | `boolean` | Sì | `false` | | `--radius ` | Righe di contesto sopra e sotto ogni utilizzo. Un intero non negativo. Imposta [`radius`](/docs/integrations/paraglide/reference/collect-context#radius). | `number` | Sì | `10` | | `--verbose` | Stampa un riepilogo: gli utilizzi trovati, i file analizzati, le directory di output usate e la config da cui sono stati letti gli alias. | `boolean` | Sì | `false` | | `-h, --help` | Mostra le istruzioni d'uso. | `boolean` | Sì | `false` | Le opzioni `targets`, `languages`, `autoImports`, `conditions` e `rootDirectory` non hanno un flag corrispondente. Puoi impostarle con [`collectContext`](/docs/integrations/paraglide/reference/collect-context). ## Esempio [#example] ```bash # Analizza l'app nella directory di lavoro npx paraglide-context # Analizza una singola app di un monorepo, mostrando un riepilogo npx paraglide-context apps/web --verbose # Analizza src e un pacchetto condiviso, con 5 righe di contesto npx paraglide-context --include src --include ../shared --radius 5 # Dichiara un alias e ignora la config del bundler npx paraglide-context --alias ~=./src --no-bundler-config ``` ## Altre note [#notes] | Codice di uscita | Significato | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `0` | L'esecuzione è terminata, con o senza avvisi. | | `1` | Un errore ha interrotto l'esecuzione, ad esempio l'impossibilità di scrivere un file di metadati. L'errore viene stampato. | | `2` | Flag sconosciuto, valore mancante, più di un `root` oppure un valore di `--radius` che non è un intero non negativo. Vengono stampate le istruzioni d'uso. | * Gli avvisi iniziano con `[paraglide-context]` e vengono scritti su standard error. * Un file di metadati viene scritto solo se il suo contenuto cambia, quindi una seconda esecuzione senza modifiche alla sorgente non scrive nulla. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.