Échecs de build

Ouvrez le build ayant échoué dans votre onglet Déploiements et associez le message d'erreur à une section ci-dessous.

Trouver l'erreur

1. Allez dans l'onglet Déploiements de votre projet
2. Cliquez sur le build ayant échoué
3. Examinez le message d'erreur et le journal

Le journal indique exactement ce qui n'a pas fonctionné et où.

Échecs courants

Configuration invalide

Erreur : « Invalid docs.json »

Votre docs.json contient des erreurs de syntaxe ou de schéma.

Solution :

1. Vérifiez l'absence de virgules, crochets ou guillemets manquants
2. Exécutez jamdesk validate localement
3. Comparez avec la référence du schéma

Pages manquantes

Erreur : « Page 'path/to/page' not found »

Une page dans la navigation n'existe pas.

Solution :

• Vérifiez que le fichier existe
• Vérifiez que le chemin correspond exactement (sensible à la casse)
• N'incluez pas l'extension .mdx dans docs.json

Erreurs de syntaxe MDX

Erreur : « MDX compilation failed »

Syntaxe MDX ou JSX invalide.

Causes courantes :

• Balises non fermées : <Card> sans </Card>
• Accolades non échappées : { au lieu de \{
• Props invalides : title=value au lieu de title="value"

Images manquantes

Erreur : « Asset not found »

Une image référencée dans le MDX n'existe pas.

Solution :

• Vérifiez que le chemin de l'image est correct
• Les chemins sont relatifs à votre répertoire de documentation
• Vérifiez que le fichier a été validé dans Git

Étapes de débogage

Toujours bloqué ?

Si vous ne parvenez pas à résoudre le problème :

1. Copiez le journal de build complet
2. Notez l'identifiant de votre projet
3. Contactez le support

Articles connexes