> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skanesgalab.my.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Panduan Akun GitHub & Hands-On Pertama

> Cara membuat akun GitHub, setup SSH Key, membuat repositori pertama di GitHub, dan mempraktikkan git push berkas contoh.

Halaman ini memandu kamu mulai dari nol: mendaftar akun GitHub, mengonfigurasi koneksi aman, membuat repositori pertama di web GitHub, hingga mengirimkan (*push*) file proyek perdanamu dari terminal.

***

## Bagian 1: Cara Membuat Akun GitHub

1. Buka peramban (*web browser*) dan buka link [https://github.com](https://github.com).
2. Klik tombol hijau **Sign up** di pojok kanan atas.
3. Masukkan data yang diminta secara berurutan:
   * **Email:** Gunakan email aktif milikmu pribadi.
   * **Password:** Buat sandi minimal 15 karakter atau 8 karakter kombinasi huruf dan angka.
   * **Username:** Pilih nama pengguna unik (misal: `anaktjkseyegan` atau nama aslimu).
4. Selesaikan verifikasi puzzle (captcha) untuk memastikan kamu bukan bot.
5. GitHub akan mengirimkan kode OTP 6-digit ke kotak masuk emailmu. Masukkan kode tersebut.
6. Pada pertanyaan personalisasi minat, kamu bisa memilih *Just me* dan *Student/Individual*, lalu klik **Continue**.
7. Selamat! Akun GitHub milikmu sudah aktif dan siap digunakan.

***

## Bagian 2: Menghubungkan Laptop ke GitHub Menggunakan SSH Key

Agar kamu bisa mengunggah kode dari terminal komputermu ke GitHub dengan aman tanpa harus memasukkan username/password berulang kali, kita menggunakan **SSH Key**.

### 1. Konfigurasi Identitas Git di Terminal

Buka Terminal (Linux/macOS) atau Git Bash (Windows), lalu ketikkan perintah berikut:

```bash theme={null}
git config --global user.name "Nama Kamu"
git config --global user.email "emailkamu@example.com"
```

*(Gunakan email yang sama persis dengan yang kamu daftarkan di GitHub).*

### 2. Membuat Kunci SSH Baru

Jalankan perintah ini di terminal:

```bash theme={null}
ssh-keygen -t ed25519 -C "emailkamu@example.com"
```

* Saat muncul `Enter file in which to save the key`, tekan **Enter** (gunakan path default).
* Saat diminta `Enter passphrase`, tekan **Enter** dua kali (boleh dikosongkan untuk kemudahan pemula).

### 3. Menyalin Public Key

Tampilkan dan salin seluruh teks kunci publik yang baru dibuat:

```bash theme={null}
cat ~/.ssh/id_ed25519.pub
```

*Teks akan berawalan `ssh-ed25519 AAAA...` dan berakhiran nama emailmu.* Salin seluruh teks tersebut.

### 4. Menempelkan Kunci ke GitHub

1. Di web GitHub, klik foto profilmu di kanan atas $\to$ pilih menu **Settings**.
2. Pada menu sidebar sebelah kiri, klik **SSH and GPG keys**.
3. Klik tombol hijau **New SSH key**.
4. Beri judul di kolom **Title** (contoh: `Laptop Pribadi`).
5. Tempel (*paste*) teks kunci yang sudah kamu salin tadi ke kolom **Key**.
6. Klik **Add SSH key**.

### 5. Uji Coba Koneksi

Ketikkan perintah ini di terminal untuk memastikan laptopmu sudah terhubung:

```bash theme={null}
ssh -T git@github.com
```

*Jika muncul pertanyaan `Are you sure you want to continue connecting (yes/no/[fingerprint])?`, ketik `yes` lalu tekan Enter.*

Jika sukses, terminal akan menampilkan pesan:

> `Hi username! You've successfully authenticated, but GitHub does not provide shell access.`

***

## Bagian 3: Hands-On — Membuat Repositori & Push Berkas Pertama

Sekarang kita akan mempraktikkan langsung: membuat wadah repositori di GitHub dan mengirim berkas contoh dari laptopmu ke GitHub.

### Langkah 1: Buat Repositori Baru di Web GitHub

1. Di pojok kanan atas GitHub, klik ikon tanda tambah (**+**) $\to$ pilih **New repository**.
2. Masukkan nama repositori di kolom **Repository name**, misalnya: `belajar-git-pertama`.
3. Pilih opsi **Public** (agar bisa dilihat orang lain).
4. **PENTING:** Jangan centang opsi *Add a README file*, biarkan kosong sepenuhnya agar repositori terbuat dalam keadaan bersih.
5. Klik tombol hijau **Create repository**.
6. GitHub akan menampilkan halaman petunjuk dengan alamat SSH repositorimu (berformat: `git@github.com:username/belajar-git-pertama.git`).

***

### Langkah 2: Buat Folder & File Contoh di Komputermu

Buka terminal laptopmu dan jalankan perintah-perintah berikut:

```bash theme={null}
# 1. Buat folder baru dan masuk ke dalamnya
mkdir belajar-git-pertama
cd belajar-git-pertama

# 2. Inisialisasi folder menjadi repositori Git lokal
git init

# 3. Tentukan nama cabang utama menjadi 'main'
git branch -M main

# 4. Buat sebuah berkas contoh bernama README.md
echo "# Belajar Git dan GitHub Pertama Saya" > README.md
echo "Halo dunia! Ini adalah repositori pertama saya yang dibuat menggunakan Git." >> README.md
```

***

### Langkah 3: Simpan Perubahan (Add & Commit)

```bash theme={null}
# Periksa status file (akan terlihat file README.md berwarna merah/untracked)
git status

# Masukkan file ke Staging Area
git add README.md

# Simpan perubahan dengan pesan commit
git commit -m "feat: commit perdana menambahkan file README.md"
```

***

### Langkah 4: Hubungkan ke GitHub & Lakukan Push

Sekarang hubungkan repositori lokalmu ke repositori GitHub yang tadi dibuat:

```bash theme={null}
# Hubungkan alamat remote GitHub (ganti USERNAME dengan username GitHub aslimu)
git remote add origin git@github.com:USERNAME/belajar-git-pertama.git

# Unggah (Push) berkas ke GitHub
git push -u origin main
```

***

### Langkah 5: Cek Hasilnya di GitHub!

Kembalilah ke halaman repositori di web GitHub lalu lakukan *refresh* (F5).

Kamu akan melihat:

* Berkas `README.md` sudah terpajang rapi di GitHub.
* Pesan commit *"feat: commit perdana menambahkan file README.md"* tampil beserta waktu pembuatannya.
* Riwayat komit pertamamu kini tersimpan dengan aman di server cloud GitHub selamanya!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.