Docsbook
Aperçu

Documentation multilingue SEO : hreflang et URLs

La plupart des documents produits en 2026 sont uniquement en anglais. Les équipes qui traduisent correctement capturent le trafic organique que les sites uniquement en anglais ne voient jamais — des recherches en japonais, espagnol, allemand, mandarin pour la même intention d'achat.

Ce post est le guide pratique SEO pour expédier des documents en 15 langues sans perturber la recherche Google ou AI.

TL;DR#

  • Chaque langue doit vivre à une URL séparée (/ja/, /es/, /de/)
  • Ajoutez des balises hreflang afin que les moteurs de recherche sachent ce qui est une traduction de quoi
  • Utilisez l'attribut lang sur l'élément <html>
  • La traduction par IA en 2026 est suffisamment bonne pour la documentation (pas pour le contenu marketing)
  • Une source anglaise canonique, traductions par IA en plus — ne jamais dupliquer les sources

La règle fondamentale#

Une URL par paire (page, langue).

Incorrect :

docs.yourcompany.com/quick-start?lang=ja
docs.yourcompany.com/quick-start (with cookies)

Correct :

docs.yourcompany.com/quick-start
docs.yourcompany.com/ja/quick-start
docs.yourcompany.com/es/quick-start

Sans des URLs séparées, il n'y a rien à indexer pour un moteur de recherche par langue : une URL contient un document dans son index, donc quelle que soit la langue qu'il a vue, c'est la seule qui peut se classer. Chaque autre locale est invisible pour la recherche dans sa propre langue, peu importe la qualité de la traduction.

configuration hreflang#

Chaque page a besoin de <link rel="alternate" hreflang="..."> balises pointant vers chaque traduction.

<link rel="alternate" hreflang="en" href="https://docs.yourcompany.com/quick-start">
<link rel="alternate" hreflang="ja" href="https://docs.yourcompany.com/ja/quick-start">
<link rel="alternate" hreflang="es" href="https://docs.yourcompany.com/es/quick-start">
<link rel="alternate" hreflang="x-default" href="https://docs.yourcompany.com/quick-start">

x-default indique à Google "si aucune autre locale ne correspond, affichez ceci." Généralement la version anglaise.

Docsbook génère hreflang automatiquement lorsque vous activez une langue dans Paramètres → Langues.

Quand la traduction par IA est suffisamment bonne#

Trois facteurs :

Type de contenu Qualité de la traduction par IA Recommandation
Documents de référence (API, configuration) Élevée Utiliser l'IA
Tutoriels et guides pratiques Élevée Utiliser l'IA, révision humaine légère
Pages de destination marketing Moyenne Révision humaine requise
Texte de marque (slogans, mission) Faible Traduction humaine
Exemples de code N/A Conserver l'original
Messages d'erreur Élevée lorsque la terminologie est cohérente Utiliser l'IA

La qualité de la traduction LLM pour le contenu technique s'est améliorée de manière significative entre 2023 et 2026. Pour la documentation spécifiquement, la traduction automatique présente des avantages structurels par rapport à un processus humain plutôt qu'un simple avantage de coût :

  • Cohérence terminologique. Un modèle applique le même terme au même concept sur mille pages ; un pool tournant de traducteurs humains dérive, et la dérive est invisible jusqu'à ce qu'un lecteur signale un bug à ce sujet.
  • Vitesse. Quinze langues en quelques minutes plutôt qu'un cycle de devis et de planification par langue.
  • Coût de révision. La véritable dépense de la traduction humaine n'est pas le premier passage mais chaque passage suivant : changez un paragraphe et vous payez à nouveau par mot, dans chaque langue. La traduction automatique recalculera la page modifiée. C'est pourquoi les documents traduits deviennent obsolètes sous un pipeline humain et restent à jour sous un pipeline automatique.

Ce que les humains surpassent encore :

  • Localisation culturelle (formats de date, exemples, voix de marque)
  • Texte juridique à enjeux élevés
  • Slogans marketing

Pour la documentation, le rapport coût-bénéfice penche fortement en faveur de la traduction par IA en 2026.

