Truy cập
- Mở Docusaurus:
http://<SERVER_IP>
Sửa và xuất bản nội dung
1. Thêm hoặc sửa các tệp nội dung:
/opt/docusaurus/docs
/opt/docusaurus/blog
/opt/docusaurus/src/pages
2. Cập nhật /opt/docusaurus/docusaurus.config.js cho thiết lập trang, điều hướng và cấu hình giao diện.
3. Build lại trang:
cd /opt/docusaurus && npm run build
Nginx phục vụ các tệp đã tạo từ: /opt/docusaurus/build
Không cần khởi động lại Nginx sau khi build lại.
Các đường dẫn quan trọng
- Dự án:
/opt/docusaurus - Tài liệu:
/opt/docusaurus/docs - Blog:
/opt/docusaurus/blog - Trang:
/opt/docusaurus/src/pages - Cấu hình:
/opt/docusaurus/docusaurus.config.js - Kết quả build:
/opt/docusaurus/build - Cấu hình Nginx:
/etc/nginx/sites-available/docusaurus.conf
Tên miền và HTTPS
1. Trỏ tên miền của bạn tới địa chỉ IP của máy chủ.
2. Sửa cấu hình Nginx và thay server_name _; bằng tên miền của bạn (ví dụ, server_name <YOUR_DOMAIN>;):
vim /etc/nginx/sites-available/docusaurus.conf
3. Kiểm tra cấu hình:
nginx -t
4. Cài đặt Certbot:
apt install -y certbot python3-certbot-nginx
5. Tạo chứng chỉ Let's Encrypt:
certbot --nginx --non-interactive --agree-tos --email <YOUR_EMAIL> -d <YOUR_DOMAIN>
6. Tải lại Nginx:
systemctl reload nginx
7. Cập nhật URL trang Docusaurus: thay url: 'http://<SERVER_IP>', bằng url: 'https://<YOUR_DOMAIN>', in /opt/docusaurus/docusaurus.config.js.
8. Build lại trang:
cd /opt/docusaurus && npm run build
9. Mở trình duyệt và truy cập: https://<YOUR_DOMAIN>
Ghi chú
- Docusaurus tạo ra trang tĩnh, không cần cơ sở dữ liệu.
- Thay đổi nội dung cần build lại thì mới hiển thị công khai.
- Thay đổi cấu hình Docusaurus và cấu trúc dự án theo ý bạn.
