Schnellstart: Eine Dokumentationswebsite mit Docsbook veröffentlichen

1. Öffnen Sie docsbook.io/start.
2. Fügen Sie Ihre Quelle in das einzige Feld ein: eine Website-URL, einen Link zu einem GitHub-Repository oder einen Satz über Ihr Produkt. Docsbook erkennt, worum es sich handelt — es gibt keinen Typ zur Auswahl.
3. Warten Sie, während Docsbook die Quelle liest. In jedem Schritt wird angegeben, was gelesen und gefunden wurde.

Erwartetes Ergebnis: Eine Entwurfsseite wird in ihrem eigenen Adminbereich geöffnet, mit der Seitenanzahl, der Quelle, aus der sie stammt, und allen Bereichen für Branding, Layout und SEO. Es wurde noch kein Konto erstellt.

1. Klicken Sie im Adminbereich auf Öffnen oder klicken Sie auf die Vorschau selbst.
2. Durchsuchen Sie die generierten Seiten wie eine echte Dokumentationswebsite — Kopfzeile, Seitenleistenbaum, Gliederung, Breadcrumbs sowie Zurück/Weiter funktionieren alle.
3. Verwenden Sie Assistent im Bereich, um Formulierungen zu ändern oder Fragen zur Website zu stellen. Im Nachrichtenfeld öffnet der interaktive Modus die Website neben dem Chat, wobei jeder Block anklickbar ist.

Erwartetes Ergebnis: Sie haben den Entwurf gelesen und wissen, ob er Ihr Produkt korrekt beschreibt. Ein Entwurf von einer Website oder einer Idee bleibt nur in Ihrem Browser, bis Sie ihn veröffentlichen.

1. Klicken Sie auf der Startseite des Bereichs auf Diese Website veröffentlichen oder auf die blaue Schaltfläche in der Symbolleiste der Dokumentation selbst. Sie lautet Veröffentlichen, wenn Sie bisher nichts geändert haben, Änderungen speichern, wenn Sie Änderungen vorgenommen haben, und Eigentümerschaft beanspruchen, wenn Sie über einen Anspruchslink hierher gelangt sind — alle drei Optionen bewirken dasselbe.
2. Wählen Sie eine Anmeldemethode: GitHub, Google, Apple oder E-Mail mit einem Einmalcode.
3. Schließen Sie den Anmeldevorgang ab.

Erwartetes Ergebnis: Der Entwurf wird zu einem aktiven Docsbook-Projekt mit einer öffentlichen Adresse, einem Suchindex und Analysen. Nichts von dem, was Sie geschrieben haben, wird erneut erstellt.

Wenn Ihre Website aus einem GitHub-Repository stammt und Sie sich mit Google, Apple oder Ihrer E-Mail-Adresse angemeldet haben, fordert Docsbook Sie außerdem auf, den GitHub-Zugriff zu autorisieren — die Repository-Dateien werden über diese Autorisierung gelesen.

1. Öffnen Sie die von Docsbook angezeigte Adresse. Sie folgt dem unten stehenden Muster.

docsbook.io/{owner}/{repo}

2. Verwenden Sie das Suchfeld in der Kopfzeile oder drücken Sie Cmd+K (unter Windows und Linux Strg+K) und suchen Sie nach einer Formulierung aus einer Ihrer Seiten.

Erwartetes Ergebnis: Die Seite wird unter einer öffentlichen URL geladen, die Suche gibt Ihre Formulierung zurück und die Website ist lesbar, ohne dass eine Anmeldung erforderlich ist.