بناء مدونة Look Scanned باستخدام Hugo

نبذة عن Look Scanned

Look Scanned هو تطبيق ويب خفيف يُحاكي مظهر المستندات الممسوحة ضوئياً. صُمم مع التركيز على خصوصية المستخدم، ويُمكّن المطورين والمصممين والمستخدمين العاديين من إنشاء ملفات PDF تبدو كأنها ممسوحة ضوئياً دون الحاجة لأجهزة حقيقية.

لماذا اخترنا Hugo؟

بعد دراسة متأنية لمختلف مولّدات المواقع الثابتة، وقع اختيارنا على Hugo للأسباب التالية:

أداء فائق - مبني بلغة Go، مما يضمن سرعة بناء استثنائية
سهولة الاستخدام - واجهة بسيطة ومسار تعلم سلس
ثراء القوالب - مجموعة متنوعة من القوالب الجذابة والقابلة للتخصيص
مجتمع داعم - مساعدة فورية وتوثيق متكامل
دعم التعريب - نظام تعدد لغات متكامل

خطوات البدء

تثبيت Hugo

لنظام macOS (باستخدام Homebrew):

brew install hugo

لنظام Windows (باستخدام Chocolatey):

choco install hugo-extended

لمستخدمي Linux، راجع دليل التثبيت.

إنشاء المشروع

نفّذ الأوامر التالية:

hugo new site lookscanned-blog
cd lookscanned-blog

إعداد القالب

أضف قالب PaperMod كوحدة Git فرعية:

git init
git submodule add https://github.com/adityatelange/hugo-PaperMod themes/PaperMod

أضف في ملف config.toml:

theme = "PaperMod"

إعداد اللغات

قم بتهيئة دعم اللغات في config.toml:

defaultContentLanguage = 'en'
defaultContentLanguageInSubdir = false

[params]
  displayFullLangName = true

[languages]
  [languages.en]
    languageCode = 'en'
    languageName = 'English'
    title = 'Look Scanned Blog'
  [languages.zh]
    languageName = '简体中文'
    title = 'Look Scanned 博客'
  [languages.zh-tw]
    languageCode = 'zh-TW'
    languageName = '繁體中文'
    title = 'Look Scanned 部落格'
  # إضافة لغات أخرى...

كتابة المحتوى

أنشئ أول مقالة:

hugo new posts/build-blog-using-hugo/index.ar.md

بيئة التطوير

شغّل الخادم المحلي:

hugo server -D

تفقد الموقع على http://localhost:1313.

نشر الموقع

أتمتة عملية النشر باستخدام GitHub Actions:

النشر على GitHub Pages
- أنشئ مستودعاً جديداً على GitHub
- ارفع الشيفرة المصدرية
- فعّل خدمة GitHub Pages
- اضبط النشر التلقائي
النشر على Cloudflare Pages
- اربط مستودع GitHub
- حدد hugo كأمر للبناء
- عيّن المجلد public للنشر

تخصيص الموقع

لتحسين تجربة المستخدم، أزلنا قائمة اختيار اللغة من رأس الصفحة. يمكنك مراجعة التعديلات هنا.

خاتمة

يُعد Hugo خياراً مثالياً لإنشاء المدونات الشخصية. يتميز بأدائه العالي، ومرونته في الإعداد، وتوثيقه الشامل، مما يجعله مناسباً لجميع مستويات المطورين. مع الاستخدام المستمر، ستكتشف إمكانيات جديدة لإنشاء مدونة متميزة.