Skip to content

Latest commit

 

History

History
280 lines (165 loc) · 29.7 KB

File metadata and controls

280 lines (165 loc) · 29.7 KB

Tweet

Discord

Duyuru: Bu projede yönetici olmak ve projenin sürdürülmesine yardımcı olmak ister misiniz?? Eğer ilgileniyorsanız, bana Twitter'dan DM atabilir ve klavuz'u inceleyebilirsiniz.

Giriş

Bu eğitim aracılığıyla Github üzerinde ilk kez katkıda bulunacak kişilerin, basit ve kolay bir projeye katılmalarına yardımcı olunması amaçlanmıştır.

Bu eğitim başka dillerde de mevcuttur diğer diller (Şimdilik İngilizce, Portekizce, İspanyolca, ve İtalyanca. Bu konuda çeviri destekleriniz memnuniyetle karşılanır).

Hedefler

  • Açık kaynaklı bir projeye katkıda bulunulması.
  • GitHub'ta kullanım kolaylığı elde edilmesi.

Bu eğitim kimler için?

  • Eğitim yeni başlayanlar için olmak ile birlikte <a href="" target=""></a> bağlantı etiketini nasıl yazacağınızı ve düzenleyeceğinizi biliyorsanız, uygulamamızı başarabilirsiniz.
  • Ayrıca biraz daha deneyim sahibi ancak ilk açık kaynak katkısını yapmak veya konu ile ilgili daha fazla güven ve ekstra deneyim amacıyla katkıda bulunmak isteyenler içindir.

Neden bunu yapmam gerekiyor?

Hevesli veya deneyimli herhangi bir web geliştiricisinin Git versiyon kontrolünü ve herkes tarafından kullanılan en popüler Git barındırma hizmeti olan GitHub’ı kullanması gerekir. Github Aynı zamanda Açık Kaynak topluluğunun da kalbidir. GitHub'ı rahat kullanmak önemli bir beceridir. Github üzerinde bir projeye katkıda bulunmak kendinize olan güveninizi arttıracak ve size GitHub profilinizde sunabileceğiniz bir içerik vererek profil değerinizi arttıracaktır.
Yeni bir geliştiriciyseniz, Git ve GitHub'ı öğrenmeniz gerekip gerekmediğini merak ediyorsanız işte cevap: Git'i Dün Öğrenmiş Olmalıydın.

Ne katkıda bulunacağım?

Katılımcı Kartı

Proje web sayfası'ndaki bunun gibi bir kartla katkıda bulunacaksınız. Üzerinde Adınızı, Twitter kullanıcı adınızı, kısa bir açıklamayı ve tavsiye ettiğiniz web geliştiricileri için faydalı kaynaklara yönelik 3 bağlantıyı içerecektir.

HTML dosyasının içindeki kart şablonunun bir kopyasını oluşturacak ve kendi bilgilerinizle özelleştireceksiniz.

Hızlı Erişim Dizini

Katkı:

Kurulum

İlk önce uygulamamızı gerçekleştirmek için kurulumu yapalım

  1. GitHub hesabınıza giriş yapın. Henüz bir hesabınız yoksa Github'a kayıt ol. Devam etmeden önce GitHub Merhaba Dünya eğitimini yapmanızı tavsiye ediyoruz.
  2. GitHub Masaüstü uygulamasını indirin.
    • • Alternatif olarak, Git'i komut satırında kullanmakta rahatsanız, yapabileceğiniz ilk katkılar, gerekli komutlar için rehber olarak hizmet edebilecek benzer bir projedir. VEYA
    • VS Code kullanıyorsanız, VS Code entegre Git ile birlikte gelir ve ihtiyacımız olanı doğrudan düzenleyiciden yapmanızı sağlar.
    • Ancak bu eğitimi uygulamanın en basit ve en kolay yolu GitHub Desktop kullanmaktır.

Artık hazır olduğunuza göre, projeye katkıda bulunma işine geçebiliriz.



