Lokale Vorschau für Inhaltsautoren

Sehen Sie Ihre Dokumentation lokal in der Vorschau an, bevor Sie Änderungen pushen. Alles, was Sie benötigen, ist Docker und ein docs/-Verzeichnis.

Voraussetzungen

Docker Desktop installiert und ausgeführt
Ihr Content-Repository lokal geklont mit einem docs/-Verzeichnis, das mindestens eine index.mdx enthält

Entwicklungsserver starten

Führen Sie im Stammverzeichnis Ihres Content-Repositories folgenden Befehl aus:

docker run --rm -it \
  -v "$(pwd)/docs:/content/docs" \
  -p 4321:4321 \
  -e MODE=dev \
  ghcr.io/f5-sales-demo/docs-builder:latest

Öffnen Sie http://localhost:4321, sobald der Server gestartet ist.

Bilder und statische Ressourcen

Platzieren Sie Bilder in einem Unterverzeichnis wie docs/images/. Der Container erkennt diese automatisch — keine zusätzlichen Volume-Mounts erforderlich.

Referenzieren Sie sie in Ihrem MDX mit einem wurzelrelativen Pfad:

![Architecture diagram](/images/architecture.png)

Fehlerbehebung

Port bereits in Verwendung — Ordnen Sie einen anderen Host-Port zu: -p 8080:4321, dann öffnen Sie http://localhost:8080.

Inhalte werden nicht angezeigt — Überprüfen Sie, ob docs/index.mdx existiert. Prüfen Sie die Container-Ausgabe auf eine ERROR: No content found-Meldung.

Veraltetes Image — Laden Sie die neueste Version herunter:

docker pull ghcr.io/f5-sales-demo/docs-builder:latest

Weiterführende Lektüre

Docker Build — Image-Details, Umgebungsvariablen und Produktions-Builds
Architektur — Content-Injection-Modell und Theme-System-Design