GitGud

Gitgud

Perkenalan

Gitgud adalah repositori open-source yang dirancang untuk memberi para pemula dan pengembang berpengalaman platform untuk belajar dan meningkatkan keterampilan GIT mereka. Repositori ini dibangun dengan tujuan memberikan pengalaman belajar interaktif bagi pengembang dari semua tingkat keterampilan. Apakah Anda baru memulai dengan Git atau ingin meningkatkan keterampilan Anda yang ada, Gitgud menyediakan serangkaian sumber daya dan alat yang luas yang dapat membantu Anda menguasai Git. Gitgud memungkinkan Anda untuk dengan mudah memvisualisasikan dan sepenuhnya memanfaatkan GIT di seluruh proyek Anda. Ini dibuat menggunakan tinta yang menyediakan pengalaman bangunan UI berbasis komponen yang sama yang ditawarkan, tetapi dalam antarmuka baris perintah (CLI).

Persyaratan

• Setidaknya memiliki versi git 2.24.3
• Menginstal NPM
• Kami tidak merekomendasikan menggunakan ITERM2 untuk gitgud karena masalah rendering. Terminal hiper atau default adalah alternatif yang baik.

---

Instalasi

 $ npm install --global gitgud

---

Ini akan menginstal paket secara global

Penggunaan

 $ GitGud

• Arahkan ke proyek apa pun yang memiliki direktori git di dalamnya dan jalankan perintah 'gitgud'. Ini akan memuat UI gitgud ke jendela terminal Anda

• UI Gitgud terdiri dari: Perubahan yang tidak terselesaikan, perubahan bertahap, Tampilan Tree Cabang Git dan tombol Fungsionalitas

• Navigasikan melalui UI dengan tombol 'tab' atau tombol panah kiri/kanan

• Tekan tombol 'Enter/Return' untuk memilih/mengklik opsi

• Di seluruh aplikasi Anda dapat menekan tombol 'ESC' (Escape) untuk kembali

• Anda dapat keluar dari aplikasi dengan menjalankan Ctrl + C

---

Fungsionalitas

• Perubahan Panggung

  • Anda dapat memilih STAGE/UNSTAGE (all files) untuk memindahkan semua file antara perubahan tahap dan perubahan yang tidak stage.
  • Jika Anda mengkliknya setelah itu akan memindahkan semua file dari bagian 'Perubahan Tidak Tagus' dari UI ke 'Panggung Perubahan'. Jika Anda mengkliknya lagi, itu akan membatalkan 'perubahan yang dipentaskan' dan memindahkan file kembali ke 'perubahan yang tidak disusun' dan sebagainya.
  • Anda juga memiliki opsi untuk mementaskan/tidak membuat file individual dengan menavigasi melalui mereka dengan tombol naik/turun.
  • Tekan 'ESC' untuk keluar dari menu perubahan tahap.

• Melakukan perubahan

  • Ini akan meminta Anda untuk memasukkan 'pesan komit' yang tidak mengharuskan Anda untuk membungkus input dengan tanda kutip. Setelah masuk dan mengirimkan pesan komit, itu menjalankan komit dan membawa Anda kembali ke menu utama.
  • Tekan 'ESC' untuk keluar dari perubahan komit.

• Dorong perubahan bertahap

  • Ini akan mendorong perubahan bertahap pada cabang saat ini yang Anda hadapi.
  • Anda dapat melihat cabang apa yang Anda hadapi di atas GUI.

• Cabang Checkout

  • Ini akan menampilkan daftar semua cabang dalam proyek. Cabang tidak dapat dipilih, mereka ada di sana untuk membantu Anda melihat cabang lokal mana yang tersedia untuk beralih.
  • Anda diminta untuk memasukkan cabang untuk checkout. Jika Anda memasuki cabang yang tidak ada, itu akan membuat yang baru.
  • Jika Anda memiliki perubahan yang tidak terselubung, kesalahan akan ditampilkan dan itu akan membatalkan operasi checkout, memberi tahu Anda bahwa Anda memiliki perubahan yang tidak terselubung dan untuk melakukan atau menyimpan perubahan sebelum beralih cabang. Anda dapat menekan 'ESC' untuk kembali dan menyimpan/melakukan perubahan sebelum Anda mencoba checkout lagi

• Hapus Cabang

  • Ini akan menampilkan daftar cabang yang tidak dapat dipilih, mereka ada untuk membantu Anda melihat cabang lokal mana yang tersedia.
  • Anda diminta untuk memasukkan nama cabang, dan jika cabang ada, itu akan menghapus/menghapusnya dan membawa Anda kembali ke menu utama. Jika cabang tidak ada maka itu akan melempar kesalahan.
  • Tekan 'ESC' untuk keluar dari cabang hapus

• Akses Pohon Log Lengkap

  • Ini akan membuat seluruh pohon kayu mengapung GUI Gitgud.
  • Tekan 'ESC' untuk keluar dari pohon log

---

Gaya

Gitgud memungkinkan pengguna untuk menyesuaikan tampilan dan nuansa aplikasi dengan mengedit 'stylefile.'

Untuk mengakses 'stylefile' dari gitgud yang diinstal secara global, pertama -tama Anda perlu mencari tahu di mana NPM menyimpan file yang diinstal secara global. Untuk melakukannya, jalankan perintah berikut:

 npm root -g

Ini akan mengembalikan lokasi paket NPM Anda yang terpasang secara global.

Di Mac Anda harus melihat sesuatu seperti ini: /usr/local/lib/node_modules

Di Windows, Anda mungkin mendapatkan ini: *C: Users You AppData Roaming npm node_modules

Arahkan ke tempat paket global Anda disimpan, buka folder Gitgud, dan kemudian buka stylefile di editor (perintah: nano styleFile.js akan membukanya di sebagian besar sistem Mac/Linux).

Saat Anda membuka file, itu akan terlihat seperti ini:

• showLogo :

  • Secara default ini diatur ke false , tetapi jika Anda ingin memiliki logo Gitgud di atas GUI Anda, Anda dapat mengubahnya menjadi true .

• defaultColor :

  • Ini adalah warna untuk blok teks utama di seluruh aplikasi.

• accentColor :

  • Ini adalah warna untuk perbatasan aplikasi serta beberapa header teks di seluruh aplikasi.

• gitTreeColor :

  • Ini adalah warna untuk font pohon git di seluruh aplikasi.

• appResize :

  • Ini memungkinkan aplikasi untuk responsif, memungkinkan pengguna untuk mengubah ukuran jendela konsol mereka tanpa harus memulai kembali aplikasi. Ini dapat mengurangi kinerja untuk beberapa pengguna.

• showFlag :

  • Memungkinkan pengguna untuk memilih apakah akan menampilkan tag output GIT oleh file yang dipentaskan/tidak diselesaikan.
  • Diatur ke false secara default.
  • Lihat di sini untuk info lebih lanjut tentang tag output git

---

FAQ

---

Berkontribusi

Gitgud adalah proyek sumber terbuka yang sepenuhnya dan kontribusi dipersilakan!

Saat mengirimkan permintaan tarik, harap jelaskan dengan jelas fitur yang Anda tambahkan atau bug yang Anda perbaiki.

Kontributor pertama kali dipersilakan juga! Ada beberapa masalah yang ditandai dengan tag good first issue . Ini mungkin tempat yang baik bagi pemula untuk memulai!

Terima kasih kepada Joseph Garrone karena telah memberi kami nama paket NPM.