Jamdesk Documentation logo

Dein erster Build

Was nach dem Verbinden eines Repos passiert: Build-Phasen, der Tab Deployments und was zu prüfen ist, wenn etwas fehlschlägt.

Automatische Builds

Jamdesk startet deinen ersten Build, sobald du ein Repository verbindest. Jeder spätere Push auf deinen verbundenen Branch löst einen neuen Build aus.

Build-Fortschritt

Verfolge deinen Build im Dashboard:

1
Queued

Dein Build wartet darauf, zu starten. Zu Stoßzeiten kann es eine kurze Warteschlange geben.

2
Cloning

Jamdesk lädt die Inhalte deines Repositorys von GitHub herunter.

3
Validating

Jamdesk prüft deine docs.json- und MDX-Dateien auf Fehler.

4
Building

Jamdesk kompiliert MDX zu HTML mit Syntaxhervorhebung und einem Suchindex.

5
Deploying

Die erstellten Dateien werden in das globale CDN hochgeladen.

6
Live

Deine Dokumentation ist unter deiner Projekt-URL verfügbar.

Ihre Live-Dokumentation anzeigen

Klicke im Dashboard auf View Site oder besuche https://your-project.jamdesk.app.

Deine Dokumentation erscheint auch auf deiner eigenen Domain, sofern du eine konfiguriert hast.

Manuellen Build starten

Baue ohne neuen Push neu:

  1. Gehe zu deinem Projekt im Dashboard
  2. Öffne Settings
  3. Klicke auf Rebuild

Verwende dies nach Änderungen an Umgebungsvariablen oder um einen frischen Build zu erzwingen.

Wenn Ihr Build fehlschlägt

Das Dashboard zeigt bei einem fehlgeschlagenen Build eine Fehlermeldung an. Häufige Ursachen:

  • Ungültige docs.json-Syntax
  • MDX-Syntaxfehler
  • Fehlende Seiten, die in der Navigation referenziert werden
Referenz für Build-Fehler

Siehe gängige Fehlercodes und wie du sie behebst

Verwandte Artikel

Builds auslösen

Erfahre mehr über automatische und manuelle Build-Auslöser

Builds überwachen

Verfolge den Build-Fortschritt und sieh dir Logs an