Traduire la documentation Docusaurus dans une autre langue, sans altérer le MDX ni le code
Compressez votre dossier docs en ZIP, importez-le et récupérez les mêmes fichiers traduits, prêts à être déposés dans i18n/<locale>/docusaurus-plugin-content-docs/current. Les lignes d'import, Tabs et autres composants, balises d'encarts, blocs de code et liens restent inchangés ; les titres, labels de la barre latérale, descriptions et textes sont traduits. Le début est gratuit et sans inscription ; jusqu'à 1,000,000 caractères de texte pour $5, en paiement unique.
- Lignes import, export et composants JSX recopiés à l'identique
- Balises d'encarts (:::note, :::tip) préservées ; seul le texte interne est traduit
- Front matter : title, description et sidebar_label traduits ; id, slug, sidebar_position conservés
- Ancres de titres telles que {#install} conservées pour que les liens continuent de fonctionner
- Même arborescence restituée dans un .zip ; images copiées à l'identique
Docusaurus i18n sans copier-coller
Docusaurus requiert une copie traduite de chaque document dans le dossier de locale, avec des noms de fichiers identiques. Faire cela à la main ou fichier par fichier avec un chatbot IA prend du temps, et le MDX ne pardonne pas : un nom d'import traduit ou une prop modifiée fait planter le build. Cet outil ne traduit que les éléments visibles pour le lecteur et copie tout le reste de vos fichiers.
Le code inline, les cibles de liens, les chemins d'images et les {expressions} MDX sont remplacés par des balises avant la traduction puis restaurés ensuite, de sorte que le modèle ne les voit jamais. Les lignes contenant uniquement du JSX, comme <Tabs> ou <TabItem value="mac">, sont ignorées. Les blocs de code sont entièrement laissés de côté, y compris leurs commentaires.
Après le téléchargement
- Décompressez l'archive et copiez le contenu du dossier docs-<locale> dans i18n/<locale>/docusaurus-plugin-content-docs/current
- Lancez docusaurus write-translations pour les libellés du thème et les noms de catégories de la barre latérale, stockés en JSON
- Démarrez le site avec --locale <locale> et vérifiez l'affichage des pages
- Corrigez les paragraphes listés dans le fichier d'avertissements, le cas échéant
Non inclus
Les labels des catégories de la barre latérale, le texte de la barre de navigation et du pied de page sont stockés dans des fichiers JSON générés par write-translations ; traduisez-les avec l'outil pour fichiers de localisation. Les articles de blog fonctionnent de la même manière que la doc : compressez le dossier blog en ZIP et envoyez-le dans une seconde tâche, ou réunissez docs et blog dans un seul .zip.
Le fonctionnement de l'outil, son coût et le traitement de vos fichiers sont détaillés sur la page Traduire de la documentation Markdown ; les prix de chaque outil figurent sur la page tarifs.
Dernière mise à jour :
Questions et réponses
Le build continuera-t-il de réussir ?
Les imports, composants, props, blocs de code et cibles de liens sont copiés à l'identique depuis vos fichiers, ce qui évite les erreurs habituelles de build MDX. Lancez le build une fois la copie effectuée et consultez le fichier d'avertissements.
Les encarts sont-ils traduits ?
Les lignes :::note et ::: restent intactes ; seul le texte situé entre ces balises est traduit.
Quel volume une seule tâche peut-elle traiter ?
Jusqu'à 1,000,000 caractères de texte, soit environ 300 pages, pour $5. Le code et les clés du front matter ne sont pas comptabilisés.
Puis-je tester sur quelques fichiers d'abord ?
Oui. Le début est traduit gratuitement et affiché à l'écran ; une tâche de 40 paragraphes ou moins est entièrement gratuite.