Github Pages ve Jekyll Kurulumu

07 Jul 2017

Reading time ~2 minutes

Github Pages Nedir?

Github, kullanıcılarına Github Depoları(Repositories) üzerinden yönetilebilen hosting sağlamaktadır.En önemlisi de bunu ücretsiz sağlamaktadır.Eğer kendi blog sitenizi kurmak istiyorsanız ve hosting için para vermek istemiyorsanız github pages’i kullanabilirsiniz.

Github Pages Kurulumu

Github pages kurulumu için ilk olarak repository oluşturun ve kullanıcıisminiz.github.io olarak ayarlayın.

Daha sonra deneme yapmak için index.html dosyasını ekleyelim ve içini aşağıdaki şekilde dolduralım.

Buradan sonra da aşağıdan commit new file butonuna tıklayarak dosyamızı oluşturmuş olduk. Şimdi de tarayıcınızın url bölümüne kullanıcıisminiz.github.io yazarak sitenizi test edebilirsiniz.

Gördüğünüz gibi sitemiz aktif hale gelmiştir.Şimdi de jekyll kurulumunu geçelim.

Tema Kullanımı

HTML, CSS, JavaScript ile uğraşmak istemeyip hazır tema kullanmak isterseniz.

Hazır temalar linkine tıklayınız.

Buradan istediğiniz bir temayı seçip indiriniz.Daha sonra da kullanıcıisminiz.github.io adlı repository’nize yüklemelisiniz. Yüklediğiniz dosyaların içinde config.yml adında bir dosya olacaktır.Onun içini kendinize göre değiştirmelisiniz.Tüm bu ayarlamaları yaptıysanız siteniz hazır durumdadır.

Jekyll Nedir?

Jekyll ruby ile yazılmış basit ve güçlü bir altyapıya sahip olan statik bir site oluşturucudur.Markdown formatında yazdığımız sayfayı statik HTML sayfasına dönüştürür.Jekyll Github Pages tarafından desteklenen bir mekanizmadır.

Jekyll Kurulumu

Jekyll Ruby ile yazılmış olduğu için ilk olarak Ruby kurulmalıdır.Aşağıda işletim sistemlerine göre kurulumu anlatacağım.

Windows İçin

Eğer Windows kullanıyorsanız aşağıdaki linkten Ruby'i kurmalısınız.
Ruby link: Ruby
Jekyll'ın düzgün bir şekilde çalışabilmesi için yukarıdaki linkten Development Kit'i indirmelisiniz.
Development Kit'i indirip çalıştırdıktan sonra dosyaları bir yere çıkartmanızı isteyecektir.
Benim önerim C:\\DevKit buraya kurmanızdır.Bunun sebebi ise Komut İstemi(Namıdeğer cmd) de çalışırken zorlanmamamız.
Dosyalarımızı çıkardıktan sonra cmd yi açalım ve aşağıdakini yazalım.

cd C:\\DevKit

Bu dizine girdikten sonra;

ruby dk.rb init

komutunu yazalım.Daha sonra aşağıdaki komutu yazalım;

ruby dk.rb install

komutunu yazdıktan sonra Ruby'nin kurulumu tamamlandı.Kurulumun başarılı olup olmadığını anlamak için cmd yi açarak aşağıdaki komutları yazalım.

ruby -v
gem -v

Versiyon numaraları çıkarsa kurulum başarılıdır.
Ruby ve RubyGem kurulumu tamamlandıktan sonra şimdi sıra Jekyll kurulumuna geldi.Jekyll kurulumunu yapmak için cmd yi açarak aşağıdaki komutu yazmamız gerekli;

gem install jekyll

Ve Jekyll kurulumunu tamamladık.