Доступ
- Відкрийте Docusaurus:
http://<SERVER_IP>
Редагування та публікація контенту
1. Додайте або змініть файли з контентом:
/opt/docusaurus/docs
/opt/docusaurus/blog
/opt/docusaurus/src/pages
2. Оновлення /opt/docusaurus/docusaurus.config.js для налаштувань сайту, навігації та конфігурації теми.
3. Перезберіть сайт:
cd /opt/docusaurus && npm run build
Nginx віддає згенеровані файли з: /opt/docusaurus/build
Після перезбірки перезапускати Nginx не потрібно.
Важливі шляхи
- Проєкт:
/opt/docusaurus - Документація:
/opt/docusaurus/docs - Блог:
/opt/docusaurus/blog - Сторінки:
/opt/docusaurus/src/pages - Конфігурація:
/opt/docusaurus/docusaurus.config.js - Результат збірки:
/opt/docusaurus/build - Конфігурація Nginx:
/etc/nginx/sites-available/docusaurus.conf
Домен і HTTPS
1. Спрямуйте свій домен на IP-адресу сервера.
2. Відредагуйте конфігурацію Nginx і замініть server_name _; на свій домен (наприклад, server_name <YOUR_DOMAIN>;):
vim /etc/nginx/sites-available/docusaurus.conf
3. Перевірте конфігурацію:
nginx -t
4. Встановіть Certbot:
apt install -y certbot python3-certbot-nginx
5. Згенеруйте сертифікат Let's Encrypt:
certbot --nginx --non-interactive --agree-tos --email <YOUR_EMAIL> -d <YOUR_DOMAIN>
6. Перезавантажте Nginx:
systemctl reload nginx
7. Оновіть URL сайту Docusaurus: замініть url: 'http://<SERVER_IP>', на url: 'https://<YOUR_DOMAIN>', in /opt/docusaurus/docusaurus.config.js.
8. Перезберіть сайт:
cd /opt/docusaurus && npm run build
9. Відкрийте браузер і перейдіть за адресою: https://<YOUR_DOMAIN>
Примітки
- Docusaurus створює статичний сайт, база даних не потрібна.
- Зміни контенту з'являються публічно лише після нової збірки.
- Змініть конфігурацію Docusaurus і структуру проєкту на свій розсуд.
