Help:VisualEditor/User guide/ms

 Jika anda ingin mencuba VisualEditor tanpa menyunting rencana, anda boleh berbuat demikian dengan bebas di [//www.mediawiki.org/wiki/Project:Sandbox?veaction=edit halaman ini]. Anda tidak memerlukan akaun untuk menggunakannya.

Mula: Palang VisualEditor
center|800px|Palang VisualEditor

Menyunting rujukan
{| cellpadding="15"
 * colspan=2 |
 * colspan=2 |

Menyunting rujukan sedia ada

 * colspan=2 |
 * VisualEditor - Editing references 1.png
 * Bagi menyunting rujukan sedia ada, petik rujukan dalam teks, dan petik ikon "Rujukan" (tanda buku) yang kelihatan berhampirannya, atau ikon pada palang.
 * colspan=2 |
 * VisualEditor - Editing references 6.png
 * Memetik ikon Rujukan membuka dialog yang memuatkan penyunting mini; ini akan membolehkan anda untuk menyunting teks rujukan.
 * colspan=2 |
 * VisualEditor - Editing references 6.png
 * Memetik ikon Rujukan membuka dialog yang memuatkan penyunting mini; ini akan membolehkan anda untuk menyunting teks rujukan.
 * Memetik ikon Rujukan membuka dialog yang memuatkan penyunting mini; ini akan membolehkan anda untuk menyunting teks rujukan.

Banyak wiki menggunakan templat untuk memformat rujukan mengijut piawai tertentu. Anda akan nampak ini jika anda menyunting rujukan sedia ada; kandungannya akan berwarna biru apabila anda memilihnya.

Click on the icon (puzzle piece) to edit the content of the template in the template mini-editor.
 * colspan=2 |
 * VisualEditor - Editing References - Cite Web.png
 * If what appears when you click on the reference is one of the several template icons, clicking on it takes you directly to the template mini-editor.
 * colspan=2 |
 * VisualEditor - Editing references 5.png
 * Memetik ikon Transklusi (kepingan susun suai gambar) akan membolehkan anda untuk menyunting parameter templat secara individu.
 * colspan=2 |
 * VisualEditor - Apply changes.png
 * Petik "Kenakan perubahan" ("Apply changes") apabila sudah selesai, dan anda kan dibawa kembali ke penyunting rujukan.
 * Memetik ikon Transklusi (kepingan susun suai gambar) akan membolehkan anda untuk menyunting parameter templat secara individu.
 * colspan=2 |
 * VisualEditor - Apply changes.png
 * Petik "Kenakan perubahan" ("Apply changes") apabila sudah selesai, dan anda kan dibawa kembali ke penyunting rujukan.
 * VisualEditor - Apply changes.png
 * Petik "Kenakan perubahan" ("Apply changes") apabila sudah selesai, dan anda kan dibawa kembali ke penyunting rujukan.

Jika tiada lagi yang mahu disunting, petik "Kenakan perubahan" sekali lagi untuk pulang kepada laman.
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Mengguna rujukan sedia ada

 * colspan=2 |
 * VisualEditor - Toolbar - Reference.png
 * Jika laman sudahpun mempunyai rujukan, anda boleh emilih untuk menggunakan petikan sedia ada, jika ia berkaitan dengan teks yang anda mahu gunakan.
 * VisualEditor - Toolbar - Reference.png
 * Jika laman sudahpun mempunyai rujukan, anda boleh emilih untuk menggunakan petikan sedia ada, jika ia berkaitan dengan teks yang anda mahu gunakan.

Bagi mengguna semula rujukan sedia ada, letakkan kursor anda di tempat di mana anda mahu ia kelihatan dalam teks, dan petik ikon "Rujukan" icon (tanda buku) pada palang. Cari rujukan yang anda mahu yang terdapat dalam senarai, dan pilih rujukan tersebut.
 * colspan=2 |
 * VisualEditor - Editing references 21.png
 * Dalam penyunting rujukan, petik butang yang berkata "Guna rujukan sedia ada" ("Use an existing reference"), pada bahagian kiri bawah tetingkap.
 * colspan=2 |
 * VisualEditor - Editing references 18.png
 * Jika terdapat banyak rujukan, anda boleh menggunakan palan gelintar (dilabel "Apa yang mahu anda rujuk?") ("What do you want to reference?")  untuk hanya memaparkan rujukan yang sepadan dengan teks yang dipilih.
 * colspan=2 |
 * VisualEditor - Editing references 18.png
 * Jika terdapat banyak rujukan, anda boleh menggunakan palan gelintar (dilabel "Apa yang mahu anda rujuk?") ("What do you want to reference?")  untuk hanya memaparkan rujukan yang sepadan dengan teks yang dipilih.
 * Jika terdapat banyak rujukan, anda boleh menggunakan palan gelintar (dilabel "Apa yang mahu anda rujuk?") ("What do you want to reference?")  untuk hanya memaparkan rujukan yang sepadan dengan teks yang dipilih.
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Menambah rujukan baharu

 * colspan=2 |
 * VisualEditor - Toolbar - Reference.png
 * Untuk menambah rujukan baru, letakkan kursor anda di tempat di mana anda mahu ia kelihatan dalam teks, dan petik ikon "Rujukan" icon (tanda buku) pada palang.
 * colspan=2 |
 * VisualEditor - Editing references 20.png
 * Anda dapat menambah, menyunting dan memformat petikan anda dalam penyunting rujukan.
 * colspan=2 |
 * VisualEditor - Editing references 20.png
 * Anda dapat menambah, menyunting dan memformat petikan anda dalam penyunting rujukan.
 * Anda dapat menambah, menyunting dan memformat petikan anda dalam penyunting rujukan.

Anda boleh memasukkan rujukan ke dalam kumpulan tertentu; ini digunakan bagi memaparkan kumpulan-kumpulan rujukan dengan alat "Senarai rujukan".
 * colspan=2 |
 * border|center|300px
 * Sekiranya anda menambah rujukan baru dan anda juga mahu memasukkan templat bersama-samanya, petik ikon Transklusi (kepingan susun suai gambar) ("Transclusion" dalam gambar sebelah) pada palang penyunting rujukan.
 * colspan=2 |
 * VisualEditor - Editing references 9.png
 * Kemudian, cari tempat yang anda mahu guna, dan tambah serta suntingnya seperti mana yang anda lakukan untuk rujukan sedia ada.
 * colspan=2 |
 * VisualEditor - Editing references 9.png
 * Kemudian, cari tempat yang anda mahu guna, dan tambah serta suntingnya seperti mana yang anda lakukan untuk rujukan sedia ada.
 * Kemudian, cari tempat yang anda mahu guna, dan tambah serta suntingnya seperti mana yang anda lakukan untuk rujukan sedia ada.

Petik butang "Kenakan perubahan" ("Apply changes") untuk pulang kepada penyunting rujukan, dan petik "Kenakan perubahan" sekali lagi untuk pulang kepada laman.
 * colspan=2 |
 * border|center|300px
 * Jika tidak ada senarai rujukan pada laman (misalnya, anda menambah rujukan pertama pada laman), anda perlu menambah rujukan itu agar teks rujukan anda dapat dipaparkan.
 * border|center|300px
 * Jika tidak ada senarai rujukan pada laman (misalnya, anda menambah rujukan pertama pada laman), anda perlu menambah rujukan itu agar teks rujukan anda dapat dipaparkan.

Letakkan kursor pada tempat di mana anda mahu rujukan dipaparkan (lazimnya pada bahagian bawah laman) dan petik ikon "Senarai rujukan" ("References list" dalam gambar bersebelahan) (tiga buah buku) untuk menambahnya.
 * colspan=2 |
 * VisualEditor - Editing references 11.png
 * Untuk menambah senarai rujukan, petik "Kenakan perubahan" pada dialog.
 * VisualEditor - Editing references 11.png
 * Untuk menambah senarai rujukan, petik "Kenakan perubahan" pada dialog.

Sekiranya anda memcipta kumpulan rujukan, anda boleh menentukan kumpulan dalam dialog ini bagi memilih rujukan yang berkaitan dengannya.
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Using the cite menu

 * colspan=2 |
 * VisualEditor - Editing References - Cite Pulldown.png
 * If your wiki supports the cite menu, this may be an appropriate and easier avenue for adding references. (The cite menu can also be used for updating existing references; see above.) The cite menu offers quick access to some of the more familiar citation templates. It is not available on all MediaWiki projects yet and must be enabled.
 * VisualEditor - Editing References - Cite Pulldown.png
 * If your wiki supports the cite menu, this may be an appropriate and easier avenue for adding references. (The cite menu can also be used for updating existing references; see above.) The cite menu offers quick access to some of the more familiar citation templates. It is not available on all MediaWiki projects yet and must be enabled.

(Instructions to add the cite menu to a specific wiki are available at VisualEditor/Citation tool.)

To add a citation using the cite menu, press "cite" and select the appropriate template from the menu.
 * colspan=2 |
 * VisualEditor - Editing references - Cite book required fields.png
 * Selecting the template icon will take you into the template mini-editor for the template you have chosen. Strongly recommended parameters may be marked with an asterisk. While the most common parameters will display, they are not all required. Unused parameters should not display.
 * colspan=2 |
 * VisualEditor - Editing references - Add parameter.png
 * To add additional parameters, scroll down in the template mini-editor to the "add parameter" option.
 * colspan=2 |
 * VisualEditor - Apply changes.png
 * Click on "" when you're done, and you'll go back to the editor. If there is nothing more to edit, click on "" again to return to the page.
 * }
 * To add additional parameters, scroll down in the template mini-editor to the "add parameter" option.
 * colspan=2 |
 * VisualEditor - Apply changes.png
 * Click on "" when you're done, and you'll go back to the editor. If there is nothing more to edit, click on "" again to return to the page.
 * }
 * Click on "" when you're done, and you'll go back to the editor. If there is nothing more to edit, click on "" again to return to the page.
 * }
 * }

