ديف أوبس

كيفية تثبيت Hexo على أوبنتو

كيفية تثبيت Hexo، مولد مواقع ثابتة (Static Site Generator) وعمل مدونة به على خادوم أوبنتو

يعد Hexo من أشهر أدوات إنشاء المواقع الثابتة (Static Site Generators) التي تعتمد على Node.js لإنشاء المواقع التي لا تحتاج إلى قاعدة بيانات لإدارتها، مما يجعلها خفيفة وسريعة. يستخدم Hexo لإنشاء مدونات شخصية أو مواقع ثابتة تعرض مقاطع من المحتوى بدون الحاجة إلى أدوات إدارة معقدة. في هذا المقال، سوف نغطي كيفية تثبيت Hexo على خادوم أوبنتو، وإنشاء مدونة باستخدامه، مع العديد من النصائح لتهيئة المدونة وتخصيصها حسب الحاجة.

المتطلبات الأساسية

قبل البدء في تثبيت Hexo، يجب أن يكون لديك بيئة جاهزة على خادم أوبنتو تحتوي على Node.js و npm، حيث يعد Hexo مكتوبًا باستخدام Node.js ويعتمد على npm لإدارة الحزم.

الخطوات الأساسية للتحضير
  1. تحديث النظام:
    من الأفضل أن تبدأ بتحديث خادم أوبنتو لضمان أنك تعمل بأحدث الإصدارات المتاحة. افتح الطرفية (Terminal) وأدخل الأوامر التالية:

    bash
    sudo apt update sudo apt upgrade
  2. تثبيت Node.js و npm:
    لتثبيت Node.js و npm، يمكنك استخدام مستودعات NodeSource. أولاً، قم بإضافة المستودع الخاص بـ Node.js:

    bash
    curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -

    ثم قم بتثبيت Node.js و npm:

    bash
    sudo apt install -y nodejs

    للتحقق من أن التثبيت تم بنجاح، يمكنك التحقق من الإصدارات باستخدام الأوامر:

    bash
    node -v npm -v

تثبيت Hexo

بعد التأكد من أن البيئة الأساسية جاهزة، يمكنك الآن تثبيت Hexo على خادم أوبنتو.

  1. تثبيت Hexo باستخدام npm:
    يمكنك تثبيت Hexo على مستوى النظام باستخدام npm. في الطرفية، اكتب الأمر التالي:

    bash
    sudo npm install -g hexo-cli

    يقوم هذا الأمر بتثبيت Hexo بشكل عالمي، مما يعني أنه سيكون متاحًا لاستخدامه في أي مكان على النظام.

  2. إنشاء مشروع Hexo جديد:
    بعد تثبيت Hexo، يمكنك الآن إنشاء مجلد جديد لمشروع Hexo الخاص بك. انتقل إلى الدليل الذي تريد إنشاء مدونتك فيه، ثم استخدم الأمر التالي لإنشاء موقع جديد:

    bash
    hexo init my-blog cd my-blog

    سيقوم هذا بإنشاء هيكل مجلدات أساسي داخل my-blog مع بعض الملفات التمهيدية. يمكنك الآن الذهاب إلى هذا المجلد وفتح الملفات لتعديل محتوى المدونة.

  3. تثبيت الحزم المطلوبة:
    بعد إنشاء المشروع، يجب تثبيت الحزم المطلوبة التي يتم تحديدها في package.json باستخدام npm:

    bash
    npm install

    هذا يضمن أن جميع الحزم الضرورية لـ Hexo موجودة في المشروع.

تشغيل المدونة محليًا

للتأكد من أن كل شيء قد تم بشكل صحيح، يمكنك تشغيل Hexo على الخادم الخاص بك في الوضع المحلي.

  1. تشغيل خادم Hexo محليًا:
    لاختبار المدونة محليًا، يمكنك استخدام الأمر التالي لتشغيل الخادم المحلي:

    bash
    hexo server

    بعد تنفيذ هذا الأمر، يمكنك فتح متصفح الإنترنت والانتقال إلى http://localhost:4000 لعرض مدونتك. يجب أن ترى صفحة الترحيب الخاصة بـ Hexo، وهي الصفحة الافتراضية التي تم إنشاؤها.

