Il tuo primo build
Cosa succede dopo aver collegato un repo: le fasi del build, la scheda Deployments e cosa controllare se qualcosa fallisce.
Build automatiche
Jamdesk avvia il tuo primo build non appena colleghi un repository. Ogni push successivo sul branch collegato attiva un nuovo build.
Avanzamento della build
Segui il tuo build nella dashboard:
Il tuo build è in attesa di iniziare. Negli orari di punta può esserci una breve coda.
Jamdesk recupera i contenuti del tuo repository da GitHub.
Jamdesk controlla il tuo docs.json e i file MDX alla ricerca di errori.
Jamdesk compila MDX in HTML con evidenziazione della sintassi e un indice di ricerca.
I file generati vengono caricati sulla CDN globale.
La tua documentazione è disponibile all'URL del tuo progetto.
Visualizzare la documentazione pubblicata
Fai clic su View Site nella dashboard oppure visita https://your-project.jamdesk.app.
La tua documentazione compare anche sul tuo dominio personalizzato, se ne hai configurato uno.
Ricostruzione manuale
Ricostruisci senza eseguire un push delle modifiche:
- Vai al tuo progetto nella dashboard
- Apri Settings
- Fai clic su Rebuild
Usalo dopo aver modificato le variabili d'ambiente o per forzare un build nuovo.
Se la build non riesce
La dashboard mostra un messaggio di errore per un build non riuscito. Cause comuni:
- Sintassi non valida in
docs.json - Errori di sintassi MDX
- Pagine mancanti referenziate nella navigazione