Доступ
- Откройте 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 и структуру проекта по своему усмотрению.
