Bu GitHub öğreticisi sevgiyle DjangoGirls Nasıl Yapılır Contribute Tutorial olan Creative Commons Attribution-ShareAlike 4.0 lisansı altında mevcuttur.

Bu eğitim için, aşağıdaki araçları kullanacağız [Evrak Çantası] (https://github.com/beeware/briefcase) deposu temel olarak bağlantılar ve referanslar için.

Başlarken ve önkoşullar

BeeWare'e katkıda bulunmaya başlamak için aşağıdakiler gereklidir:

Depoyu çatallayın

Önce [Evrak Çantası]'nı çatallayın (https://github.com/beeware/briefcase) deposunu kişisel GitHub hesabınıza aktarın:

Çatal düğme

Belgeleri Düzenleme

Basit değişiklikler

Yazım hatası düzeltmeleri gibi basit değişiklikler için GitHub çevrimiçi Editör:

  • GitHub'da yerel çatal sayfanızı açın,
  • herhangi bir bölümdeki README.rst dosyasına gidin,
  • Düzenle simgesine (kalem) basın

ve bölümü doğrudan github.com'da düzenleyebilirsiniz.

Düzenle düğmesi

RST sözdizimi, belgelerin tek tek sayfalarını düzenlemek için kullanılır.

GitHub editörü

Not

Yukarıdaki ekran görüntüsü şu anda GitHub deposunda bulunanları yansıtmayabilir. Canlı depo zaman zaman değişecektir. Ancak, çekme isteği gönderme süreci aynı kalır.

Değişikliklerinizi kaydedin ve aşağıda açıklandığı gibi bir çekme isteği oluşturun.

Yeni kod ve karmaşık değişiklikler

Yeni kod eklemek, sınıfları genişletmek veya karmaşık değişiklikler için kodun bir kopyasını yerel bilgisayarınıza alın.

Ya işletim sisteminiz için GitHub uygulamasını kullanın (yukarıda bahsedilmiştir) ya da depoyu yerel olarak almak için git komut satırını kullanın. Depoyu alırsınız adresini kendi GitHub depo çatalınızın ön sayfasından girin:

git clone git@github.com:yourusername/briefcase.git

Ardından, yeni değişikliklerinizin yer alacağı bir dal oluşturun. Aramak yardımcı olur Şubede yapacağınız değişikliklerle ilgili bir şey.

git checkout -b update_documentation

Kodda herhangi bir değişiklik yapın ve bunların test edilip kaydedildiğinden emin olun Yerel olarak.

Ardından git kullanarak değişiklikleri işleyin ve değişiklikleri uzaktan kumandanıza gönderin GitHub deposu.

Örnek:

$ git durum
update_documentation şubesinde
İzlenmemiş dosyalar:
  (işlenecek dosyalara dahil etmek için "git add <file>..." kullanın)

    README.rst

git add README.rst

$ git commit -m "Evrak Çantası için README.rst belgesini güncelle"
[update_documentation fe36152] Gitbook ekran görüntüsü eklendi
 1 dosya değişti, 0 ekleme(+), 0 silme(-)
 oluşturma modu 100644 README.rst

$ git push
Nesneleri sayıyorum: 11, tamam.
Delta sıkıştırma 8 iş parçacığına kadar kullanılıyor.
Nesneler sıkıştırılıyor: 100 (5/5), tamamlandı.
Nesneler yazılıyor: 100 (5/5), 266,37 KiB | 0 bayt/s, tamamlandı.
Toplam 5 (delta 1), yeniden kullanılan 0 (delta 0)
git@github.com:yourusername/briefcase.git adresine
   b37ca59..fe36152 update_documentation -> update_documentation

Çekme isteği oluşturma

Değişikliklerinizi tamamladıktan sonra bir pull request üzerinde GitHub. BeeWare çekme talebi hakkında bilgilendirilecek, talebinizi inceleyecek değişiklikler yapın, gerekirse düzeltmeler önerin ve ardından değişikliklerinizi *çekin ana sürüme.

GitHub'daki kendi deponuzda Karşılaştır ve çekme isteği yapın

image4

Bu değişikliğin neden yapıldığına dair bilgileri doldurun. Eleştirmen gerçek değişikliğin ayrıntılarını görebilirsiniz, böylece değişikliğin içeriği.

Ardından Çekme isteği oluştur düğmesine basın.

GitHub e-postaları, takip süreci için sizi bilgilendirecektir.