JDOC

Bagaimana Berkontribusi ke Dokumentasi Joomla!

From Joomla! Documentation

This page is a translated version of the page JDOC:How to Contribute to Joomla! Documentation and the translation is 87% complete.

Outdated translations are marked like this.
Other languages:
বাংলা • ‎Deutsch • ‎English • ‎español • ‎eesti • ‎فارسی • ‎français • ‎हिन्दी • ‎Bahasa Indonesia • ‎italiano • ‎Nederlands • ‎português • ‎português do Brasil • ‎Türkçe

Dokumentasi Joomla! diberdayakan oleh software Wikipedia yang sama. Pertumbuhan dan keberhasilannya tergantung pada orang-orang seperti Anda. Terima kasih telah memulai langkah pertama berkontribusi ke Proyek Joomla. Halaman ini menjelaskan kepada Anda bagaimana memulainya dan cara-cara lain untuk ikut membantu usaha dokumentasi.

Memulai!

Ada beberapa hal yang perlu Anda lakukan terlebih dahulu.

Baca Kebijakan Wiki

Anda wajib mengulas kebijakan Wiki Dok Joomla! sebelum mulai.

Buat Akun Pengguna

Untuk mengedit Wiki Dokumentasi Joomla, Anda perlu sebuah akun pengguna. Anda bisa daftar di sini. Setelah itu, konfirmasi alamat e-mail Anda. Ini akan mengizinkan Anda untuk mengedit halaman di sini kecuali halaman yang dikunci.

Catatan: Apabila Anda tidak mengedit apapun dalam 5 hari sejak pembuatan akun, maka akun Anda akan dihapus secara otomatis demi alasan keamanan.

Buat Halaman Pengguna

Setelah membuat akun, mengkonfirmasi alamat e-mail dan masuk, Anda harus membuat satu halaman pengguna. Tips membuat halaman pengguna:
  • Di menu pengguna, pergi ke halaman Nama pengguna Anda (atau gunakan butir menu pertama yang ada di dalam dropdown sebelah kanan)
  • Klik tindakan yang tersedia di dalam dropdown itu
    JDOCS-actions-create-page-id.png
  • Klik Buat
  • Tambah kode ke editor {{subst:Newuser}}
  • Isilah ringkasan (misalnya Ini adalah halaman pengguna baru saya)
    JDOCS-summary-form-input-id.png
  • Klik tombol simpan

Bergabung di Milis Dokumentasi

Anda harus bergabung ke milis Dok. Memang tidak wajib, tapi mungkin Anda akan kehilangan diskusi yang berhubungan dengan dokumentasi.

Apa Yang Harus Dilakukan Pertama Kali?

Ada beberapa area dokumentasi yang selalu butuh perhatian. Anda bisa mulai dengan memilih salah satu yang Anda sukai atau bekerja sekaligus dalam sekali waktu. Setelah memiliki akun wiki, Anda bebas bekerja pada aspek apa saja yang Anda sukai di dokumentasi. Bahkan, kontribusi yang paling mudah seperti mengoreksi ejaan dan kosa kata merupakan bantuan yang luar biasa!

  1. Bantu konten dokumentasi.
  2. Tugas-Tugas Pemeliharaan.
  3. Gabung atau mulai proyek dokumentasi.
  4. Bantu Layar Bantuan.

