Le Générateur Hreflang de Screpy crée des balises HTML, des fragments de sitemap XML ou des déclarations HTTP Link pour un groupe de pages équivalentes dans différentes langues. Saisissez 2 à 50 codes pris en charge avec leurs URL, choisissez un format, puis copiez ou téléchargez la sortie de chaque page. Les annotations proviennent de vos valeurs : le générateur ne visite pas les URL, n’installe aucun code et ne confirme pas les liens de retour entre pages publiées.
Préparer un groupe de pages équivalentes
Utilisez une génération pour les versions d’une même page : le même produit, article ou service dans différentes langues ou différents marchés. Une page d’accueil française et une fiche produit anglaise ne sont pas équivalentes parce qu’elles partagent un domaine. Recommencez pour le contenu suivant, plutôt que de réunir toutes les URL traduites du site dans un groupe.
Pour un produit fictif avec des versions anglaise et turque, préparez ces valeurs :
| Champ | Valeur | Rôle |
|---|---|---|
| Langue et URL | en — https://example.com/en/blue-shirt/ |
Fiche produit anglaise |
| Langue et URL | tr — https://example.com/tr/mavi-gomlek/ |
Fiche produit turque équivalente |
| URL x-default facultative | https://example.com/choose-language/ |
Destination adaptée au choix de langue |
Les chemins traduits peuvent différer. Copiez chaque URL publique prévue au lieu de la construire en remplaçant le dossier de langue. Indiquez l’adresse HTTP ou HTTPS complète et gardez l’hôte, le chemin et la barre finale cohérents avec la destination à publier. Les identifiants dans les URL ne sont pas acceptés. Le formulaire supprime les fragments comme #details : utilisez des adresses de pages, pas des liens vers des sections.
Choisir des codes de langue pris en charge
Ce générateur accepte une langue à deux lettres, comme en, tr ou de, éventuellement suivie d’une région prise en charge à deux lettres, comme en-GB ou pt-BR. Utilisez en pour une page destinée aux anglophones en général ; choisissez un code régional si vous maintenez réellement cette version régionale. Un pays seul, tel que GB, ne désigne pas une langue.
Chaque ligne normale doit avoir un code différent. en-US et en-us correspondent à la même saisie : changer les majuscules ne crée pas une autre version. Les codes générés utilisent des minuscules pour la langue et des majuscules pour la région. Vérifiez-les avant de copier, notamment la différence entre la langue uk et la région GB pour le Royaume-Uni.
Le formulaire prend uniquement en charge les codes langue et langue-région. Il n’accepte pas les combinaisons d’écriture comme zh-Hant, même si Google les prend en charge dans les cas adaptés. Si votre mise en œuvre en a besoin, préparez-les en dehors de ce générateur. L’acceptation d’un code ne confirme pas non plus que le texte de la page correspond à cette langue.
Décider d’ajouter ou non x-default
Une URL x-default indique une destination pour les internautes dont la langue ou la région n’est pas couverte par les autres options. Il peut s’agir d’un sélecteur de langue ou d’une page existante choisie par défaut. L’explication de Google sur x-default présente les deux possibilités. Choisissez une destination utile à ce groupe de pages ; n’envoyez pas les visiteurs de chaque produit vers une page sans rapport pour simplement remplir le champ.
Le champ est facultatif. Le laisser vide n’ajoute aucune annotation par défaut. Fournir une URL ajoute hreflang="x-default" à chaque ensemble généré, sans créer de redirection du navigateur ni d’interface de sélection de langue.
Avec les deux lignes de langue de l’exemple, ajouter le sélecteur produit deux blocs de sortie comprenant chacun trois alternatives : en, tr et x-default. Aucun troisième bloc n’est créé pour le sélecteur. Si la destination par défaut est une page distincte, configurez vous-même ses annotations correspondantes. Si elle figure déjà parmi les URL des lignes normales, cette page possède déjà un bloc généré. Vérifiez cette distinction avant de supposer que chaque destination dispose de son code d’installation.
Sélectionner la sortie HTML ou HTTP Link
Choisissez le format que vous pouvez maintenir là où les pages du groupe sont servies. Il n’est pas nécessaire de générer les trois simplement parce qu’ils sont disponibles.
| Format | Emplacement | Sortie fournie |
|---|---|---|
| HTML | Le <head> de chaque page |
Un ensemble d’éléments <link> |
| HTTP Link | La réponse HTTP de chaque page | Une déclaration d’en-tête Link: |
| XML | Un sitemap avec les alternatives linguistiques | Un fragment <url> par page normale |
Pour HTML, le groupe fictif produit cet ensemble à placer dans le head des deux fiches produit :
<link rel="alternate" hreflang="en" href="https://example.com/en/blue-shirt/" />
<link rel="alternate" hreflang="tr" href="https://example.com/tr/mavi-gomlek/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/choose-language/" />
La page anglaise inclut sa propre URL et celle de la page turque ; la page turque reçoit le même ensemble. Dans un CMS, utilisez le modèle ou le champ qui contrôle le head. Coller les balises dans le corps visible d’un article n’est pas l’installation prévue.
La sortie HTTP Link appartient aux en-têtes de réponse, configurés dans votre système de publication ou sur le serveur. Elle convient aux documents comme les PDF qui n’ont pas de head HTML. Copiez toute la déclaration, pas seulement une URL, puis inspectez la réponse réelle après installation. Télécharger un fichier texte ne modifie pas une réponse à lui seul. Conservez les déclarations d’en-tête existantes sans rapport avec ces alternatives.
Transformer les fragments XML en sitemap
Le téléchargement XML est un fragment de page, pas un sitemap complet prêt à soumettre. Chaque bloc fournit un <loc> pour sa page saisie sur une ligne normale et répète les alternatives sous forme d’éléments <xhtml:link>. Ajoutez ces blocs à un sitemap contenant les espaces de noms sitemap et XHTML.
Pour l’exemple sur le même hôte, un fichier complet de deux pages aurait cette forme :
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:xhtml="http://www.w3.org/1999/xhtml">
<url>
<loc>https://example.com/en/blue-shirt/</loc>
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/blue-shirt/" />
<xhtml:link rel="alternate" hreflang="tr" href="https://example.com/tr/mavi-gomlek/" />
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/choose-language/" />
</url>
<url>
<loc>https://example.com/tr/mavi-gomlek/</loc>
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/blue-shirt/" />
<xhtml:link rel="alternate" hreflang="tr" href="https://example.com/tr/mavi-gomlek/" />
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/choose-language/" />
</url>
</urlset>
Les deux valeurs <loc> diffèrent ; leurs ensembles d’alternatives sont identiques. En ajoutant des fragments à un fichier existant, conservez un seul <urlset> englobant au lieu d’imbriquer des documents complets. Remplacez les URL fictives par les vôtres et préservez les échappements XML comme & dans les paramètres de requête. Publiez le fichier à un emplacement qui couvre les pages répertoriées ; cet exemple convient à un sitemap à la racine de example.com.
Consultez les instructions de Google sur hreflang dans les sitemaps pour les exigences d’espaces de noms et d’hébergement. Les téléchargements séparés du générateur n’assemblent, n’hébergent ni ne soumettent ce sitemap à votre place.
Vérifier les annotations installées
Le résultat généré montre ce que produisent vos valeurs, pas ce que reçoivent les visiteurs ou les robots. Après installation, comparez les pages publiées au groupe prévu :
- Vérifiez que chaque adresse alternative ouvre la bonne page linguistique, plutôt qu’une erreur, une ancienne URL ou une destination sans rapport.
- Pour HTML ou les en-têtes, inspectez les annotations réelles de chaque page normale, y compris son autoréférence et ses liens de retour vers les autres versions.
- Pour XML, inspectez le sitemap publié lui-même : sa structure englobante, chaque
<loc>et son ensemble complet d’alternatives. - Examinez les balises canonical avec les alternatives. Les recommandations de Google sur les URL canoniques préconisent une page canonique dans la même langue lorsqu’elle existe. Ne faites pas automatiquement pointer le canonical de chaque traduction vers la page anglaise.
Utilisez Hreflang Tags Tester pour inspecter les déclarations HTML et HTTP publiées. Cet outil ne valide pas les annotations de sitemap ni les balises rendues par JavaScript. Si les URL préférées ne correspondent pas au groupe, examinez-les avec Canonical Tag Checker.
Lorsqu’une traduction change d’adresse ou disparaît, actualisez le groupe partout où vous l’avez installé. Générer un nouvel ensemble sans remplacer les annotations publiées laisse l’ancienne relation en place. Hreflang aide à décrire des versions équivalentes ; il ne traduit pas le contenu et ne garantit ni indexation, ni classement, ni affichage systématique d’une URL précise par Google.