Mengedit page

Table of contents

  1. Mengedit Melalui Github
  2. Mengedit Secara Lokal (locally)
    1. Menjalankan Page Lokal
    2. Menghubungkan dengan Repository Github
    3. Commit dan Push

Mengedit Melalui Github

  1. Buka page yang ingin diedit, misal ingin mengedit konten pada page Tutorial.

  1. Scroll menuju bagian bawah page. Klik pada Edit this page on GitHub.

  1. Akan muncul halaman preview untuk source code-nya pada repository Github, klik pada ikon pensil (Edit this file) untuk mengedit.

  1. Muncul source code dari page Tutorial. Terdapat beberapa bagian kode yang dipisahkan oleh tanda ---. Bagian pertama merupakan metadata yang memberikan informasi mengenai page tersebut. Bagian kedua merupakan kode untuk navigasi yang berisikan judul dan table of contents. Di bagian bawahnya merupakan isi page tersebut.

Edit kode pada bagian ini untuk merubah isi konten dari suatu page.

  1. Jangan lupa di commit agar perubahannya dapat tersimpan.

  1. Cek kembali pada page Tutorial untuk melihat perubahannya.
  2. Cek website resmi Just the Docs Template untuk mengetahui fitur-fiturnya lebih lanjut.

Mengedit Secara Lokal (locally)

Untuk mengedit page secara lokal, maka dapat menggunakan aplikasi pendukung, seperti Visual Code Studio. Selain itu, diperlukan menginstall library ruby gem terlebih dahulu. Klik di sini untuk melihat tutorialnya.

Menjalankan Page Lokal

  1. Buka terminal, arahkan pada folder yang diinginkan untuk meletakkan clone dari repository.
cd [directory]

ganti [directory] dengan path folder.

  1. Clone repository page tersebut dengan mengetikkan kode di bawah.
 git clone https://github.com/PT-Inersia/PT-Inersia.github.io.git
  1. Pastikan terminal telah diarahkan pada folder yang di-clone, jalankan page dengan kode berikut.
bundle exec jekyll serve
  1. Tampilan web secara default menggunakan port :4000 seperti pada gambar di bawah. Salin alamat web tersebut di browser.

  1. Sekarang sudah bisa mengedit page tersebut. Jika ingin mengedit isi konten, dapat ditemukan pada folder docs yang berekstensi .md.

  1. Tekan CTRL + C pada terminal jika ingin menghentikan sesi.

Menghubungkan dengan Repository Github

  1. Pada terminal, buka folder clone sebelumnya. Remote repository Github menggunakan kode di bawah.
git remote add origin https://github.com/PT-Inersia/PT-Inersia.github.io.git
  1. Cek apakah sudah terhubung atau belum.
git remote -v
  1. Jika berhasil, maka akan muncul teks berikut:
> origin  https://github.com/PT-Inersia/PT-Inersia.github.io.git (fetch)
> origin  https://github.com/PT-Inersia/PT-Inersia.github.io.git (push)

Commit dan Push

jika pengeditan sudah selesai, maka perlu dilakukan commit (agar perubahan tersimpan) dan push (untuk memasukan hasil pengeditan ke repository Github)

  1. Pada terminal, ketikkan kode commit di bawah ini ([Commit comment] dapat diganti sesuai keinginan)
git commit -m "[Commit comment]"
  1. Push ke repository Github pada branch main.
git push origin main

Jika menggunakan VS Code, maka tinggal buka bar Source Control, tulis pesan yang diinginkan pada kolom message dan tekan Commit.

Perhatikan bahwa pesan harus ditulis agar tidak terjadi error!

Jika telah berhasil di-commit, maka akan muncul tombol Sync Changes. Tekan tombol tersebut untuk mengsinkronisasi hasil commit-nya.