دليل بناء Hugo بسيط

هوغو (Hugo) هو إطار عمل لبناء مواقع الويب، يتميز بسرعة عالية في البناء والنشر. فيما يتعلق بتثبيته وتكوينه في نظام Windows، لا يوجد توضيح مفصل في الوثائق الرسمية، والمصادر الخارجية متباينة. لذا قمت بكتابة هذا الدليل.

التنزيل والتثبيت

قم بفتح صفحة Releases الرسمية على GitHub لـ Hugo.
حدد أحدث إصدار للتنزيل (اختر hugo_xxx_Windows-64/32bit.zip).
قم بفك ضغط ملف hugo.exe الموجود داخل الحزمة إلى مجلد D:\hugo.
في مستكشف الملفات (أو ما يعرف بـ "جهاز الكمبيوتر الخاص بي")، انقر بزر الماوس الأيمن في مكان فارغ ثم افتح الخصائص.
انتقل بالتسلسل إلى "إعدادات النظام المتقدمة" - "المتغيرات البيئية"، ثم انقر مرتين لفتح المتغير النظامي Path.
في واجهة المتغيرات البيئية، انقر مرتين في السطر الفارغ وأضف D:\hugo، ثم انقر على موافق.

افتح نافذة الأوامر وأدخل الأمر التالي:

hugo version

للتحقق من نجاح تثبيت Hugo (إذا نجح التثبيت، سترى رقم الإصدار).

إنشاء الموقع

انتقل إلى الدليل المناسب واستخدم الأمر التالي:

hugo new site quickstart

سيقوم هذا بإنشاء موقع Hugo جديد داخل مجلد يسمى quickstart.

إضافة قوالب (Themes)

يمكنك اختيار قالب من صفحة القوالب الرسمية.

قم بالانتقال مباشرة إلى صفحة القالب على GitHub وقم بتنزيل مجلد القالب، ثم قم بفك ضغطه داخل مجلد theme في موقعك.

استخدم الأمر التالي لإضافة القالب إلى ملف تكوين الموقع:

echo 'theme = "اسم مجلد القالب"' >> config.toml

إنشاء مقال

استخدم الأمر التالي لإنشاء مقال جديد:

hugo new posts/my-first-post.md

ثم افتح المقال وقم بتغيير draft: true في "front matter" إلى draft: false لنشره بشكل عام وعرضه.

تشغيل خدمة Hugo

استخدم الأمر التالي لتشغيل خدمة Hugo لمعاينة الموقع محليًا:

hugo server -D

قم بفتح http://localhost:1313/ لرؤية الموقع المعاين في الوقت الحقيقي (أي تغيير محلي سيتم تحديثه فورًا).

النشر المحلي

استخدم الأمر التالي:

Build static pages

لنشر الموقع محلياً (سيتم حفظ الإخراج في مجلد public).

المراجع والشكر

Quick Start · Hugo

عنوان النص: https://wiki-power.com/
يتم حماية هذا المقال بموجب اتفاقية CC BY-NC-SA 4.0، يُرجى ذكر المصدر عند إعادة النشر.

تمت ترجمة هذه المشاركة باستخدام ChatGPT، يرجى تزويدنا بتعليقاتكم إذا كانت هناك أي حذف أو إهمال.