# General Translation Integrations: Configuration URL: https://generaltranslation.com/fr/docs/integrations/mintlify/reference/config.mdx --- title: Configuration description: Référence de gt.config.json généré par General Translation pour un projet Mintlify. Référence de la configuration de l’intégration Mintlify. --- # Configuration General Translation génère un `gt.config.json` pour votre projet Mintlify lors de la configuration — vous ne l’écrivez pas à la main. Cette page décrit le contenu de ce fichier afin que vous puissiez le vérifier ou l’ajuster une fois la pull request de configuration fusionnée. Il s’agit d’une configuration CLI standard de General Translation. Chaque clé commune est documentée une seule fois dans la [référence de configuration CLI](/docs/cli/reference/config) ; cette page couvre uniquement les choix propres à Mintlify et les deux modes générés par l’intégration. ## Modes [#modes] La configuration générée dépend du paramètre **Masquer le paramètre régional par défaut dans les chemins d’URL** (voir [Configurer Mintlify](/docs/integrations/mintlify/guides/configuring-mintlify)). Les deux modes traduisent `docs.json` et chaque page `.mdx`/`.md` ; ils diffèrent par l’organisation des fichiers et par la façon dont le paramètre régional par défaut est servi. | Clé | Description | Masquer le paramètre régional par défaut | Afficher le paramètre régional par défaut | | --------------------------------------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [`files.mdx.include`](#files) | Motifs glob des pages à traduire. | `./**/*.mdx`, `./**/*.md` (traduit sur place) | `./[locale]/**/*.mdx`, `./snippets/[locale]/**/*.mdx`, ainsi que leurs équivalents en `.md` | | [`files.mdx.transform`](#files) | Réécrit les chemins source vers des dossiers de paramètres régionaux. | `{ match: "^(snippets/)?(.*)$", replace: "$1{locale}/$2" }` | *(aucun)* | | [`options.jsonSchema`](#options) | Préréglage utilisé pour localiser `docs.json`. | `mintlify-hide-default` | `mintlify` | | [`options.docsHideDefaultLocaleImport`](#options) | Masque le paramètre régional par défaut dans les imports. | `true` | *(omis)* | | [`options.experimentalHideDefaultLocale`](#options) | Sert le paramètre régional par défaut sans préfixe du paramètre régional. | `true` | *(omis)* | ## Fichiers [#files] Le bloc `files` indique à la CLI General Translation quels éléments traduire. Pour un projet Mintlify, il inclut toujours `docs.json` et les pages de documentation. * `files.json.include` — toujours `['./docs.json']`. La navigation de `docs.json` et les étiquettes sont localisées avec le préréglage de `options.jsonSchema`. * `files.mdx.include` — les pages `.mdx` et `.md` à traduire. En mode hide-default-locale, cela correspond à toute l’arborescence (`./**/*.mdx`, `./**/*.md`) et les fichiers sont déplacés dans des dossiers de paramètres régionaux par la transformation ; en mode show-default-locale, cela cible les dossiers existants pour chaque paramètre régional. * `files.mdx.transform` — en mode hide-default-locale, réécrit chaque chemin source vers un dossier `{locale}/` (en laissant sur place le préfixe initial `snippets/`). Le mode show-default-locale omet la transformation, car le contenu se trouve déjà dans des dossiers de paramètres régionaux. * `files.mdx.exclude` — les dossiers de paramètres régionaux eux-mêmes, ainsi que les fichiers courants du dépôt qui ne doivent jamais être traduits (voir [Contenu pris en charge](/docs/integrations/mintlify/reference/supported-content#excluded)). Consultez la [référence de configuration de la CLI](/docs/cli/reference/config) pour la sémantique complète de `files`, `include`, `exclude` et `transform`, ainsi que la [page sur le format MDX et Markdown](/docs/cli/reference/formats/mdx-md-files) et la [page sur le format JSON](/docs/cli/reference/formats/json-files) pour le comportement propre à chaque format. ## Options [#options] Le bloc `options` configure le comportement spécifique à Mintlify. Ces clés sont définies pour chaque projet Mintlify, sauf indication contraire pour un mode donné. * `mintlify.inferTitleFromFilename` — `true`. Déduit le titre d’une page à partir de son nom de fichier lorsqu’elle n’a pas de titre explicite. * `jsonSchema` — associe `./docs.json` à un préréglage capable de localiser la navigation Mintlify : `mintlify-hide-default` lorsque le paramètre régional par défaut est masqué, sinon `mintlify`. * `docsUrlPattern` — `/[locale]`. Le modèle utilisé pour localiser les URL de la documentation. * `docsImportPattern` — `/snippets/[locale]`. Le modèle utilisé pour localiser les imports de snippets. * `generateRedirects` — `./docs.json`. Génère des redirections dans `docs.json` afin que les liens existants continuent de fonctionner après la réorganisation de la navigation. * `experimentalLocalizeStaticImports` — `true`. Localise les chemins d’import statiques (comme les snippets). * `experimentalLocalizeStaticUrls` — `true`. Localise les URL statiques internes afin que les liens restent dans la langue du lecteur. * `experimentalLocalizeRelativeAssets` — `true`. Localise les références relatives aux assets. * `experimentalAddHeaderAnchorIds` — `'mintlify'`. Ajoute des ID d’ancre stables aux titres afin que les liens internes à la page continuent de fonctionner dans toutes les langues. * `docsHideDefaultLocaleImport` — `true` *(mode hide-default-locale uniquement)*. Masque le paramètre régional par défaut dans les imports générés. * `experimentalHideDefaultLocale` — `true` *(mode hide-default-locale uniquement)*. Sert le paramètre régional par défaut sans préfixe du paramètre régional. ## Exemple [#example] La configuration générée pour un projet où le paramètre régional par défaut est masqué (source en anglais, cibles en espagnol et en français) : ```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" // ainsi que les fichiers du dépôt tels que 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" } } ``` *Remarque : après l’initialisation, la CLI résout l’espace réservé d’exclusion `[locales]` en le remplaçant par vos paramètres régionaux cibles. Vérifiez le `gt.config.json` généré et ajustez les fichiers exclus si votre dépôt contient du contenu traduisible dans l’un des chemins exclus.*