Acceso
- Abre Docusaurus:
http://<SERVER_IP>
Editar y publicar contenido
1. Añade o edita archivos de contenido:
/opt/docusaurus/docs
/opt/docusaurus/blog
/opt/docusaurus/src/pages
2. Actualiza /opt/docusaurus/docusaurus.config.js para los ajustes del sitio, la navegación y la configuración del tema.
3. Reconstruye el sitio:
cd /opt/docusaurus && npm run build
Nginx sirve los archivos generados desde: /opt/docusaurus/build
No hace falta reiniciar Nginx después de reconstruir.
Rutas importantes
- Proyecto:
/opt/docusaurus - Documentación:
/opt/docusaurus/docs - Blog:
/opt/docusaurus/blog - Páginas:
/opt/docusaurus/src/pages - Configuración:
/opt/docusaurus/docusaurus.config.js - Salida de la compilación:
/opt/docusaurus/build - Configuración de Nginx:
/etc/nginx/sites-available/docusaurus.conf
Dominio y HTTPS
1. Apunta tu dominio a la dirección IP del servidor.
2. Edita la configuración de Nginx y sustituye server_name _; por tu dominio (por ejemplo, server_name <YOUR_DOMAIN>;):
vim /etc/nginx/sites-available/docusaurus.conf
3. Prueba la configuración:
nginx -t
4. Instala Certbot:
apt install -y certbot python3-certbot-nginx
5. Genera un certificado de Let's Encrypt:
certbot --nginx --non-interactive --agree-tos --email <YOUR_EMAIL> -d <YOUR_DOMAIN>
6. Recarga Nginx:
systemctl reload nginx
7. Actualiza la URL del sitio Docusaurus: sustituye url: 'http://<SERVER_IP>', por url: 'https://<YOUR_DOMAIN>', in /opt/docusaurus/docusaurus.config.js.
8. Reconstruye el sitio:
cd /opt/docusaurus && npm run build
9. Abre tu navegador y visita: https://<YOUR_DOMAIN>
Notas
- Docusaurus genera un sitio estático: no hace falta base de datos.
- Los cambios de contenido requieren una nueva compilación antes de aparecer públicamente.
- Cambia la configuración de Docusaurus y la estructura del proyecto según tus preferencias.
