كيفية إنشاء مدونة مع هوغو

• المقدمة
• المتطلبات الأساسية
• الخطوة 1: قم بتثبيت برنامج Hugo
• الخطوة 2: قم ببناء موقعك
• الخطوة 3: قم بتثبيت السمات من مستودع Hugo
• الخطوة 4: قم بإجراء بعض تغييرات التكوين الأساسية
• الخطوة 5: تأليف المحتوى الخاص بك
• الخطوة 6: اضبط المحتوى الخاص بك مع خادم Hugo
• الخطوة 7: نشر موقعك

المقدمة

Hugo هو مولد موقع ثابت مع سرعة عرض سريعة وخفيفة وسهل الاستخدام. بفضل جميع ميزاته الموجهة للمحتوى ، يمكنك دائمًا التركيز على إنشاء المحتوى بدلاً من بناء البيئة:

• باستخدام Hugo ، يمكنك إنشاء موقع ثابت يعمل في أي مكان في عدة دقائق دون القلق بشأن التبعيات المملة أو قواعد البيانات.
• يمكنك إنشاء المحتوى الخاص بك في Markdown ، وهو أسلوب الكتابة الأكثر ملاءمة ، ورؤية التغييرات التي أجريتها على الويب على الفور.
• علاوة على ذلك ، يمكنك تحقيق أقصى استفادة من مستودع ثراء Hugo ومجتمع سريع النمو.

في هذا البرنامج التعليمي ، سأوضح لك كيفية تثبيت Hugo واستخدامه لإنشاء موقع مدونة ثابت على مثيل خادم Vultr LEMP المستند إلى CentOS.

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

تسجيل الدخول إلى المثيل الخاص بك كمستخدم غير الجذر مع أذونات sudo. انظر كيفية إنشاء مثل هذا المستخدم في هذه المقالة .

الخطوة 1: قم بتثبيت برنامج Hugo

يمكن تثبيت Hugo على جميع المنصات الرئيسية تقريبًا. بالنسبة لـ CentOS ، ما عليك سوى تنزيل أحدث ملف برنامج في .tar.gzأرشيف وفك ضغطه إلى موقع مناسب. في وقت كتابة هذا التقرير ، كان الإصدار الأخير 0.15.

sudo yum update -y
sudo yum install git -y
cd ~
wget https://github.com/spf13/hugo/releases/download/v0.15/hugo_0.15_linux_amd64.tar.gz
tar -zxvf hugo_0.15_linux_amd64.tar.gz
sudo mv hugo_0.15_linux_amd64/hugo_0.15_linux_amd64 /usr/local/bin/hugo

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

 hugo version

الخطوة 2: قم ببناء موقعك

باستخدام Hugo ، يمكنك إنشاء موقعك من داخل أي مجلد على الخادم الخاص بك. هنا ، أنشأت موقعًا في الدليل mysite/تحت دليل بيتي.

cd ~
hugo new site ~/mysite

قم بتشغيل الأوامر التالية لرؤية بنية الموقع:

cd mysite
ls -lF

كما ترى ، تشبه هندسة الموقع الحالية:

الأمثلة /

config.toml

المحتوى/

البيانات/

تخطيطات /

ثابتة/

مع اثنين من الدلائل آخر لتنشأ بعد، themes/و public/، والهندسة المعمارية كاملة من موقع هوغو هو المدمجة ولكنها شاملة.

بداية ، اعلم أنه يجب تخزين المحتوى الخاص بك في الدليل content/.

الخطوة 3: قم بتثبيت السمات من مستودع Hugo

لتثبيت جميع السمات من مستودع Hugo ، قم بتشغيل الأوامر التالية. سيؤدي هذا إلى إنشاء دليل مسمى themes/في دليل الموقع الخاص بك وتنزيل جميع السمات من ال Hugo theme repo.

cd ~/mysite/
git clone --depth 1 --recursive https://github.com/spf13/hugoThemes.git themes

إذا كنت ترغب فقط في تثبيت سمة واحدة ، فانتقل إلى موضوع Hugo theme لتحديد المظهر المفضل لديك. انسخ عنوان URL الخاص به والصقه في git cloneالأمر أدناه.

cd ~/mysite/
mkdir themes
cd themes
git clone https://github.com/jaden/twentyfourteen

الخطوة 4: قم بإجراء بعض تغييرات التكوين الأساسية

