Build-Fehler

Öffne den fehlgeschlagenen Build im Tab Deployments und ordne die Fehlermeldung einem Abschnitt weiter unten zu.

Fehler finden

1. Öffne den Tab Deployments deines Projekts
2. Klicke auf den fehlgeschlagenen Build
3. Prüfe die Fehlermeldung und das Protokoll

Das Protokoll zeigt genau, was schiefgelaufen ist und wo.

Häufige Fehler

Ungültige Konfiguration

Fehler: "Invalid docs.json"

Deine docs.json enthält Syntax- oder Schemafehler.

Lösung:

1. Prüfe, ob Kommas, Klammern oder Anführungszeichen fehlen
2. Führe lokal jamdesk validate aus
3. Vergleiche die Datei mit der Schema-Referenz

Fehlende Seiten

Fehler: "Page 'path/to/page' not found"

Eine Seite in der Navigation ist nicht vorhanden.

Lösung:

• Prüfe, ob die Datei vorhanden ist
• Stelle sicher, dass der Pfad exakt übereinstimmt (Groß- und Kleinschreibung beachten)
• Füge die Erweiterung .mdx nicht in docs.json ein

MDX-Syntaxfehler

Fehler: "MDX compilation failed"

Ungültige MDX- oder JSX-Syntax.

Häufige Ursachen:

• Nicht geschlossene Tags: <Card> ohne </Card>
• Nicht maskierte geschweifte Klammern: { statt \{
• Ungültige Props: title=value statt title="value"

Fehlende Bilder

Fehler: "Asset not found"

Ein in MDX referenziertes Bild ist nicht vorhanden.

Lösung:

• Prüfe, ob der Bildpfad korrekt ist
• Pfade beziehen sich relativ auf dein Dokumentationsverzeichnis
• Stelle sicher, dass die Datei in Git committed wurde

Schritte zur Fehlerbehebung

Noch keine Lösung?

Wenn du das Problem nicht beheben kannst:

1. Kopiere das vollständige Build-Protokoll
2. Notiere die Projekt-ID
3. Support kontaktieren

Verwandte Artikel