GitHub'da İlk Projenizi Nasıl Yayınlarsınız?

GitHub, yazılım projelerini internet üzerinde saklamak, geliştirme sürecini takip etmek ve başkalarıyla paylaşmak için kullanılan popüler bir platformdur. İlk projenizi GitHub’a yüklemek için Git repository oluşturabilir, dosyalarınızı commit edebilir ve projenizi uzak repository’ye gönderebilirsiniz.

GitHub nedir?

GitHub, Git ile oluşturulan repository’leri internet üzerinde barındırmaya ve projeler üzerinde birlikte çalışmaya olanak sağlayan bir platformdur. Kodlar, proje dosyaları ve değişiklik geçmişi repository içerisinde tutulabilir.

Git ile GitHub aynı şey değildir. Git, versiyon kontrolünü sağlayan bir sistemdir. GitHub ise Git repository’lerini uzakta saklamak ve projeler üzerinde iş birliği yapmak için kullanılan bir platformdur.

GitHub'da repository nasıl oluşturulur?

İlk olarak GitHub hesabınıza giriş yapın ve yeni bir repository oluşturun. GitHub üzerinde repository oluşturmak için sağ üst bölümdeki New repository seçeneğini kullanabilirsiniz.

Repository oluştururken proje adı, açıklama ve görünürlük seçeneklerini belirleyebilirsiniz. İlk projenizi bilgisayarınızda bulunan mevcut bir klasörden gönderecekseniz, GitHub'ın önerdiği gibi repository'yi README, .gitignore veya lisans dosyalarıyla önceden başlatmamak daha kolay bir başlangıç sağlayabilir.

Git ile proje nasıl hazırlanır?

Bilgisayarınızda bulunan proje klasörünü Git repository haline getirerek başlayabilirsiniz. Terminali açın ve proje klasörüne gidin.

Ardından aşağıdaki komutu çalıştırın:

git init -b main

Bu komut, klasörü Git repository olarak başlatır ve main isimli başlangıç branch'ini oluşturur. Git'in uygun bir sürümünü kullanmıyorsanız branch adını ayrıca değiştirebilirsiniz.

Repository'nin durumunu kontrol etmek için git status komutunu kullanabilirsiniz:

git status

Bu komut, Git tarafından takip edilen ve henüz commit edilmemiş değişiklikleri görmenizi sağlar.

Proje dosyaları Git'e nasıl eklenir?

Git repository oluşturulduktan sonra proje dosyalarını staging alanına eklemek gerekir. Bunun için git add komutu kullanılır.

git add .

Buradaki . işareti, proje klasöründeki uygun değişiklikleri staging alanına ekler. Belirli bir dosyayı eklemek isterseniz dosyanın adını da yazabilirsiniz:

git add index.html

Bu aşamada dosyalar henüz GitHub'a gönderilmiş olmaz. Öncelikle bu değişikliklerin Git geçmişine bir commit olarak kaydedilmesi gerekir.

Git commit nasıl oluşturulur?

Commit, projedeki değişikliklerin belirli bir noktadaki kaydıdır. Dosyaları staging alanına ekledikten sonra aşağıdaki komutla ilk commit'inizi oluşturabilirsiniz:

git commit -m "İlk commit"

Commit mesajının yapılan değişikliği açıklaması, proje geçmişini takip etmeyi kolaylaştırır. İlk projede İlk commit gibi basit bir mesaj kullanılabilir.

Bu işlem sonrasında projenizin yerel Git geçmişinde ilk kaydınız oluşur.

GitHub repository ile yerel proje nasıl bağlanır?

GitHub'da oluşturduğunuz repository ile bilgisayarınızdaki Git repository'sini birbirine bağlamak için uzak repository adresini eklemeniz gerekir.

GitHub'daki repository sayfasından Quick Setup bölümündeki repository URL'sini kopyalayabilirsiniz. Ardından terminalde şu komutu kullanabilirsiniz:

