Docusaurus trasforma la tua documentazione in un sito statico in build/: ogni documento e ogni post del blog come HTML, con ricerca e navigazione che girano nel browser. Lobsite ospita quella cartella. Esegui npm run build, poi npx lobsite, e la tua documentazione è online a un indirizzo *.lobsite.app con HTTPS. Ogni deploy ha anche un suo URL, comodo per rivedere le modifiche alla documentazione prima che vadano online.
Come funziona
- Fai la build della documentazione con
npm run build. Docusaurus scrive il sito inbuild/e, di default, fa fallire la build se ci sono link rotti. - Esegui
npx lobsitenel progetto. Pubblicabuild/, nonstatic/. Il primo deploy non richiede account e dura 6 ore. - Tienila con il link per rivendicarla, in un account gratuito. Da lì in poi,
npm run build && npx lobsiteaggiorna lo stesso indirizzo.
url, baseUrl e barre finali
// docusaurus.config.js
export default {
url: "https://my-docs.lobsite.app",
baseUrl: "/",
};
urlè l'indirizzo del tuo sito. Docusaurus lo usa per i link canonici e la sitemap.baseUrlsu Lobsite è/. Un sito di progetto GitHub Pages usa/repo-name/; lasciarlo così rompe ogni link alle risorse.trailingSlashsi può omettere. I documenti generati comedocs/intro/index.htmlsi aprono a/docs/intro/;/docs/introreindirizza lì.
Rivedere le modifiche alla documentazione
La documentazione la scrivono in tanti e spesso la rivede qualcun altro. lobsite deploy --preview pubblica la build a un suo URL senza toccare la documentazione online, così chi rivede legge la modifica come apparirà. lobsite promote la mette online e lobsite rollback torna alla versione precedente in un solo passo. Sposti delle pagine? Aggiungi in lobsite.toml i reindirizzamenti per i vecchi percorsi, così i link dai risultati di ricerca e da altri siti continuano a funzionare; il Generatore di reindirizzamenti scrive le regole. Gli agenti IA per il codice possono eseguire lo stesso deploy con npx -y lobsite --yes, che non si ferma mai a fare domande.
Anteprima prima di andare online. Rollback in un clic, reindirizzamenti compresi.
I file vengono salvati in base al loro hash. Ripubblicare un sito invariato carica 0 byte.
Ogni sito riceve un indirizzo *.lobsite.app con HTTPS dal primo deploy.
Reindirizzamenti, header e moduli stanno in lobsite.toml e viaggiano con ogni deploy.
Nessuna domanda quando lo usa un agente, e una riga Tell the user: con l'URL e il link per rivendicarlo.
Ogni limite è pubblicato e ogni errore ti dice cosa fare dopo.
Hosting per Docusaurus a confronto
| Lobsite | GitHub Pages | Netlify | Vercel | |
|---|---|---|---|---|
| Fa la build della documentazione per te | No: pubblichi build/ |
In GitHub Actions, o docusaurus deploy |
Sì | Sì |
| URL di anteprima per ogni deploy | Sì | No | Sì | Sì |
| Rollback in un passo | Sì | Revert di un commit | Sì | Sì |
| Account prima del primo deploy | No: online 6 ore, poi tienilo gratis | Sì, e un repository | Sì | Sì |
| Dominio personalizzato | Sì, gratis | Sì, gratis | Sì | Sì |
GitHub Pages va bene per la documentazione open source che vive accanto al codice. Lobsite è adatto alla documentazione che costruisci in locale o in CI e vuoi visualizzare in anteprima, mettere online e ripristinare senza un flusso Git attorno all'hosting.
Domande frequenti
Quale baseUrl dovrebbe usare Docusaurus su Lobsite?
/. Il sito è servito dalla radice del suo indirizzo. Solo un sito di progetto GitHub Pages ha bisogno di /repo-name/.
La ricerca di Docusaurus funziona su un hosting statico?
Sì. Algolia DocSearch gira nel browser del visitatore, e i plugin di ricerca locale costruiscono il loro indice in build/. Nessuno dei due ha bisogno di un server.
Posso ospitare documentazione Docusaurus con più versioni?
Sì. Ogni versione viene generata in build/ come pagine a sé, quindi vengono pubblicate tutte insieme. Vengono caricati solo i file cambiati dall'ultimo deploy.
Quanto può essere grande un sito Docusaurus?
Nel piano gratuito, fino a 100 file e 50 MB per deploy, che bastano per la maggior parte dei siti di documentazione. Una documentazione più grande, con molte versioni o immagini, richiede il piano a pagamento, in arrivo; tutti i limiti sono nella tabella dei limiti.