---
layout: post
title: دوّن على صفحات GitHub بكل سهولة
---


يسهّل [Jekyll Now](http://www.jekyllnow.com/) البداية في التدوين على [صفحات GitHub](https://pages.github.com/) وذلك بإزالة خطوات تنصيب وإعداد [Jekyll](https://jekyllrb.com/).

[صفحات GitHub](https://pages.github.com/) هي خدمة استضافة الصفحات الثابتة للمشاريع والمدونات. تعتمد هذه الخدمة على موّلد الصفحات الثابتة [Jekyll](https://jekyllrb.com/) والذي يحول ملفات [ماركداون](https://ar.wikipedia.org/wiki/%D9%85%D8%A7%D8%B1%D9%83%D8%AF%D8%A7%D9%88%D9%86_(%D9%84%D8%BA%D8%A9_%D8%AD%D8%A7%D8%B3%D9%88%D8%A8)) مع ترميزها وهيكلتها إلى مدونة بسيطة وأنيقة.

من ميزات Jekyll Now:

- تصميم أنيق ومناسب للهواتف المحمولة
- لا يحتاج لسطر الأوامر
- لا يحتاج لتنصيب وإعداد [روبي](https://ar.wikipedia.org/wiki/%D8%B1%D9%88%D8%A8%D9%8A_(%D9%84%D8%BA%D8%A9_%D8%A8%D8%B1%D9%85%D8%AC%D8%A9))
- لا يتحتاج لتحميل المكتبات التي يعتمد عليها Jekyll مثل محوّل ماركداون وملوّن الأكواد
- سهل تجريبه فيمكنك حذف المدونة في أي وقت تشاء أن لم تعجبك


![شكل Jekyll Now]({{ site.baseurl }}/images/jekyll-now-theme-screenshot.png "صورة لشكل المدونة")

## كيف تبدأ

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

استعمل زر Fork على [مصدر المدونة](https://github.com/a3ammar/arabic-jekyll) لنسخها إلى حسابك، ثم عدل على اسم المشروع في إعدادات النسخة ليكون `<username>.github.com` مع تبديل `<username>` إلى اسم حسابك. ستصبح مدونك جاهزة فورًا على الرابط <http://username.github.io>.

![الخطوة الأولى]({{ site.baseurl }}/images/step1.gif "الخطوة الأولى")

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

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

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

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

حان وقت كتابة أول تدونة على المدونة، حرر الملف `_posts/2017-1-3-Hello-World.md` وابدأ بسرد أفكارك. استخدم [دليل الماركداون]({{ site.baseurl }}/markdown) إذا احتجت مساعدة.



![كيفية التحرير]({{ site.baseurl }}/images/edit.gif "كيفية التحرير")

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

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

بحيث:

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

#### طرق تحرير المدونة:
1. حرر الملف مباشرة على GitHub بالذهاب إلى الملف على نسخة المدونة الخاصة بك (كالمعروض في الأعلى)، أو
2. أستخدم أحد المحرارات السحابية المخصصة للعمل مع GitHub، مثل [Prose](http://prose.io) والتي تساعدك على التعامل مع المسودات والصور، أو
3. وهي الطريقة الأكثر مرونة، حمل نسخة المدونة الخاصة بك على جهازك وحررها ببرنامج متخصص في تحرير الماركداون مثل [كاتب](http://katibapp.com/). تحتاج هذه الطريقة بعض من العلم بكيفية عمل [Git](https://git-scm.com/). (لتسهيل التعامل مع Git استخدام [برنامج GitHub المكتبي](https://desktop.github.com/))

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

1. حمل Jekyll وكل المكتبات اللازمة لصفحات GitHub بإستخدام الأمر (برنامج `gem` هو مدير المكتبات في لغة روبي)

```
gem install github-pages
```

2. حمل مصدر نسختك الشخصية للمدونة بإستخدام الأمر

```
git clone https://github.com/<username>/<username>.github.io.git
```

3. إذهب للملف الذي حملته ومن ثم استخدم الأمر لتشغيل خادم Jekyll

```
jekyll serve
```

4. افتح الرابط <http://127.0.0.1:4000> بالمتصفح لعرض المدونة
5. بعد التعديل استخدم Git لحفظ التعديلات ثم رفعها إلى GitHub لنشرها على المدونة

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

[تواصل معي](https://github.com/a3ammar/arabic-jekyll/issues/new)، سأسعد بمساعدتك.

## شكر ونسب

- [Jekyll Now](http://www.jekyllnow.com/) صاحب التصميم الأصلي
- خط [Noto](https://www.google.com/get/noto/) من قوقل
- خط [كوكب مونو](http://makkuk.com/kawkab-mono/) من [عبدالله عارف](https://twitter.com/abdullaharif)
- [Jekyll](https://github.com/jekyll/jekyll) مولد الصفحات
- [SVG icons](https://github.com/neilorangepeel/Free-Social-Icons) مصمم ايقونات الشبكات الإجتماعية
- [Solarized Light Pygments](https://gist.github.com/edwardhotchkiss/2005058) الألوان المستخدمة في ملوّن الكود
- [Joel Glovier](http://joelglovier.com/writing/) ساعد صاحب المصدر الأصلي على هيكلة الـRSS
- [David Furnes](https://github.com/dfurnes), [Jon Uy](https://github.com/jonuy), [Luke Patton](https://github.com/lkpttn) مساعدة ومراجعة للتصميم الأصلي
- [Bart Kiers](https://github.com/bkiers), [Florian Simon](https://github.com/vermluh), [Henry Stanley](https://github.com/henryaj), [Hun Jae Lee](https://github.com/hunjaelee), [Javier Cejudo](https://github.com/javiercejudo), [Peter Etelej](https://github.com/etelej), [Ben Abbott](https://github.com/jaminscript), [Ray Nicholus](https://github.com/rnicholus), [Erin Grand](https://github.com/eringrand), [Léo Colombaro](https://github.com/LeoColomb), [Dean Attali](https://github.com/daattali), [Clayton Errington](https://github.com/cjerrington), [Colton Fitzgerald](https://github.com/coltonfitzgerald), [Trace Mayer](https://github.com/sunnankar) شكرا على [المساعدة](https://github.com/barryclark/jekyll-now/commits/master)