Mengedit Manual¶
Anda dapat memodifikasi manual dengan mengedit file teks lokal. File-file tersebut disimpan secara sinkron dengan yang online melalui repositori, berdasarkan ini, server ini akan mengupdate manual online.
Manual ini ditulis dalam bahasa markup reStructuredText (RST) dan dapat diedit menggunakan teks editor polos. Untuk pratinjau, Anda dapat mengubah source file manual (build) dari RST menjadi laman HTML.
Update¶
Firstly, make sure that your local copy of the manual is up to date with the online repository using:
make update
Menulis¶
Anda sekarang dapat mengedit file dokumentasi yang merupakan file .rst` dalam folder ``manual dengan menggunakan editor teks sesuai pilihan Anda.
Be sure to check the Panduan Gaya Menulis for conventions and Panduan Gaya Markup to learn how to write in the reStructuredText markup language.
Selamat menulis!
Perubahan yang Lebih Besar¶
If you are going to add or overhaul a section, be sure to check carefully that it does not already exist. In some places, the docs are so disorganized that sections may be duplicated or in a strange location. In the case that you find a duplicate or out of place section, create an issue explaining the issue, and optionally include a revision (actual changes).
Sebelum Anda membuat edit yang tidak sederhana dan dapat dibenarkan secara polos (contohnya saat memindahkan folder), Anda seharusnya vertifikasi dengan penjaga manual bahwa kontribusi Anda sesuai dengan visi komunitas untuk manual. Hal ini memastikan penggunaan waktu dan niat baik Anda dengan sebaik-baiknya karena mungkin saja, karena alasan tertentu, perubahan Anda akan bertentangan dan ditolak atau perlu tinjauan yang memakan waktu. Misalnya, orang lain mungkin sudah mengerjakan bagian yang ingin Anda ubah, bagian tersebut mungkin dijadwalkan untuk dihapus atau diperbarui sesuai dengan perubahan yang direncanakan ke Blender.
Komunikasi lebih awal dan sering adalah kunci untuk memiliki lingkungan yang produktif, tidak menyia-nyiakan usaha orang dan mendapatkan manual Blender yang lebih baik sebagai hasilnya.
Mendapatkan Bantuan/Jawaban¶
Jika Anda ragu tentang fungsionalitas yang ingin Anda dokumentasikan, Anda seharusnya mengajukan pertanyaan Anda kepada developer Blender yang bertanggung jawab untuk area itu atau bertanya di saluran bantuan pengguna tidak resmi di #docs atau saluran #blender-coders di Chat.
Blender itself has a system of module owners with developer and artist members who are responsible for the design and maintenance of the assigned Blender areas. See the module pages for more information.
Pratinjau/Melihat Kembali¶
To view your changes, build the manual as instructed.
Keep in mind that you can also build only the chapter you just edited to view it quickly.
Open the generated .html files inside the build/html folder using your web browser,
or refresh the page if you have it open already.
Upload¶
Jik Anda sudah senang dengan perubahan Anda, Anda dapat mengupload perubahan tersebut, supaya mereka dapat masuk ke dalam manual online. Pada awalnya, hal ini diselesaikan dengan mengirimkan tambalan supaya seseorang dapat meninjau kembali perubahan Anda dan memberikan masukan. Setelah itu, Anda dapat komit perubahan Anda langsung. Proses ini dideskripsikan lebih detail di bagian berikutnya.