Hazel Kavili

Accio data!

github twitter linkedin email rss
Blogdown Paketini Kullanarak Kendi Blogunuzu Hazırlamak
Nov 5, 2017
4 minutes read

Bu yazıyı, Alison Presmanes Hills’ın Up and Running with Blogdown yazısını okuyup, R + Blogdown + Hugo ile kendi sitemi yaptıktan sonra, Türkçe kaynak arayan arkadaşlar için hazırladım. Az sonra yazacağım adımları takip etmek ve verilen kaynakları okumak faydalı olacaktır.

Kendi işlerim için kullandığım araçlar MacOS, R Studio ve Github olduğu için sizlere bunlar hakkında deneyimlerimi aktaracağım ancak Windows ya da Linux dağılımları kullanan arkadaşlar gerekli aramaları yaparak kendi sistemleri hakkında ayrıntılı bilgilere ulaşabilirler.

1 - Github

Birçoğumuz versiyon kontrol aracı olan Git’ten haberdarız ancak kullanmasının ve komutlarına aşinalık kazanmanın zaman aldığını da biliyoruz. R Studio’nun Preview versiyonuyla birlikte artık R Studio IDE’sinden de Terminal ekranınızda yaptığınız birçok git işlemini gerçekleştirebiliyorsunuz. Blogunuzu yazmaya başlamadan önce aşağıdaki bazı kaynakları okumanızın ve uygulama yapmanızın faydalı olacağına inanıyorum:

Github.com’dan bir üyelik edindikten sonra R Studio’da Tools --> Global Options menüsüne gelip Github/SVN tabını seçip View Public Key’e tıklayın. Ardından gelen SSH key’i kopyalayın ve Github sayfanızdaki Settings --> SSH & GPG seçeneğine gelip New SSH Key tıklayıp, az önce kopyaladığınız Key’i yapıştırın.

*(SSH Key’ler ile ilgili bu Türkçe kaynağa bakabilirsiniz: SSH açık-anahtar doğrulaması (SSH public key authentication))

Şimdi Github’da yeni bir repo oluşturun (Create new repository):

yeni repo oluştur yeni repo oluştur2

Ardından bu oluşturduğunuz repoyu, Terminal ekranınızdan, bilgisayarınızdaki çalışma alanınıza (working directory) klonlayabilirsiniz (clone).

cd ~Desktop/
git clone "https://github.com/kullaniciadi/myownblog.git"

Bu repoyu klonladıktan sonra klasörün içindeki READ.me dosyasını silmelisiniz. Hugo temalarını ve blogdown’u indirdikten sonra bazı hatalar almamanız için yapmanız gereken bir işlem gibi görünüyor, en azından MacOS kullanıcıları için gözlemlediğim durum bu.

2 - R Studio

R Studio konsolundan blogdown paketini yükleyelim:

if (!requireNamespace("devtools")) install.packages("devtools")
devtools::install_github("rstudio/blogdown")

Ardından bize blogumuz için temalar bulmamızı sağlayan Hugo paketini yükleyelim:

blogdown::install_hugo()
# veya 
library(blogdown)
install_hugo()

Şimdi R Studio’da File --> New Project diyelim, projemize bir isim verelim ve bulunduğumuz alanda bir proje oluşturalım.

yeni proje

yeni proje

3 - Hugo temaları

Kendi sitenizin tasarımını sıfırdan yapmak yerine bazı hazır temalar arasından birini seçmek isterseniz, 90’dan fazla seçeneğiyle Hugo harika bir koleksiyon. Dikkat etmeniz gereken şey, bu temaları blogdown ile kullanıp kullanamayacağınız. Şu an okuduğunuz blogu Cocoa temasını kullanarak hazırladım.

3.1 - Temayı seçtikten sonra

Birkaç komut ile sitenizi kendi bilgisayarınızda çalıştırmaya başlayabiliriz. new_site() fonksiyonunu çalıştırdığınızda, default tema olarak Lithium geliyor.

blogdown::new_site() # default tema lithium olarak geliyor

Eğer kendiniz seçtiğiniz tema ile devam etmek isterseniz, ilk önce onun bazı konfigürasyon dosyalarını indirmeniz gerekecek. Bunun için de seçtiğiniz Hugo temasının dosyalarının olduğu Github linkinden (kullanıcı_adı/tema_reposu) kopyalayıp, new_site fonksiyonun theme argümanına atamanız gerekmektedir.

