SpongeDocs’un Yazıları

“Sponge Dosyaları” olarak da bilinen Sponge dokümantasyonu, Sponge projesinin resmi belgeleridir. SpongeDocs’un amacı şudur:

  • Kullanıcıların bir Sponge uygulamasıyla güçlendirilmiş öz sunucularını kurmalarına yardımcı olur.

  • Geliştiricilere, Sponge projesine nasıl katkıda bulunacakları konusunda bilgi verin.

  • Geliştiricilere, eklenti geliştirmeye başlama konusunda bilgi verin.

Sorunları bildir

It may always occur that a page gets outdated, an error sneaks in or you just look at a page and think “Well, there is a better way of explaining this.” If that is the case and you are for some reason not able to provide a fix yourself, there are four ways of making us aware of the problem:

  1. SpongeDocs GitHub’da Bir Konu Oluştur <https://github.com/SpongePowered/SpongeDocs/issues> `_

  2. SpongeDocs Forum Kategorisinde Bir Gönderi Oluştur <https://forums.spongepowered.org/c/sponge-docs> _

  3. Irc.esper.net adresindeki #spongedocs kanalında bizi ziyaret edin <ircs: //irc.esper.net: 6697 / # spongedocs> `_ (kaydolmanız gerekiyor)

  4. Visit us on our Discord Server, namely the #docs channel.

Dokümanları Yazma

SpongeDocs’a yapılan değişiklikler ve eklemeler, çekme isteği olarak GitHub’daki SpongeDocs havuzuna <https://github.com/SpongePowered/SpongeDocs> `_ gönderilmelidir. Çekme taleplerinin gözden geçirme işlemi sırasında rafine edilmesi yaygın olduğu için hemen mükemmel olmasını gerektirmiyoruz. Eksik açıklamalar da açıktır, anlamak istemediğiniz bazı parçalar varsa utangaç olmayın. Boşlukları doldurabilecek her zaman biri olacak.

The Docs are written in reStructuredText (reST), if you’re familiar with Markdown (md) the step to reST shouldn’t be too hard. If you’re having issues with it we suggest that you join our #spongedocs on irc.esper.net and ask for help there, or join our Discord Server and post on the #docs channel. Discord and IRC are linked, so you’ll get the same support irrespective of the platform you choose. Alternatively, you can post on our forums if you think it is more apropriate.

The Sponge Documentation is licensed under the Creative Commons - Share-Alike license. Art assets are held under the related Creative Commons - Non Commercial, No Derivatives license. Contributors implicitly accept this licensing.

Stil rehberi

Tüm SpongeDocs sayfalarında tutarlı bir formata sahip olduğumuzdan emin olmak için, Sponge Documentation yazarken geliştirdiğimiz yönergeler aşağıda belirtilmiştir. Dokümanlar büyüdükçe bu liste eklenebilir (şekli değişmiş olabilir).

  1. Başlıklar Başlık Olgusunda Yazılmalıdır (<- example) [# 8 geçerliyse].

  2. Sayfa başlıkları anlamlı olmalıdır (başlığı bir bağlantı olarak görürsünüz).

  3. Program code should be contained in inline literals or code blocks.

  1. Kod bloklarına çok fazla metin koymamaya çalışın çünkü bunlar çevrilemezler. Katkıda bulunanlar kod bloklarında mümkün olduğunca yorum yapmaktan vazgeçtiler. Bazı örneklerde basit yer tutucu metin gerekli olabilir. İdeal olarak, kod bloğu örnekleri kısa olmalı ve gövde metnindeki her örnek için bir açıklama izlemelidir. Tabii ki, kısa bir örnekle gösterilemeyen bazı kavramlar olabilir.

  2. Use the following code block types for particular code blocks:

  • Groovy/Gradle-Files -> groovy

  • Hocon-Config -> guess (hocon highlighting is not yet supported)

  • In-Game/Server Console Command -> none

  • Java-Code -> java

  • Json-Config -> json

  • Linux-Terminal -> bash

  • Logs -> none

  • Text -> text

  • Windows-Console -> bat

  1. Kullanıcılar için ayrı alanlar tutun, Plugin devs ve Sponge Devs gibi.

  2. Mümkün olduğunca sayfaları paylaşarak tekrarlardan kaçının.

  3. Harici kaynaklara bunları üretmek yerine bağlayın.

  1. Bazı istisnalar çeviri amacıyla yapılır.

  1. SpongeForge, SpongeVanilla ve SpongeAPI arasında ayrım yapın.

  2. Kendi dilinizde kötü görünüyorsa, kendi kurallarınızı bulun.

  3. Sponge, Proje Başlığıdır ve çevrilmemelidir.

  1. Bazı diller de fonetik bir çeviriyi kullanmak isteyebilir.

  1. Automated translations (e.g. Google Translate) are strongly discouraged. These often contain serious errors, and are very likely to be rejected.

  2. Sayfa Başlıkları ve Bölüm Başlıkları, düz metin olmalı, karakter blokları ve diğer biçimlendirmelerden kaçınılmalıdır.

  3. Code symbols should be capitalized in their original form and have no extra spaces (e.g. blockState (a field name) or BlockState (a class name), rather than block state). They should also be formatted as a literal using double backticks (e.g. blockState) in body text.

  4. Satırların maksimum uzunluğu 120 karakter olmalıdır.

  5. İçeri aktarma, her bir makalede ilk kez başvurulduğunda kod bloklarında yazılmalı, ancak ilk defadan sonra tekrar edilmemelidir.

Not

Sponge devamlı değişen bir projedir, gelişme dokümanlarının eksikliği beklenmelidir. Sponge resmi olarak yayımlanıncaya kadar pek çok konuda boşluk olduğundan emin olabilirsiniz. Bununla birlikte, SpongeDocs canlı bir belgedir ve daima düzenlemeye tabidir. Hiçbir zaman kusursuz olamayacak, sadece talep doğrultusunda değişecektir.

Contributions, suggestions and corrections are always welcome.