Katkı

10 kolay adımda açık kaynağa katkıda bulunun.

Tahmini süre: 30 dakikadan az.

Adım 1: Bu depoyu çatallayın(fork)

  • Buradaki amaç, bu projenin bir kopyasını oluşturmak ve hesabınız bünyesine yerleştirmektir.
  • GitHub'da bir proje depo(repo) olarak adlandırılmakta, çatal(fork) ise bunun kopyalanmasıdır.
  • Bu reponun ana sayfa'sında (main) olduğunuzdan emin olun.
  • Fork butonuna basın
Fork
  • Artık kendi hesabınızda projenin tam bir kopyasına sahipsiniz.

Adım 2: Depoyu klonlayın(clone)

  • Şimdi projenin yerel bir kopyasını oluşturmak istiyoruz. Yani kendi cihazımıza kaydedilmiş bir kopya.
  • GitHub masaüstü uygulamasını açalım. Uygulamada:
  • Dosya'ya ve ardından Depoyu klonla'ya tıklayın
Clone
  • GitHub'da projelerimizin ve forkladıklarımızın bir listesini göreceğiz.
  • <github-kullanıcı-adı>/Contribute-To-This-Project seçelim.
  • Klonlaya tıklayalım
Klonlaya tıklayalım
  • Forklanmış bir projenin solunda çatal sembolü olacaktır..
  • Forkladığınız projenin kendi GitHub kullanıcı adı olacaktır.
vaše račvanje
  • Proje sabit diskinize kopyalanırken bu biraz zaman alacaktır. Genellikle varsayılan dizini korumanız önerilmektedir. ..\Documents\GitHub.
  • Artık projenin yerel bir kopyasına sahipsiniz.

Adım 3: Yeni bir şube(branch) oluşturun

  • Depo klonlandıktan ve GitHub masaüstünde açıldıktan sonra yeni bir şube(branch) oluşturma zamanı gelmiştir.
  • Dal(branch), değişikliklerinizi projenin Master adlı ana bölümünden ayrı tutmanın bir yoludur. Örneğin, işler ters giderse ve değişikliklerinizden memnun değilseniz, şubeyi silmeniz durumunda ana proje etkilenmeyecektir.
  • Mevcut şube'ye(current) tıklayın
  • Ardından Yeni'ye tıklayın
Create branch
  • Şubenize(branch) bir isim verin
  • Create branch'ı tıklayın
Naziv grane
  • İstediğiniz bir isim koyabilirsiniz, ancak bu dal(branch) projeye adınızın olduğu bir kart eklemek amacıyla olduğundan, your-name-card şeklinde isimlendirmek iyi bir uygulama olacağından bu dalın amacını açık tutar.
  • Yeni şubenizi(branch) Github'da yayınlayın
Ime grane
  • Şimdi ana daldan ayrı yeni bir dal oluşturdunuz.
  • Sonraki adımlar için bu dalda çalıştığınızdan emin olun. Bulunduğunuz şubenin adını GitHub masaüstü uygulamasının üst orta kısmında Current branch şeklinde yazdığını göreceksiniz.

Lütfen master branch üzerinde çalışmayın


Adım 4: index.html dosyasını açın

  • Şimdi düzenleyeceğimiz dosyayı favori kod düzenleyicinizle açmanız gerekiyor.
  • Bilgisayarınızdaki proje klasörünü bulun. Varsayılanı koruduysanız bu şöyle bir şey olmalıdır your-computer > Documents > GitHub > Contribute-To-This-Project
  • index.html dosyası doğrudan Contribute-To-This-Project klasöründedir.
  • Kod düzenleyicinizi (Sublime, VS Code, Atom..etc) açın ve Open file komutunu kullanın ve index.html dosyasını projenin ana dizininde bulun.
  • Alternatif olarak, dosyayı sabit sürücünüzde bulabilir, sağ tıklayıp düzenleyicinizle açabilirsiniz.
