Menggunakan Git melalui editor

Pendahuluan

Apa itu Git?

Git adalah sistem kontrol versi kode yang umum digunakan dalam proyek perangkat lunak. Git antara lain memungkinkan:

memiliki riwayat kode, yang bisa dikembalikan ke keadaan sebelumnya;
menyinkronkan beberapa perangkat dan bekerja secara tim pada file yang sama dengan meminimalkan konflik;
memelihara beberapa versi dari kode yang sama, untuk mengembangkan dan bereksperimen tanpa merusak versi yang berfungsi;
mencadangkan proyek dengan mudah.

Folder yang versinya dikelola oleh Git disebut repositori (_repository_ atau _repo_ dalam bahasa Inggris).

Apa itu forge?

Meskipun Git adalah perangkat lunak yang dapat digunakan secara lokal (di komputer Anda atau di editor Leek Wars), Git juga dapat berinteraksi dengan sebuah forge perangkat lunak, yaitu server yang menampung repositori Git.

Leek Wars mendukung beberapa forge; yang paling mudah adalah memilih salah satu dari berikut ini:

GitHub, layanan proprieter milik Microsoft (AS). Juga menampung kode Leek Wars.
GitLab.com, instans resmi GitLab (AS), perangkat lunak bebas yang dapat dihosting sendiri.
Bitbucket, layanan proprieter milik Atlassian (AS).
Codeberg, instans resmi Forgejo, perangkat lunak bebas komunitas yang dapat dihosting sendiri, dihosting oleh sebuah organisasi nirlaba Jerman.

Anda juga dapat menggunakan forge lain yang berbasis GitLab, Bitbucket, Forgejo, Gitea, atau Gogs, misalnya framagit.org atau gitea.com.

Menggunakan Git untuk AI yang sudah ada

Pertama-tama, AI harus berada di dalam sebuah folder, bukan di root. Buat sebuah folder, klik kanan pada folder tersebut, pilih "Inisialisasi repositori Git". Folder ini akan berisi semua file yang akan dimasukkan ke Git.

Sebuah tab Git dengan ikon percabangan muncul di bagian atas daftar file (menu kiri). Buka tab tersebut.

Membuat commit

(commit dapat diartikan sebagai "penyimpanan" atau "validasi" perubahan)

Di bagian atas tab Git, pastikan pada menu pilihan bahwa repositori yang diinginkan telah dipilih (jika Anda memiliki beberapa).

Ketika file di dalam repositori diubah, perubahannya muncul di tab Git. Untuk saat ini perubahan tersebut belum diindeks: ibarat draf, yang belum terpahat dalam riwayat.

Ketika Anda ingin menyimpan perubahan ke dalam riwayat, klik tombol ➕ untuk mengindeksnya. Ringkas perubahan dalam beberapa kata di kolom "Pesan commit", lalu validasi.

Catatan: untuk melihat semua tombol tab Git dengan baik, Anda mungkin perlu memperlebarnya ke kanan dengan menyeret tepi kanannya!

Riwayat adalah daftar commit, dan setiap commit adalah sekumpulan perubahan, dengan tanggal dan pesan. Idenya adalah agar Anda bisa menemukan kapan suatu perubahan dibuat, kembali ke keadaan sebelumnya, mengelompokkan perubahan agar tidak ada kode yang setengah jadi...

Menghubungkan ke forge

Konfigurasi di forge

Buat akun di sebuah forge Git dan buat repositori kosong di sana. Temukan alamat repositori Anda, yang seharusnya mirip dengan https://exemple.net/mon-pseudo/mon-depot.git. Ini adalah alamat halaman utama repositori Anda, dengan tambahan .git di akhir.

Selanjutnya Anda harus mengizinkan Leek Wars mengakses repositori tersebut. Langkahnya bergantung pada forge.

GitHub: cara termudah adalah memasang GitHub App Leek Wars, langsung dari editor (lihat di bawah). Sebagai alternatif, Anda dapat membuat token: klik profil Anda, Settings, Developer Settings (paling bawah). Di halaman yang terbuka, pilih Personal access tokens, Tokens (classic). Pilih masa berlaku (misalnya 90 hari) dan berikan hanya hak yang diperlukan untuk berkontribusi pada repositori.
Forgejo: Pengaturan akun, Aplikasi, Token akses baru. Izinkan akses baca dan tulis ke "repository".

Jika Anda membuat token, simpan baik-baik agar tidak hilang!

Konfigurasi di Leek Wars

Di bagian bawah tab Git, klik tombol awan "Pengaturan remote".

Di sinilah repositori jarak jauh (remote) dideklarasikan: masukkan sebuah nama (misalnya origin), tempel URL repositori dan klik tombol "Tambah". Langkah ini wajib sebelum Anda dapat melakukan push apa pun.

Untuk autentikasi, pilih forge Anda: GitHub, GitLab, Bitbucket, atau Forgejo.

GitHub: jalur utamanya adalah tombol "Pasang GitHub App". Saat pemasangan, pilih repositori yang ingin diberi akses; setelah kembali ke Leek Wars, Anda dapat langsung memilih salah satu repositori tersebut untuk remote. Sebagai alternatif, tempel Personal Access Token di kolom "Token akses".
GitLab dan Bitbucket: tempel token di kolom "Token akses". Jika Anda menggunakan instans yang dihosting sendiri, bukan gitlab.com atau bitbucket.org, centang "Instans yang dihosting sendiri" dan masukkan alamat forge (kotak centang ini juga ada untuk GitHub).
Forgejo: kotak centang "Instans yang dihosting sendiri" tidak ada untuk forge ini; kolom alamat instans selalu ditampilkan (terisi otomatis dengan codeberg.org). Masukkan alamat instans Anda jika perlu, dan tempel token di kolom "Token akses".

Mengirim commit ke server

Untuk saat ini, riwayat commit hanya tersimpan di Leek Wars. Untuk mengirimnya ke forge, lakukan push dengan tombol ⬆ di bagian paling bawah tab Git.

Setiap kali Anda ingin mengirim commit baru, lakukan push.

Fungsi lainnya

Editor dan tab Git juga menyediakan:

Mengklon repositori: menu File → "Klon repo git", dengan memasukkan URL repositori dan folder tujuan.
Tarik (pull): tombol "Tarik (pull)" untuk mengambil commit dari remote, dengan pilihan strategi merge atau rebase ("Strategi pull").
Branch: pemilih branch memungkinkan berganti branch, membuat branch baru ("Branch baru...") dan melihat branch jarak jauh.
Riwayat dan diff: tombol "Riwayat" mencantumkan daftar commit, dan mengklik file yang diubah akan menampilkan perbedaannya.
Penyelesaian konflik: jika terjadi konflik saat merge atau rebase, editor memungkinkan Anda menyelesaikannya lalu melanjutkan.
Membatalkan commit terakhir: perubahan dari commit yang dibatalkan tetap berada di indeks.
Memadatkan repositori: mengurangi ruang yang dipakai repositori (berguna untuk kuota).
Terminal Git terintegrasi: menampilkan log perintah Git yang dijalankan oleh editor.