# General Translation Integrations: Configurazione URL: https://generaltranslation.com/it/docs/integrations/mintlify/reference/config.mdx Docs index: https://generaltranslation.com/llms.txt Description: Esamina il file gt.config.json generato 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)* | | [`options.experimentalClearLocaleDirs`](#options) | Svuota le directory generate delle impostazioni regionali prima di scrivere le traduzioni. | `true` | `true` | ## 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 la preimpostazione 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)). Quando il repository contiene specifiche OpenAPI 3.x in JSON o YAML, Locadex aggiunge ogni specifica sorgente a `files.json` o `files.yaml`. Aggiunge inoltre un transform che scrive la specifica tradotta nella directory dell'impostazione regionale corrispondente. (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 o condizionale. * `mintlify.inferTitleFromFilename` — `true`. Ricava il titolo di una pagina dal nome del file quando la pagina non ha un titolo esplicito. * [`mintlify.localizeRedirects`](#localized-redirects) — facoltativa e `false` per impostazione predefinita. Le configurazioni generate durante il setup la omettono. Se abilitata, aggiunge copie localizzate dei reindirizzamenti per le pagine sorgente rinominate o rimosse durante l'esecuzione corrente di [`gt translate`](/docs/cli/reference/commands/translate). * `mintlify.openapi.files` — percorsi delle specifiche OpenAPI 3.x rilevate *(se presenti)*. Registra le specifiche tradotte in Mintlify. * `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`. Le specifiche OpenAPI JSON rilevate usano la preimpostazione `openapi`. * `yamlSchema` — associa le specifiche OpenAPI YAML rilevate alla preimpostazione `openapi` *(se presenti)*. * `docsUrlPattern` — `/[locale]`. Il pattern usato per localizzare gli URL della documentazione. * `docsImportPattern` — `/snippets/[locale]`. Il pattern usato per localizzare le importazioni degli snippet. * `experimentalLocalizeStaticImports` — `true`. Localizza i percorsi delle importazioni statiche (come gli snippet). * `experimentalLocalizeStaticUrls` — `{ "skipUntranslatedPages": true }`. Localizza gli URL statici interni in modo che i link restino nella lingua del lettore, ma lascia il link sull'URL sorgente quando la pagina di destinazione non è tradotta. * `experimentalLocalizeRelativeAssets` — `true`. Localizza i riferimenti relativi alle risorse. * `experimentalClearLocaleDirs` — `true`. Svuota le directory delle impostazioni regionali generate prima di scrivere le traduzioni, in modo che le pagine sorgente rimosse non lascino pagine tradotte obsolete. * `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. ### Reindirizzamenti localizzati **Tipo** `boolean` · **Facoltativo** · **Predefinito** `false` Imposta `options.mintlify.localizeRedirects` su `true` per aggiungere, per ciascuna impostazione regionale, una copia delle voci di reindirizzamento dell'impostazione regionale sorgente la cui pagina di partenza è stata rinominata o rimossa durante la stessa esecuzione di [`gt translate`](/docs/cli/reference/commands/translate). La CLI lascia invariato il reindirizzamento originale, ne mantiene l'ancora e il valore `permanent` e salta un'impostazione regionale se la pagina di destinazione non è tradotta. Questa opzione richiede che `options.docsUrlPattern` inserisca l'impostazione regionale in ogni URL. `options.experimentalHideDefaultLocale` stabilisce se l'impostazione regionale sorgente mantiene un percorso senza prefisso. Se `docsUrlPattern` non è definito, la CLI mostra un avviso e non aggiunge alcun reindirizzamento. ## 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" ] } }, "defaultLocale": "en", "locales": ["es", "fr"], "options": { "mintlify": { "inferTitleFromFilename": true, "localizeRedirects": true }, "jsonSchema": { "./docs.json": { "preset": "mintlify-hide-default" } }, "docsUrlPattern": "/[locale]", "docsImportPattern": "/snippets/[locale]", "experimentalLocalizeStaticImports": true, "experimentalLocalizeStaticUrls": { "skipUntranslatedPages": true }, "experimentalLocalizeRelativeAssets": true, "experimentalClearLocaleDirs": 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.