Github Pages Üzerine Hexo Kurulumu

Github Pages ile your-github-username.github.io üzerinde kendi statik sayfamızı yayınlayabiliyoruz. Çeşitli geliştiriciler bu sistem üzerinde blog inşası için çeşitli static site generator araçları yayınlıyor. İçlerinde gördüğüm kadarıyla Hexo çeşitli tema ve eklenti desteğiyle öne çıkıyor.

1. Gereksinimler

• Node.js ve npm

  Hexo, node.js üzerinde çalıştığından npm kurulumu gerekmektedir.

  • Windows
    x86 ya da x64 kurulum dosyaları

  • Linux
    Altta dnf yerine kullandığınız dağıtımın paket yöneticisini yazın (apt-get gibi)
    

    sudo dnf install nodejs npm

  • MacOS
    

    brew update
    brew install node

• Git

  Yazı yazdıktan sonra github-pages’e deploy etmek için git kullanılacaktır.

  • Windows
    x86 ya da x64 kurulum dosyaları

  • Linux
    Altta dnf yerine kullandığınız dağıtımın paket yöneticisini yazın (apt-get gibi)
    

    sudo dnf install git

  • MacOS
    

    brew update
    brew install git

2. Hexo kurulumu

Yukarıdaki gereksinimleri sağladıktan sonra terminal penceresi açıp

npm install hexo-cli -g
npm install hexo-deployer-git --save

yazarak npm üzerinden Hexo kurulumunu gerçekleştirin. Linux sistemlerde komutun başına sudo koymak gerekebilir.
Kurulum gerçekleştikten sonra blog/site dosyalarını saklayacağınız bir klasör oluşturup o klasör içerisinde terminal penceresi açarak

hexo init your-github-username.github.io
npm install

yazarak bulunduğunuz klasör içinde your-github-username.github.io klasörünün oluştuğunu ve içerisine Hexo dosyalarının kopyalandığını göreceksiniz.
your-github-username.github.io klasöründeki _config.yml dosyasını açarak title, url, author gibi değişkenleri kendinize göre ayarladıktan sonra deploy: kısmını alttaki gibi ayarlayın (your-github-username kısmını kendinizin username ile değiştirmeniz gerektiğini söylememe gerek yok)

_config.yml

deploy:
  type: git
  repo: https://github.com/your-github-username/your-github-username.github.io
  branch: master

2.1. Github Git bağlantısı

Yazıyı github-pages’e deploy edebilmek için Git clienti github için ayarlayıp ssh key alacağız.
Öncelikle terminal açıp (windows’da git bash)

git config --global user.name "your-github-username"
git config --global user.email "your_email@example.com"

komutlarını uyguladıktan sonra ssh key oluşturmak için

ssh-keygen -t rsa -C "your_email@example.com"

komutunu yazınca > Enter a file in which to save the key (/home/you/.ssh/id_rsa): [Press enter] sorusuyla public ssh key dosyasını kaydetme yeri sorulacaktır, Enter basarak default konumu kullanacağız.
Sonra passphrase oluşturmamızı isteyecektir passphrase yazıp devam ediyoruz.
Daha sonra terminale

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_rsa

yazarak SSH keyini ssh-agent’e ekliyoruz.
Son olarak ~/.ssh/id_rsa/id_rsa.pub dosyasını bir metin editörü ile açıp içeriğini kopyalıyoruz ve bu adresteki SSH keys → New SSH key butonuna tıklayıp açılan sayfadaki alana yapıştırıp Add SSH key butonuna tıklayıp oluşturduğumuz SSH keyini github’a eklemiş oluyoruz.

3. İlk yazıyı yazmaya başlıyoruz

your-github-username.github.io klasöründe terminal penceresi açıp

hexo new 'Ilk Yazi'

yazarak source/_posts klasöründe Ilk-Yazi.md adlı markdown dosyasını oluşturup dosyayı bir metin editörü ile düzenleyip kaydettikten sonra terminal penceresinde

hexo generate
hexo deploy

komutlarını kullanarak statik site dosyalarının oluşturulmasını ve your-github-username.github.io reponuza gönderilmesini sağlayın. Kısa bir süre sonra github-pages sayfanızda görünecektir.

Bir sonraki yazıda VSCode ile kullandığım markdown ve LaTeX eklentileri, Hexo’ya eklediğim bazı eklentileri ve Hexo ile kullanılan bazı kullanışlı tag’leri yazacağım.