# gt: General Translation CLI tool: gt generate URL: https://generaltranslation.com/it/docs/cli/reference/commands/generate.mdx Docs index: https://generaltranslation.com/llms.txt Description: Genera template di origine per la traduzione manuale. Riferimento API per il comando gt generate. Genera file template locali per l'impostazione regionale predefinita e per le impostazioni regionali di destinazione. Usalo quando gestisci le traduzioni in autonomia anziché tramite la General Translation API. *Nota: disponibile quando la CLI rileva `gt-next`, `gt-react`, `gt-react-native`, `gt-tanstack-start`, `gt-node`, `gt-vue`, `gt-flask` o `gt-fastapi`. Il comando non viene registrato nei progetti che non utilizzano nessuna di queste librerie. Se usi la General Translation API, usa invece [`gt translate`](/docs/cli/reference/commands/translate).* ## Panoramica [#overview] Configura prima il progetto, quindi genera i template: ```bash npx gt configure npx gt generate ``` ## Come funziona [#how-it-works] 1. Legge `gt.config.json` per determinare l'impostazione regionale predefinita e le impostazioni regionali di destinazione, i percorsi sorgente, il dizionario e il percorso `files.gt.output`. 2. Usa il parser della libreria rilevata per analizzare il contenuto inline e il dizionario configurato, esattamente come [`gt translate`](/docs/cli/reference/commands/translate) raccoglie i contenuti. 3. Sostituisce il template dell'impostazione regionale predefinita con le voci sorgente attuali. 4. Esegue il merge di queste voci in ciascun file delle impostazioni regionali di destinazione. I valori di destinazione esistenti vengono mantenuti, le nuove voci usano il testo sorgente e le voci obsolete vengono rimosse. Il comando non effettua chiamate alla General Translation API. Se `files.gt.output` non è configurato, analizza il progetto ma termina senza scrivere alcun template. ## Flag [#flags] ### Flag per la generazione dei template | Parametro | Descrizione | Tipo | Facoltativo | Predefinito | | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------- | ----------- | ------------------------------------------------ | | `-c, --config ` | Percorso di `gt.config.json`. | `string` | Sì | `gt.config.json` rilevato | | `--default-language, --default-locale ` | Impostazione regionale predefinita usata per il template di origine. | `string` | Sì | Impostazione regionale predefinita configurata | | `--new, --locales ` | Impostazioni regionali di destinazione di cui vengono uniti i file di template. | `string[]` | Sì | Impostazioni regionali configurate | | `--src ` | Pattern glob per i file di origine. | `string[]` | Sì | Glob `src`, `app`, `pages` e `components` | | `--dictionary ` | Percorso del file di dizionario. | `string` | Sì | — | | `--tsconfig, --jsconfig ` | Percorso di un file di configurazione TypeScript o JavaScript usato per risolvere le importazioni del codice sorgente. | `string` | Sì | Configurazione rilevata oppure `./tsconfig.json` | | `--inline` | Include il contenuto inline supportato dalla libreria rilevata. | `boolean` | Sì | `true` | | `--ignore-errors` | Ignora gli errori rilevati durante la scansione del contenuto inline. | `boolean` | Sì | `false` | ### Flag di compatibilità accettati Il comando condivide il parser con [`gt translate`](/docs/cli/reference/commands/translate), quindi l'output della guida include i flag riportati di seguito. Questi flag non hanno alcun effetto sulla generazione locale dei template. In particolare, `--dry-run` non impedisce la scrittura dei file. | Parametro | Descrizione | Tipo | Opzionale | Predefinito | | ----------------------------------------- | ------------------------------------------------------ | ------------------- | --------- | ---------------------------- | | `--api-key ` | Accettato ma non utilizzato. | `string` | Sì | — | | `--project-id ` | Accettato ma non utilizzato. | `string` | Sì | — | | `--version-id ` | Accettato ma non utilizzato. | `string` | Sì | — | | `--dry-run` | Accettato, ma non impedisce la scrittura dei template. | `boolean` | Sì | `false` | | `--timeout ` | Accettato ma non utilizzato. | `number` | Sì | `900` | | `--save-local`, `--no-save-local` | Accettato ma non utilizzato. | `boolean` | Sì | Valore configurato o `false` | | `--publish` | Accettato ma non utilizzato. | `boolean` | Sì | `false` | | `--experimental-localize-static-urls` | Accettato ma non utilizzato. | `boolean` | Sì | `false` | | `--experimental-hide-default-locale` | Accettato ma non utilizzato. | `boolean` | Sì | `false` | | `--experimental-flatten-json-files` | Accettato ma non utilizzato. | `boolean` | Sì | `false` | | `--experimental-localize-static-imports` | Accettato ma non utilizzato. | `boolean` | Sì | `false` | | `--experimental-localize-relative-assets` | Accettato ma non utilizzato. | `boolean` | Sì | `false` | | `--force` | Accettato ma non utilizzato. | `boolean` | Sì | `false` | | `--force-download` | Accettato ma non utilizzato. | `boolean` | Sì | `false` | | `--omit-config-ids` | Accettato ma non utilizzato. | `boolean` | Sì | `false` | | `--experimental-clear-locale-dirs` | Accettato ma non utilizzato. | `boolean` | Sì | `false` | | `--branch ` | Accettato ma non utilizzato. | `string` | Sì | — | | `--disable-branch-detection` | Accettato ma non utilizzato. | `boolean` | Sì | `false` | | `--enable-branching` | Accettato ma non utilizzato. | `boolean` | Sì | `false` | | `--remote-name ` | Accettato ma non utilizzato. | `string` | Sì | `origin` | | `--tag [value]` | Accettato ma non utilizzato. | `string \| boolean` | Sì | — | | `-m, --message ` | Accettato ma non utilizzato. | `string` | Sì | — | ## Esempio [#example] ```bash # Genera i templates per le impostazioni regionali configurate npx gt generate # Genera da un'impostazione regionale sorgente personalizzata, ignorando gli errori di scansione npx gt generate --default-locale en-US --ignore-errors ``` ## Altre note [#notes] Dopo aver generato i file template, traduci i valori di destinazione e distribuiscili tramite la [traduzione locale](/docs/react/guides/storing-translations). Esegui di nuovo `generate` ogni volta che il contenuto sorgente cambia e controlla i file di destinazione, perché le voci eliminate dal sorgente vengono rimosse anche da lì. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.