Bantu Kelola Konten Kami

  1. Mengedit, menulis ulang, dan penyusunan laman. Periksa Perlu laman untuk area-area yang membutuhkan bantuan segera. Mereka disebut 'Perlu laman' karena memang dibutuhkan tugas-tugas kecil untuk melengkapinya. Ada yang sederhana seperti, mengulas konten atau menambahkan sebuah gambar. Yang lainnya memerlukan penambahan konten atau peningkatan. Pilihlah dan berikanlah sedikit cinta untuk mereka. Ini adalah sebuah bantuan yang hebat untuk para pengguna Joomla! yang bergantung pada dokumentasi.
  2. Bersenang-senanglah dan telusurilah artikel-artikel yang mubazir, yang sudah kadaluwarsa (seperti 1.0 dan 1.5), atau yang memerlukan pemisahan karena informasi versi tertentu. Lalu, jangan ragu untuk menggunakan templat {{delete}}, {{merge}} atau {{JSplit}} pada artikel-artikel tersebut. Klik tautan-tautan templat sebelumnya untuk melihat bagaimana cara menggunakan dan menerapkannya ke artikel-artikel yang Anda pikir perlu penanda templat ini. Tambahkanlah ke bagian paling atas laman dan demikianlah laman tersebut ditandai.
  3. Buat laman baru atau tutorial. Bila Anda ingin membuat sebuah laman baru, lakukanlah penelitian yang luas terlebih dahulu. Hindari membuat artikel baru bila sudah ada. Gunakan fitur pencarian Wiki Dok untuk melihat apakah topik Anda sudah pernah dibuat. Duplikasi akan disatukan dan/atau dihapus. Jangan ragu untuk memodifikasi, membuat format ulang, atau memperbaiki pekerjaan orang lain di Wiki Dok Joomla. Ini adalah wiki dokumentasi kolaborasi, tapi pastikan Anda mengikuti kebijakan dan panduan.
    1. Menggunakan tautan-tautan wiki. Sangat mudah untuk menautkan sebuah laman dengan menggunakan sintak standar. Bila Anda membuat sebuah tautan ke sebuah artikel yang belum ada, maka tautannya akan berwarna merah. Mengklik tautan berwarna merah akan mengantarkan Anda ke laman edit laman untuk artikel baru. Ketiklah tulisan Anda, klik simpan dan laman yang baru akan tercipta. Setelahnya tautan akan berubah dari berwarna merah menjadi biru yang menandakan bahwa artikel tersebut sekarang sudah ada.
    2. Menggunakan URL. Digunakan ketika Anda ingin membuat sebuah laman dari nol. Anda dapat menggunakan URL wiki untuk membuat sebuah laman yang baru. URL ke artikel wiki biasanya akan seperti ini: https://docs.joomla.org/JUDULARTIKELANDA. Bila Anda mengganti JUDULARTIKELANDA dengan nama laman yang ingin Anda buat, maka Anda akan mendapati sebuah laman kosong yang menandakan bahwa belum ada artikel dengan nama tersebut. Mengklik tautan Buat halaman ini akan mengantarkan Anda ke laman edit untuk artikel itu, dimana Anda bisa membuat laman baru dengan mengetikkan tulisan Anda, lalu klik Kirim.
  4. Bantu memperbarui gambar di artikel. Periksa kategori Perlu pembaruan gambar untuk melihat daftar laman yang memerlukan pembaruan gambar-gambar. Panduan untuk membantu Anda ada di artikel, panduan penamaan Gambar.

Pemeliharaan Wiki

Memelihara sebuah wiki dan membuatnya tetap tersusun rapi memerlukan usaha dan kerja yang berkesinambungan pada bagian-bagian administrator, editor, dan pengguna. Selalu ada tugas-tugas seperti: Kategorisasi, melihat laman-laman yang memerlukan bantuan, yang sedang dalam pengerjaan, atau menandakan laman untuk penghapusan, penyatuan/penggabungan atau pemisahan. Untuk semua tugas pemeliharaan dan ide-ide bantuan Anda, silakan kunjungi laman Pemeliharaan Dokumentasi kami.

Proyek Dokumentasi

  • Tim dok sedang bekerja pada Tutorial Pemula. Tujuan kami agar ia mudah dipahami dan mudah dinavigasikan, sesuatu yang dapat diikuti oleh seorang Pemula dengan mudah untuk mempelajari konsep-konsep dasar. Bayangkanlah kembali ketika pada saat pertama kali Anda masih baru dengan Joomla! dan tambahkanlah topik-topik yang dulunya susah Anda pahami sebagai seorang pemula. Alangkah bagusnya, bila Anda bergabung ke Proyek Tutorial Pemula.
  • Bergabung bersama Proyek Tutorial Pengembang dan bagilah pengetahuan Anda. Tandai nama Anda dengan menggunakan 4 tanda gelombang ( ~~~~ ) pada laman Proyek Tutorial Pengembang dan buatlah daftar apa saja yang bisa Anda lakukan. Silakan tambah beberapa topik tutorial kedalam daftar saran topik.