نشر المدونة على الخادم

لتشغيل المدونة على خادم أوبنتو بشكل دائم، يجب نشرها باستخدام Hexo على الخادم.

  1. إعداد الموقع للنشر:
    قبل النشر، تحتاج إلى إعداد Hexo ليقوم بإنشاء النسخة الثابتة من الموقع في مجلد public. يمكنك فعل ذلك باستخدام الأمر التالي:

    bash
    hexo generate

    هذا سيقوم بإنشاء الملفات الثابتة التي تمثل صفحات المدونة في مجلد public. الآن يجب إعداد خادم ويب لعرض هذه الملفات. غالبًا ما يُستخدم Nginx أو Apache لهذا الغرض.

  2. تثبيت Nginx:
    إذا كنت تستخدم Nginx لخادم الويب الخاص بك، يمكنك تثبيته باستخدام الأمر التالي:

    bash
    sudo apt install nginx
  3. إعداد Nginx:
    يجب تعديل إعدادات Nginx لتوجيه حركة المرور إلى المجلد public الخاص بـ Hexo. افتح ملف التكوين الخاص بـ Nginx:

    bash
    sudo nano /etc/nginx/sites-available/default

    ثم قم بتعديل التوجيهات بحيث يبدو الملف كالتالي:

    nginx
    server { listen 80; server_name your_domain_or_IP; root /path/to/your/blog/public; index index.html; location / { try_files $uri $uri/ =404; } }

    تأكد من استبدال /path/to/your/blog/public بالمسار الفعلي لمجلد public في Hexo.

  4. إعادة تشغيل Nginx:
    بعد تحديث تكوين Nginx، يجب إعادة تشغيل الخدمة:

    bash
    sudo systemctl restart nginx

    الآن يمكنك الوصول إلى مدونتك من خلال http://your_domain_or_IP.

إعداد النظام للإنتاج

لكي يتمكن الزوار من الوصول إلى مدونتك بشكل مستمر، يجب تفعيل Hexo ليتعامل مع عملية النشر بشكل تلقائي، خاصة إذا كنت ترغب في نشر محتوى جديد.

  1. إعداد النشر باستخدام Git:
    يمكنك إعداد Hexo لرفع المدونة إلى مستودع Git مثل GitHub Pages أو أي خدمة استضافة أخرى. ابدأ بإنشاء مستودع جديد على GitHub أو على أي خدمة مستودعات أخرى، ثم استخدم الأوامر التالية لإعداد المستودع في Hexo:

    bash
    hexo deploy

    يمكن تعديل التكوينات في ملف _config.yml لضبط خيارات النشر.

تخصيص المدونة

بمجرد أن تصبح المدونة جاهزة، يمكنك تخصيصها حسب احتياجاتك:

  1. تغيير القالب:
    Hexo يأتي مع قالب افتراضي، ولكن يمكنك تغيير هذا القالب بسهولة باستخدام مجموعة من القوالب الجاهزة التي يمكن العثور عليها على الإنترنت أو عبر مستودعات Hexo. للقيام بذلك، يمكن تعديل إعدادات القالب في الملف _config.yml.

  2. إضافة محتوى جديد:
    لإضافة مقال جديد، يمكنك استخدام الأمر التالي:

    bash
    hexo new post "عنوان المقال"

    ثم قم بتحرير المقال الجديد في المجلد source/_posts/. بعد الانتهاء من تحرير المقال، يمكنك نشره عبر الأمر:

    bash
    hexo generate hexo deploy

خاتمة

لقد تمكنا من تثبيت Hexo على خادم أوبنتو، وإعداد مدونة ثابتة وتخصيصها حسب الحاجة. يوفر Hexo مجموعة كبيرة من الأدوات التي تجعل من السهل إنشاء مواقع ثابتة أو مدونات مع استضافة بسيطة وقابلة للتخصيص.