# General Translation Integrations: Configurazione URL: https://generaltranslation.com/it/docs/integrations/mintlify/reference/config.mdx Docs index: https://generaltranslation.com/llms.txt Description: Riferimento per il file gt.config.json che General Translation genera per un progetto Mintlify. Riferimento per la configurazione dell'integrazione Mintlify. 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 avviata da **Progetto > Automazioni** genera la modalità show-default-locale, in cui ogni lingua usa un percorso con prefisso dell'impostazione regionale. I progetti esistenti possono usare la modalità hide-default-locale, in cui le pagine sorgente mantengono i percorsi originali. 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 sorgente. | 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'`. Scrive la sintassi nativa di Mintlify `{#id}` su ogni intestazione tradotta, usando l'ID dell'intestazione sorgente affinché i link interni alla pagina mantengano la stessa destinazione in tutte le lingue. Le intestazioni annidate in profondità nel JSX vengono spostate a margine, perché Mintlify riconosce questa sintassi solo con un massimo di tre spazi iniziali. * `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] L'esempio seguente mostra un progetto esistente configurato per nascondere l'impostazione regionale sorgente (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.* ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.