---
title: Traduire un site MkDocs avec l'IA | Smartcat
description: Traduisez votre site MkDocs avec l'IA et examinez-le en contexte. Installez via une surcharge de thème pour le bloc head.
canonical: https://fr.smartcat.com/integrations/mkdocs/
language: fr
updated: 2026-11-16
---

# Traduire un site MkDocs avec l'IA | Smartcat

## Traduisez votre site MkDocs avec l'IA

Ajoutez l'extrait de site Web Smartcat à votre projet MkDocs une seule fois, déployez-le via votre pipeline habituel et effectuez la Tévision des traductions dans Smartcat avant de publier une langue.

- [Commencer l'essai gratuit](https://smartcat.com/sign-up)

- [Réserver une démo](https://www.smartcat.com/book-a-demo/?mkdocs)

## Comment ajouter Smartcat à MkDocs

Créez un projet de site web Smartcat à partir de l'URL de votre site MkDocs publié et choisissez les langues cibles.

Installez l'extrait de code Smartcat généré via une surcharge de thème pour le bloc head (extra_javascript charge uniquement les ressources).

Déployez la modification et ouvrez le site publié pour confirmer que l'extrait est présent.

Vérifiez les traductions dans le logiciel informatique visuel de Smartcat et publiez les langues qui sont prêtes.

## Traduire un site MkDocs sans révision du HTML généré

Conservez l'intégration dans la configuration source de votre MkDocs. extra_javascript charge les ressources JavaScript, tandis qu'une surcharge du thème peut être nécessaire lorsque l'installation fournie requiert un balisage d'en-tête. Avec Material for MkDocs, utilisez l'extension de modèle prise en charge plutôt que de modifier le paquet de thème installé.

Reconstruisez et déployez, puis examinez un guide comprenant une navigation, des avertissements et des exemples de code. Un avertissement traduit doit conserver sa gravité, et un exemple de commande doit rester exécutable. La traduction de site web ne produit pas un deuxième ensemble de sources Markdown.

## Quelles modifications pour les visiteurs, et ce qui reste dans MkDocs

La traduction de sites Web apporte des modifications à l'expérience de lecture publiée. Il ne crée pas de fichiers sources traduits, de catalogues de messages ou de builds de paramètres régionaux dans votre dépôt MkDocs.

## Examiner avant qu'une langue ne soit mise en ligne

La traduction automatique vous offre un premier jet rapide. Dans le logiciel informatique visuel de Smartcat, vous voyez chaque suite traduite sur la page, raccourcissez les titres trop longs sur mobile et maintenez la cohérence des noms de produits et de marques grâce à un glossaire. Faites l'attribution d'une personne pour examiner lorsqu'une page a besoin d'approbation, et ne publiez que les langues qui sont prêtes.

## Foire aux questions

### Puis-je coller des tags de script HTML dans extra_javascript ?

extra_javascript est une configuration de ressources, et non un champ d'en-tête HTML libre. Suivez sa structure bénéficiant d'une assistance et utilisez une surcharge de thème lorsque le balisage réel est requis.

### Puis-je éditer les traductions avant de publier ?

Oui. Peaufinez et confirmez la formulation dans le logiciel informatique visuel de Smartcat, puis publiez les langues prêtes.

### Que se passe-t-il lorsque j'ajoute une nouvelle page dans MkDocs ?

Le nouveau texte suit le mode de traduction sélectionné du projet Smartcat. Choisissez des traductions révisées lorsque chaque nouvelle page nécessite une approbation ; les modes automatiques peuvent traduire le texte nouvellement rencontré. Aucun des deux modes n'apporte de modifications à votre contenu source dans MkDocs.

Publiez votre site MkDocs dans plus de langues

Installez l'extrait de code une seule fois, effectuez la révision des traductions en contexte et publiez les langues dont votre public a besoin. Voir toutes les [intégrations de sites web](https://www.smartcat.com/integrations/category/website-translation/) ou découvrir comment fonctionne le [traducteur de site web](https://www.smartcat.com/website-translator/).

- [Commencer l'essai gratuit](https://smartcat.com/sign-up)