Otvori index fajl
  • Artık düzenleyeceğiniz dosya düzenleyicinizde açık ve üzerinde değişiklik yapmaya hazırsınız.

Adım 5: Kart şablonunu kopyalayın

  • Üzerinde çalışmaya başlamak için kart şablonunun bir kopyasını oluşturacağız
  • Html dosyasının en üstünde, <head> ve <header> bölümlerinin altında == TEMPLATE == etiketli bölümü bulacaksınız.
  • Contributor card START yorumundan Contributor card END yorumuna, resimdeki kırmızı kare içindeki her şeyi kopyalayın.
Kopirajte šablon kartice
  • Her şeyi doğrudan yapıştırılacak yeri belirten yorumun altına yapıştırın.
  • Kartın başlangıcının öncesi ile sonununun ardında tek bir satır boşluk olduğundan emin olun. Bu kodumuzu olabildiğince okunabilir tutmak için iyi bir uygulamadır.
  • Asla linter veya stil formatlayıcı kullanmayın. Proje daha güzel bir kuruluma sahiptir.
Nalepite šablon kartice
  • Artık, kişiselleştirmeniz ve düzenlemeniz için size ait kartınız var.

Adım 6: Değişikliklerinizi uygulayın

  • Şimdi kartımızdaki özelleştirilebilir alanları değiştirerek html düzenlemeye başlayacağız.
  • 'Name' kısmını adınız ile değiştirin
  • Not: class="name" değiştirilmemelidir
Promeni ime
  • Twitter hesabınızın URL'sini girin href="Insert URL here"
  • Kullanıcı adınızı(handle) metin alanına yazın
Promeni kontakt
  • Twitter dışında bir platform kullanmayı tercih ederseniz twitter simgesini değiştirmeniz gerekecektir <i class="fa fa-twitter"></i>. Font Awesome Icons'a giderek doğru simgeyi bulmanız sonrasında yalnızca fa-twitter bölümünü örneğin fa-facebook gibi yeni simgeyle değiştirebilirsiniz.
  • Bize kendin hakkında birşeyler söyle
  • Kısa ve güzel tut. Bunu blog gönderisinden çok bir tweet gibi düşünebilirsiniz
Promeni o sebi
  • Web geliştirme için yararlı olan 3 kaynağa ait bağlantının topluluk ile paylaşılması
  • Bu herhangi bir şey, video, konuşma, podcast, makale, referans veya araç olabilir
  • Yeni başlayan biriyseniz, bundan korkmayın, basit olduğunu düşünseniz bile bildiklerinizi paylaşın. Kaç kişinin faydalanacağına şaşıracaksınız
izmeni resurse
  • Link: # değiştirilerek buraya bağlantı eklenir href="here"
  • Title: Kısa bir başlık açıklaması yazın title="here"
  • Name: Metin alanına kaynağın adını yazın >here</a>
  • Tüm değişikliklerinizi kaydettiğinizden emin olun.
  • Değişikliklerinizi test edin. BU ÖNEMLİ! Html dosyasını tarayıcınızda açın (üzerine çift taklayarak açabilirsiniz) ve kartınızın sitede nasıl görüneceğine bakın. Bağlantılarınızı tıklayın ve çalıştıklarından emin olun. Konsolu açın (Ctrl + Shift + J (Windows / Linux) veya Cmd + Opt + J (Mac)) ve hata mesajı olmadığını kontrol edin.
  • Harika, kodunuzu düzenlemeyi bitirdiniz! Sonraki adımlarda, değişikliklerinizi GitHub'a gönderecek ve ardından ana projeyle birleştirilmek(merge) üzere sunacaksınız.

