Docusaurus baut deine Dokumentation zu einer statischen Website in build/: jedes Dokument und jeder Blogbeitrag als HTML, mit Suche und Navigation, die im Browser laufen. Lobsite hostet diesen Ordner. Führe npm run build aus, dann npx lobsite, und deine Doku ist unter einer *.lobsite.app-Adresse mit HTTPS live. Jedes Deploy bekommt außerdem eine eigene URL, praktisch, um Änderungen an der Doku vor dem Livegang zu prüfen.
So funktioniert es
- Bau die Doku mit
npm run build. Docusaurus schreibt die Website nachbuild/und lässt den Build standardmäßig bei kaputten Links scheitern. - Führe
npx lobsiteaus im Projekt. Es deploytbuild/, nichtstatic/. Das erste Deploy braucht kein Konto und hält 6 Stunden. - Behalte sie mit dem Übernahme-Link, in einem kostenlosen Konto. Danach aktualisiert
npm run build && npx lobsitedieselbe Adresse.
url, baseUrl und Schrägstriche am Ende
// docusaurus.config.js
export default {
url: "https://my-docs.lobsite.app",
baseUrl: "/",
};
urlist die Adresse deiner Website. Docusaurus nutzt sie für Canonical-Links und die Sitemap.baseUrlist auf Lobsite/. Eine GitHub-Pages-Projektseite nutzt/repo-name/; bleibt das stehen, ist jeder Asset-Link kaputt.trailingSlashkannst du weglassen. Alsdocs/intro/index.htmlgebaute Dokumente öffnen sich unter/docs/intro/;/docs/introleitet dorthin weiter.
Änderungen an der Doku prüfen
Doku wird von vielen Leuten geschrieben und oft von jemand anderem geprüft. lobsite deploy --preview veröffentlicht den Build unter einer eigenen URL, ohne die Live-Doku anzurühren, sodass die prüfende Person die Änderung so liest, wie sie aussehen wird. lobsite promote schaltet sie live, und lobsite rollback geht in einem Schritt zur vorherigen Version zurück. Du verschiebst Seiten? Trag Weiterleitungen für die alten Pfade in lobsite.toml ein, damit Links aus Suchergebnissen und von anderen Websites weiter funktionieren; der Redirect-Generator schreibt die Regeln. KI-Coding-Agenten können dasselbe Deploy mit npx -y lobsite --yes ausführen, das nie für eine Rückfrage anhält.
Vorschau ansehen, bevor es live geht. Mit einem Klick zurückrollen, samt Weiterleitungen.
Dateien werden nach ihrem Hash gespeichert. Ein erneutes Deploy einer unveränderten Website lädt 0 Bytes hoch.
Jede Website bekommt ab dem ersten Deploy eine *.lobsite.app-Adresse mit HTTPS.
Weiterleitungen, Header und Formulare stehen in lobsite.toml und reisen mit jedem Deploy mit.
Keine Rückfragen unter einem Agent, und eine Tell the user:-Zeile mit der URL und dem Übernahme-Link.
Jedes Limit ist veröffentlicht, und jeder Fehler sagt dir, was als Nächstes zu tun ist.
Docusaurus-Hoster im Vergleich
| Lobsite | GitHub Pages | Netlify | Vercel | |
|---|---|---|---|---|
| Baut die Doku für dich | Nein: du deployst build/ |
In GitHub Actions, oder docusaurus deploy |
Ja | Ja |
| Vorschau-URL für jedes Deploy | Ja | Nein | Ja | Ja |
| Rollback in einem Schritt | Ja | Einen Commit zurücknehmen | Ja | Ja |
| Konto vor dem ersten Deploy | Nein: 6 Stunden live, dann kostenlos behalten | Ja, und ein Repository | Ja | Ja |
| Eigene Domain | Ja, kostenlos | Ja, kostenlos | Ja | Ja |
GitHub Pages eignet sich gut für Open-Source-Doku, die neben dem Code liegt. Lobsite passt zu Doku, die du lokal oder in CI baust und als Vorschau zeigen, live schalten und zurückrollen willst, ohne einen Git-Workflow rund ums Hosting.
Häufige Fragen
Welche baseUrl sollte Docusaurus auf Lobsite verwenden?
/. Die Website wird ab der Wurzel ihrer Adresse ausgeliefert. Nur eine GitHub-Pages-Projektseite braucht /repo-name/.
Funktioniert die Docusaurus-Suche auf einem statischen Hoster?
Ja. Algolia DocSearch läuft im Browser der Besucher, und lokale Such-Plugins bauen ihren Index in build/. Keins von beiden braucht einen Server.
Kann ich versionierte Docusaurus-Doku hosten?
Ja. Jede Version wird als eigene Seiten in build/ gebaut, also werden alle zusammen deployt. Hochgeladen werden nur die Dateien, die sich seit dem letzten Deploy geändert haben.
Wie groß darf eine Docusaurus-Website sein?
Im kostenlosen Tarif bis zu 100 Dateien und 50 MB pro Deploy, was für die meisten Doku-Websites reicht. Größere Doku mit vielen Versionen oder Bildern braucht den kostenpflichtigen Tarif, der bald kommt; alle Grenzen stehen in der Tabelle der Limits.