SEO

Docsbook erstellt die maschinenlesbare Hälfte Ihrer Dokumentation für Sie. Jede von ihm gehostete Seite ist serverseitig gerendertes HTML mit einem aufgelösten <title>, einer bereinigten Meta-Beschreibung, einer kanonischen URL, einem hreflang-Set, das nur Sprachen enthält, in die Sie tatsächlich übersetzt haben, OpenGraph- und X-Karten mit einem generierten Bild, einem JSON-LD-Graphen sowie einem Eintrag in einer Sitemap, auf die robots.txt verweist. Sie schreiben Markdown; der Head ist eine Konsequenz daraus.

Dieser Abschnitt behandelt Suchergebnisse – also das, was Google und Bing crawlen, indizieren und bewerten. Zwei benachbarte Bereiche behandeln die anderen maschinellen Oberflächen und überschneiden sich nicht damit: AEO ist das Antwortfeld über den Suchergebnissen, und GEO bedeutet, dass Sie von einem KI-Assistenten zitiert werden, anstatt in den Suchergebnissen bewertet zu werden.

Was es dich kostet#

Drei Dinge, und eines davon ist nicht optional.

1. Aktiviere den SEO-Schalter. Im Adminbereich unter Einstellungen ▸ SEO & GEO den SEO Schalter. Er ist bei einem neuen Projekt deaktiviert, und solange er deaktiviert ist, wird jede Seite noindex, nofollow ausgeliefert — das Markup wird vollständig generiert, und alles darin sagt „nicht indexieren“. Das ist der häufigste Grund dafür, dass eine Docsbook-Website nicht in Google erscheint. Diese Funktion ist in jedem Tarif kostenlos.
2. Verfasse ein klares # H1 und einen einleitenden Absatz, der die Frage der Seite beantwortet. Sie werden zu Titel und Beschreibung, sofern du sie nicht überschreibst.
3. Sonst nichts. Kanonische URLs, die Sitemap, robots.txt, Cards, JSON-LD und der Sprachcluster werden verwaltet, und es gibt keine Konfigurationsmöglichkeit dafür.

Um die generierte Zeile für eine Seite zu überschreiben, füge sie in das Frontmatter ein:

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

Um eine Seite aus dem Index fernzuhalten, während sie weiterhin veröffentlicht und lesbar bleibt:

---
noindex: true
---

robots: noindex, noindex: yes und noindex: 1 werden ebenfalls akzeptiert. Verwende dies für Seiten, die Crawl-Budget verbrauchen, ohne jemals einen Klick zu erhalten — ein Änderungsprotokoll mit 90.000 Zeichen, interne Arbeitsnotizen oder ein unfertiger Platzhalter. Der websiteweite Schalter ist dafür das falsche Instrument: Wenn du ihn deaktivierst, wird alles verborgen.

Die Signale und wo jedes einzelne entschieden wird#

Warum dies der richtige Weg ist (Belege)#

Was Docsbook nicht behaupten wird#

• Nichts davon sorgt für ein besseres Ranking einer Seite. Jeder der oben genannten Mechanismen macht eine Seite crawlbar, eindeutig und korrekt dargestellt. Googles FAQ zur Seitenerfahrung beantwortet die Frage „Gibt es ein einzelnes ‚Signal zur Seitenerfahrung‘ …?“ mit „Es gibt kein einzelnes Signal“ und beantwortet die Frage, wie wichtig die Seitenerfahrung für das Ranking ist, mit „Die Google-Suche versucht immer, die relevantesten Inhalte anzuzeigen, selbst wenn die Seitenerfahrung unterdurchschnittlich ist“ (Seitenerfahrung). Markup ist die Grundlage, nicht der Hebel.
• Strukturierte Daten werden als Signal für die Berechtigung, nicht als Ranking-Signal dokumentiert. Googles eigene Einführung spricht über Rich Results und sagt nichts über das Ranking aus.
• priority und changefreq in der Sitemap bewirken für Google nichts. „Google ignoriert die Werte <priority> und <changefreq>.“ Docsbook gibt sie für die Suchmaschinen aus, die sie tatsächlich auswerten.
• Das Crawl-Budget ist wahrscheinlich nicht dein Problem. Googles Leitfaden zum Crawl-Budget richtet sich an „große Websites (1 Million+ eindeutige Seiten) mit Inhalten, die sich mäßig häufig ändern (einmal pro Woche)“ und an „mittlere oder größere Websites (10.000+ eindeutige Seiten) mit sehr häufig wechselnden Inhalten (täglich)“ — und sagt im selben Atemzug, dass dies „eine grobe Schätzung ist, die dir bei der Einstufung deiner Website helfen soll. Dies sind keine exakten Schwellenwerte.“ noindex in einem riesigen Änderungsprotokoll ist trotzdem sinnvoll; eine 60-seitige Dokumentationswebsite als Crawl-Budget-Notfall zu behandeln, ist es nicht.
• Kein Multiplikator. Der Traffic hängt von deinem Thema, deiner Konkurrenz und deiner Domain ab. Jede Plattform, die dir einen Prozentsatz nennt, nennt dir den einer anderen Website.

Grenzen#

• Der websiteweite Schalter ist standardmäßig deaktiviert und gilt für den gesamten Arbeitsbereich. Es gibt keine Steuerung „diesen Abschnitt indexieren, nicht jenen“ oberhalb der seitenbezogenen noindex-Markierung.
• Bei einer benutzerdefinierten Domain werden der SEO-Schalter und noindex pro Seite nicht berücksichtigt — Seiten werden bedingungslos als index, follow bereitgestellt — und es gibt keinen hreflang- Cluster, kein BreadcrumbList, keine Sitemap, keine Weiterleitung für verschobene Seiten und keine der GEO-Seitensignale. Die kanonische URL, der Titel, die Beschreibung, Karten und der TechArticle-Knoten sind dort alle korrekt. Siehe Funktionsweise.
• Die Positionen in der Search Console umfassen nur von Docsbook gehostete Hosts. Eine Website auf Ihrer eigenen Domain liegt außerhalb der Property, die Docsbook ausliest. Siehe Indexierung.
• Eine Umbenennung außerhalb von Docsbook hinterlässt keine Weiterleitung. Über Docsbook vorgenommene Verschiebungen erstellen automatisch eine; ein git mv tut dies nicht.

Checkliste#

• Der SEO-Schalter ist unter Einstellungen ▸ SEO & GEO aktiviert.
• Jede Seite hat genau eine eindeutige # H1 oder ein Frontmatter-title.
• Der einleitende Absatz beantwortet die Frage der Seite in ein oder zwei Sätzen.
• Jede Seite ist über die Seitenleiste erreichbar; es gibt keine verwaisten Seiten.
• Seiten, die niemals ein Ranking erzielen sollen, enthalten noindex: true.
• Für mehrsprachige Dokumentationen sind Übersetzungen aktiviert , damit jede Sprache ihre eigene indexierbare URL erhält.

Verwandte Themen#

• So erstellt Docsbook den Head einer Seite — die Auflösungsreihenfolge.
• Indexierung — Erkennung, erneutes Crawling und Search Console.
• AEO — Antwortmaschinen und Rich Results
• GEO — Zitierung durch KI-Assistenten
• llms.txt
• KI-Übersetzungen
• Suchoptionen — die Website-Suche, die Leser verwenden, sobald sie angekommen sind.