Traduction

Docsbook publie votre documentation dans quinze codes de langue. Vous n’avez pas à écrire, stocker ou gérer de fichiers de traduction : vous activez une langue, et Docsbook traduit les pages directement à partir du Markdown déjà présent dans votre dépôt, publie chaque langue sur son propre chemin d’URL et retraduit une page lorsqu’un commit la modifie.

Une documentation traduite automatiquement est généralement un handicap — identifiants de code déformés, terminologie qui varie d’une page à l’autre, traductions qui se dégradent discrètement lorsque la source évolue, et URL localisées qui nuisent à votre visibilité dans les moteurs de recherche au lieu de l’améliorer. Le reste de cette section explique comment le pipeline de Docsbook traite chacun de ces problèmes, et dans quels cas il ne les traite toujours pas.

Ce que l'ouverture d'une langue vous apporte#

Trois éléments concrets, que vous pouvez tous vérifier vous-même.

Un ensemble distinct d'URL auxquelles une requête dans cette langue peut correspondre. Chaque langue correspond à un chemin d'URL distinct, généré en HTML statique, répertorié dans votre sitemap et associé à sa propre entrée hreflang. Une page uniquement en anglais ne peut pas correspondre à une requête en espagnol, quel que soit son classement ; une page en espagnol le peut. Les propres recommandations de Google indiquent que les pages traduites sont le moyen de devenir éligible auprès de ce public — et non un problème de contenu dupliqué — et Docsbook crée le cluster hreflang par page plutôt que par site, afin que le cluster qu'il publie soit accepté par Google. Le mécanisme, ainsi que la manière dont il échoue lorsqu'il est mis en œuvre négligemment, sont expliqués dans Qualité de traduction et SEO.

Une recherche sur le site qui fonctionne dans la langue du lecteur. Lorsqu'une page est traduite, le texte traduit est indexé pour la recherche en texte intégral sous le code de cette langue, et pas seulement l'original anglais. Un lecteur qui effectue une recherche en allemand trouve des pages en allemand.

Une documentation qu'un assistant peut citer dans cette langue. Le même HTML statique qu'un robot d'exploration lit est celui qu'un assistant IA récupère. La traduction étend la couverture GEO aux langues que vous ouvrez, car il existe désormais une page dans cette langue à citer.

Ce que cela coûte#

Effort. Activer une langue se résume à cocher une case et à confirmer dans une boîte de dialogue. Il n'y a aucune étape d'exportation, aucun fichier .po, aucune clé ni aucun compte fournisseur. Corriger ensuite une phrase précise consiste à la modifier dans le panneau Traductions ou à effectuer un appel upload_translation — consultez le processus de correction.

Coût financier. Traduire consomme le solde IA de votre projet ; afficher une page déjà traduite à un lecteur ne coûte rien. Une page est divisée en sections identifiées par le hachage du contenu : si vous modifiez un paragraphe, cette section est retraduite et le reste est réutilisé depuis le cache. Docsbook vous fournit une estimation avant que vous ne confirmiez l'exécution et s'arrête plutôt que de dépasser le solde lorsque celui-ci est épuisé. La traduction automatique et les outils du processus de traduction font partie du forfait payant — consultez Tarifs.

Attention. C'est le coût que la plupart des équipes sous-estiment. La traduction automatique de textes techniques est suffisamment bonne pour être publiée, mais pas suffisamment bonne pour être ignorée : la dérive terminologique et la traduction excessive des termes propres au domaine sont les problèmes documentés, et les règles de Google concernant le spam considèrent la traduction automatique non révisée comme un risque pour votre site, et non comme un acte neutre. Qualité de la traduction et SEO précise ce que Docsbook mesure, ce qu'il ne mesure pas et ce que vous devriez vérifier.

Dans cette section#

Limites et questions ouvertes#

• Quinze codes de langue, et uniquement ceux-ci. en, es, fr, de, pt, it, ru, zh, ja, ko, ar, hi, tr, pl, nl. L’un d’eux est la langue source de votre projet, qui n’est jamais une cible de traduction — un projet en anglais dispose donc de quatorze cibles. Les variantes régionales (pt-BR par rapport à pt-PT, zh-Hans par rapport à zh-Hant) ne sont pas des options distinctes.
• Docsbook ne publie aucun score de qualité de traduction. Il n’existe pour vos pages aucun indicateur BLEU, COMET ou d’évaluation humaine, et cette documentation n’en revendique aucun. Le produit mesure la couverture et la fraîcheur — le nombre de pages disponibles dans chaque langue et le nombre de pages traduites à partir de la version actuelle de la source. Considérez que « la traduction est bonne » est un jugement qui vous revient, à fonder sur les éléments présentés dans Qualité de la traduction et SEO.
• La traduction automatique est une fonctionnalité payante, tout comme la configuration linguistique qui l’accompagne. Un projet gratuit voit les paramètres et détecte automatiquement sa langue source lors de la connexion, mais ne peut pas modifier les langues activées ni la langue source, définir le mode de traduction ou lancer une passe. Consultez Tarifs.
• Le pipeline traduit les pages Markdown de votre dépôt. Il ne s’agit pas d’un système de localisation des chaînes de l’interface utilisateur et il ne traduit pas les descriptions des champs d’une spécification OpenAPI.

Articles connexes#

• SEO — ce que Docsbook émet pour les moteurs de recherche sur chaque page, qu’elle soit traduite ou non
• GEO — être cité par un assistant IA plutôt qu’être classé
• Rapport sur les pays des visiteurs — les régions d’où viennent les visiteurs et pour lesquelles vous n’avez pas encore effectué de traduction
• Contenu & Configuration — comment les pages sont intégrées à Docsbook au départ