Ajouter des langues à un site de documentation
Publiez un site de documentation en plusieurs langues : choisissez les langues du site et la langue par défaut, traduisez les articles, les pages du site, les titres et les étiquettes du menu, et découvrez ce que voient les lecteurs lorsqu'une page n'est pas encore traduite.
Un site de documentation peut être publié en plusieurs langues. Chaque article et chaque page du site possède sa propre copie par langue, les lecteurs changent de langue dans l'en-tête du site, et une page qui n'est pas encore traduite s'affiche dans votre langue par défaut. L'offre Free permet 2 langues par site, Starter 5, et l'offre Pro et supérieures autant que vous le souhaitez.
Avant de commencer
- Les propriétaires, administrateurs et éditeurs peuvent modifier les langues d'un site.
- Vous pouvez choisir parmi 74 langues, y compris des variantes régionales telles que Anglais (Royaume-Uni) et Espagnol (Amérique latine).
| Forfait | Langues par site |
|---|---|
| Free | 2 |
| Starter | 5 |
| Pro, Business, Custom | Illimité |
Ajouter une langue
Ouvrir les paramètres du site
Ouvrez votre site de documentation et accédez à Paramètres → Général.
Ajouter des langues
Sous langues, ajoutez les langues souhaitées. "Les articles existent par langue ; les lecteurs changent de langue dans l'en-tête." Un compteur indique combien votre forfait autorise.

Le paramètre Langues dans Paramètres, Général Vérifier la langue par défaut
Langue par défaut est "La langue dans laquelle vous rédigez le contenu du site. Son adresse ne comporte pas de préfixe de langue." C'est la langue vers laquelle les lecteurs sont redirigés par défaut et celle à partir de laquelle les traductions sont effectuées.
Enregistrer et publier
Cliquez sur Enregistrer, traduisez vos pages (voir ci-dessous), puis publiez le site.
Fonctionnement des adresses
La langue par défaut se trouve à la racine du site ; chaque autre langue reçoit un préfixe composé de son code.
| Langue | Exemple d'adresse |
|---|---|
| Anglais (par défaut) | help.example.com/getting-started |
| Allemand | help.example.com/de-de/getting-started |
| Japonais | help.example.com/ja-jp/getting-started |
Pour cette raison, aucune page ou section ne peut utiliser un code de langue comme adresse. Si c'est le cas, l'ajout de cette langue affichera : "Une page ou une section utilise déjà l'adresse /de-de. Modifiez son slug avant d'ajouter cette langue."
Traduire votre contenu
L'ajout d'une langue ne traduit rien automatiquement. Chaque type de contenu a sa propre méthode, et seule la traduction IA des pages complètes utilise des crédits.
| Élément | Comment le traduire | Coût |
|---|---|---|
| Articles | Ouvrez la page dans Pages du site, choisissez le menu Langue dans la barre supérieure, puis Traduire…. Chaque langue est une copie distincte que vous pouvez modifier. Voir Modifier un article. | Crédits, comme toute traduction d'article |
| Pages du site | ⋯ → Traduire vers toutes les langues… dans la barre supérieure de la page. Voir Créer des pages de site. | Crédits, affichés comme Article IA |
| Titres de page, titres de menu et résumés | Détails → langues : choisissez la langue à modifier, ou cliquez sur Traduire depuis l'anglais | Gratuit |
| Titres de section | Traduire le titre de la section ou Traduire le titre… dans le menu de la section dans Pages du site | Gratuit |
| Étiquettes de menu | Traduire toutes les étiquettes dans Menu de navigation. Voir Configurer le menu de navigation du site. | Gratuit |
| Titre et sous-titre de la page d'accueil | Autres langues → Traduire vers toutes les langues sous chaque champ dans Apparence | Gratuit |
| Entrées du journal des modifications | L'action de traduction propre à l'entrée. Voir Publier un journal des modifications du site. | Crédits |
Les traductions gratuites sont limitées à 60 requêtes par espace de travail par heure. Au-delà : "Vous avez beaucoup traduit au cours de la dernière heure. Réessayez dans un moment." Le texte que vous laissez vide dans une langue affiche le texte de la langue par défaut : "Les éléments vides affichent le texte en anglais."
Dans les paramètres de page, chaque langue indique son état d'avancement, par exemple "Dans 2 sur 3", avec un drapeau par langue ; un drapeau grisé signifie "non traduit, les lecteurs voient l'anglais".
Réviser les traductions IA des pages du site
Les traductions IA des pages du site sont enregistrées en tant que brouillons jusqu'à ce que quelqu'un les marque comme prêtes, afin qu'aucun contenu non vérifié ne soit publié. Pour ignorer cette révision, activez Publier les traductions IA sans révision dans Paramètres → Publication. "Désactivé : les pages du site traduites restent en tant que brouillons jusqu'à ce que quelqu'un les marque comme prêtes." C'est désactivé par défaut.
Ce que voient les lecteurs
- L'en-tête dispose d'un sélecteur de Langue avec toutes les langues publiées.
- La même page dans une autre langue s'ouvre à l'adresse correspondante, afin que les lecteurs restent sur la page qu'ils lisaient.
- Si une page n'a pas de copie dans la langue du lecteur, il voit la version dans la langue par défaut avec "Cette page n'est pas encore disponible dans votre langue, elle est donc affichée en anglais."
- Les langues s'écrivant de droite à gauche, comme l'arabe et l'hébreu, se lisent de droite à gauche.
Si votre forfait change
Si votre espace de travail passe à un forfait avec moins de langues, rien n'est supprimé. Les langues dépassant la limite restent dans vos paramètres avec leurs articles mais ne sont pas publiées : "Non publié sur votre forfait : Italien, Néerlandais. Ils restent ici avec leurs articles." Vous ne pouvez pas ajouter d'autre langue tant que vous n'êtes pas en dessous de la limite ou que vous n'avez pas mis à niveau.
Dépannage
| Vous voyez | Que faire |
|---|---|
| "Votre forfait publie jusqu'à 2 langues par site. Starter inclut 5 langues." | Supprimez une langue ou mettez à niveau. |
| "La langue par défaut doit être l'une des langues du site." | Ajoutez la langue aux langues avant de la définir comme langue par défaut. |
| "Une page ou une section utilise déjà l'adresse /fr-fr. Modifiez son slug avant d'ajouter cette langue." | Renommez d'abord l'adresse de cette page ou section. |
| "Aucun article dans cette langue pour le moment." | L'article n'a pas de copie dans la langue vers laquelle vous avez basculé. Utilisez Traduire… dans le menu Langue. |
| "Votre forfait ne publie pas cette langue. Mettez à niveau pour traduire vers celle-ci." | La langue dépasse la limite de votre forfait. Mettez à niveau ou supprimez une autre langue. |
| "Rédigez d'abord la page en anglais, puis traduisez-la." | Une page de site nécessite du texte dans la langue par défaut avant de pouvoir être traduite. |
| "Aucune traduction n'a été renvoyée. Réessayez." | La traduction gratuite n'a rien renvoyé. Réessayez dans un instant. |