Localisez votre documentation Markdown

Traduisez tous les fichiers Markdown de votre documentation en quelques minutes avec General Translation

Commencer

content/docs/en-US/platform/locadex/quickstart.md

  1. ---
  2. title: Quickstart
  3. description: Use Locadex, the AI agent which connects your codebase, translations, and content sources. It’s the fastest way to run General Translation's full-stack localization.
  4. ---
  5. Locadex is the General Translation AI agent which connects your codebase, translations, and content sources.
  6. After setup, Locadex can configure your project and automatically translate it into the languages you choose.
  7. Locadex currently supports **Next.js**, **Mintlify**, **Fern**, and **Docusaurus** projects, along with React applications built with Vite, Gatsby, Redwood, React Router, TanStack Start, Bazel, esbuild, Rollup, Rolldown, or webpack.
  8. ## How Locadex works [#locadex-works]
  9. Locadex works inside your GitHub repository and automatically opens or updates PRs with generated changes. Three automation templates keep your localization up to date:
  10. - **Generate code** wraps source code with the right internationalization (i18n) library calls, such as `t()` and the `T` component.
  11. - **Generate translations and push** translates source content into every target language and updates translation files.
  12. - **Keep locales in sync** updates project files when languages are added or removed.

npx gt translatees, fr, ja

Localisez votre documentation dans n’importe quelle langue, en quelques étapes

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

  1. Lancez l’assistant de configuration initiale

    Exécutez npx gt init dans le dépôt de votre documentation, choisissez Markdown comme format de fichier et sélectionnez vos langues cibles.

  2. Indiquez l’emplacement de vos fichiers

    L’assistant ajoute à gt.config.json un motif glob pour vos fichiers .md, avec un dossier [locale] pour chaque langue. Vous n’avez aucun code à modifier.

  3. Traduisez et déployez

    Exécutez npx gt translate : la CLI génère une copie traduite de chaque fichier, en préservant toute la syntaxe et la mise en forme Markdown. Enregistrez les fichiers traduits dans votre dépôt et publiez-les avec votre site de documentation.

Comment maintenir les traductions à jour à chaque déploiement ?

Transcription

In Montreal, your French page shows the line you added this week in English. Your build script runs next build alone, so the line was never translated. General Translation keeps translations current when your CI runs npx gt translate before the build. Create an API key for CI with the file, context and translation queue permissions. Store it and your project ID as secrets in your CI provider. Add npx gt translate to your build script, before the build command. Run that build on every push to main, for example with a GitHub Actions workflow. Each build then ships current translations in Spanish, Japanese and French.

Les meilleures entreprises au monde nous font confiance

General Translation développe une stack de localisation complète pour simplifier le travail des développeurs

  • 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

Exécutez npx gt translate avant la compilation de votre documentation : chaque exécution ne traduit que ce qui a changé, pour que votre documentation soit disponible dans toutes les langues à chaque déploiement

  1. Envoyez une modification de la documentation
  2. Votre processus de compilation exécute la CLInpx gt translate
  3. Seul ce qui a changé est traduit
  4. Déployé 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 transpose le 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. Pour la documentation Markdown, l’internationalisation consiste à organiser les fichiers dans un dossier par locale pour que votre site puisse les servir, et la traduction à produire chaque fichier dans chaque langue. General Translation gère l’ensemble du workflow de localisation, en continu.

Vous vous intéressez plus particulièrement à la traduction ? Consultez Traduction Markdown.

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 être intégrée à votre dépôt lors de la compilation. 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. Exécutez npx gt init, choisissez vos langues, puis lancez npx gt translate ; 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 ?

General Translation prend en charge plus de 120 paramètres régionaux, dont des variantes régionales comme pt-BR et zh-Hant et des langues s’écrivant de droite à gauche comme l’arabe et l’hébreu. Indiquez-les dans gt.config.json et ajoutez-en d’autres quand vous le souhaitez. Consultez les paramètres régionaux pris en charge.

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

Oui, en continu. Exécutez npx gt translate dans votre pipeline CI avant la compilation de votre documentation. Seul le contenu dont la source a changé est traduit, et vos modifications locales sont conservées. 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 d’altérer ma mise en forme Markdown ?

Non. La CLI préserve toute la syntaxe et la mise en forme Markdown dans chaque fichier traduit, et les identifiants de titre explicites tels que {#id} restent associés à leurs titres.

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 Markdown accessible à un public international

Commencez gratuitement, sans frais mensuels