Adım 7: Değişikliklerinizi kabul edin(commit)

  • GitHub masaüstü uygulamasına geri dönün.
  • Değişiklikleriniz staging alanına otomatik olarak eklenecektir.
  • Bu, Git'in şuana kadar mevcut gerçekleştirilen tüm değişiklikleri kaydettiği anlamına gelir.
  • Bunun uygulamaya yansıdığını görebilirsiniz. Dosyaya eklediğiniz her şey yeşil olacak ve silme işlemleri kırmızı olarak gösterilecektir.
  • Bir sonraki adıma Commit denir
  • Bu kabaca "değişiklikleri onayla" anlamına gelir
Komituj promene
  • GitHub masaüstü başlığınız böyle görünmelidir
  • Geçerli depoda proje adının yanındaki çatal sembolüne dikkat edin
  • Mevcut şubeniz 3. adımda verdiğiniz isme sahip olacaktır
Komituj promene
  • Taahhüt(commit) etmek için Summary(özet) alanını doldurmalısınız
  • Bu, neyi değiştirdiğinizi açıklayan taahhüt mesajıdır
  • Bu durumda "Kart bilgilerimi ekle" mantıklı bir mesaj olacaktır
  • İsteğe bağlı olarak daha ayrıntılı bir Açıklama ekleyebilirsiniz.
  • Commit butonuna basınız Butonda şöyle bir şey yazacaktır Commit to "your-branch-name"
commit-message

Adım 8: Değişikliklerinizi GitHub'a aktarın(push)

  • Değişiklikleriniz artık kaydedildi veya taahhüt(commit) edildi. Ancak bunlar yalnızca yerel olarak, yani bilgisayarınızda kaydedilmiştir.
  • Yerel değişiklikleri Github'daki deponuzla senkronize etmeye Push denir. Yerel deponuzdaki değişiklikleri Github'taki uzak depoya "ittirme(pushlama)" işlemi gerçekleştirilecektir.
  • Push Butonuna tıklayınız
Pušuj na GitHub
  • Birkaç saniye sonra işlem tamamlanır ve artık bu dalın(branch) tam olarak aynı kopyası hem makinenizde hem de GitHub'da bulunur.

Adım 9: Bir PR(Çekme İsteği) Gönderin(Pull Request)

  • İşte beklediğiniz an; Pull Request gönderme zamanı.
  • Şimdiye kadar yaptığınız tüm işler, hatırladığınız gibi kendi GitHub hesabınızda bulunan çatallanmış proje dahilindeydi(fork).
  • Şimdi, değişikliklerinizi birleştirilecek ana projeye gönderme zamanı.
  • Orijinal proje yürütücüsünden, gerçekleştirmiş olduğunuz değişikliklerinizi projelerine "çekmesini" istediğiniz için buna Pull Request denir.
  • GitHub'da çatalınızın ana sayfasına gidin (üstte çatal simgesi ve kendi kullanıcı adınız olacaktır).
  • Deponun üst kısmına doğru, yeşil bir düğme ile vurgulanmış bir çekme talebi mesajı göreceksiniz. (Pull request)
  • Compare and pull request butonuna tıklayınız
Submit a Pull Request
  • Open a pull request sayfası bu şekilde gözükmektedir.
  • UNUTMAYIN, dalınızı çatalınızdaki Master dalıyla değil, orijinal projeyle birleştirmeye çalışıyorsunuz.
  • Aşağıdaki resim, çekme isteğinizin başlığının nasıl görünmesi gerektiği hakkında bir fikir verecektir.
  • Solda orijinal proje ve ardından ana dal bulunur. Sağda ise çatalımız ve oluşturduğumuz dal vardır.
Open a Pull Request
  • Çekme(Pull request) isteği oluşturun
  • Bir başlık yazın
  • Açıklamaya isteğe bağlı bilgiler ekleyin
  • Create pull request butonuna tıklayın
Submit a Pull Request
  • Tüm seçenekler sizi şaşırtmasın. Şimdilik sadece bu üç adımı yapmanız gerekiyor.
  • Allow edits from maintainers (Bakımcıların düzenlemelerine izin ver) seçeneğini işaretli bırakın.
  • Şimdi, proje yürütücüsüne bir Pull Request(Çekme talebi) gönderilecektir. İncelenip kabul edildiği anda değişiklikleriniz proje web sayfası'nda görünecektir.

