# gt: General Translation CLI tool: gt validate URL: https://generaltranslation.com/it/docs/cli/reference/commands/validate.mdx Docs index: https://generaltranslation.com/llms.txt Description: Controlla un progetto General Translation per individuare errori di traduzione senza chiamare l'API. Riferimento API per il comando gt validate. Analizza il progetto alla ricerca di contenuti inline — come i componenti [``](/docs/react/reference/components/t) e le chiamate a [`useGT`](/docs/react/reference/hooks/use-gt) — e delle voci del dizionario, quindi verifica l'eventuale presenza di problemi che impedirebbero una traduzione corretta. Non chiama l'API di General Translation, quindi può essere eseguito in sicurezza in qualsiasi momento, anche durante lo sviluppo e in CI. Poiché termina con un codice di stato diverso da zero in caso di errori, funziona bene come controllo CI. *Nota: disponibile per i framework e le librerie inline — `gt-next`, `gt-react`, `gt-react-native`, `gt-tanstack-start`, `gt-node`, `gt-flask` e `gt-fastapi`. Non è registrato per i progetti base (non framework).* Valida l'intero progetto oppure passa i percorsi dei file per validare solo tali file. ```bash npx gt validate npx gt validate src/components/Header.tsx src/pages/Home.tsx ``` ## Cosa controlla [#checks] * **Contenuti inline** nei glob `src` — componenti [``](/docs/react/reference/components/t), chiamate [`useGT`](/docs/react/reference/hooks/use-gt)/[`useTranslations`](/docs/react/reference/hooks/use-translations) e altri pattern di traduzione inline — per individuare errori di sintassi che impedirebbero la traduzione. * **Voci del dizionario** — analizza il file del dizionario (in `dictionary.[js|json|ts]` in `./` o `./src` quando `--dictionary` non è impostato) per verificare che la sintassi sia corretta. `validate` non chiama mai l'API di General Translation, quindi può essere eseguito in sicurezza in qualsiasi momento, incluso durante lo sviluppo e in CI. ## Outputs [#outputs] * **Avvisi** — riporta il numero e l'elenco dei problemi non fatali rilevati durante la scansione. I soli avvisi non fanno fallire il comando. * **Errori** — riporta il numero e l'elenco degli errori di sintassi, quindi termina con un codice di stato diverso da zero. È questo che rende `validate` un utile controllo in CI. * **Riepilogo** — in caso di successo, riporta il numero di voci traducibili trovate; se non ne trova nessuna, segnala che non sono stati rilevati contenuti inline o dizionari. ## Flag [#flags] | Parametro | Descrizione | Tipo | Facoltativo | Predefinito | | ------------------------------- | ---------------------------------------------- | ---------- | ----------- | ------------------------------------------- | | `-c, --config ` | Percorso del file di configurazione. | `string` | Sì | `gt.config.json` | | `--src ` | Pattern glob per i file sorgente. | `string[]` | Sì | glob di `src`, `app`, `pages`, `components` | | `--dictionary ` | Percorso del file dizionario. | `string` | Sì | — | | `--tsconfig, --jsconfig ` | Percorso di un file di configurazione TS o JS. | `string` | Sì | Rilevato automaticamente | | `--inline` | Include il contenuto inline nella validazione. | `boolean` | Sì | `true` | ## Esempio [#example] ```bash # Valida l'intero progetto npx gt validate # Valida solo file specifici npx gt validate src/components/Header.tsx src/pages/Home.tsx ``` ## Altre note [#notes] Specificare `[files...]` valida solo quei file, anziché l’intero progetto. Esegui `validate` nella CI prima di [`gt translate`](/docs/cli/reference/commands/translate) per individuare subito gli errori di sintassi: se trova errori, restituisce un codice di uscita diverso da zero e fa fallire la build. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.