SEO du blog Techniir

Ce document récapitule la configuration SEO en place et les gestes manuels restants. Il n’est pas publié (le dossier docs/ n’est pas servi par Hugo).

Ce qui est automatique

ÉlémentOùDétail
sitemap.xmlgénéré par Hugohttps://www.techniir.com/sitemap.xml, référencé dans robots.txt
robots.txttemplate du thème + enableRobotsTXTautorise tout le crawl en prod, bloque tout hors prod
<html lang="fr">defaultContentLanguage + [languages.fr]pilote aussi og:locale et inLanguage
JSON-LD BlogPostingthemes/PaperMod/.../schema_json.htmlheadline, author, datePublished, dateModified, description, image, publisher
JSON-LD BreadcrumbListidemtoutes les pages
JSON-LD Organizationidempage d’accueil
JSON-LD Personlayouts/_partials/extend_head.htmlpage /about/ uniquement, sameAs = GitHub + LinkedIn
dateModifiedenableGitInfo = truedate du dernier commit Git touchant le fichier
canonical, meta description, meta robots index, follow, Open Graph, Twitter Cardsthèmepar page
<title> courtlayouts/_partials/head.html (override)article = titre seul ; accueil = site.Title ; section/tag = titre · Techniir

Longueur des balises (limites Bing / Google)

  • <title> : viser 50 à 60 caractères. Le title: d’un article est aussi son <h1>, son og:title et le headline du JSON-LD. L’override head.html n’ajoute plus de suffixe de marque (site.Title) sur les articles.
  • description: : viser 120 à 158 caractères. Sert de meta description, og:description et description JSON-LD. Sans description:, le thème retombe sur summary: (souvent trop long).
  • Override du thème : seul le bloc <title> de layouts/_partials/head.html diffère de themes/PaperMod/layouts/_partials/head.html. Sur mise à jour de PaperMod, re-diff ce fichier et ne ré-appliquer que ce bloc. Checklist complète des personnalisations à revérifier : docs/mise-a-jour-papermod.md.

Vérification Google Search Console / Bing Webmaster Tools

Méthode balise meta (recommandée, aucun fichier)

Dans hugo.toml, décommenter et renseigner :

[params.analytics.google]
  SiteVerificationTag = "CODE_GOOGLE"   # valeur de content="..."
[params.analytics.bing]
  SiteVerificationTag = "CODE_BING"     # valeur de content="..." (balise msvalidate.01)

PaperMod injecte alors <meta name="google-site-verification"> et <meta name="msvalidate.01">. Rebuild, déploiement, puis « Vérifier » dans chaque console.

Méthode fichier à la racine

Tout fichier placé dans static/ est servi à la racine du site.

  • Google : déposer le google<HASH>.html fourni dans static/ → https://www.techniir.com/google<HASH>.html
  • Bing : déposer BingSiteAuth.xml dans static/ → https://www.techniir.com/BingSiteAuth.xml

Après vérification

Soumettre le sitemap dans chaque console :

  • Google Search Console : Index > Sitemaps > sitemap.xml
  • Bing Webmaster Tools : Sitemaps > https://www.techniir.com/sitemap.xml

Gestes manuels restants

  1. Vérifier la propriété dans Search Console et Bing (accès compte Google / Microsoft requis).
  2. Soumettre sitemap.xml dans les deux consoles.
  3. Image de partage social (Open Graph) : les articles utilisent une couverture .svg. LinkedIn, Facebook et X n’affichent pas les SVG en aperçu. Fournir, par article, une image raster 1200x630 (PNG ou JPG) via cover.image, ou une image par défaut du site : déposer static/og-default.png puis ajouter dans hugo.toml :
    [params]
  images = ["og-default.png"]
  4. En CI (azure-pipelines-blog.yml), la version de Hugo est lue depuis .tool-versions (extended-0.165.0). Si dateModified ne reflète pas les commits, ajouter fetchDepth: 0 au checkout pour un historique Git complet.