Erişim
- Docusaurus'u açın:
http://<SERVER_IP>
İçerik düzenleme ve yayınlama
1. İçerik dosyaları ekleyin veya düzenleyin:
/opt/docusaurus/docs
/opt/docusaurus/blog
/opt/docusaurus/src/pages
2. Güncelle /opt/docusaurus/docusaurus.config.js site ayarları, gezinme ve tema yapılandırması için.
3. Siteyi yeniden derleyin:
cd /opt/docusaurus && npm run build
Nginx, üretilen dosyaları şu konumdan sunar: /opt/docusaurus/build
Yeniden derlemeden sonra Nginx'i yeniden başlatmak gerekmez.
Önemli Yollar
- Proje:
/opt/docusaurus - Dokümantasyon:
/opt/docusaurus/docs - Blog:
/opt/docusaurus/blog - Sayfalar:
/opt/docusaurus/src/pages - Yapılandırma:
/opt/docusaurus/docusaurus.config.js - Derleme çıktısı:
/opt/docusaurus/build - Nginx yapılandırması:
/etc/nginx/sites-available/docusaurus.conf
Alan adı ve HTTPS
1. Alan adınızı sunucunun IP adresine yönlendirin.
2. Nginx yapılandırmasını düzenleyip şunu değiştirin: server_name _; kendi alan adınızla (örneğin, server_name <YOUR_DOMAIN>;):
vim /etc/nginx/sites-available/docusaurus.conf
3. Yapılandırmayı test edin:
nginx -t
4. Certbot'u kurun:
apt install -y certbot python3-certbot-nginx
5. Bir Let's Encrypt sertifikası oluşturun:
certbot --nginx --non-interactive --agree-tos --email <YOUR_EMAIL> -d <YOUR_DOMAIN>
6. Nginx'i yeniden yükleyin:
systemctl reload nginx
7. Docusaurus site URL'sini güncelleyin: şunu değiştirin: url: 'http://<SERVER_IP>', şununla: url: 'https://<YOUR_DOMAIN>', in /opt/docusaurus/docusaurus.config.js.
8. Siteyi yeniden derleyin:
cd /opt/docusaurus && npm run build
9. Tarayıcını aç ve şu adresi ziyaret et: https://<YOUR_DOMAIN>
Notlar
- Docusaurus statik bir web sitesi üretir; veritabanı gerekmez.
- İçerik değişikliklerinin herkese görünmesi için yeni bir derleme gerekir.
- Docusaurus yapılandırmasını ve proje yapısını tercihlerinize göre değiştirin.
