Votre Premier Build
Ce qui se passe après avoir connecté un dépôt -- les phases de build, l'onglet Déploiements, et ce qu'il faut vérifier en cas d'échec.
Votre premier build démarre automatiquement lorsque vous connectez un dépôt.
Builds Automatiques
Lorsque vous connectez un dépôt, Jamdesk déclenche un build initial immédiatement. Chaque push suivant sur votre branche connectée déclenche automatiquement un nouveau build.
Progression du Build
Suivez votre build dans le dashboard :
Votre build attend de démarrer. Aux heures de pointe, il peut y avoir une brève file d'attente.
Jamdesk récupère le contenu de votre dépôt depuis GitHub.
Votre fichier docs.json et vos fichiers MDX sont validés pour détecter les erreurs.
Le MDX est compilé en HTML optimisé avec la coloration syntaxique et l'indexation de recherche.
Les fichiers buildés sont téléchargés vers le CDN mondial.
Votre documentation est disponible à l'URL de votre projet.
Consulter Votre Documentation en Ligne
Une fois le build terminé, cliquez sur Voir le site dans le dashboard ou rendez-vous sur :
https://your-project.jamdesk.app
Si vous avez configuré un domaine personnalisé, votre documentation sera également disponible à cette adresse.
Rebuild Manuel
Besoin de rebuilder sans pousser de modifications ?
- Accédez à votre projet dans le dashboard
- Ouvrez Paramètres
- Cliquez sur Rebuild
Utilisez cette option après avoir modifié des variables d'environnement ou pour forcer un build complet.
En Cas d'Échec du Build
Les échecs de build affichent un message d'erreur dans le dashboard. Causes fréquentes :
- Syntaxe
docs.jsoninvalide - Erreurs de syntaxe MDX
- Pages manquantes référencées dans la navigation