Adım 10: Kutlama

Bu kadar. Başardın! GitHub'ta açık kaynağa katkıda bulundunuz.

Canlı bir web sayfasına kod eklediniz: https://syknapse.github.io/Contribute-To-This-Project

Değişiklikleriniz hemen görünmeyecektir; öncelikle proje yürütücüsü tarafından gözden geçirilip kabul edilmeli ve birleştirilmelidir(merge). Bir kez birleştirildikten sonra kartınız sayfada görünür ve canlı olacaktır.

Gözden geçiren kişinin bir PR üzerinde değişiklik istemesi çok normaldir. Başınıza gelirse iyi bir uygulama olarak düşünün. Yorumlara ve istenen değişikliklere dikkat edin. İstenen değişiklikleri yaptıktan sonra (size ait branch'a geri döndüğünüzde) tek yapmanız gereken değişikliklerinizi taahhüt(commit) etmek ve push etmektir. PR, yeni değişikliklerle otomatik olarak güncellenecektir.

En kısa zamanda incelemeye ve birleştirmeye çalışacağıma söz veriyorum ama bunu boş zamanlarımda yapıyorum, bu yüzden birkaç gün gecikme kaçınılmaz.



Sonraki adımlar

  • Merge edilmiş Çekme Talebinizi(pull request) kontrol etmek için bir süre sonra tekrar gelin.
  • Değişiklikleriniz onaylandığında veya ek değişiklikler istendiğinde GitHub'dan bir e-posta almalısınız. Ve aynı zamanda PR nihayet master ile birleştiğinde ve kartınız eklendiğinde de.
  • Bu projeyi faydalı bulduysanız, lütfen sayfanın üst kısmına bir ⭐ yıldız ⭐ verin ve projenin yayılmasına yardımcı olmak için bu konuda Tweet atın.Tweet
  • Beni takip edebilir ve Twitter veya bu diğer seçeneklerden herhangi birini kullanarak iletişime geçebilirsiniz.
  • Bu açık kaynaklı bir projedir, dolayısıyla kartınız ile katkıda bulunmanın yanı sıra hataları düzeltmeye, iyileştirmelere veya yeni özellikleri eklemeye yardımcı olabilirsiniz. Bir issue açabilir ve pull request gönderebilirsiniz.
  • Topluluğumuzu geliştirmeye yardımcı olmak için çekme isteklerinin yanında bulunan Github Tartışmalar sekmesine bakabilirsiniz. Bu alan kendinizi tanıtabileceğiniz, açık kaynak hakkında daha derin tartışmalara girebileceğiniz ve proje sorumluları ile iletişim kurabileceğiniz bir yerdir. Bu özelliği geliştirmemize ve topluluğumuzu geliştirmemize yardım edecek misiniz? -Bu projeye katkıda bulunduğunuz için teşekkür ederiz. Şimdi devam edebilir ve diğer projelere katkıda bulunmayı deneyebilirsiniz; acemi dostu katkı seçenekleri için Good First Issue etiketini arayabilirsiniz.
  • Ayrıca, PR'leri gözden geçirme ve birleştirme konusunda bana yardım edecek ortak çalışma arkadaşları arıyorum. Daha gelişmiş Git alıştırması yapmak istiyorsanız, lütfen bana Twitter'dan bir DM atın ve maintainer's guide kaynağını okuyun.

Teşekkür

Bu proje büyük ölçüde Roshan Jossey'in mükemmel eğitimlere sahip first-conributions projesinden esinlenmiştir.

Ayrıca, özellikle #GoogleUdacityScholars The Google Challenge Scholarship: Front-End Web Dev, 2017 Avrupa kümesindeki büyük topluluktan ilham almıştır.

Lisans

MIT License

Başa dön ↑