Risoluzione dei problemi
Build fallita: vitepress non trovato
Verifica che le dipendenze siano installate e che Cloudflare Pages esegua l’installazione prima della build.
bash
npm install
npm run buildBuild riuscita ma pagine 404
Controlla che la directory di output sia .vitepress/dist. Una directory errata distribuisce file errati.
text
.vitepress/distdocs.hideapps.top non si apre
- Verifica che docs.hideapps.top sia aggiunto in Custom domains.
- Verifica che il CNAME docs esista.
- Verifica che la destinazione sia hideapps-docs.pages.dev.
- Se il dominio è appena stato aggiunto, attendi l’emissione del certificato Cloudflare.
Il certificato HTTPS resta in attesa
Controlla se hideapps.top contiene record CAA che limitano l’emissione dei certificati.
Anteprima locale corretta ma stili mancanti online
Questo progetto è distribuito alla radice del sottodominio, quindi VitePress non richiede base.