Bu yazımda Octopress alt yapısını kullanarak blog yapımının aşamalarını anlatacağım. Octopress, Rails tabanlı bir blog yazılımıdır. İşletim sistemi olarak Mint kullandığım için Linux'ta kurulumunu anlatacağım. Kurulum esnasında aldığım hataların çözümünü en altta anlattım benzer hatalar almanız durumunda yardımcı olacağını düşünüyorum :)

Öncelikle sistemimizde kurulu olması gerekenler ;

  • Github hesabı ve github reposu (kullanıcıAdınız.github.io isimli oluşturulmuş bir depo)
  • Git
  • RVM ile Ruby (Ruby versiyonu 1.9.3'ten büyük olmalı)

Kurulum

İlk adımda terminalde projeyi konumlandırmak istediğimiz klasörü açıyoruz. Octopress deposunu github'tan klonlayalım ve dosyanın içine girelim :

1
2

$git clone git://github.com/imathis/octopress.git octopress
$cd octopress

Gerekli gem kurulumlarımızı gerçekleştirelim :

1
2
3

   $gem install bundler
   $bundle install
   $rake install

Farklı tema kullanmak isteyenler için önerim:

Octopress Temaları linkinden beğendiğiniz bir temayı seçebilirsiniz. rake install komutu ile default tema yüklendiği için bu komutu direkt çalıştırmayın, temaya uygun komutu seçtiğiniz temanın github reposundan gerekli adımları takip ederek çalıştırmanızı öneririm.

Config Dosyası Ayarları

Kurulumu tamamladığımıza göre _config.yml dosyasını açalım ve içerisinde bulunan kişiselleştirme ayarlarını yapalım. Aşağıda yazdığım bilgileri kişisel olarak dolduralım. Ek olarak gün-ay-yıl formatını date_format kısmında değiştirelim:

1
2
3
4
5
6
7
8
9
10

...
url: http://githubKullanıcıAdınız.github.io
title: Bloğun Başlığı
subtitle: Bloğun Alt Başlığı
author: Adınız Soyadınız
simple_search: https://www.google.com/search
description: Açıklama (isteğe bağlı)
..
date_format: "%B %e %A, %Y"
...

Aynı dosyada bloğunuza bağlayıp görüntüleyebileceğiniz sosyal medya hesap ayarlarınız bulunuyor(Github, Twitter, Google+ vs). Ben sadece github hesabımı bağladım. Sırasıyla kullanıcı adı, tüm repoların görünmesi için 0, profil linki ve forkların görünmesi için true şeklinde ayarlayalım.

1
2
3
4
5
6
7

...
# Github repositories
github_user: githubKullaniciAdiniz
github_repo_count: 0
github_show_profile_link: true
github_skip_forks: true
...

Bloğumuzu kişiselleştirmeyi tamamladık!

Blog Yazısı Oluşturma

Yazımızı aşağıdaki komutla oluşturalım:

1

$rake new_post["İlk Yazımın Başlığı"]

octopress/source/_posts dizinine geldiğimizde oluşturduğumuz yazıyı ‘tarih-yazimizin-ismi.markdown’ ismiyle bulalım ve dosyayı açalım. Burada layout, title, date, comments hazır geliyor. Yazımızın kategorisini, categories kısmından ekleyelim:

1
2
3
4
5
6
7
8
9
10
11

---
layout: post
title: "İlk Yazımın Başlığı"
date: 2019-01-24 01:11:08 +0300
comments: true
categories:[kategori1,kategori2,kategori3]
---
YAZIMIZI YAZMAYA BURADAN BAŞLIYORUZ !
MERHABA BLOĞUM :)
...
..

NOT: Yazımızı markdown formatıyla yazacağımızı unutmayalım! Bunun için online editörleri kullanabilirsiniz.

Github Deposuna Bağlama

Öncelikle github'da kullanıcıadınız.github.io ismiyle bir repository oluşturalım. Bilgisayarımızdaki dosyaları oluşturduğumuz depoya bağlayalım:

1

$rake setup_github_pages[repository urli]

Şimdi ise bilgisayarımızdaki dosyaları depomuza atalım:

1
2

$rake generate
$rake deploy

Bu iki komutu her yeni yazı oluşturduğumuzda ve depomuza göndereceğimizde kullanacağız. Depoya göndermeden önce localde görüntülemek isterseniz aşağıdaki komut ile http://localhost:4000/ adresinden ulaşabilirsiniz:

1

$rake preview

Alınabilecek Hatalar ve Çözümleri

Bloğumu linkteki tema ile yapmak istedim. İlk olarak temayı klonladım. Aldığım ilk hata Bundler hatası oldu. Temanın gereksinimi olarak Bundler 2.0 ve üzerini istiyor. Sistemde default olarak 1.7 geldiği için güncellemeniz gerekiyor.

Bundler Hatası :

1

$rake install['abacus']

Yukarıdaki komutu çalıştırdım ve şu hatayı aldım:

You must use Bundler 2 or greater with this lockfile.

Çözüm olarak sistemdeki Bundler gemini aşağıdaki gibi güncelleyebilirsiniz:

1
2
3

$gem update --system
$gem install bundler
$bundle update --bundler

Bu komutları çalıştırdıktan sonra bundler –version ile kontrol ettiğinizde Bundler version 2.0.1 dönüşünü aldıysanız sorun çözülmüş demektir.

Gem::LoadError Hatası

Bu hata aşağıda yazdığım gibi uzayıp giden devamında bundler dosya yolları olan bir hatadır. Böyle bir hata aldıysanız Gemfile'dakiyle sisteminizdeki rake gem'inin versiyonlarının uymamamasından kaynaklanır. Yukarıdak kullandığımız rake install komutlarını bundle exec rake install şeklinde çalıştırılınca sorun çözülecektir.

rake aborted! Gem::LoadError: You have already activated rake 12.3.2, but your Gemfile requires rake 10.5.0. Prepending bundle exec to your command may solve this. ….

Octopress ile bloğumuzu oluşturduk, işinize yaramış olması dileğiyle :)