الوصول
- افتح Docusaurus:
http://<SERVER_IP>
تحرير المحتوى ونشره
1. أضف ملفات المحتوى أو عدّلها:
/opt/docusaurus/docs
/opt/docusaurus/blog
/opt/docusaurus/src/pages
٢. حدّث /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. حدّث رابط موقع 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 وبنية المشروع بحسب تفضيلاتك.
