Menggunakan Quarto & Github
Pertemuan 11
Hari ini
Menggunakan quarto untuk menulis artikel.
Menggunakan github untuk hosting tulisan anda.
Quarto
Quarto adalah versi upgrade dari rscript.
Dengan file quarto (ekstensi .qmd), anda bisa menggabungkan kode R anda dengan tulisan, dan dirender menjadi html, pdf dan word sekaligus.
- setelah itu anda dapat edit wordnya.
Tapi kekuatan quarto yang sebenarnya (menurut saya) adalah render html-nya.
Download Quarto
Quarto dapat didownload di sini.
Atau google aja “download quarto”
Quarto dapat digunakan dengan VSCode, Jupyter, dan text editor lainnya. Di kuliah ini, kita pakai RStudio.
Download Quarto
Memulai Quarto
Quarto dapat dimulai dengan `file -> new file -> quarto document
Memulai Quarto
silakan pilih html, bisa juga pdf atau word. lainnya cuekin
Memulai Quarto
akan ada file di lokasi kita edit rscript tapi bukan rscript
Memulai Quarto
Quarto tidak dirun seperti rscript, tapi dirender.
Sekali render, quarto akan menghasilkan file html, pdf atau docx tergantung pilihan di “format”.
Note bahwa ekstensi Quarto adalah
.qmdbukan.rDiantara 3 dash (—) itu disebut metadata/options/header.
Jika anda mulai dengan cara ini, options-nya terbatas di title, author dan format.
Menggunakan format
Saya sudah menyiapkan format Quarto untuk anda gunakan.
Untuk ke depannya, mendingan pake format saya karena options-nya lebih lengkap.
Untuk belajar apa aja yang ditaruh di options-nya, bisa ke dokumentasi quarto atau google.
Cara pakai quarto
gunakan tanda pagar (#) untuk judul. Perbanyak pagar untuk level heading yang lebih kecil.
Selengkapnya dapat dibaca di markdown basic
“Markdown syntax” = apa yang kita ketik di file
.qmd“output” = hasilnya ketika dirender.
Gambar
Untuk memasang gambar, anda harus meletakkan file gambarnya di folder yang sama dengan file qmd-nya.
Misalnya di folder UAS ada file
index.qmddangambar1.jpgAnda bisa attach gambar di hasil render qmd-nya.
lengkapnya di figure basic
Gambar
Cara cepat untuk menaruh tabel atau diagram misalnya dapat dengan cara print screen atau pakai snip (tekan 🪟+
shift+S)Lalu dicrop hanya part yang ingin anda attach di tulisan anda.
save hasil cropnya dalam jpg atau png, lalu kopas ke folder anda.
tabel
Untuk tabel yang simpel, anda dapat gunakan markdown tabel seperti di sini
Untuk tabel yang lebih ribet, anda dapat menggunakan tabel editor di qmd. Tekan tombol
visual. lalu pilihinsertlalutableJika tabelnya ribet banget, buat saja di excel, lalu discreenshot dan gunakan gambar.
Insert table
insert tabel ribet
R Codes
R codes dapat langsung ditulis di qmd anda, dan akan dirun ketika anda render.
R codes harus diawali dengan 3 backticks (sebelah angka 1) dan {r}, diakhiri dengan tanda 3 backticks.
Hasilnya
Template
Untuk tugas akhir anda, ambil template qmd yang sudah saya siapkan di sini
download juga gambar logo APP dan data latihan.
Simpan semuanya di 1 folder, buka file
index.qmddengan R Studio. Pastikan anda sudah install Quarto.Pelajari baik-baik file qmd-nya, lalu klik panah kecil di sebelah ⇒Render.
Pilih Render HTML untuk render HTML, atau pilih Render MS Word untuk menjadikannya word.
Render
Render
Jika anda pilih Render HTML, di folder anda akan ada file baru yaitu
index.htmldan sebuah folder baru.Jika anda pilih Render MS Word, anda akan lihat file
index.docx.Tentu keunggulan render MS Word adalah anda bisa melanjutkan ngedit di aplikasi word.
Keunggulan HTML? tentu saja hosting di internet!
- word juga bisa dikopas ke wordpress sih, tapi kerenan github!
Github
Github aslinya adalah sebuah website untuk hosting code projects (disebut juga dengan repository.
Dia berfungsi sebagai version control dan melakukan kolaborasi terutama untuk project open source.
Singkatnya, semua programer pasti pernah pake github.
Namun github bisa menawarkan hosting mini untuk website anda.
Github
Buka github dan buat akun baru di sini
pilih username yang cukup profesional dan mudah diingat.
- username ini akan jadi bagian dari url website anda.
Kode verifikasi akan dikirim ke email anda.
kalau disuruh pilih paket, pilih yang free.
Welcome to github
Github
pilih skip personalization
Membuat website github
More on Quarto
Quarto jauh lebih sakti daripada sekedar buat 1 artikel.
Quarto dapat digunakan untuk membuat website dari 0 (dengan mayoritas ekstensi html), membuat presentasi (kuliah ini dibuat dengan Quarto), dan masih banyak lagi.
- membuat website dari 0 jauh lebih susah daripada wordpress atau blogpost, tapi jauh lebih customizable.
Jika anda tertarik, anda dapat belajar quarto dan RStudio sendiri lebih jauh.
Next 3 meetings
fokus ke cara menulis dan berbagai alternative methods.
mostly nggak pakai software lagi.
Karena anda udah bisa quarto, buat dulu aja templatenya. nanti diedit2 sambil kita belajar cara menulis.
next up: Kerangka, literature review, methods.
