# General Translation Integrations: Configuration de Mintlify
URL: https://generaltranslation.com/fr/docs/integrations/mintlify/guides/configuring-mintlify.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Comment connecter un dépôt de documentation Mintlify à General Translation et configurer les langues et les déclencheurs de traduction.

Connectez le dépôt GitHub qui contient votre documentation Mintlify à General Translation, puis choisissez vos langues et comment les traductions sont exécutées. 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), donc son dépôt et son automatisation se configurent depuis **projet &gt; Intégrations** et **projet &gt; Automatisations** dans le Dashboard.

## Avant de commencer [#before-start]

* Un [projet](/docs/platform/dashboard/get-started) General Translation.
* 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&#39;ancien `mint.json` (migrez d&#39;abord vers `docs.json`) ou qui ressemblent à une application Next.js.

## Connectez et associez votre dépôt [#connect]

1. Dans le Dashboard, ouvrez **Projet &gt; Intégrations &gt; Catalogue**.
2. Connectez GitHub et autorisez la GitHub App General Translation sur le dépôt qui contient votre documentation Mintlify.
3. Ouvrez **Projet &gt; Automatisations** et choisissez **Générer les traductions et effectuer le push**.
4. Sélectionnez le dépôt, le répertoire cible et le framework **Mintlify**.

## Définissez le répertoire cible [#target-directory]

Si votre `docs.json` se trouve à la racine du dépôt, définissez **Répertoire cible** sur `.`. Si votre documentation se trouve dans un sous-répertoire, par exemple dans un monorepo, définissez **Répertoire cible** sur ce chemin afin que Locadex fonctionne dans le bon dossier. (Voir [Utiliser Locadex dans un monorepo](/docs/platform/locadex/guides/using-in-monorepos)).

## Choisir les langues [#languages]

Définissez le **paramètre régional source** (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 paramètres régionaux que vous avez choisis. Seuls les paramètres régionaux correspondant à une langue prise en charge par Mintlify peuvent être utilisés. (Voir [Locales](/docs/integrations/mintlify/reference/locales)).

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

## Choisir la structure des URL pour les paramètres régionaux par défaut [#default-locale-url]

Lorsque vous lancez la configuration initiale depuis **projet &gt; automatisation**, l&#39;option **Hide paramètres régionaux par défaut in URL paths** est activée par défaut. Laissez-la activée pour conserver les chemins existants de vos pages source et placer uniquement les pages traduites sous des chemins préfixés par le paramètre régional.

Désactivez-la pour placer toutes les langues sous un chemin préfixé par le paramètre régional. Par exemple, les pages source en anglais sont alors déplacées sous `/en/...`.

Votre choix est enregistré dans le fichier `gt.config.json` généré. Il modifie la façon dont Locadex restructure les fichiers et la navigation de `docs.json` : relisez donc la pull request de configuration initiale avant de la fusionner. (Consultez la [référence de configuration](/docs/integrations/mintlify/reference/config#modes).)

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

Locadex ouvre ou met à jour des pull requests avec ses modifications. Il réutilise une PR ouverte pour la même branche d’automatisation et en ouvre une nouvelle après la fusion ou la fermeture de la PR précédente.

Les nouvelles automatisations de traduction utilisent par défaut **Les modifications d’une pull request**, avec **Fusion automatique** désactivée. Choisissez **Un commit est poussé** pour traduire les modifications après leur intégration dans la branche cible, et activez **Fusion automatique** lorsque des vérifications obligatoires fiables peuvent protéger la branche. (Voir [Fusion automatique des PR Locadex](/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

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
