Localisez votre documentation Mintlify

Traduisez votre site de documentation en quelques minutes avec General Translation

Commencer
General Translation

Quickstart

Translate a Mintlify documentation site with General Translation.

The integration is powered by Locadex, an AI agent: connect the GitHub repository that holds your docs, choose your languages, and Locadex opens a pull request with internationalization (i18n) routing and translated content. There is nothing to install and no config to write by hand.

Before you start

You need:

  • A project.
  • A GitHub repository containing a valid Mintlify project: a docs.json whose $schema points at Mintlify (mintlify.com/docs.json), with no legacy mint.json.
  • Permission to install a GitHub App on that repository.

Pull request fusionnéees, fr, ja

Localisez votre documentation en quelques étapes

Des traductions prêtes pour la production pour l’ensemble de votre site de documentation, en quelques minutes seulement

  1. Connectez votre dépôt

    Connectez notre Locadex Agent au dépôt GitHub qui héberge votre documentation Mintlify.

  2. Choisissez vos langues

    Sélectionnez votre paramètre régional source et vos langues cibles. Rien à installer, aucune configuration à rédiger à la main.

  3. Fusionnez la PR

    Locadex s’occupe de toute la configuration et ouvre une PR contenant vos pages traduites, une navigation multilingue et le routage nécessaire à l’internationalisation (i18n). Fusionnez-la et votre documentation traduite est en ligne.

Comment traduire un site de documentation Mintlify ?

Transcription

In Hamburg, your Mintlify docs open in English, and the site offers no German. The navigation in docs.json lists one set of English pages and no languages. General Translation lets you choose languages, and Locadex opens a translation pull request. Authorize the General Translation app on GitHub, and choose your docs repository in the Dashboard. Create an automation from the Generate translations and push template for Mintlify, then run its setup with your languages. Locadex's pull request adds a navigation entry per language and the translated pages. The merged site's menu switches the docs to Spanish, Japanese and German.

Les meilleures entreprises au monde nous font confiance

General Translation développe une stack de localisation complète, pour une expérience fluide aussi bien pour les développeurs que pour les utilisateurs

  • 11+ locales sur le dashboard, la page d’accueil et iOS

  • 14+ locales pour le web et la documentation

  • 47+ locales pour la plateforme et la documentation

  • 2+ locales pour le web, iOS et Android

  • 7+ locales pour le web et GTM

  • Bibliothèques i18n open-source
  • Traduction context-aware
  • Plateforme de relecture en équipe
  • Intégrations de contenu
  • Locadex Agent

Des traductions aussi naturelles que celles de locuteurs natifs, avec une prise en compte complète du contexte

Des traductions de la plus haute qualité, adaptées à votre produit et vérifiées à la lumière de l’ensemble de votre site de documentation

Du contexte à chaque niveau

Les traductions respectent votre ton et vos règles de style, tout en tenant compte du contexte et de la logique de votre produit.

Une cohérence sur toutes les pages

Chaque page est relue et comparée à votre texte source. Sa cohérence avec les autres pages est également vérifiée.

Relisez et modifiez en équipe

Chaque ligne est modifiable dans le tableau de bord, avec un affichage des langues côte à côte, un historique et des commentaires.

Une localisation continue au fil de vos mises à jour

À chaque mise à jour de votre documentation, Locadex traduit les modifications et ouvre une pull request pour vous. Il ne vous reste qu’à relire et à fusionner

  1. Envoyez une modification de la documentation
  2. Locadex traduit ce qui a changé
  3. Une pull request s’ouvre
  4. Relisez et fusionnez
  5. En ligne dans toutes les langues

Connectez et localisez l’ensemble de vos produits

General Translation réunit votre code, vos contenus, vos traductions et leur relecture sur une seule plateforme

Questions fréquentes

Quelle est la différence entre traduction, internationalisation et localisation ?

La traduction consiste à transposer un contenu d’une langue à une autre. L’internationalisation (i18n) prépare votre site à prendre en charge plusieurs locales : routage, navigation, dates et formes plurielles. La localisation (l10n) englobe le tout : elle consiste à adapter l’ensemble du produit à chaque locale, du texte au formatage. Sur un site Mintlify, l’internationalisation correspond au routage selon les locales et à la navigation multilingue mis en place par Locadex, tandis que la traduction fournit vos pages dans chaque langue. General Translation gère quant à lui l’ensemble du workflow de localisation, en continu.

