# General Translation Integrations: Configuration URL: https://generaltranslation.com/fr/docs/integrations/mintlify/reference/config.mdx Docs index: https://generaltranslation.com/llms.txt Description: Vérifiez le `gt.config.json` généré pour un projet Mintlify. Référence de la configuration de l’intégration Mintlify. 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 de la 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 lancée depuis **Projet > Automations** génère le mode show-default-locale, dans lequel chaque langue utilise un chemin préfixé par un paramètre régional. Les projets existants peuvent utiliser le mode hide-default-locale, dans lequel les pages source conservent leurs chemins d’origine. 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 source 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)* | | [`options.experimentalClearLocaleDirs`](#options) | Vide les répertoires de paramètres régionaux générés avant l’écriture des traductions. | `true` | `true` | ## Fichiers [#files] Le bloc `files` indique à la CLI de 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)). Lorsque le dépôt contient des spécifications OpenAPI 3.x au format JSON ou YAML, Locadex ajoute chaque spécification source à `files.json` ou `files.yaml`. Il ajoute également une transformation qui écrit la spécification traduite dans le répertoire du paramètre régional correspondant. (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é ou une condition particulière. * `mintlify.inferTitleFromFilename` — `true`. Déduit le titre d’une page à partir de son nom de fichier lorsqu’elle n’a pas de titre explicite. * [`mintlify.localizeRedirects`](#localized-redirects) — facultatif et `false` par défaut. Les configurations générées par le setup ne l’incluent pas. Lorsqu’il est activé, ajoute des copies localisées des redirections pour les pages source renommées ou supprimées lors de l’exécution en cours de [`gt translate`](/docs/cli/reference/commands/translate). * `mintlify.openapi.files` — chemins vers les spécifications OpenAPI 3.x détectées *(le cas échéant)*. Enregistre les spécifications traduites auprès de Mintlify. * `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`. Les spécifications OpenAPI au format JSON détectées utilisent le préréglage `openapi`. * `yamlSchema` — associe les spécifications OpenAPI au format YAML détectées au préréglage `openapi` *(le cas échéant)*. * `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. * `experimentalLocalizeStaticImports` — `true`. Localise les chemins d’import statiques (comme les snippets). * `experimentalLocalizeStaticUrls` — `{ "skipUntranslatedPages": true }`. Localise les URL statiques internes afin que les liens restent dans la langue du lecteur, tout en conservant l’URL source d’un lien lorsque la page cible n’est pas traduite. * `experimentalLocalizeRelativeAssets` — `true`. Localise les références relatives aux assets. * `experimentalClearLocaleDirs` — `true`. Vide les répertoires de paramètres régionaux générés avant d’écrire les traductions, afin que les pages source supprimées ne laissent pas derrière elles des pages traduites obsolètes. * `experimentalAddHeaderAnchorIds` — `'mintlify'`. Écrit la syntaxe native Mintlify `{#id}` sur chaque titre traduit, en reprenant l’ID du titre source afin que les liens internes à la page conservent la même cible dans toutes les langues. Les titres profondément imbriqués dans du JSX sont déplacés dans la marge, car Mintlify ne reconnaît cette syntaxe qu’avec un maximum de trois espaces en début de ligne. * `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. ### Redirections localisées **Type** `boolean` · **Facultatif** · **Valeur par défaut** `false` Définissez `options.mintlify.localizeRedirects` sur `true` pour ajouter, pour chaque paramètre régional, une copie des entrées de redirection du paramètre régional source dont la page source a été renommée ou supprimée au cours de la même exécution de [`gt translate`](/docs/cli/reference/commands/translate). La CLI laisse la redirection d'origine inchangée, préserve son ancre et sa valeur `permanent`, et ignore un paramètre régional lorsque la page de destination n'est pas traduite. Cette option nécessite que `options.docsUrlPattern` place le paramètre régional dans chaque URL. `options.experimentalHideDefaultLocale` détermine si le paramètre régional source conserve un chemin sans préfixe. Si `docsUrlPattern` est absent, la CLI affiche un avertissement et n'ajoute aucune redirection. ## Exemple [#example] L’exemple suivant présente un projet existant configuré pour masquer le paramètre régional source (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" ] } }, "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" } } ``` *Remarque : après le setup, 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.* ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.