Chaque langue indexée séparément#

Trois signaux sont importants :

  1. Modèle d'URL — /ja/ sous-répertoire ou ja.yourdomain.com sous-domaine (le sous-répertoire est plus facile)
  2. Balises hreflang — bidirectionnelles, pointent dans les deux sens entre toutes les versions
  3. lang attribut — <html lang="ja"> sur la version japonaise
  4. Entrées de Sitemap — chaque langue obtient sa propre entrée avec des annotations xhtml:link

Google classe ensuite chaque langue dans les résultats de recherche de son locale respectif. Un utilisateur au Japon cherchant en japonais voit /ja/. Un utilisateur en Espagne cherchant en espagnol voit /es/.

Ce que les moteurs de recherche AI font avec les traductions#

Trois comportements observés :

ChatGPT#

ChatGPT citera une page traduite si la requête est dans cette langue. Demander à ChatGPT "ドキュメンテーションプラットフォームを比較してください" (comparez les plateformes de documentation en japonais) renvoie des sources japonaises, y compris des versions japonaises des documents.

Perplexité#

Identique à ChatGPT — La perplexité correspond strictement à la langue de la requête à la langue source. Si vous traduisez bien, vous gagnez un canal de citation par langue.

Gémeaux#

Google Gemini utilise l'index sous-jacent de Google. Les mêmes signaux hreflang et de locale qui aident les Aperçus de l'IA de Google aident Gemini.

Comment Docsbook propose plusieurs langues#

Trois étapes pour activer une langue :

  1. Tableau de bord → Paramètres → Langues → sélectionner la langue → activer
  2. L'IA traduit l'ensemble du document dans cette langue ; la traduction est facturée en dollars sur le solde du projet
  3. La page apparaît à /{language-code}/{path} avec hreflang et lang correctement définis

15 langues prises en charge : EN, ES, FR, DE, PT, IT, RU, ZH, JA, KO, AR, HI, TR, PL, NL.

Vous pouvez également télécharger vos propres traductions via l'outil MCP upload_translation ou l'interface admin si vous avez un traducteur humain.

Modes de traduction#

Trois modes disponibles :

  • Auto — Docsbook AI traduit tout automatiquement
  • Manuel — file d'attente des traductions en attente, vous révisez avant publication
  • Externe — webhook votre propre pipeline de traduction (votre TMS, vos traducteurs)

Le mode externe est destiné aux équipes qui ont déjà une mémoire de traduction et souhaitent continuer à l'utiliser. L'set_translation_mode outil MCP bascule entre les modes.

Erreurs qui tuent le SEO multilingue#

  • Changement de paramètre de requête (?lang=ja) — Google n'indexe pas ces pages comme distinctes
  • Détection de langue basée sur les cookies — même problème, une seule URL est indexée
  • Balises hreflang manquantes — Google considère les traductions comme du contenu dupliqué
  • hreflang unidirectionnel — les deux pages doivent se référencer mutuellement
  • Aucun lang attribut — les lecteurs d'écran et les robots d'exploration reviennent à l'anglais

Économie des coûts#

Traduire 200 pages en 14 langues supplémentaires :

Traduction humaine DIY Traduction AI Docsbook
Coût Par mot, cité par langue, payé à nouveau à chaque révision Mesuré par traduction effectuée contre le solde du projet
Temps Mois Heures
Coût de mise à jour Facturé à nouveau par mot chaque fois que la page source change Recalculé lorsque la source change
Indexation SEO Configuration hreflang manuelle Automatique par locale
Meilleur pour Contenu juridique, réglementé et marketing où un humain doit approuver Contenu de référence et de mode d'emploi qui change souvent

La traduction automatique n'est pas strictement meilleure. Elle est meilleure pour ce qui tue la plupart des projets de traduction, qui n'est pas le premier passage mais la vingtième révision.

Commencer gratuitement — pas de carte de crédit

Étapes suivantes#

Updated

Cette page vous a-t-elle été utile ?

Propulsé par Docsbook