## Ruby Kurulumu
Ruby ile birlikte artık RubyGems de kuruluyor. O yüzden ayrıca bir RubyGems kurulumu yapmayacağız.
pacman -S ruby
## RubyGems Ayarlaması
RubyGems kurulu fakat gemlerin içerisindeki çalıştırılabilir dosyaları direk çalıştıramıyoruz. Tam yol belirtmemiz gerekiyor. Bu sorunu çözmek için PATH dizinine RubyGems yolunu ekleyeceğiz. ~/.bashrc dosyasına şu eklemeyi yapalım.
PATH="$(ruby -e 'print Gem.user_dir')/bin:$PATH"
Kurulu gemleri göstermek için
gem list
Bir gem ile ilgili bilgi almak için
gem spec gem_adi
Şu ana kadar yaptığımız komutların hepsi --local değeri ile çalışıyor. Yani bizim sistemimizdeki gemleri tarıyor/inceliyor. Eğer uzak sunucudaki gemleri incelemek istiyorsak --remote değeri eklememiz yeterli.
gem spec mysql --remote
MySQL gemi yüklü olmasada uzak sunucudan bilgisini getirecektir.
Gem yüklemek için
gem install mysql
Bu komutla beraber mysql gem yüklenecektir fakat dökümantasyonları da indirecek. Eğer production ortamında kurulum yapıyorsanız dökümantasyona ihtiyacınız olmayabilir. Dökümantasyon olmadan kurulum yapmak için --no-document yapmanız yeterli.
gem install mysql --no-document
Yüklü gemleri güncelleştirmek için
gem update
## Bundler Kurulumu
Bundler, Ruby’nin paket yönetim amaçlı oluşturulmuş bir gemidir.
gem install bundler
## Jekyll Kurulumu
Ruby ve RubyGems kurulumu yaptığımıza göre Jekyll kurulumu yapabiliriz.
Kurulumdan önce gemleri güncelleyelim.
gem update
jekyll gemi kuralım.
gem install jekyll
## Jekyll Başlangıç Projesi Oluşturma
jekyll gemi ile birlikte jekyll komutumuz geliyor. Örnek bir proje oluşturmak için şu komutu kullanmamız yeterli.
jekyll new proje_ismi
## Jekyll Projesini Çalıştırma
Oluşturduğumuz projenin dizinine ulaşarak şu komutla jekyll’i çalıştırabiliriz.
jekyll serve
http://127.0.0.1:4000 adresinden Jekyll projemizi inceleyebiliriz.
## Github Pages Gemlerini Yükleme
Jekyll projemizi Github Pages’e göre yapmamız için Github Pages’ın kullandığı gemleri kullanmamız gerekiyor. (Tabi ki localde oluşturup _site klasörünü yükleyebiliriz fakat saçma olmaz mı?)
Projenin ana dizininde Gemfile isminde bir dosya oluşturun ve içeriğini şu şekilde düzenleyin.
source 'https://rubygems.org'
gem 'github-pages'
bundle install komutu ile gerekli gemlerin yüklenmesini sağlayın.
## Ekstra: safe_yaml Psych sorunu
Eğer uninitialized constant Psych::Nodes (NameError) şeklinde bir hata alıyorsanız bunun sebebi Github-Pages’in belirli bir Psych versiyonu ile çalışmasından kaynaklanıyor. Eski bir psych versiyonunu kullanmanız gerekiyor.
Github Pages projenizi şu komut ile çalıştırırsanız bir sorun oluşmayacaktır.
gem cleanup
bundle exec jekyll serve