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:
- bir GitHub hesabı
- karmaşık düzenlemeler söz konusu olduğunda Git komut satırına aşinalık basics veya aşinalık bir uygulama ile (Windows ve Mac) itmek için bilgisayarınızda yaptığınız düzenlemeleri GitHub'a aktarın.
Depoyu çatallayın
Önce [Evrak Çantası]'nı çatallayın (https://github.com/beeware/briefcase) deposunu kişisel GitHub hesabınıza aktarın:
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.
RST sözdizimi, belgelerin tek tek sayfalarını düzenlemek için kullanılı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
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.