SEO

Docsbook génère pour vous la moitié de votre documentation lisible par machine. Chaque page qu’il héberge est un HTML rendu côté serveur contenant un <title> résolu, une description meta nettoyée, une URL canonique, un ensemble hreflang qui contient uniquement les langues dans lesquelles vous avez réellement traduit, des cartes OpenGraph et X avec une image générée, un graphe JSON-LD et une entrée dans un sitemap vers lequel robots.txt pointe. Vous écrivez en Markdown ; l’en-tête en découle.

Cette section couvre les résultats de recherche — ce que Google et Bing explorent, indexent et classent. Deux sections voisines couvrent les autres surfaces machine et ne se chevauchent pas avec celle-ci : AEO est l’encadré de réponse au-dessus des résultats, et GEO consiste à être cité par un assistant IA plutôt qu’à être classé.

Ce que cela vous coûte#

Trois choses, dont une n'est pas facultative.

1. Activez le référencement naturel. Dans le panneau d'administration, Paramètres ▸ SEO & GEO, le bouton bascule SEO. Il est désactivé dans un nouveau projet et, tant qu'il est désactivé, chaque page est diffusée noindex, nofollow — le balisage est entièrement généré et indique partout « ne m'indexez pas ». C'est la raison la plus fréquente pour laquelle un site Docsbook n'apparaît pas sur Google. C'est gratuit avec tous les forfaits.
2. Rédigez un # H1 clair et un paragraphe d'introduction qui répond à la question de la page. Ces éléments deviennent le titre et la description, sauf si vous les remplacez.
3. Rien d'autre. Les URL canoniques, le plan du site, robots.txt, les cartes, JSON-LD et le groupe linguistique sont gérés, et aucune interface de configuration n'est prévue pour eux.

Pour remplacer la ligne générée pour une page, placez-la dans le frontmatter :

---
title: "Configure a webhook"
description: "Register a Docsbook webhook, choose its events, and verify the first delivery."
---

Pour exclure une page de l'index tout en la laissant publiée et lisible :

---
noindex: true
---

robots: noindex, noindex: yes et noindex: 1 sont également acceptés. Utilisez-les sur les pages qui consomment du budget d'exploration sans jamais générer de clic — un journal des modifications de 90 000 caractères, des notes de travail internes, un espace réservé inachevé. Le bouton bascule à l'échelle du site est le mauvais instrument pour cela : le désactiver masque tout.

Les signaux et l’endroit où chacun est décidé#

Pourquoi c'est la bonne méthode (preuves)#

Ce que Docsbook ne prétendra pas#

• Rien de tout cela ne fait monter une page dans les résultats. Chaque mécanisme ci-dessus rend une page explorable, sans ambiguïté et correctement présentée. La FAQ de Google sur l'expérience utilisateur des pages répond à la question « Existe-t-il un unique “signal d'expérience utilisateur de la page”… ? » par « Il n'existe pas de signal unique », et répond à la question de savoir dans quelle mesure l'expérience utilisateur d'une page influe sur son classement par « La recherche Google cherche toujours à afficher le contenu le plus pertinent, même si l'expérience utilisateur de la page est médiocre » (Expérience utilisateur des pages). Le balisage est le minimum requis, pas le levier.
• Les données structurées sont documentées comme un signal d'éligibilité, pas comme un signal de classement. La propre introduction de Google parle de résultats enrichis et ne dit rien du classement.
• priority et changefreq dans le sitemap ne servent à rien pour Google. « Google ignore les valeurs <priority> et <changefreq>. » Docsbook les génère pour les moteurs qui les prennent effectivement en compte.
• Le budget d'exploration n'est probablement pas votre problème. Le guide de Google sur le budget d'exploration s'adresse aux « grands sites (plus d'un million de pages uniques) dont le contenu change assez souvent (une fois par semaine) » et aux « sites de taille moyenne ou plus grands (10 000 pages uniques ou plus) dont le contenu change très rapidement (quotidiennement) » — et précise dans la même phrase qu'il s'agit « d'une estimation approximative destinée à vous aider à classer votre site. Il ne s'agit pas de seuils exacts. » noindex sur un journal des modifications volumineux reste utile ; traiter un site de documentation de 60 pages comme une urgence liée au budget d'exploration ne l'est pas.
• Aucun multiplicateur. Le trafic dépend de votre sujet, de vos concurrents et de votre domaine. Toute plateforme qui vous annonce un pourcentage vous annonce celui du site de quelqu'un d'autre.

Limites#

• Le commutateur à l’échelle du site est désactivé par défaut et s’applique à l’ensemble de l’espace de travail. Il n’existe aucun contrôle « indexer cette section, pas celle-là » au-dessus de l’indicateur noindex par page.
• Sur un domaine personnalisé, le commutateur SEO et le paramètre noindex par page ne sont pas pris en compte — les pages sont servies index, follow sans condition — et il n’existe aucun cluster hreflang, aucun BreadcrumbList, aucun sitemap, aucune redirection de page déplacée et aucun des signaux au niveau des pages de GEO. L’URL canonique, le titre, la description, les cartes et le nœud TechArticle sont tous corrects dans ce cas. Consultez Fonctionnement.
• Les positions dans Search Console concernent uniquement les hôtes hébergés par Docsbook. Un site sur votre propre domaine se trouve en dehors de la propriété que Docsbook consulte. Consultez Indexation.
• Un renommage effectué en dehors de Docsbook ne crée aucune redirection. Les déplacements effectués via Docsbook en créent automatiquement une ; un git mv ne le fait pas.

Liste de contrôle#

• La bascule SEO est activée dans Settings ▸ SEO & GEO.
• Chaque page possède un # H1 clair, ou un title dans le frontmatter.
• Le paragraphe d’introduction répond à la question de la page en une ou deux phrases.
• Chaque page est accessible depuis la barre latérale ; aucune page orpheline.
• Les pages qui ne doivent jamais être classées contiennent noindex: true.
• Pour une documentation multilingue, les traductions sont activées afin que chaque langue bénéficie de sa propre URL indexable.

Connexe#

• Comment Docsbook construit l’en-tête d’une page — les ordres de résolution.
• Indexation — découverte, nouvelle exploration et Search Console.
• AEO — moteurs de réponse et résultats enrichis
• GEO — citations par les assistants IA
• llms.txt
• Traductions par IA
• Options de recherche — la recherche sur le site qu’utilisent les lecteurs une fois arrivés.