Menyunting templat
{| cellpadding="15"
 * Bagi menambah templat baru, letakkan kursor anda di tempat di mana anda mahu ia dimuatkan, dan petik ikon "Transklusi" (kepingan susun suai gambar) pada palang.
 * border|300px|center
 * colspan=2 |
 * Masukkan nama templat yang anda mahu muatkan dan petik "Tambah templat".
 * VisualEditor - Template editing 4.png
 * colspan=2 |
 * Anda juga boleh menyunting templat yang sudahpun dimuatkan ke dalam laman dengan memilih templat (kelihatan biru) dan memetik ikon "Transklusi" (kepingan susun suai gambar) yang akan muncul, ataupun ikon pada palang.
 * VisualEditor - Template editing 1.png
 * colspan=2 |
 * Menambah ataupun membuka tempalt sedia ada akan membuka dialog "Transklusi" dengan senarai parameter-parameter individu dan nilai masing-masing.
 * Anda juga boleh menyunting templat yang sudahpun dimuatkan ke dalam laman dengan memilih templat (kelihatan biru) dan memetik ikon "Transklusi" (kepingan susun suai gambar) yang akan muncul, ataupun ikon pada palang.
 * VisualEditor - Template editing 1.png
 * colspan=2 |
 * Menambah ataupun membuka tempalt sedia ada akan membuka dialog "Transklusi" dengan senarai parameter-parameter individu dan nilai masing-masing.
 * colspan=2 |
 * Menambah ataupun membuka tempalt sedia ada akan membuka dialog "Transklusi" dengan senarai parameter-parameter individu dan nilai masing-masing.
 * Menambah ataupun membuka tempalt sedia ada akan membuka dialog "Transklusi" dengan senarai parameter-parameter individu dan nilai masing-masing.

Anda boleh menambah parameter ataupun menyunting parameter yang sedia ada.
 * VisualEditor - Template editing 2.png
 * colspan=2 |
 * Bagi mengubah nilai parameter, pilih parameter daripada senarai dan sunting nilainya pada tetingkap bersebelahan.
 * VisualEditor - Template editing 3.png
 * colspan=2 |
 * Apabila sesebuah templat memuatkan templat-templat lain, templat-templat ini (subtemplat) akan tampil sebagai parameter. Subtemplat ini boleh disunting ataupun dibuang dengan memetik nama subtemplat berkaitan.
 * colspan=2 |
 * Apabila sesebuah templat memuatkan templat-templat lain, templat-templat ini (subtemplat) akan tampil sebagai parameter. Subtemplat ini boleh disunting ataupun dibuang dengan memetik nama subtemplat berkaitan.
 * Apabila sesebuah templat memuatkan templat-templat lain, templat-templat ini (subtemplat) akan tampil sebagai parameter. Subtemplat ini boleh disunting ataupun dibuang dengan memetik nama subtemplat berkaitan.
 * Apabila sesebuah templat memuatkan templat-templat lain, templat-templat ini (subtemplat) akan tampil sebagai parameter. Subtemplat ini boleh disunting ataupun dibuang dengan memetik nama subtemplat berkaitan.

Subtemplat-subtemplat baru ditambah dengan cara yang digunakan untuk menambah parameter. Anda mungkin perlu menyemak dokumentasi templat bagi memastikan yang subtempat disokong.
 * VisualEditor - Template editing 5.png
 * colspan=2 |
 * Apabila selesai, petik "Kenakan perubahan" bagi menutup dialog dan pulang kepada penyunting laman.
 * VisualEditor - Apply changes.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Menggantikan templat

 * colspan=2 |
 * Apabila sesebuah templat perlu diganti, taip  (termasuk titik tindih) sebelum nama templat.
 * Apabila sesebuah templat perlu diganti, taip  (termasuk titik tindih) sebelum nama templat.
 * Apabila sesebuah templat perlu diganti, taip  (termasuk titik tindih) sebelum nama templat.

Penyiapan automatik ("Autocompletion") tidak berfungsi dengan ; jika anda perlukan penyiapan automatik, tambah   hanya selepas mencari templat yang anda mahu.

Kemudian, klik butang hijau "".
 * VisualEditor - Template editing 7.png
 * colspan=2 |
 * Tambah parameter seperti biasa dan "Kenakan perubahan".
 * VisualEditor - Template editing 6.png
 * colspan=2 |
 * Anda tidak akan melihat pengembangan tempalt semasa fasa permulaan ini.
 * VisualEditor - Template editing 8.png
 * }
 * Anda tidak akan melihat pengembangan tempalt semasa fasa permulaan ini.
 * VisualEditor - Template editing 8.png
 * }
 * }
 * }

Menyunting puisi dan lain-lain perkara istimewa
Sesetengah perkara seperti puisi dan skor muzik belum disokong oleh VisualEditor. Sehingga itu, anda perlu menyunting wikiteks sumber secara langsung jika anda ingin menyunting atau menambah perkara-perkara berkenaan.

Jalan pintas kekunci
Ramai penyunting sudah biasa menyunting secara langsung, terutamanya teks tebal, condong dan juga pautan wiki ("wikilinks").Jalan pintas kekunci membolehkan sisipan format tanpa perlu memetik butang palang. Jalan pintas yang sering dijumpai dan yang digunakan penyunting-penyunting lain, berfungsi dengan VisualEditor.