# General Translation Integrations: Configurer Mintlify
URL: https://generaltranslation.com/fr/docs/integrations/mintlify/guides/configuring-mintlify.mdx
---
title: Configurer Mintlify
description: "Comment connecter un dépôt de documentation Mintlify à General Translation : ce guide explique comment choisir les langues et définir la manière dont les traductions sont exécutées."
related:
  links:
    - /docs/integrations/mintlify/guides/translating-content
    - /docs/integrations/mintlify/guides/managing-translations
    - /docs/integrations/mintlify/guides/using-translated-content

---

# Configuration de Mintlify

Connectez le dépôt GitHub qui contient votre documentation Mintlify à General Translation, puis choisissez vos langues et le mode d’exécution des traductions. Le [Quickstart](/docs/integrations/mintlify/quickstart) présente la méthode la plus rapide ; ce guide détaille davantage les options de configuration.

L’intégration fonctionne sur [Locadex](/docs/platform/locadex/quickstart) et se configure donc depuis **Locadex > Agent** dans le Dashboard, et non via un package ou un fichier de configuration que vous modifiez à la main.

## Avant de commencer [#before-start]

* Un [projet](/docs/platform/dashboard/get-started) General Translation avec un abonnement incluant la fonctionnalité `locadex_workflows`.
* Un dépôt GitHub contenant un projet Mintlify valide. Locadex vérifie que le dépôt contient un fichier `docs.json` dont le champ `$schema` pointe vers Mintlify. Il rejette les projets qui utilisent encore l’ancien `mint.json` (migrez d’abord vers `docs.json`) ou qui ressemblent à une application Next.js.

## Connecter et lier votre dépôt [#connect]

1. Dans le Dashboard, ouvrez votre projet et accédez à **Locadex > Agent**.
2. Cliquez sur **Connect GitHub** et autorisez l’application GitHub de General Translation sur les dépôts auxquels vous souhaitez donner accès à Locadex.
3. Sélectionnez le dépôt qui contient votre documentation Mintlify. Chaque projet est lié à un dépôt.

## Définir le répertoire racine de l’application [#app-directory]

Si votre `docs.json` se trouve à la racine du dépôt, laissez le répertoire racine de l’application vide ou définissez-le sur `.`. Si votre documentation se trouve dans un sous-répertoire (par exemple dans un monorepo), définissez le répertoire racine de l’application sur ce chemin pour que Locadex utilise le bon dossier. Consultez [Monorepos](/docs/platform/locadex/guides/using-in-monorepos).

## Choisir les langues [#languages]

Définissez le **paramètre régional par défaut** (la langue dans laquelle votre documentation est rédigée) et les **langues cibles** vers lesquelles effectuer la traduction.

Mintlify prend en charge un ensemble fixe de codes de langue, et General Translation y fait correspondre les locales que vous avez choisies. Seules les locales correspondant à une langue prise en charge par Mintlify peuvent être utilisées. Voir [Locales](/docs/integrations/mintlify/reference/locales).

Pour modifier les langues ultérieurement, consultez [Gérer les traductions](/docs/integrations/mintlify/guides/managing-translations).

## Masquer le paramètre régional par défaut [#hide-default]

Utilisez le bouton bascule **Hide default locale in URL paths** pour définir comment votre langue source est servie :

* **Activé** (par défaut) : les pages de votre paramètre régional par défaut conservent leurs chemins actuels (sans préfixe du paramètre régional), et seules les langues traduites reçoivent un préfixe du paramètre régional.
* **Désactivé** : chaque langue, y compris celle par défaut, est servie avec son propre préfixe du paramètre régional.

Ce choix modifie la façon dont Locadex réorganise vos fichiers et la navigation dans `docs.json`. Consultez la [référence de configuration](/docs/integrations/mintlify/reference/config) pour voir exactement ce que produit chaque mode.

## Définir comment les traductions sont exécutées [#triggers]

Locadex ouvre des pull requests pour chaque modification qu’il apporte. Pour les dépôts de documentation, il s’exécute à chaque nouveau commit sur votre branche par défaut et peut fusionner automatiquement les pull requests de traduction une fois les vérifications validées, afin que votre documentation reste traduite sans intervention manuelle. Vous pouvez consulter ces paramètres et modifier le mode de déclenchement ou le comportement de fusion automatique à tout moment — voir [Fusion automatique](/docs/platform/locadex/guides/auto-merging-prs).
## Next steps

- /docs/integrations/mintlify/guides/translating-content
- /docs/integrations/mintlify/guides/managing-translations
- /docs/integrations/mintlify/guides/using-translated-content