Layar Bantuan

Tidak ramai orang yang mengetahui, semua laman Layar Bantuan dibuat dan melayani setiap instalasi Joomla! di seluruh dunia dari wiki ini! Sangat penting untuk para pemula dan bahkan bagi mereka yang sudah menguasai Joomla! di tingkatan menengah.

The Joomla! 4.x Help Screens need to be completely created. Any contributtion you give to them will be appreciated by many users worldwide and we're looking for volunteers to help with this important task. A matrix needs to be put in place as well as an action plan.

Yang Harus Diingat

Berikut beberapa hal yang harus diingat sebagai seorang kontributor Dok Joomla.

  • Jangan takut akan merusak sebuah laman, bila Anda memang melakukannya dan sesuatu yang buruk terjadi, kembalikan editan Anda. Klik tab Lihat Riwayat laman dan Anda akan melihat tautan-tautan undo dan pengembalian.
  • Tulislah artikel-artikel dengan latar belakang pemikiran bahwa ia akan diterjemahkan kedalam beberapa bahasa yang lain. Menggunakan bahasa-bahasa prokem atau dialek kedaerahan tidak akan diterjemahkan atau hasilnya akan sulit dimengerti.
  • Jangan takut untuk mengunduh dan membaca Panduan Gaya Editorial (PDF) umum yang diterapkan ke semua Dokumentasi Joomla. Ada petunjuk--petunjuk yang bermanfaat tentang cara penulisan Dokumentasi Joomla! disana.
  • Kata-kata yang harus diperhatikan ketika menulis, baca panduan lengkap … atau gunakan tanggapan cepat dari browser Google Chrome atau Mozilla Firefox. Ada pemeriksaan ejaan bawaan yang mereka miliki yang akan menggarisbawahi sebuah kata yang salah ketik/ejaan berdasarkan pengaturan bahasa utama masing-masing browser Anda.
  • Jangan lupa tambahkan templat {{inuse}} ke artikel Anda bila pengerjaannya memakan waktu yang lama, lebih dari satu menit. Ini akan membantu mencegah konflik penyuntingan.

Tolong, saya tidak mengerti Markup Wiki!

Bila Anda masih baru di Wiki dan dalam pemakaian markup sederhana untuk membuat laman, maka Anda bisa menggunakan bantuan berikut ini.

  • WikiEditor yang baru mengandung tombol-tombol dan tautan cepat untuk membuat laman menjadi lebih mudah. Klik Tingkat Lanjut (Advanced) untuk melihat tombol-tombol lain dan tautan-tautan format tulisan.
  • Gunakan Contekan Wiki JDOC untuk mempelajari perintah dasar sintaks. Terdapat juga sebuah dropdown markup yang biasa dipakai di editor. Klik Bantuan (Help) dan ia akan muncul.
  • Masih takut? Cobalah alat berikut yang dapat membantu Anda membuat laman-laman wiki yang hebat.
  • Pengaya Microsoft Word untuk Markup Wiki, menyimpan Dok Word dalam Markup Wiki.
  • OpenOffice.org versi 2.4 dan terbaru memiliki filter ekspor MediaWiki bawaan. Buka saja sebuah dokumen Penulis dan klik Berkas - Ekspor. Lalu, ubah format Berkas ke MediaWiki.
  • Berikut adalah alat-alat yang tersedia untuk mengubah format-format lain kedalam format wiki, misalnya HTML, Excel, CSV. Beberapa diantaranya adalah konverter online, potong dan tempelkan HTML untuk membuat sebuah output ber-markup wiki.
  • Dapatkan bantuan di Glip (kami punya 2 kelompok disana yaitu: satu untuk Kelompok Terjemahan JDoc dan satunya lagi Kelompok Kerja JDoc).
  • Tanyakan pertanyaan di laman bicara editor atau kepada seorang administrator.