jekyll and github logo

در قسمت دوم آموزش نصب jekyll، نحوه اتصال این برنامه به یک صفحه github و طریقه پیکربندی اون رو توضیح خواهم داد. در اینجا نکته ای که بسیار اهمیت داره نحوه پیکربندی برنامه تو ویندوز هست. چون اجرای jekyll روی ویندوز با تنظیمات پیش فرض github به دلیل ناسازگاری افزونه هایی مثل pygments پیغام خطا میده.

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

ایجاد حساب github

بعد از ثبت نام در وبسایت github، در منو بالا New Repository رو انتخاب کرده و یک مخزن ایجاد کنید. در قسمت نام مخزن، عبارت username.github.io رو وارد کنید (بجای username نام کاربری خودتون رو بنویسید). ما بقی تنظیمات را در حالت پیش فرض قرار دهید.

سپس با استفاده از نرم افزار github در ویندوز از مخزن خود clone بگیرید و اونو تو یک فولدر بریزید (آموزش).

خب حالا نوبت به jekyll میرسه. در اینجا باید یک وبسایت جدید با jekyll تو همون مسیر ایجاد کنید. به طور مثال اگه مسیر مخزن شما C:\username.github.io باشه کد زیر رو وارد می کنید.

jekyll new C:\username.github.io

تنظیمات مربوط به وبسایتتون که شامل نام و توضیحات و … میشه رو تو فایل _config.yml وارد کنید. بعد از تغییر دادن محتویات این فایل اون رو تو همین مسیر با نام جدید مثلا win_config.yml کپی کنید. تو فایل جدید کد زیر رو به انتهای فایل اضافه کنید.

highlight: rouge

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

اگر دقت کنید یک فایل با نام .gitignore توی مسیر اصلی مخزنتون وجود داره. اونرو باز کنید و اسم فایل دوم رو بهش اضافه کنید. این فایل مشخص می کنه که چه فولدرها و فایلهایی از کامپیوترتون به سرور آپلود نشه. احتمالا فولدر _site قبلا به این فایل اضافه شده.

بعد از اینکه تموم این تنظیمات رو انجام دادید می تونید با jekyll وبسایت خودتون رو بسازید و اونرو بعد از هر بار commit کردن تو آدرس username.github.io ببینید.

    نکات مهم

  • تنظیمات زیر در github بعد از هر بار اجرا بازنویسی می شن و شما نمی تونین این تنظیمات رو به هیچ شکلی عوض کنید:
    highlighter: pygments
    safe: true
    lsi: false
    github: [Repository metadata]
  • تنظیم source رو به هیچ وجه دستکاری نکنید.
  • چون jekyll در github به صورت safe بالا میاد پس هیچ افزونه اضافی رو برای jekyll نمی تونید اضافه کنید.
  • لیست تنظیمات jekyll در این صفحه موجود است.

در پست بعد اتصال دامنه به github رو آموزش خواهم داد. لطفا نظرات و سوالاتتون رو در مورد این پست در قسمت نظرات عنوان کنید.

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