Halaman ini merupakan panduan dalam mengunggah notebook ke repo hidrokit-nb. Tidak diperlukan pengetahuan Git/Github untuk mengunggah notebook melalui GitHub.
Daftar Isi
Persiapan
- Notebook yang dimaksud adalah file berekstensi
.ipynb
. - Menamai file dengan format
pemilik-judul.ipynb
ataupemilik-judul-v0.ipynb
jika memiliki nomor versi (isi spasi dengan-
). Gunakan nama username GitHub untuk konsistensi. - Pastikan notebook sudah tertera lisensinya (baca: Lisensi Notebook).
- Memiliki akun GitHub (jika belum, daftar disini).
- Dilakukan melalui komputer (desktop).
Unggah Notebook ke hidrokit-nb
Jika ini bukan pengalaman pertama dalam mengunggah notebook / pull request di repo hidrokit-nb, baca Pull Request.
Fork hidrokit-nb
- Masuk akun GitHub.
- Buka pranala https://github.com/taruma/hidrokit-nb/.
- Klik Fork pada tepi kanan atas.
![Fork Button](/notebook/assets/images/panduan/unggah_notebook_00.png)
- Akan muncul proses forking.
![Forking](/notebook/assets/images/panduan/unggah_notebook_01.png)
- Tunggu proses fork selesai.
Upload Files
- Setelah proses fork selesai. Klik
notebook
pada daftar folder.
![clicking notebook directory](/notebook/assets/images/panduan/unggah_notebook_02.png)
- Klik Upload files. Pastikan bahwa Anda berada di direktori
hidrokit-nb/notebook/
.
![click upload files](/notebook/assets/images/panduan/unggah_notebook_03.png)
- Akan terbuka halaman untuk mengunggah file. Anda bisa mengupload dengan cara drag files atau mengklik pilihan choose your files. Pastikan berada di direktori
hidrokit-nb/notebook
.
![drag or upload files](/notebook/assets/images/panduan/unggah_notebook_04.png)
- Pastikan bahwa notebook anda terunggah.
![make sure file is uploaded](/notebook/assets/images/panduan/unggah_notebook_05.png)
- Isi deskripsi commit seperti pada gambar. Pastikan pilihan sudah seperti di gambar. Klik Commit Changes.
![add commit message](/notebook/assets/images/panduan/unggah_notebook_06.png)
- Hasil unggah dapat dilihat dengan membuka direktori
notebook
.
![double check file is uploaded](/notebook/assets/images/panduan/unggah_notebook_07.png)
Pull Request
Jika notebook yang ingin diunggah sudah tersimpan pada repo Anda. Saatnya menggabungkan hasil unggahan/perubahan yang Anda lakukan dengan repo hidrokit-nb.
- Dari halaman forked repository yang telah Anda buat klik New pull request. Alamat forked repository Anda berupa
https://github.com/<username>/hidrokit-nb
.
![new pull request](/notebook/assets/images/panduan/unggah_notebook_08.png)
- Akan muncul tampilan “Comparing changes”. Klik compare accross forks untuk membandingkan repo Anda dengan repo hidrokit-nb. Pastikan repo hidrokit di posisi kiri dan repo Anda di posisi kanan (perhatikan tanda panah ⬅ yang berarti menggabungkan kanan ke kiri). Bandingkan cabang master. Klik Create Pull Request untuk ke langkah berikutnya.
![comparing changes](/notebook/assets/images/panduan/unggah_notebook_09.png)
Jika mendapatkan pesan “Can’t automatically merge”. Abaikan dan lanjut dengan klik Create Pull Request.
![if something is not right](/notebook/assets/images/panduan/unggah_notebook_10.png)
- Isi Pull Request dengan informasi notebook Anda. Untuk judul isi sejelas dan sesingkat mungkin. Centang pilihan “Allow edit from maintainers” untuk memberikan akses pengelola mengubah PR. Klik Create Pull Request.
![pull request message](/notebook/assets/images/panduan/unggah_notebook_11.png)
- Dari sini, pengelola akan memeriksa PR Anda. Jika terdapat konflik, pengelola akan memberi tahu langkah selanjutnya (hal ini seharusnya tidak terjadi jika ini merupakan PR pertama Anda). Jika tidak memiliki konflik, PR anda akan digabungkan ke repo hidrokit-nb dan notebook Anda akan muncul di direktori repo hidrokit-nb
![you are done](/notebook/assets/images/panduan/unggah_notebook_12.png)
🎉🎊 Selamat! Anda telah membuat Pull Request pertama Anda. 🎊🎉
Kami menanti kontribusi Anda berikutnya. 👍👍