Aller au contenu principal

Configuration SEO

Yundera Docs (propulsé par Docusaurus) inclut des fonctionnalités SEO prêtes à l'emploi. Ce guide explique ce qui est configuré et comment le personnaliser.

Ce qui est inclus par défaut​

Données structurées (JSON-LD)​

Le site injecte automatiquement trois types de données structurées Schema.org :

SchémaObjectif
OrganizationIdentifie Yundera comme éditeur (nom, logo, liens sociaux)
WebSiteIdentifie le site de documentation pour le panneau de connaissance Google
FAQPageActive les résultats enrichis FAQ dans la recherche Google (Q&R déroulantes)

Sitemap​

Un sitemap.xml est généré automatiquement lors de la construction. Il inclut toutes les pages docs avec les dates de dernière modification.

https://docs.yundera.com/sitemap.xml

robots.txt​

Un fichier robots.txt autorise tous les robots et pointe vers le sitemap :

User-agent: *
Allow: /

Sitemap: https://docs.yundera.com/sitemap.xml

Balises méta​

Chaque page inclut :

  • Balises Open Graph (og:title, og:description, og:image, og:type)
  • Balises Twitter Card (twitter:card, twitter:site)
  • Balises géo (geo.region, geo.placename)
  • Balise méta Keywords
  • Couleur de thème pour navigateurs mobiles

SEO par page​

Chaque document Markdown peut remplacer les champs SEO dans son frontmatter :

---
title: Titre de Ma Page
description: Une description claire pour les moteurs de recherche (155 caractères recommandés).
keywords: [mot-clé1, mot-clé2, mot-clé3]
image: /img/my-custom-social-card.png
---
  • title — devient <title> et og:title
  • description — devient <meta name="description"> et og:description
  • keywords — devient <meta name="keywords">
  • image — devient og:image pour les aperçus de partage social

Résultats enrichis FAQ​

Le site inclut un schéma de données structurées FAQPage qui permet à Google d'afficher des menus déroulants FAQ directement dans les résultats de recherche. Pour ajouter une nouvelle FAQ :

  1. Créez un nouveau doc dans docs/faq/
  2. Ajoutez la question et la réponse dans le fichier Markdown
  3. Ajoutez la même paire Q&R au schéma FAQPage dans docusaurus.config.js
  4. Reconstruisez le site

Testez votre schéma FAQ avec le Test des résultats enrichis Google.

Ciblage géographique​

Le site inclut des balises méta géographiques pour l'optimisation régionale :

<meta name="geo.region" content="FR">
<meta name="geo.placename" content="France">
<meta name="content-language" content="en">

Ces balises aident les moteurs de recherche à comprendre la pertinence géographique du contenu.

Tests​

Voir aussi​