Fait avec Chinaski

URL canoniques

Les URL canoniques disent aux moteurs de recherche quelle adresse fait autorité pour une page, important quand le même contenu pourrait être atteint sous des URL légèrement différentes. Chinaski gère les canoniques à trois niveaux : votre URL de site, les valeurs automatiques par page, et les remplacements choisis à la main. Cette page explique chacun.

Votre URL de site vient d'abord

Tout ce qui est canonique commence par le réglage Site URL. Chinaski construit chaque adresse canonique à partir d'elle, donc bien la régler est l'étape une : définissez-la une fois (par exemple https://example.com) et choisissez votre orthographe préférée, y compris s'il faut utiliser www..

Pour les sites multi-langues, la base effective s'adapte à votre mode d'URL de langue. En mode sous-domaine (es.example.com), les URL canoniques de chaque langue sont réécrites vers son propre sous-domaine de langue automatiquement.

Sans Site URL définie, aucune URL canonique n'est émise du tout ; rien d'absolu n'est inventé.

Canoniques automatiques sur chaque page

Quand une page n'a pas d'URL canonique personnalisée, Chinaski en calcule une automatiquement :

  • Les pages reçoivent leur propre adresse publique (y compris tout chemin de page parente).
  • Les posts reçoivent leur adresse de blog complète (y compris le préfixe de blog, tel que /blog/).
  • Les listes de blog et de catégories reçoivent des canoniques par page : la page 2 du blog pointe vers l'adresse de la page 2, pas vers la première page du blog, pour que les pages paginées ne se battent pas entre elles dans la recherche.
  • L'index des documents se canonise vers sa propre adresse de section.
  • Les anciennes URL qui ont des redirections portent aussi une balise canonique pointant vers la destination, c'est ainsi que les moteurs de recherche traitent correctement la page déplacée.

Chaque page rendue émet alors la canonique deux fois dans ses balises meta : comme balise <link rel="canonical">, et comme propriété OpenGraph og:url utilisée par les plateformes sociales.

Remplacer la canonique d'une page

Si vous syndiquez du contenu, publiez une version miroir, ou avez besoin autrement qu'une page crédite une autre adresse, remplissez le champ Canonical URL dans la section SEO de l'éditeur de page ou de post. Ce que vous entrez là gagne : le builder utilise votre valeur verbatim au lieu de celle calculée automatiquement. Laissez-le vide dans des circonstances normales : la valeur automatique est déjà correcte.

Imposer un seul hôte de domaine

Les balises canoniques disent aux moteurs de recherche ce que vous préférez ; les redirections l'imposent. À chaque build, Chinaski écrit une règle dans le fichier de redirections du site qui envoie l'orthographe non canonique de votre hôte vers la canonique : www.example.com → example.com (ou l'inverse, selon votre réglage Site URL), de façon permanente (301) et en préservant le chemin demandé. La règle est réécrite proprement à chaque build pour qu'elle n'accumule jamais de doublons, et le log de build rapporte chaque fois que le bloc d'imposition a été écrit.

Une réserve d'hébergement : cette règle de domaine est écrite dans le fichier _redirects au format Netlify, que les hébergeurs et passerelles lisant ce format peuvent imposer au niveau du serveur. Le fichier d'export au format Caddy ne l'inclut pas ; sur ces configurations l'imposition est au niveau des balises de page et, si vous voulez une redirection dure, vous ajoutez une règle d'hôte à votre propre Caddyfile.

Conseils pratiques

  • Définissez la Site URL une fois, tôt. Tout ce qui est absolu (canoniques, URL sociales, adresses de sitemap) en dérive.
  • Ne remplacez pas les canoniques à la légère. La valeur automatique est correcte pour chaque page ordinaire ; utilisez le champ de remplacement seulement quand le contenu existe réellement à une autre URL (syndication, agrégateurs).
  • Un cadre de référence : une canonique pointe des pages *vers l'extérieur* vers d'autres sites ou à travers des domaines à vous ; pour les pages qui n'ont jamais quitté votre site, laissez le champ vide et laissez la canonique automatique faire le travail.
Lisez ce site en