blogdown::new_site(theme = 'nishanths/cocoa-hugo-theme', theme_example = TRUE)

Temanızı daha sonra yüklemek isterseniz de aşağıdaki adımları izleyebilirsiniz.

library(blogdown)
new_site() # default tema lithium
install_theme("nishanths/cocoa-hugo-theme", theme_example = TRUE, update_config = TRUE)

Blogdown’u yüklediğiniz zaman R Studio’daki Addins tabında Serve Site ile blogunuzun çalıştırabilirsiniz.

addins

addins

3.2 - Konfigürasyon dosyalarını değiştirme

Buradan sonra biraz daha özelleştirilmiş ayarlara girmek isterseniz öncelikle indirdiğiniz temanın config.toml dosyasını bir gözden geçirin. Bu dosyadaki bilgiler sitenizin genel görünüşü, ikonlar, dil, Google Analytics takip ID’si gibi ayarları yapabileceğiniz bir yer.

yenimenu yeniparam

Ayrıca mutlaka indirdiğiniz temayla birlikte gelen dosyaları iyice karıştırın. Örneğin sayfanızda göstereceğiniz resimleri nerede tutacağınızı, yazdığınız yazının hangi kategori altında hangi klasörde olduğunu mutlaka araştırın. Bu yüzden

3.3 - Yeni blog yazısı hazırlama

Şimdiye kadar eğer indirdiğiniz temanın klasörlerini kontrol ettiyseniz, content klasörünü fark etmişsinizdir. Örneğin benim seçtiğim temada content klasörünün içinde blog, code, post, about adlı başka klasörler var. Bunlar yayınlayacağınız yeni blog postunuzun bulunmasını isteyeceğiniz yerler.

  • R Studio’da yeni bir içerik (yazı) ekleyeceğiniz zaman, yine Addins’e gelip New Post seçin, başlık ve seçmek istediğiniz etiketleri doldurun, ardından R Studio sizin için şu ekranı hazır edecek:
yeniyazı

yeniyazı

.Rmd dosyaları, R Markdown dosyalarıdır. Markdown ise çok basit bir yazı biçimlendirme dilidir. Dilerseniz .md dosyları da kullanabilirsiniz. R Markdown özellikleri için link, Markdown özellikleri için link. Bu özellikleri kullanarak yazılarınıza kod parçaları, kod çıktıları, resimler ekleyebilirsiniz.

Şimdi tekrar Serve Site addinine tıkladığınız zaman sayfanızda istediğiniz yere yazınızın gelmiş olacağınız göreceksiniz.

4 - Netlify’de deploy yapmak

Sayfanızı belli bir url ile çağırmak isterseniz Github üzerinden Netlify kullanarak bunu kolayca yapabilirsiniz.Eğer bir domain adınız yoksa Netlify size rastgele bir domain adı atayacak ki, bu bazen çok hoş olmayabiliyor. Bunu update etmek için de config.toml dosyanızdaki base_urli kendi domain adınızla değiştirmeniz gerekiyor. Domain almak için de çeşitli siteler var, ben Hover.com adresinden aldım.

Deployment işlemine geçmeden önce tüm değişiklerinizi, yazılarınızı, resimlerinizi github’daki reponuza gönderdiğinize emin olun. Aşağıdaki komutları sıralayla R Studio’nun Terminal’inden gerçekleştirebilirsiniz:

pwd # print working directory, çalışma alanınızı kontrol edin
git status #durumunu kontrol edin, bir şeyler değişmiş mi bir bakın
git add . #değişiklik olan tüm dosyaları havuza toplayın. nokta(.) tüm dosyaları ekler
git commit -m "yeni yazı ekledim"  #bir commit mesajı yazın, ne yaptığınızı
git push origin master # değişikliklerinizi github'daki dosyalarınıza bildirin
git status #son bir kontrol yapın

i- Değişiklikleriniz iletildiyse, github hesabınız ile Netlify kayıt olun. Yeni bir kayıt yaptırmanıza gerek yok.

ii- Giriş yapın ve New site from Git -> Continuous Deployment: GitHub adımlarını takip edin.

iii- Github hesabınızla kayıt olduğunuz için blogunuzu yazdığınız repoyu seçebilirsiniz.

iv- Hugo versiyonunuzu da terminalde hugo version diyerek kontrol ettikten sonra aşağıdaki ekrandan deploy edebilirsiniz:

deployment

deployment


Back to posts


comments powered by Disqus