git remote add origin https://github.com/KULLANICI-ADI/PROJE-ADI.git

Burada origin, GitHub repository'sini temsil eden uzak bağlantının ismidir. Git'te origin yaygın olarak kullanılan varsayılan remote adıdır.

Bağlantının doğru oluşturulduğunu kontrol etmek için:

git remote -v

komutunu çalıştırabilirsiniz.

Proje GitHub'a nasıl gönderilir?

Yerel repository ile GitHub repository'si birbirine bağlandıktan sonra sıra projeyi GitHub'a göndermeye gelir. Bunun için git push komutu kullanılır.

git push -u origin main

Bu komut, main branch'indeki commit'leri GitHub'daki uzak repository'ye gönderir. -u seçeneği, yerel branch ile uzak branch arasında takip ilişkisi oluşturur.

İlk gönderim tamamlandıktan sonra GitHub repository sayfanızı yenilediğinizde proje dosyalarınızı görebilirsiniz.

GitHub'a proje yüklerken nelere dikkat edilmeli?

Bir projeyi GitHub'a göndermeden önce repository içerisinde paylaşılmaması gereken bilgileri kontrol etmek önemlidir. Özellikle uygulamaların çalışması için kullanılan gizli bilgilerin doğrudan kod içerisine eklenmemesi gerekir.

GitHub'ın resmi dokümantasyonu, parola ve API anahtarı gibi hassas bilgilerin git add, commit veya push ile repository'ye gönderilmemesi gerektiğini özellikle belirtir.

İlk projenizi yayınlamadan önce şu noktaları kontrol edebilirsiniz:

• API anahtarları ve parolalar kodda bulunuyor mu?
• Gereksiz veya geçici dosyalar repository'ye eklenmiş mi?
• Projenin nasıl çalıştırılacağını anlatan bir README dosyası var mı?
• Repository'nin görünürlük ayarı projenizin amacına uygun mu?

Özellikle kişisel projelerde README dosyası eklemek, projenin amacını ve kullanım şeklini başkalarına açıklamak açısından faydalı olabilir.

GitHub'da yayınlanan proje nasıl güncellenir?

Projenizi GitHub'a gönderdikten sonra yerel dosyalarda değişiklik yapmaya devam edebilirsiniz. Yeni değişiklikleri GitHub'a göndermek için temel olarak aynı üç aşamalı süreç izlenir.

git add .
git commit -m "Yeni özellik eklendi"
git push

İlk komut değişiklikleri staging alanına ekler. İkinci komut değişiklikleri commit olarak kaydeder. Son komut ise yeni commit'i GitHub'daki uzak repository'ye gönderir.

Bu çalışma düzeni, projenizin hem yerel bilgisayarınızda hem de GitHub üzerinde güncel tutulmasını sağlar.

GitHub'a proje yüklemenin farklı yolları nelerdir?

İlk projenizi GitHub'a göndermek için yalnızca terminal kullanmanız gerekmez. GitHub CLI ve GitHub Desktop gibi araçlar da bu süreci kolaylaştırabilir.

GitHub Desktop, komut satırı kullanmak istemeyen kullanıcıların yerel repository'lerini grafik arayüz üzerinden yönetmesine olanak sağlar. Mevcut bir Git repository'si Add Local Repository seçeneğiyle GitHub Desktop'a eklenebilir.

GitHub CLI ise repository oluşturma ve mevcut bir yerel projeyi GitHub'a gönderme gibi işlemlerin komut satırından yapılmasını sağlar.

İlk projenizi GitHub'da yayınlamak için temel akış; repository oluşturmak, projeyi Git ile başlatmak, dosyaları staging alanına eklemek, commit oluşturmak, GitHub repository'sini remote olarak tanımlamak ve git push ile değişiklikleri göndermektir. Bu adımları öğrendikten sonra branch, merge ve pull request gibi GitHub özelliklerine geçerek daha kapsamlı projeler üzerinde çalışabilirsiniz.