Accesso
- Apri Docusaurus:
http://<SERVER_IP>
Modificare e pubblicare contenuti
1. Aggiungi o modifica i file di contenuto:
/opt/docusaurus/docs
/opt/docusaurus/blog
/opt/docusaurus/src/pages
2. Aggiorna /opt/docusaurus/docusaurus.config.js per le impostazioni del sito, la navigazione e la configurazione del tema.
3. Ricostruisci il sito:
cd /opt/docusaurus && npm run build
Nginx serve i file generati da: /opt/docusaurus/build
Dopo la ricostruzione non serve riavviare Nginx.
Percorsi importanti
- Progetto:
/opt/docusaurus - Documentazione:
/opt/docusaurus/docs - Blog:
/opt/docusaurus/blog - Pagine:
/opt/docusaurus/src/pages - Configurazione:
/opt/docusaurus/docusaurus.config.js - Output della build:
/opt/docusaurus/build - Configurazione Nginx:
/etc/nginx/sites-available/docusaurus.conf
Dominio e HTTPS
1. Fai puntare il tuo dominio all'indirizzo IP del server.
2. Modifica la configurazione di Nginx e sostituisci server_name _; con il tuo dominio (per esempio, server_name <YOUR_DOMAIN>;):
vim /etc/nginx/sites-available/docusaurus.conf
3. Verifica la configurazione:
nginx -t
4. Installa Certbot:
apt install -y certbot python3-certbot-nginx
5. Genera un certificato Let's Encrypt:
certbot --nginx --non-interactive --agree-tos --email <YOUR_EMAIL> -d <YOUR_DOMAIN>
6. Ricarica Nginx:
systemctl reload nginx
7. Aggiorna l'URL del sito Docusaurus: sostituisci url: 'http://<SERVER_IP>', con url: 'https://<YOUR_DOMAIN>', in /opt/docusaurus/docusaurus.config.js.
8. Ricostruisci il sito:
cd /opt/docusaurus && npm run build
9. Apri il browser e vai a: https://<YOUR_DOMAIN>
Note
- Docusaurus genera un sito statico: non serve alcun database.
- Le modifiche ai contenuti richiedono una nuova build prima di essere visibili al pubblico.
- Modifica la configurazione di Docusaurus e la struttura del progetto secondo le tue preferenze.
