Tutorial ini adalah panduan ringkas untuk memasang dan menggunakan GitHub. Inilah cara membuat repositori tempatan, cara menyambungkan repositori tempatan ini ke repositori Github jauh (di mana semua orang dapat melihatnya), bagaimana melakukan perubahan, dan akhirnya bagaimana mendorong semua kandungan repositori tempatan ke GitHub, antara tugas biasa yang lain.
Sebelum memulakan, penting untuk diperhatikan bahawa tutorial ini menggunakan pemahaman asas mengenai istilah yang digunakan dalam Git: push, pull, komit, repositori, dll. Ia juga memerlukan pendaftaran terlebih dahulu di GitHub.
Pemasangan Github
Pada Debian / Ubuntu dan derivatif:
sudo apt-get install git
En Fedora dan derivatif:
sudo yum install git
En Arch dan derivatif:
sudo pacman -S git
Persediaan awal Github
Setelah pemasangan berjaya dilakukan, langkah seterusnya adalah mengkonfigurasi butiran konfigurasi pengguna GitHub. Untuk melakukan ini, gunakan perintah berikut, ganti "nama pengguna" dengan nama pengguna GitHub anda dan "email_id" dengan alamat e-mel yang digunakan untuk membuat akaun GitHub.
git config --global user.name "username" git config --global user.email "email_id"
Buat repositori tempatan
Perkara pertama adalah membuat folder di komputer anda, yang akan berfungsi sebagai repositori tempatan. Untuk melakukan ini, jalankan arahan berikut:
git init Mytest
Perintah ini membuat folder MyTest. Sebaliknya, sub-folder .init menjadikan MyTest dikenali sebagai repositori Git tempatan.
Sekiranya repositori berjaya dibuat, garis yang serupa dengan yang berikut akan muncul:
Repositori Git kosong yang dimulakan di /home/tu_usuario/Mytest/.git/
Kemudian, anda mesti pergi ke folder MyTest:
cd Mytest
Buat fail README untuk menerangkan repositori
Fail README umumnya digunakan untuk menerangkan apa yang terdapat di dalam repositori atau mengenai projek itu. Untuk membuatnya, jalankan:
gedit BACA
Setelah memasukkan keterangan repositori, jangan lupa untuk menyimpan perubahan anda.
Menambah fail repositori ke indeks
Ini adalah langkah penting. Sebelum anda dapat memuat naik perubahan anda ke Github atau pelayan serasi Git lain, anda mesti mengindeks semua fail yang terdapat di repositori tempatan. Indeks ini akan mengandungi fail baru serta perubahan pada fail yang ada di repositori tempatan.
Dalam kes kami, repositori tempatan kami sudah mengandungi fail baru: README. Oleh itu, kita akan membuat fail lain dengan program C sederhana dan yang akan kita panggil example.c. Kandungannya adalah:
#include int main () {printf ("hello world"); pulangan 0; }
Jadi sekarang kami mempunyai 2 fail di repositori tempatan kami: README dan example.c.
Langkah seterusnya adalah menambahkan fail ini ke indeks:
git add README git add smaple.c
Perintah "git add" dapat digunakan untuk menambahkan sejumlah fail dan folder ke indeks. Untuk menambahkan semua perubahan, tanpa menentukan nama fail, adalah mungkin untuk melaksanakan "git add." (dengan tempoh pada akhir).
Simpan perubahan yang dibuat pada indeks
Setelah semua fail ditambahkan, adalah mungkin untuk merekod perubahan ini dengan melakukan apa yang disebut jarum. Ini bermaksud bahawa menambah atau mengubah fail selesai dan perubahan dapat dimuat ke repositori Github jauh. Untuk melakukan ini, anda mesti melaksanakan arahan berikut:
git komit -m "mesej"
"Mesej" boleh menjadi apa-apa mesej yang secara ringkas menerangkan perubahan yang dimaksudkan, misalnya: "Saya menambahkan fungsi seperti itu" atau "Saya membetulkannya", dan seterusnya.
Buat repositori di GitHub
Nama repositori mestilah sama dengan repositori pada sistem tempatan. Dalam kes ini, ia akan menjadi "MyTest". Untuk melakukan ini, pertama sekali, anda mesti log masuk Github. Kemudian, anda perlu mengklik tanda tambah (+) di sudut kanan atas halaman dan memilih pilihan "buat repositori baru". Akhirnya, anda perlu mengisi data dan klik pada butang "buat repositori".
Setelah ini selesai, repositori akan dibuat dan dimungkinkan untuk memuat naik kandungan repositori tempatan ke repositori GitHub. Untuk menyambung ke repositori jauh di GitHub, anda harus menjalankan perintah:
git jauh tambah asal https://github.com/user_name/Mytest.git
Tolak fail dari repositori tempatan ke repositori GitHub
Langkah terakhir adalah mendorong kandungan repositori tempatan ke repositori jauh, menggunakan perintah:
tuan induk asal tekan
Hanya tinggal memasukkan kelayakan masuk (nama pengguna dan kata laluan).
Ini akan memuat naik semua kandungan folder MyTest (repositori tempatan) ke GitHub (repositori luaran). Untuk projek seterusnya, anda tidak perlu lagi mengikuti langkah-langkah ini dari awal. Sebaliknya, anda boleh memulakan dari langkah 3 secara langsung. Akhir sekali, jangan lupa bahawa perubahan akan tersedia dari laman web Github.
Membuat cawangan
Apabila pembangun ingin memperbaiki bug atau menambahkan fungsi baru, mereka sering membuat cabang atau salinan kod sehingga mereka dapat melakukan secara berasingan, tanpa mempengaruhi projek asalnya. Kemudian setelah selesai mereka dapat menggabungkan cawangan ini kembali ke cabang utama (master).
Untuk membuat cawangan baru terdapat dua pilihan:
Pilihan panjang:
cawangan git mirama # buat cawangan baru yang disebut mirama git checkout mirama - beralih ke menggunakan cawangan mirama.
Pilihan pendek:
git checkout -b mirama - buat dan beralih menggunakan cawangan mirama
Setelah perubahan dibuat, tambahkan ke indeks cawangan dan buat komit yang sesuai:
git tambah. git commit -m "perubahan pada mirama"
Kemudian, anda harus kembali ke cabang utama dan mengambil perubahan yang dibuat dalam mirama:
git checkout master git merge mirama
Akhirnya, anda harus menghapus mirama (kerana perubahan dimasukkan ke dalam master):
cawangan git -d mirama
Dan muat naik master ke Github:
tuan induk asal tekan
Membuat repositori Git (garpu)
Terima kasih kepada Git dan adanya perpustakaan repositori awam yang besar, seperti Github, selalunya tidak perlu untuk memulakan program kami dari awal. Dalam kes tersebut, adalah mungkin untuk menggunakan kod asas ini untuk membuat projek baru.
Untuk melakukan ini, perkara pertama yang perlu dilakukan adalah garpu dari repositori yang ada, iaitu projek yang berasal daripadanya yang mengambil kod projek asal sebagai asas. Di Github, ini dapat dicapai dengan mengklik butang yang sesuai, seperti yang dilihat pada tangkapan skrin di bawah.
Kemudian, apa yang harus kita lakukan adalah mengklon repositori projek baru ini di komputer kita. Sebagai contoh, kita dapat menggunakan repositori Ankifox saya, peluasan untuk Firefox yang membolehkan menambahkan kata-kata ke Anki, yang terdapat di Github:
klon git https://github.com/usemoslinux/Ankifox.git
Jangan lupa ganti https://github.com/usemoslinux/Ankifox.git dengan URL yang sesuai dengan projek anda. Mendapatkan alamat ini sangat mudah, seperti yang dilihat pada gambar di bawah.
Perintah ini akan membuat direktori yang disebut «Ankifox», akan menginisialisasi direktori .git di dalamnya, dan ia akan memuat turun semua data dari repositori itu, agar dapat berfungsi dengan versi terbaru.