Halo! Ini adalah panduan super simpel buat kamu yang baru masuk Teknik Informatika dan belum paham coding sama sekali.
Repo ini gunanya untuk bikin laporan atau catatan kuliah Matematika Diskret jadi website buku yang keren (Jupyter Book). Gak perlu jago coding, cukup ikuti langkah-langkah ini.
Sebelum mulai, pastikan di laptopmu sudah terpasang alat-alat ini. Kalau belum, download dan install dulu ya (klik linknya):
- Python (Download versi terbaru, waktu install JANGAN LUPA CENTANG "Add Python to PATH").
- Git (Download dan Next-Next aja mpai selesai).
- VS Code (Tempat ngetik yang enak).
Buka aplikasi Command Prompt (CMD) atau terminal di VS Code, lalu ketik perintah ini satu per satu (tekan Enter setelah setiap baris):
-
Install Alat Pembukuan:
pip install -U jupyter-book
-
Install Alat Upload (Github Pages):
pip install ghp-import
Sip! Laptopmu sudah siap tempur.
Alurnya cuma 3 langkah: Tulis -> Daftarkan -> Bangun.
Buka folder materi di VS Code. Buat file baru dengan akhiran .md (misalnya logika.md).
Isi dengan catatanmu. Wajib pakai tanda pagar # di baris paling atas untuk judul.
Contoh isi file logika.md:
# LOGIKA PROPOSISI
Ini adalah catatan tentang logika...Supaya tulisanmu muncul di menu website, kamu harus "mendaftarkannya".
Buka file _toc.yml di dalam folder materi, lalu tambahkan nama filemu di bawah chapters:.
Contoh:
format: jb-book
root: intro
chapters:
- file: markdown
- file: notebooks
- file: logika <-- Tambahkan ini (tanpa .md)Supaya jadi tampilan web, ketik ini di terminal:
jupyter-book build materiKalau sukses, file webnya ada di folder materi/_build/html/index.html. Buka file itu di Chrome/Edge buat liat hasilnya.
Kalau sudah selesai dan mau dikumpulin linknya:
-
Simpan ke Github (Save):
git add . git commit -m "update tugas matematika diskret" git push
-
Jadikan Website (Deploy): Ketik ini biar jadi link website yang bisa dibuka dosen:
ghp-import -n -p -f materi/_build/html
Tunggu 1-2 menit. Website kamu biasanya bakal muncul di: https://username-kamu.github.io/nama-repo-kamu/
- Judul Gak Muncul? Cek file
.mdkamu, baris paling atas harus ada# JUDUL BESAR. - Daftar Isi Gak Berubah? Jangan lupa edit
_toc.yml. - Error Aneh? Coba ketik
jupyter-book build --all materibuat bangun ulang semuanya dari awal.
Semangat belajarnya! Kalau bingung, tanya temen atau Google ya. π