account_tree Source Control — Panduan Penggunaan
Panel Source Control di Activity Bar membantu Anda mengelola repository, menghubungkan ke GitHub, melakukan commit & push, melihat riwayat commit, dan mengelola branch.
Catatan: Repository hanya muncul setelah Anda secara eksplisit menambahkannya — tidak ada pemindaian otomatis.
1. Sidebar Source Control
Klik ikon Source Control di Activity Bar (bilah ikon vertikal kiri) untuk membukanya.
| Bagian | Deskripsi |
|---|---|
| Repositories | Daftar repository yang sudah ditambahkan |
| Import | Tambah repository dari URL atau Clone |
| Changes | Lihat isi folder repository aktif |
| History | Riwayat commit dan aktivitas |
| Branches | Lihat daftar branch repository aktif |
| Sync | Push, Pull, Fetch |
| Workspace | Repository yang sedang aktif |
| Settings | Pengaturan koneksi GitHub |
Klik nama item di sidebar → panel terbuka di tab editor. Panel yang terbuka akan tetap ada setelah refresh halaman.
2. Repositories
Bagian Repositories menampilkan semua repository Anda. Setiap item menampilkan nama repository, alamat folder atau URL, dan tombol Jadikan Aktif.
Cara Menambahkan Repository
- Dari Discovery — klik kanan folder proyek → Add to Source Control
- Dari Source Control → Import — Import from URL
- Dari Source Control — klik Add di bagian Discovery
Repository Aktif
Hanya satu repository yang bisa menjadi "aktif" dalam satu waktu. Repository aktif digunakan sebagai target untuk operasi Changes, History, Branches, dan Sync.
3. Import
Import from URL
Tambahkan repository dari URL GitHub: https://github.com/{owner}/{nama-repo}. Setelah ditambahkan, repository muncul di daftar Repositories.
Clone Repository
Panel ini menyediakan input URL repository, perintah git clone https://nxdom.org/ yang terbentuk otomatis, dan tombol Salin Perintah untuk menyalin ke clipboard.
4. Changes
Menampilkan daftar file dan folder dari repository aktif. Informasi tentang stage/unstage — operasi stage dilakukan melalui Explorer → Version Control → Commit Changes.
5. History
Commit History
Menampilkan 30 commit terbaru dari GitHub:
- Kode commit (7 karakter)
- Pesan commit
- Nama pembuat
- Tanggal
Activity Log
Riwayat aktivitas Source Control yang tercatat: Push berhasil, Pull berhasil, detail owner, repo, branch, pesan, dan tanggal.
6. Branches
Menampilkan daftar branch dari repository aktif: nama branch, label default (jika branch utama), dan label protected (jika dilindungi).
7. Sync
Push — Commit & Upload ke GitHub
- Isi pesan commit (mis. "Update halaman utama").
- Klik Push ke GitHub.
- Progress ditampilkan:
Membaca file...→Upload: 10/50...→Membuat commit...→Selesai. - Jika repository di GitHub belum ada, otomatis dibuat.
File yang dilewati: node_modules, .git, dist, file gambar/biner.
Pull — Cek Remote HEAD
Menampilkan SHA commit terbaru dari remote. Pull tidak mengubah file di disk — untuk checkout penuh gunakan terminal.
Fetch — Lihat Branch Remote
Menampilkan semua branch yang ada di GitHub beserta nama branch dan commit terbaru.
Sync All
Halaman ringkasan dengan kartu Push, Pull, dan Fetch.
8. Workspace
Menampilkan Repository Aktif (detail nama, alamat, branch, status koneksi GitHub) dan Semua Repository (daftar dengan tombol Jadikan Aktif).
9. Settings
Repository Settings (Koneksi GitHub)
Hubungkan aplikasi ke akun GitHub Anda.
- Access Token — token dari GitHub (GitHub → Settings → Developer settings → Personal access tokens). Scope minimal:
repo,read:user. - Owner / Username — username GitHub Anda
- Default Branch — branch utama (biasanya
main)
Tombol: Simpan & Verifikasi — simpan dan uji koneksi ke GitHub. Putus Koneksi — hapus koneksi GitHub.
Preferences
- Konfirmasi sebelum hapus repository — Ya/Tidak
- Sumber default repository — Discovery / Manual
10. Commit & Push ke GitHub
Yang Diperlukan Sebelum Commit
- Repository aktif sudah ditentukan (klik Jadikan Aktif).
- Token GitHub valid (isi di Settings → Repository Settings).
- Owner dan branch sudah dikonfigurasi.
Alur Commit & Push
- Buka panel Commit atau Push di Source Control
- Ketik pesan commit (wajib diisi)
- Klik "Commit & Push Semua File" atau "Push ke GitHub"
- Aplikasi akan mengecek repository di GitHub, membaca semua file, mengupload, membuat commit, dan push
- Selesai — notifikasi berhasil ditampilkan
File yang Dilewati
Folder berikut tidak ikut di-upload: node_modules/, .git/, .svn/, dist/, .cache/, __pycache__, file gambar dan file biner.