../arch-linux-ruby-jekyll-kurulumu

Arch Linux - Ruby ve Jekyll Kurulumu


You are reading an article that is more than a year old. The content might be outdated.


Table of contents


## 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

Contribute to this post