jekyll logo

همونطور که تو پست قبلی قولش رو داده بودم اینجا قصد دارم یه توضیح و آموزشی در مورد jekyll داشته باشم.امیدوارم که از این برنامه و آموزش اون در اینجا خوشتون بیاد. یکی از مشکلاتی که jekyll داره و شاید اکثر برنامه های این شکلی دارن اینه که تو ویندوز به درستی کار نمی کنن. در واقع این برنامه ها برای سیستم عامل لینوکس ساخته میشن. اما همیشه راه ها یا هک هایی وجود داره که میشه این مشکلات رو رفع کرد.

یکی از این هک ها تو وبسایت jekyll-windows.juthilo.com معرفی شده که من خودم از این روش استفاده می کنم ولی باز هم مشکلاتی داشت که در اینجا روشهای حل اون رو توضیح میدم. در کل اگه با jekyll آشنایی ندارین می تونین پست «چرا تصمیم گرفتم از Jekyll استفاده کنم» رو که امیرعباس زحمتش رو کشیده مطالعه کنید. من خودم از طریق همین پست با jekyll آشنا شدم.

مزیت مهمی که jekyll داره اینه که می تونین از هاست github به صورت رایگان برای وبسایت یا وبلاگتون استفاده کنین و تنها با خرید یک دامنه یک وبسایت کامل راه اندازی کنین. این آموزش به سه دسته تقسیم میشه:

نصب jekyll

همونطور که تو وبسایت jekyll-windows.juthilo.com توضیح داده شده اول از همه نیازه که Ruby رو نصب کنیم. با مراجعه به صفحه دانلود ruby نسخه مناسب با کامپیوترمون رو دانلود می کنیم و اونرو نصب می کنیم. توجه کنید که تو مراحل نصب حتما گزینه Add ruby executables to your PATH رو مثل شکل زیر تیک زده باشید. این گزینه باعث میشه از هرجایی به دستورات ruby دسترسی داشته باشیم. البته اگه این گزینه رو تیک نزده باشید می تونین این کار رو دستی انجام بدید.(جستجو کنید)

Ruby Installation

بعد از نصب Ruby نوبت به نصب Ruby DevKit میرسه که از همون آدرس قبلی قابل دسترسی هست. برای نصب ابتدا محتویات فایل zip رو درون یک پوشه (ترجیحا در root یکی از درایورها) که اسمش بدون فاصله و حروف خاص باشه قرار می دیم. بطور مثال C:\RubyDevKit مکان مناسبی برای نصب Ruby DevKit است. پس از قرار دادن فایلها نوبت به اجرای اونها میرسه. کدهای زیر رو برای نصب DevKit توی command prompt ویندوز وارد می کنیم. دقت کنید که باید توی مسیر همین پوشه ایجاد شده باشیم تا بتونیم محتویاتش رو نصب کنیم.

C:\RubyDevKit> chcp 1252
C:\RubyDevKit> ruby dk.rb init
C:\RubyDevKit> ruby dk.rb install

بعد از اینکه نصب ruby و ruby DevKit تموم شد نوبت به نصب jekyll میرسه. برای نصب jekyll کدهای زیر رو توی command prompt ویندوز وارد کنید.

gem install jekyll

یکی از مشکلات یا ناسازگاری های jekyll با ویندوز عدم هماهنگی افزونه highlight اون هست که برای حل اون جایگزینی وجود داره. افزونه پیش فرض jekyll برای highlight کردن کدهای درون صفحات، افزونه pygments هست که توی ویندوز اجرا نمیشه و هر دفعه که شما کد رو اجرا کنید پیام خطا میده. برای رفع مشکل highlight از افزونه rouge که با ویندوز سازگاری داره استفاده می کنیم. برای نصب این افزونه کد زیر رو توی command prompt ویندوز وارد کنید.

gem install rouge

در نهایت هم برای اضافه کردن قابلیت watch (مشاهده تغییرات در آن واحد) به jekyll کد زیر رو وارد می کنیم تا افزونه مورد نظر نصب بشه.

gem install wdm

حالا برنامه ما به طور کامل نصب شده و ما می تونیم ازش استفاده کنیم. بطور مثال کدهای زیر یک وبسایت demo در شاخه D:\ میسازه و بعد اون رو برای مشاهده روی آدرس http://localhost:4000 قابل دسترس می کنه.

jekyll new demo
cd demo
jekyll serve -w

اگر در مرحله سوم با اجرای کد jekyll serve -w با مشکل برخوردید باید تنظیمات برنامه رو تغییر بدین. به مسیر D:\demo رفته و فایل _config.yml رو با notepad باز کنید. در این فایل تنظیمات وبسایت demo ذخیره شده. به آخر فایل خط زیر رو اضافه کنید که نشون میده ما میخوایم از rouge استفاده کنیم.

highlighter: rouge

jekyll تنظیمات بسیار زیادی داره که می تونید تموم اونها رو توی وبسایت رسمی jekyll مشاهده کنید. تو قسمت documentation این سایت تمام ساختار jekyll به سادگی توضیح داده شده که می تونید از اونها استفاده کنید.

در پست بعدی قصد دارم در مورد اتصال github و jekyll بنویسم. خوشحال میشم نظرتون رو در مورد این پست بدونم.

    نکات مهم

  • jekyll از زبان نشانه گذاری yaml برای پست ها استفاده می کنه. استفاده از این زبان خیلی خیلی ساده هست و شما فقط کافیه از مثال ها برای یادگیری اون استفاده کنید.
  • ساختار پوشه ها کاملا مشخصه ولی نکته ای که این وسط مهمه اینه که وبسایت کامل شده و ترجمه شده نهاییتون در پوشه _site ذخیره میشه.
  • زمانی که از کد jekyll serve -w استفاده می کنید. برنامه در حالت اجرا میمونه و به تغییراتتون توجه می کنه تا اون رو سریع ترجمه کنه و خروجی رو روی پورت 4000 بهتون نشون بده. تنها تغییراتی که به صورت آنی اعمال نمیشه، تغییراتی هست که روی فایل _config.yml انجام می دین. برای اعمال این تغییرات کافیه jekyll رو متوقف کنید و بعد دوباره اون رو اجرا کنید.

آموزش نصب jekyll بر روی ویندوز (قسمت دوم)

آموزش نصب jekyll بر روی ویندوز (قسمت سوم)