Dostęp
- Otwórz Docusaurus:
http://<SERVER_IP>
Edycja i publikowanie treści
1. Dodaj lub edytuj pliki treści:
/opt/docusaurus/docs
/opt/docusaurus/blog
/opt/docusaurus/src/pages
2. Aktualizuj /opt/docusaurus/docusaurus.config.js dla ustawień witryny, nawigacji i konfiguracji motywu.
3. Przebuduj witrynę:
cd /opt/docusaurus && npm run build
Nginx udostępnia wygenerowane pliki z: /opt/docusaurus/build
Po przebudowaniu nie trzeba restartować Nginx.
Ważne ścieżki
- Projekt:
/opt/docusaurus - Dokumentacja:
/opt/docusaurus/docs - Blog:
/opt/docusaurus/blog - Strony:
/opt/docusaurus/src/pages - Konfiguracja:
/opt/docusaurus/docusaurus.config.js - Wynik budowania:
/opt/docusaurus/build - Konfiguracja Nginx:
/etc/nginx/sites-available/docusaurus.conf
Domena i HTTPS
1. Skieruj swoją domenę na adres IP serwera.
2. Edytuj konfigurację Nginx i zamień server_name _; na swoją domenę (na przykład server_name <YOUR_DOMAIN>;):
vim /etc/nginx/sites-available/docusaurus.conf
3. Przetestuj konfigurację:
nginx -t
4. Zainstaluj Certbota:
apt install -y certbot python3-certbot-nginx
5. Wygeneruj certyfikat Let's Encrypt:
certbot --nginx --non-interactive --agree-tos --email <YOUR_EMAIL> -d <YOUR_DOMAIN>
6. Przeładuj Nginx:
systemctl reload nginx
7. Zaktualizuj adres URL witryny Docusaurus: zamień url: 'http://<SERVER_IP>', na url: 'https://<YOUR_DOMAIN>', in /opt/docusaurus/docusaurus.config.js.
8. Przebuduj witrynę:
cd /opt/docusaurus && npm run build
9. Otwórz przeglądarkę i odwiedź: https://<YOUR_DOMAIN>
Uwagi
- Docusaurus generuje stronę statyczną, baza danych nie jest potrzebna.
- Zmiany treści wymagają nowego buildu, zanim staną się publicznie widoczne.
- Zmień konfigurację Docusaurusa i strukturę projektu według swoich preferencji.
