14 Rmarkdown Kullanımı

Yazar

Emrah Kırdök

Bu döküman kapsamında Rmarkdown kullanımı anlatılacaktır. İlk defa Rmarkdown kullanacaksanız öncelikle programı R içerisine kurmanız gerekecektir. Bu işlemi R otomatik olarak da yapailir. Eğer otomatik kurmadıysanız, aşağıkdai satırı komut satırına yazmanız gereklidir. Bu işlemi bir kere yapsanız yeter.

install.packages("rmarkdown")

Bu döküman kapsamında, Rmarkdown ile yazımın incelikleri gösterilecektir. Bu dosyanın ham haline aşağıdaki bağlantıdan ulaşarak kendi bilgisayarınıza indirebilirsiniz:

Bu sayfanın Rmarkdown hali

Bu iki dökümanı karşı karşıya inceleyerek, stil tiplerinin nasıl kullanıldığının farkına varınız.

14.1 YAML üst bilgisi

İlk olarak yaml olarak ifade edilen döküman üst bilgisini ekliyoruz:

---
title: "Rmarkdown Kullanımı"
author: "Emrah Kırdök"
date: "2023-03-23"
output: html_document
---

14.2 Paragraflar

Normal bir paragraf yazmak istiyorsanız, hiç bir işaret kullanmayınız.

15 Birinci seviye başlık

Birinci seviye başlık için # karakterini kullanınız.

15.1 İkinci seviye başlık

İkinci seviye başlık için ## karakterini kullanınız.

15.1.1 Üçüncü seviye başlık

Bu işaretin miktarı(#), başlık seviyesini belirtir.

15.2 Liste oluşturma

Eğer liste oluşturmak istiyorsanız + karakterini kullanmalısınız:

liste1
liste 2
- alt liste 1
- alt liste 2
liste 3

Bir liste ögesinin alt elemanlarını belirlemek istiyorsanız, tab tuşuna basarak bir satır girinti oluşturabilirsiniz.

15.3 Vurgular

Eğer italik yazmak isterseniz * tuşlarını kullanmalısınız. Kalın harflerle yazmak isterseniz iki tane ** kullanmalısınız.

15.4 Tablo oluşturma

Boru karakteri oluşturma: Sağ Alt Gr tuşu + < : |

bitki ismi	yaprak uzunluğu	koşul
bitki 1	2.4	aydinlik
bitki 2	3.4	karanlik
bitki 3	5	karanlik

Tabloları yukarıdaki gibi oluşturabilirsiniz.

15.5 Şekil ekleme

Şekil eklemek için aşağıdaki notasyonu kullanmalısınız:

Ancak dikkat edin, bu şeklin sizin bilgisayarınızda olması gerekir. İsterseniz internetten herhangi bir şeklin bağlantısını da vererek bu işi gerçekleştirebilirisniz.

15.6 Bağlantı eklemek

Örnek olarak üniversite adresinin bağlantısı.

15.7 R kodu eklemek

Rmarkdown’un en önemli özelliği, R kodunu kullanabilmeniz. R kodunu aşağıdaki şekilde yazınız.

bitki_ismi <- c("bitki 1", "bitki 2", "bitki 3")

bitki_ismi[2]

[1] "bitki 2"

R size bu kodu çalıştıracak ve çıktsını da dökümanınız içerisinde ekleyecektir.

İlerleyen derslerde grafikler oluşturarak bu özelliği kullanacağız.

15.8 Dosya isimlendirme

Derslerin başında da bahsettiğimiz gibi, dosya isimlerinde İngilizce karakter seti dışında karakter ve boşluk kullanmayın! Bu kısım çok önemli, çünkü windows ve mac kodlama sistemi farklılıkları yüzünden ödeviniz açamayabilirim ve eksik puanlandırılırsınız.

Ödevleriniz şu şekilde isimlendirmeniz tavsiye ederim:

odev_01_emrah_kirdok_571.Rmd

odev_01_emrah_kirdok_571.html

Dikkat ederseniz İngilizce karakter seti dışında karakter kullanmadım ve boşluk yerine alt çizgi “_” (Shift tuşu + tire (-)) kullandım. 571 ise öğrenci numaram olsun.

Eğer bu belgenin Rmarkdown versiyonunu inceliyorsanız, _ karakteri önünde \ işareti olduğunu göreceksiniz. Bu karakter kaçış karakteri (escape character) olarak isimlendirilir. Bu sayede Rmarkdown tarafından stil kodlarını normal metin olarak kullanabilirsiniz. Mesela # karakteri Rmakrdown için başlık olarak algılanıyor. Ancak siz bunu sadece normal bir karakter olarak kullanmak istiyorsanız \# yazabilirsiniz:

15.9 Soru şekilleri

Sorular karşınıza bir paragraf olarak gelecektir. Aynı zamanda her sonunun sonunda, o sorunun puanı da olacaktır.

15.10 Düz metin ile cevap verme

Soruların bazılarının cevabı normal metin olarak verilecektir. Bu durumda alıntı işareti kullanılarak cevabın verilmesi gereklidir. Mesela:

Eğer sorulara normal metin olarak cevap vermeniz isteniyorsa, “>” karakterini kullanarak alıntı formatında cevabınızı veriniz. Belgenizi html formatına çevirdiğinizde, tam olarak bu şekilde bir biçimlendirme görmeniz gereklidir.

Kullanmanız gereken karakter aşağıda:

15.11 Kodlama ile verilecek cevaplar

Ödevlerinizin çoğunluğunda kod yazarak cevap vereceksiniz. Bu durumda aşağıdaki R kodu satırlarına bu cevabınızı R kodu olarak yazmanız gereklidir.

# Kodunuzu buraya yaziniz

Burada dikkat edilmesi gereken noktalar:

# işareti ile başlayan satırlar R kodu olarak çalıştırılmaz. Bu kısımlar genelde okuyucuya bilgi vermek içindir
Kod bloklarında İngilizce karakter seti dışında karakter kullanmamaya özen gösterin.

Kod yazarken # işareti bir yorum belirtir. Yani # işaretini gördüğünüz yerlerdeki kodlar çalıştırılmaz, sadece insanlar için bilgi verimesi için yazılır.

Bu sayede yazdığınız programı okuyan bir araştırmacı, sadece yorum kısımlarına bakarak programınızda neler olduğunu anlayabilir.

15.12 Belgeyi derlemek

Cevaplarınızı düzgün bir şekilde verdikten sonra knit tuşuna basarak belgenizi html olarak derleyiniz ve bir sorun almadan düzgün bir çıktı aldığınızdan emin olunuz.