Github için Döküman Düzenleme

Selamun Aleykum Herkese,

İlk defa githuba başlayacağım inşallah ama bir kaç sıkıntıyla karşılaştım.İnternetim olmadığı için ertesi gün kütüphanede
aklıma gelen kaynakları indirip git ve github temelimi attım.Ana işlemleri öğrendim pull,request,commit,pull,fetch,add fakat
karşılaştığım sorun şu;
Yerel depoma çektiğim sayfaları düzenleyememek,onu da araştırınca wiki ile karşılaştım.
wiki aracını da sanırsam pull etmeliyim yanlışım varsa yada kolay bir yöntem varsa belirtir misiniz?
Şimdi ben İsmail hocamın github daki python/bs4 dizinine eklemeler yapacağım diyelim yerel depoda düzeltmeleri yapıp çekme isteği
atacağım ama eklemeler hangi dosyaya yollanmalı birde bs4’ün kurumsal dökümanına göre mi yazıları hazırlamalıyım.Anlamadığım bir
diğer nokta ise içerik hazırlarken oluşturduğumuz metin dosyasını .html olan bir dosyayla nasıl uyumlu hale getireceğim?Bu soruları çözebilirsem hem orta derece olan ingilizcemle kaynak oluşturmaya başlayabilirim
hem de kendimi geliştirip ilerde daha faydalı olabilirim.

Not:atom editor ve asciidoctor preview paketi yükledim ve çok kullanışlı olmasada .adoc dosyaları değiştirip değişikliği gözlemleyebiliyorum artık (önerilerinizi bekliyorum)


Teşekkürler
@ismailarilik

1 Beğeni

Aleyküm selam.

Böyle bir şey yok. Çektiğiniz belgeleri doğrudan düzenleyip add, commit, push yolunu izlerseniz değişikliklerinizi veri havuzuna(repo) gönderebilirsiniz. Tabii bunu çatalladığınız(fork ettiğiniz) kendi veri havuzunuza göndermeniz gerekiyor. Daha sonra GitHub arayüzünden çekme isteği(pull request) göndermelisiniz.

Gönderme yaparken hem adoc dosyalarındaki değişiklikler hem de bu adoc dosyalarından oluşturulan HTML dosyaları gönderilmeli.

Öyle yapsanız çok daha iyi olur. Birebir çeviri de olabilir. Böylece sonradan katkıda bulunacak kişiler nasıl katkıda bulunabileceklerini bilirler.

AsciiDoc belgelerini Asciidoctor ile HTML belgelerine çevirebilirsiniz. Asciidoctor ile lgili her şeyi şurada bulabilirsiniz: http://asciidoctor.org/docs/user-manual/
Tam teşkilatlı bir geliştirme ortamı kurulumu için şuraya, kod görünümlerindeki sözdizimi renklendirmesi için ise şuraya bakabilirsiniz.

Çekme isteğinizi bekliyorum. Başarılar dilerim. :slight_smile:

1 Beğeni

Merhabalar, siteye yeni üye oldum. Bu siteyi yazın sonlarında istihzanın kapandığını görünce öğrendim. Tekrar buraya döndüm ve hala yeni belgeler eklenmediğini gördüm. Bugün yeni belgeler eklemek için döndüğümde bu başlığı ve şu başlığı gördüm. Sanırım artık birşeyler yapmaya başlıyoruz. İlk olarak Pythona 3.6 ile yeni gelen 3. bir karakter dizisi biçimlendirme özelliği olan f-stringleri anlatmayı düşünüyorum ve bunun gibi daha fazlasıyla destek olmayı planlıyorum. Herkese iyi günler dilerim

2 Beğeni