# General Translation Integrations: Configurazione URL: https://generaltranslation.com/it/docs/integrations/mintlify/reference/config.mdx --- title: Configurazione description: Riferimento per il file gt.config.json generato da General Translation per un progetto Mintlify. Riferimento per la configurazione dell'integrazione con Mintlify. --- # Configurazione General Translation genera un `gt.config.json` per il tuo progetto Mintlify durante la configurazione iniziale — non devi scriverlo a mano. Questa pagina descrive il contenuto di quel file, così puoi esaminarlo o perfezionarlo dopo l'unione della pull request di configurazione iniziale. Questa è una configurazione standard della CLI di General Translation. Ogni chiave condivisa è documentata una sola volta nel [riferimento della configurazione della CLI](/docs/cli/reference/config); questa pagina tratta solo le scelte specifiche di Mintlify e le due modalità generate dall'integrazione. ## Modalità [#modes] La configurazione generata dipende dall'impostazione **Nascondi l'impostazione regionale predefinita nei percorsi URL** (vedi [Configurazione di Mintlify](/docs/integrations/mintlify/guides/configuring-mintlify)). Entrambe le modalità traducono `docs.json` e tutte le pagine `.mdx`/`.md`; differiscono per il layout dei file e per come viene servita l'impostazione regionale predefinita. | Chiave | Descrizione | Nascondi impostazione regionale predefinita | Mostra impostazione regionale predefinita | | --------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------ | | [`files.mdx.include`](#files) | Pattern glob delle pagine da tradurre. | `./**/*.mdx`, `./**/*.md` (tradotti in-place) | `./[locale]/**/*.mdx`, `./snippets/[locale]/**/*.mdx` e i corrispondenti `.md` | | [`files.mdx.transform`](#files) | Riscrive i percorsi sorgente nelle cartelle delle impostazioni regionali. | `{ match: "^(snippets/)?(.*)$", replace: "$1{locale}/$2" }` | *(nessuno)* | | [`options.jsonSchema`](#options) | Preimpostazione usata per localizzare `docs.json`. | `mintlify-hide-default` | `mintlify` | | [`options.docsHideDefaultLocaleImport`](#options) | Nasconde l'impostazione regionale predefinita nelle importazioni. | `true` | *(omesso)* | | [`options.experimentalHideDefaultLocale`](#options) | Serve l'impostazione regionale predefinita senza un prefisso di impostazione regionale. | `true` | *(omesso)* | ## File [#files] Il blocco `files` indica alla CLI di General Translation cosa tradurre. Per un progetto Mintlify, include sempre `docs.json` e le pagine della documentazione. * `files.json.include` — sempre `['./docs.json']`. La navigazione e le etichette di `docs.json` vengono localizzate con il preset in `options.jsonSchema`. * `files.mdx.include` — le pagine `.mdx` e `.md` da tradurre. In modalità hide-default-locale, comprende l'intero albero (`./**/*.mdx`, `./**/*.md`) e i file vengono spostati nelle cartelle delle impostazioni regionali tramite il transform; in modalità show-default-locale, riguarda le cartelle delle impostazioni regionali già esistenti. * `files.mdx.transform` — in modalità hide-default-locale, riscrive ogni percorso sorgente in una cartella `{locale}/` (mantenendo in-place un eventuale prefisso iniziale `snippets/`). In modalità show-default-locale, il transform viene omesso perché il contenuto si trova già nelle cartelle delle impostazioni regionali. * `files.mdx.exclude` — le stesse cartelle delle impostazioni regionali, oltre ai file comuni del repository che non devono mai essere tradotti (vedi [Contenuti supportati](/docs/integrations/mintlify/reference/supported-content#excluded)). Consulta il [riferimento della configurazione della CLI](/docs/cli/reference/config) per la semantica completa di `files`, `include`, `exclude` e `transform`, e la [pagina del formato MDX e Markdown](/docs/cli/reference/formats/mdx-md-files) e la [pagina del formato JSON](/docs/cli/reference/formats/json-files) per il comportamento specifico di ciascun formato. ## Opzioni [#options] Il blocco `options` configura il comportamento specifico di Mintlify. Queste chiavi sono impostate per ogni progetto Mintlify, salvo diversa indicazione per una modalità specifica. * `mintlify.inferTitleFromFilename` — `true`. Ricava il titolo di una pagina dal nome del file quando la pagina non ha un titolo esplicito. * `jsonSchema` — associa `./docs.json` a una preimpostazione che sa come localizzare la navigazione di Mintlify: `mintlify-hide-default` quando l'impostazione regionale predefinita è nascosta, altrimenti `mintlify`. * `docsUrlPattern` — `/[locale]`. Il pattern usato per localizzare gli URL della documentazione. * `docsImportPattern` — `/snippets/[locale]`. Il pattern usato per localizzare le importazioni degli snippet. * `generateRedirects` — `./docs.json`. Genera reindirizzamenti in `docs.json` in modo che i link esistenti continuino a risolversi dopo la riorganizzazione della navigazione. * `experimentalLocalizeStaticImports` — `true`. Localizza i percorsi delle importazioni statiche (come gli snippet). * `experimentalLocalizeStaticUrls` — `true`. Localizza gli URL statici interni in modo che i link restino nella lingua del lettore. * `experimentalLocalizeRelativeAssets` — `true`. Localizza i riferimenti relativi alle risorse. * `experimentalAddHeaderAnchorIds` — `'mintlify'`. Aggiunge ID di ancoraggio stabili alle intestazioni, così i link interni alla pagina continuano a funzionare in tutte le lingue. * `docsHideDefaultLocaleImport` — `true` *(solo modalità hide-default-locale)*. Nasconde l'impostazione regionale predefinita nelle importazioni generate. * `experimentalHideDefaultLocale` — `true` *(solo modalità hide-default-locale)*. Rende disponibile l'impostazione regionale predefinita senza un prefisso dell'impostazione regionale. ## Esempio [#example] La configurazione generata per un progetto con l'impostazione regionale predefinita nascosta (sorgente in inglese, destinazioni in spagnolo e francese): ```json title="gt.config.json" { "$schema": "https://assets.gtx.dev/config-schema.json", "files": { "json": { "include": ["./docs.json"] }, "mdx": { "include": ["./**/*.mdx", "./**/*.md"], "transform": { "match": "^(snippets/)?(.*)$", "replace": "$1{locale}/$2" }, "exclude": [ "./[locales]/**/*.mdx", "./snippets/[locales]/**/*.mdx", "./[locales]/**/*.md", "./snippets/[locales]/**/*.md" // più i file del repository come README.md, LICENSE.md, CHANGELOG.md ] } }, "defaultLocale": "en", "locales": ["es", "fr"], "options": { "mintlify": { "inferTitleFromFilename": true }, "jsonSchema": { "./docs.json": { "preset": "mintlify-hide-default" } }, "docsUrlPattern": "/[locale]", "docsImportPattern": "/snippets/[locale]", "generateRedirects": "./docs.json", "experimentalLocalizeStaticImports": true, "experimentalLocalizeStaticUrls": true, "experimentalLocalizeRelativeAssets": true, "docsHideDefaultLocaleImport": true, "experimentalHideDefaultLocale": true, "experimentalAddHeaderAnchorIds": "mintlify" } } ``` *Nota: dopo il setup, la CLI sostituisce il segnaposto di esclusione `[locales]` con le effettive impostazioni regionali di destinazione. Controlla il file `gt.config.json` generato e modifica i file esclusi se il tuo repository conserva contenuti traducibili in uno dei percorsi esclusi.*