Joomla! Documentation™

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!

There are a few things you will need to do first.

Ada beberapa hal yang perlu Anda lakukan terlebih dahulu.

Baca Kebijakan Wiki

Anda wajib mengulas Dokumentasi kebijakan Wiki Joomla! sebelum mulai.

Buat Akun Pengguna

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

You need to review the Joomla! Docs Wiki policy before you start editing.

Create a User Account

To edit the Joomla! Documentation Wiki, you will need a user account. You may register for one here. Afterwards make sure to confirm your email address. Confirmation of your e-mail address will give you permission to edit any page except for a few that are protected.

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, mengonfirmasi 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 dropdown pertama di sebelah kanan)
• Klik tombol tindakan dropdown tersebut

After you have created an account, confirmed your email address and logged in, we recommend you take a few moments to create a User page. Creating a user page serves a few purposes:

• It lets users find out more about you.
• It lets you make some initial edits so that the Wiki spammer and abuse filter can see that you're not a fake user. Note that for your first few edits, don't include external links as that will be what is most likely to trigger the filters.

A quick cheat to start your user page:

• On the user menu, go to your Username page (or use first menu item on far right dropdown)
• Click the actions drop down button
  
• Klik Buat
• Tambahkan kode ini ke editor {{subst:Newuser}}
• Isilah ringkasan (misalnya Ini adalah halaman pengguna baru saya)
  

• Klik tombol simpan

Bergabung di Milis Dokumentasi

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

Joomla's official communication tool is Mattermost. See this page for information on how to join the conversation and once you're in there, join the PD Documentation channel to join the discussion on Joomla! Documentation.

Apa Yang Harus Dilakukan Pertama Kali?

Ada beberapa area dokumentasi yang selalu butuh perhatian. Anda bisa mulai dengan memilih salah satu yang disukai atau bekerja sekaligus dalam sekali waktu. Setelah memiliki akun wiki, anda bebas bekerja pada aspek apa saja yang disukai 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 halaman. Periksa Perlu halaman untuk area-area yang membutuhkan bantuan segera. Mereka disebut 'Perlu halaman' 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.

1. Bersenang-senanglah dan telusuri 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 halaman dan demikianlah halaman tersebut ditandai.

1. Buat halaman baru atau tutorial. Bila anda ingin membuat sebuah halaman baru, lakukanlah penelitian yang luas terlebih dahulu. Hindari membuat artikel baru bila sudah ada. Gunakan fitur penelusuran Wiki Dokumentasi untuk melihat apakah topik anda sudah pernah dibuat. Duplikasi akan disatukan dan/atau dihapus. Jangan ragu untuk memodifikasi, memformat ulang, atau memperbaiki pekerjaan orang lain di Wiki Dokumentasi Joomla. Ini adalah wiki dokumentasi kolaborasi, tapi pastikan anda mengikuti kebijakan dan panduan.
   1. Menggunakan tautan-tautan wiki. Sangat mudah untuk menautkan sebuah halaman dengan menggunakan sintaks 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 halaman edit artikel baru. Ketiklah tulisan anda, klik simpan dan halaman 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 jika anda ingin membuat sebuah halaman dari nol. Anda dapat menggunakan URL wiki untuk membuat halaman baru. URL ke artikel wiki biasanya akan seperti ini: https://docs.joomla.org/JUDULARTIKELANDA. Bila anda mengganti JUDULARTIKELANDA dengan nama halaman yang ingin Aada buat, maka anda akan mendapati sebuah halaman kosong yang menandakan bahwa belum ada artikel dengan nama tersebut. Mengklik tautan Buat halaman ini akan mengantarkan anda ke halaman edit artikel itu, tempat anda bisa membuat halaman baru dengan mengetikkan tulisan anda, lalu klik Kirim.

1. 1. Using Wikilinks. It's very easy to link pages using a standard syntax. If you create a link to an article that doesn't exist yet, the link will be colored red. Clicking a red link will take you to the edit page for the new article. Simply type your text, click save and the new page will be created. Once the page has been created, the link will change from red to blue indicating that the article now exists.
   2. Using the URL. To use when you want to create a page from scratch. You can use the Wiki's URL for creating a new page. The URL to an article of the Wiki is usually something like this: https://docs.joomla.org/YOURTITLE. If you replace YOURTITLE with the name of the page you wish to create, you will be taken to a blank page which indicates that no article of that name exists yet. Clicking the Create this page link will take you to the edit page for that article, where you can create the new page by typing your text, and clicking Submit.
2. Bantu memperbarui gambar di artikel. Periksa kategori Perlu pembaruan gambar untuk melihat daftar halaman yang memerlukan pembaruan 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 reviewed and updated. Any contribution 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.