# General Translation Knowledge Base: Comment traduire un site de documentation Mintlify ? URL: https://generaltranslation.com/fr/kb/translate-mintlify-docs.mdx Docs index: https://generaltranslation.com/llms.txt Description: Rédigez une copie traduite de chaque page dans un dossier par langue, puis ajoutez chaque langue à la navigation de docs.json. Locadex, l’agent IA de General Translation, ouvre une pull request qui ajoute les pages traduites et la navigation propre à chaque langue, puis traduit les modifications ultérieures. Category: Outils de workflow Last updated: 2026-10-21 Authors: Kevin Liu, Kevin Wu Published: 2026-10-21 Traduire un site de documentation Mintlify consiste à rédiger une copie de chaque page dans un dossier par langue et à déclarer chaque langue dans le tableau `languages` de la navigation de `docs.json`. Les pages mêlent texte rédigé, blocs de code, composants MDX, frontmatter et liens : il faut donc traduire le texte ainsi que les champs `title` et `description`, laisser le code et les composants intacts, et faire pointer les liens internes vers les pages dans la langue du lecteur. Par la suite, chaque modification d’une page source rend ses traductions obsolètes tant que personne ne les a mises à jour. ## Video The video is narrated in English, with English captions. [How do I translate a Mintlify docs site?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-translate-mintlify-docs.mp4) (47 s) General Translation lets you choose languages, and Locadex opens a translation pull request. Authorize the General Translation app on GitHub, choose your docs repository in the Dashboard, create an automation from the Generate translations and push template for Mintlify, run its setup with your languages, and merge the pull request that adds a navigation entry per language and the translated pages. ## Méthodes pour traduire un site Mintlify | Approche | Ses points forts | Ce qui reste à votre charge | | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Navigation `languages` de Mintlify, avec traduction manuelle | Génère un sélecteur de langue et une arborescence de pages par langue à partir de `docs.json` | Rédiger chaque page traduite dans le dossier de sa langue, écrire une navigation complète par langue et repérer les traductions rendues obsolètes par chaque modification de la source | | Google Translate | Traduit une page que vous y collez, sans configuration initiale | Il traduit chaque passage isolément ; c’est à vous de séparer le texte du code et des composants, et de créer les dossiers et la navigation | | Un script reposant sur une API d’IA (OpenAI API, Claude API) | Peut être configuré pour traduire le texte en laissant intacts les blocs de code et les composants | Un script qui protège la syntaxe MDX, garantit la cohérence des termes produit d’une page à l’autre, crée les dossiers et la navigation, et se relance lorsque les pages changent | | General Translation (Locadex) | Ouvre une pull request contenant les pages traduites, la navigation par langue et les liens localisés, puis traduit chaque modification selon le déclencheur de votre choix | Relire et fusionner la pull request de configuration initiale, puis relire les pull requests suivantes ou activer **Auto-merge** | Optez pour la navigation de Mintlify avec traduction manuelle lorsque les traducteurs prennent en charge quelques pages qui changent rarement ; pour traduire en une seule passe un site restreint et stable, utilisez Google Translate ou un script ponctuel reposant sur une API d’IA. Choisissez General Translation lorsque la documentation évolue à chaque livraison et que chaque langue doit suivre le rythme. ## Traduire une documentation Mintlify avec Locadex General Translation traduit les documentations Mintlify grâce à Locadex, son agent IA, disponible avec les plans Starter et Enterprise. 1. Dans le tableau de bord, connectez GitHub depuis **projet > Integrations > Catalog**. 2. Dans **projet > Automations**, créez une automatisation à partir de **Generate translations and push** en sélectionnant **Mintlify** comme framework. 3. Cliquez sur **Run setup** et choisissez vos langues. 4. Relisez et fusionnez la pull request ouverte par Locadex. La pull request ajoute un fichier `gt.config.json`, une entrée de navigation `docs.json` pour chaque langue ainsi que les pages traduites. Le code et les composants y conservent leur structure, et les liens vers les pages traduites restent dans la langue du lecteur. Pour Mintlify, la boîte de dialogue **Run setup** propose une option **Hide default locale in URL paths**, activée par défaut : les pages source conservent leurs chemins actuels, et chaque langue traduite dispose de son propre dossier de paramètres régionaux, par exemple `/es/...`. Si vous désactivez cette option, les pages source sont elles aussi placées dans un dossier de paramètres régionaux (les pages en anglais passent dans `/en/...`), ce qui modifie leurs URL. ## Maintenir les traductions à jour Ensuite, Locadex s'exécute à chaque modification d'une pull request (comportement par défaut) ou à chaque push d'un commit. Chaque exécution applique les groupes de contexte assignés au projet (glossaire et instructions personnalisées), que votre application peut également utiliser, afin que les noms de produits soient cohérents des deux côtés. Le [Démarrage rapide Mintlify](/docs/integrations/mintlify/quickstart) détaille toutes les étapes. ## Related questions - [Que fait l’agent Locadex ?](https://generaltranslation.com/fr/kb/what-is-locadex.mdx): Locadex est l’agent IA de General Translation qui internationalise votre code et traduit votre contenu dans votre dépôt GitHub. Ses automatisations s’exécutent à l’ouverture d’une pull request, lors du push d’un commit ou lorsque vous les lancez vous-même, et chaque modification arrive sous forme de pull request. - [Comment traduire du contenu dans Sanity ?](https://generaltranslation.com/fr/kb/translate-sanity-content.mdx): Stockez chaque langue dans son propre document ou sous forme de valeur par paramètre régional dans chaque champ, puis traduisez la source dans chaque paramètre régional cible. Le plugin gt-sanity de General Translation ajoute une action Translate à Sanity Studio et, par défaut, importe chaque traduction sous forme de brouillon, que vous relisez puis publiez. - [Comment traduire du contenu dans Storyblok ?](https://generaltranslation.com/fr/kb/translate-storyblok-content.mdx): Dans Storyblok, ajoutez vos langues cibles à l’espace et attribuez à chaque champ traduisible une valeur par langue. L’intégration Storyblok de General Translation remplit ces valeurs depuis le tableau de bord grâce à Synchroniser et appliquer, sous forme de brouillons que vous relisez et publiez dans Storyblok. - [Comment relire et modifier les traductions ?](https://generaltranslation.com/fr/kb/review-translations.mdx): Comparez chaque traduction avec sa source et les autres paramètres régionaux, puis corrigez ce qui sonne faux. Avec General Translation, vous modifiez les traductions sur la page Translations du tableau de bord et suivez la relecture à l’aide d’étiquettes et de commentaires ; la prochaine exécution de traduction de Locadex, son agent IA, intègre ensuite vos modifications dans une pull request. ## Previous and next questions - Previous question: [Comment traduire Google Slides ?](https://generaltranslation.com/fr/kb/translate-google-slides.mdx) - Next question: [Comment traduire une application Node.js ?](https://generaltranslation.com/fr/kb/translate-node-app.mdx) ## Sitemap See the [Knowledge Base sitemap](https://generaltranslation.com/fr/kb/sitemap.md) for every article.