Vous cherchez avant tout une solution de traduction ? Consultez Traduction de la documentation Mintlify.

Est-ce que je peux simplement traduire ma documentation avec une API d’IA ?

Pour une traduction ponctuelle, oui. Mais publier chaque semaine une documentation fiable dans toutes les langues nécessite tout un système autour du modèle.

Vos pages ne se limitent pas à du texte. Les composants MDX, les importations et les blocs de code doivent être restitués à l’identique, les métadonnées frontmatter doivent conserver leurs clés et les identifiants de titres comme {#configure-client} doivent rester en place pour préserver les liens profonds.

Votre documentation est un site, pas une simple page. Il faut une version de la navigation par langue, les codes de paramètres régionaux doivent être acceptés par votre plateforme et « workspace » doit être traduit de la même façon à la page 1 et à la page 400 (ainsi que dans votre application, dont nous prenons également en charge la localisation).

Votre documentation évolue chaque semaine. Chaque mise à jour doit traduire uniquement ce qui a changé, conserver les corrections manuelles de vos relecteurs et faire l’objet d’une pull request sur la bonne branche. L’ajout d’une langue par la suite ne doit pas perturber celles déjà en place.

Les membres de votre équipe doivent pouvoir garder la main et suivre le travail : consulter chaque ligne à côté du texte source, accéder à l’historique et aux commentaires, et disposer de rôles et de consignes de ton pour chaque langue.

General Translation gère tout cela de bout en bout. Nous traitons des milliers de PRs de localisation pour nos clients, afin qu’ils puissent se concentrer sur la création d’un produit apprécié dans le monde entier.

Combien de temps prend la configuration initiale ?

Quelques minutes suffisent, sans migration. Connectez votre dépôt, choisissez vos langues et fusionnez la pull request ouverte par General Translation ; la traduction s’effectue ensuite à grande échelle (Ramp a traduit 40 000 clés, soit des millions de mots, en quelques minutes). Vous pouvez aussi confier la configuration initiale à votre agent de codage à l’aide du bouton Configuration initiale pour les agents.

Quelles langues sont prises en charge ?

Toutes les langues prises en charge par Mintlify, notamment l’espagnol, le français, l’allemand, le japonais, le coréen, le chinois (simplifié et traditionnel), le portugais (y compris le portugais du Brésil), l’arabe, l’hébreu et l’hindi. General Translation associe les paramètres régionaux de votre choix aux codes de langue de Mintlify. Pour les variantes régionales, la langue de base est utilisée, sauf si Mintlify les prend directement en charge. Consultez la liste complète.

Les traductions resteront-elles à jour à mesure que ma documentation évolue ?

Oui, en continu. Notre Locadex Agent s’exécute selon les déclencheurs que vous choisissez : pull request, commit ou déclenchement manuel. Il traduit uniquement ce qui a changé, plutôt que l’ensemble du site, et fournit les traductions via une pull request. Chaque livraison intègre ainsi les modifications et leurs traductions dans toutes les langues en même temps.

Les traductions respecteront-elles notre ton et notre terminologie ?

General Translation vous permet de définir des instructions personnalisées pour préciser votre ton et votre style, ainsi qu’un glossaire pour fixer les noms de produits et les termes clés. Le contexte est pris en compte de manière cohérente dans toutes vos traductions : application, site web, documentation, présentations et fichiers de conception.

La traduction risque-t-elle de casser mes composants MDX ?

Non. La traduction préserve la syntaxe MDX et la structure des composants tout en traduisant le contenu lisible par l’humain. Les titres et descriptions du frontmatter sont également traduits pour les sites Mintlify.

Combien cela coûte-t-il ?

Une facturation à l’usage, sans frais par utilisateur ni abonnement. L’offre Starter est sans frais de plateforme et inclut un nombre illimité de projets, d’utilisateurs et de langues, ainsi qu’un quota gratuit pour démarrer. Consultez la page des tarifs pour connaître l’ensemble des tarifs.

Rendez votre documentation Mintlify accessible à un public international

Commencez gratuitement, sans frais mensuels