يحتوي الملف المسمى config.tomlفي دليل الموقع الخاص بك على التكوين العام لموقع Hugo الخاص بك. قم بتحرير الملف باستخدام محرر نصوص لإجراء بعض تغييرات التكوين الأساسية كما هو موضح أدناه. تذكر استبدال القيم وفقًا لظروفك الخاصة.

baseurl = "http://[YourSiteIP]/"
languageCode = "en-us"
title = "Your Site Name"
theme = "twentyfourteen"

الخطوة 5: تأليف المحتوى الخاص بك

في دليل الموقع الخاص بك ، أدخل الأمر التالي لإنشاء صفحة محتوى في الدليل ~/mysite/content/post/.

cd ~/mysite/
hugo new post/about.md

افتح الملف في محرر نص ، يجب أن يكون تنسيق الملف مشابهًا لما يلي.

+++
date = "2015-12-25T03:21:23Z"
draft = true
title = "about"

+++

بين سطري +++الأكاذيب توجد معلومات التعريف الخاصة بصفحة المحتوى الخاصة بك. هنا ، يمكنك إزالة السطر draft = trueوتعديل سطر العنوان كما تريد.

تحت +++السطر الثاني ، أضف المحتوى الذي تريد عرضه على صفحة الويب. تذكر أن تكتب المحتوى الخاص بك في لغة التخفيض.

## This is an H2 headline

Text goes here.

بعد الانتهاء من هذا التعديل ، اترك محرر النصوص مفتوحًا للاستخدام لاحقًا.

الخطوة 6: اضبط المحتوى الخاص بك مع خادم Hugo

يمكنك استخدام خادم الويب المدمج في Hugo لنشر موقعك ، والذي يمكنه عرض التغييرات على الفور على صفحة الويب بمجرد تعديل المحتوى الخاص بك في محرر نصوص.

افتح محطة طرفية أخرى ، قم بتكوين iptablesالقواعد للسماح بوصولك إلى موقعك على المنفذ الافتراضي لخادم Hugo 1313:

sudo iptables -I INPUT -p tcp --dport 1313 -j ACCEPT

قم بتشغيل خادم Hugo:

hugo server --bind="[YourServerIP]"

قم بزيارة موقعك من متصفح:

http://[YourServerIP]:1313

الآن ، يمكنك محاولة تحرير محتوى ملف الصفحة في الوحدة الطرفية السابقة أو إضافة / إزالة ملف صفحة. ستجد أن أي تعديلات في content/الدليل ستنعكس في نفس الوقت على شاشة متصفحك. هذه ميزة رائعة لمدون مدون مشغول لأنه يمكنك دائمًا رؤية تعديلاتك على الفور للحصول على تجارب أفضل للتأليف.

بعد الانتهاء من التعديل ، اضغط Ctrl+Cلإيقاف خادم Hugo.

الخطوة 7: نشر موقعك

حان الوقت الآن لنشر موقعك على الويب. قم بتشغيل الأوامر التالية وسوف يقوم Hugo بإنشاء كل المحتوى الثابت المناسب للنشر داخل public/الدليل.

cd ~/mysite
hugo

ملاحظة : لن يحذف Hugo الملفات القديمة التي تم إنشاؤها مسبقًا عند تشغيل الأوامر أعلاه. لتجنب النتائج غير المتوقعة ، يمكنك دائمًا حذف public/الدليل قبل تشغيل hugoالأمر أو تحديد وجهة إخراج جديدة كما هو موضح في الأمر التالي.

hugo --destination=public2

نظرًا لأن خادم Nginx يعمل بالفعل على الخادم ، فكل ما عليك فعله هو نسخ محتوى ~/mysite/public/الدليل أو أدلة الوجهة المخصصة الأخرى إلى دليل الويب الخاص بك /usr/share/nginx/html/.

احذف الملفات الأصلية:

cd /usr/share/nginx/html/
sudo rm -rf background.jpg index.php logo.png

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

cd ~/mysite/public
sudo cp -R ~/mysite/public/. /usr/share/nginx/html/

هذا هو. الآن يمكنك زيارة موقع الويب الخاص بك بسرعة فائقة ثابت من المتصفح: http://[YourServerIP].

لمعرفة المزيد من التفاصيل ، استخدم الأمر hugo helpأو قم بزيارة موقع Hugo الرسمي .