Yeni belgelendirme siteleri oluşturun ve yayınlayın
Bu bölüm, nasıl yeni belgelendirme oluşturulacağını ve docs.fedoraproject.org web sitesinde yayınlanacağını açıklamaktadır. Bu işlemi takip etmeye başlamadan önce Ön koşullar bölümünde listelenen tüm gereksinimleri gözden geçirin.
Yeni bir belgelendirme sitesi oluşturmadan önce e-posta listesine başvurun. Bu, çalışmanızı yayınlayabileceğimizden ve zamanınızı boşa harcamadığınızdan emin olmak içindir. |
-
Şablon depoyu klonlayın: https://pagure.io/fedora-docs/template
-
Yeni belgelendirme seti için yeni bir pagure deposu oluşturun veya birilerinden sizin için bir tane oluşturmasını isteyin. Yeni depo
fedora-docs
altında listelenmelidir. -
İçerik setiniz için yeni oluşturulan depoyu klonlayın.
-
Şablon deponun içeriğini (
.git
dizini olmadan) yeni oluşturulan depoya kopyalayın. -
Yeni depoda, depo kök dizinindeki
antora.yml
yapılandırma dosyasını düzenleyin. Dosya, hangi kısımları değiştirmeniz gerektiğini gösteren yorumlar içermektedir. En azından,name
vetitle
bölümlerini her zaman değiştirin. -
Ayrıca,
site.yml
yapılandırma dosyasını düzenleyin. Bu dosyanın yalnızca içerik setinizin yerel bir ön izlemesini oluştururken kullanıldığını unutmayın - web sitesinde, site geneline aitsite.yml
yapılandırması tarafından geçersiz kılınmaktadır. Bu dosyada sadecetitle
vestart_page
bölümlerini düzenlemeniz gerekmektedir. -
Bu noktada, başlangıç yapılandırması tamamlandığında ve depo doğru isim ve gerekli diğer direktiflerle yapılandırıldığında, bu değişiklikleri yeni oluşturulan depoya gönderin (veya doğrudan gönderemezseniz bir çekme isteğinde bulunun). Bu değişiklik seti diğer tüm katkıda bulunmalar için gerekli olacaktır, bu nedenle mümkün olduğunca erken dahil edildiklerinden emin olun.
-
Güncellemeleri doğrudan göndermemek için yeni deponun bir çatalını oluşturun.
-
Gerçek ASCIIDoc içeriğini eklemeye başlayın. Yazarken, yeni kaynak dosyalarınızın kullandığınız modülün (öntanımlı olarak
./modules/ROOT/
, öncesindeantora.yml
dosyasında yapılandırdığınıza göre konum değişecektir)nav.adoc
yapılandırma dosyasına dahil edildiğinden emin olun. Ayrıca işaretlemenizi denetlemek için yerel ön izlemeyi sıklıkla kullanın. -
İşiniz bittiğinde, değişikliklerinizi kaydedin ve bunları çatalınıza gönderin (commit & push).
-
Çatal deponuzdan ana deponun
master
dalına çekme isteği yapmak için Pagure’yi kullanın. -
Birisi çekme isteğinizi görecek ve birleştirecek ya da değiştirmeniz gereken bir şey varsa geri bildirim sağlayacaktır. Yaptığınız katkıların standartlara uygun olduğundan emin olmak için yorum yapan kişilerle uyumlu çalışın.
-
Yeni içeriğinizin ilk kez yayınlanması gerekecektir ve şu anda bu otomatik olarak gerçekleşmemektedir. docs e-posta listesine içeriğinizin yayınlanmasını talep eden bir e-posta gönderin.
5 gün sonra Çekme İsteğinize kimse yanıt vermezse, Belgelendirme Ekibi ile iletişime geçin. Çekme İsteğiniz için gelen e-postayı gözden kaçırmış olabiliriz. |