دوّن على صفحات GitHub بكل سهولة

يسهّل Jekyll Now البداية في التدوين على صفحات GitHub وذلك بإزالة خطوات تنصيب وإعداد Jekyll.

صفحات GitHub هي خدمة استضافة الصفحات الثابتة للمشاريع والمدونات. تعتمد هذه الخدمة على موّلد الصفحات الثابتة Jekyll والذي يحول ملفات ماركداون مع ترميزها وهيكلتها إلى مدونة بسيطة وأنيقة.

من ميزات Jekyll Now:

  • تصميم أنيق ومناسب للهواتف المحمولة
  • لا يحتاج لسطر الأوامر
  • لا يحتاج لتنصيب وإعداد روبي
  • لا يتحتاج لتحميل المكتبات التي يعتمد عليها Jekyll مثل محوّل ماركداون وملوّن الأكواد
  • سهل تجريبه فيمكنك حذف المدونة في أي وقت تشاء أن لم تعجبك

شكل Jekyll Now

كيف تبدأ

الخطوة الأولى: انسخ مصدر المدونة إلى حسابك

استعمل زر Fork على مصدر المدونة لنسخها إلى حسابك، ثم عدل على اسم المشروع في إعدادات النسخة ليكون <username>.github.com مع تبديل <username> إلى اسم حسابك. ستصبح مدونك جاهزة فورًا على الرابط http://username.github.io.

الخطوة الأولى

الخطوة الثانية: ضع الشخصية في مدونتك الشخصية

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

عندما تعدل على ملف _config.yml (أو أي ملف آخر) سوف يقوم GitHub بإعادة توليد المدونة وستظهر التغيرات بعد عدة ثواني على http://username.github.io (في حالات نادرة قد تتأخر العملية وينصح GitHub بالإنتظار لمدة عشر دقائق على الأكثر).

الخطوة الثالثة: دوّن!

حان وقت كتابة أول تدونة على المدونة، حرر الملف _posts/2017-1-3-Hello-World.md وابدأ بسرد أفكارك. استخدم دليل الماركداون إذا احتجت مساعدة.

كيفية التحرير

يتطلب Jekyll من اسماء الملفات ان تتبع الصيغة

‫<تاريخ-التدوينة>-<عنوان-إنجيليزي-قصير>.md

بحيث:

  • <تاريخ-التدوينة> يجب أن يصاغ التاريخ بهذا الشكل سنة-شهر-يوم
  • ووضع - بين التاريخ والعنوان
  • والعنوان الإنجليزي الذي سيتخدم في رابط هذه التدوينة
  • وأخيرًا صيغة الملف .md لتعرّفه على أنه ماركداون

طرق تحرير المدونة:

  1. حرر الملف مباشرة على GitHub بالذهاب إلى الملف على نسخة المدونة الخاصة بك (كالمعروض في الأعلى)، أو
  2. أستخدم أحد المحرارات السحابية المخصصة للعمل مع GitHub، مثل Prose والتي تساعدك على التعامل مع المسودات والصور، أو
  3. وهي الطريقة الأكثر مرونة، حمل نسخة المدونة الخاصة بك على جهازك وحررها ببرنامج متخصص في تحرير الماركداون مثل كاتب. تحتاج هذه الطريقة بعض من العلم بكيفية عمل Git. (لتسهيل التعامل مع Git استخدام برنامج GitHub المكتبي)

تنصيب Jekyll وتطوير المدونة على جهازك (متقدم)

  1. حمل Jekyll وكل المكتبات اللازمة لصفحات GitHub بإستخدام الأمر (برنامج gem هو مدير المكتبات في لغة روبي)
gem install github-pages
  1. حمل مصدر نسختك الشخصية للمدونة بإستخدام الأمر
git clone https://github.com/<username>/<username>.github.io.git
  1. إذهب للملف الذي حملته ومن ثم استخدم الأمر لتشغيل خادم Jekyll
jekyll serve
  1. افتح الرابط http://127.0.0.1:4000 بالمتصفح لعرض المدونة
  2. بعد التعديل استخدم Git لحفظ التعديلات ثم رفعها إلى GitHub لنشرها على المدونة

لديك استفسار أو مشكلة؟

تواصل معي، سأسعد بمساعدتك.

شكر ونسب

كُتب في 06/01/2017