VisualEditor/Citation tool/id

Alat kutipan VisualEditor memungkinkan para pengguna untuk menggunakan tempat kutipan wiki Anda dari dalam VisualEditor. Untuk mengaktifkan alat ini, Anda memerlukan hal-hala berikut: instalasi VisualEditor dan Parsoid yang bekerja, templat kutipan di wiki Anda yang menggunakan TemplateData untuk menetapkan cara memanggilnya, dan pesan  istimewa untuk menghubungkan VisualEditor dan templatnya.

Mengimpor templat kutipan
Anda akan memerlukan templat rujukan di basis data wiki Anda agar dapat menggunakan fitur rujukan. Jika Anda belum punya templat rujukan di wiki Anda (misalnya, dalam instalasi yang masih baru) Anda perlu mendapatkannya. Menyalin dari Wikipedia adalah cara paling mudah untuk melakukan ini. Jika Anda sudah punya templat rujukan di wiki Anda, Anda bisa melewati tahap-tahap ini.


 * 1) Instal Extension:Scribunto, Extension:ParserFunctions, Extension:Cite, dan Extension:TemplateData. Kebanyakan templat rujukan di Wikipedia menggunakan bahasa pemrograman Lua yang disediakan oleh Scribunto, dan menggunakan fungsi parser ekstensi. Ekstensi Cite memungkinkan Anda menggunakan tag .  Semua Wikipedia dan wiki WMF lainnya sudah memasang semua hal ini.
 * 2) Ekspor templat rujukan dari Wikipedia: Manual:Using_content_from_Wikipedia. Mengekspor w:Template:Cite web, w:Template:Cite news, w:Template:Cite journal, w:Template:Cite book adalah langkah yang bagus untuk memulai. Versi terbaru dari templat-templat ini di Wikipedia bahasa Inggris dan beberapa wiki lain juga membutuhkan dukungan modul Lua.
 * 3) Unggah templat Anda menggunakan halaman Special:Import di wiki Anda (sebagai contoh, http://localhost/index.php/Special:Import).

Data templat
Anda akan membutuhkan Extension:TemplateData agar perkakas rujukan dapat memuat data templat ke isian di VisualEditor dan setiap templat harus memiliki data templat yang didefinisikan. Untuk informasi lebih lanjut mengenai cara mendefinisikan data templat untuk rujukan, dan untuk melihat cuplikan layar jendela rujukan dengan dan tanpa didefinisikan data templat, lihat: Wikipedia:VisualEditor/TemplateData

Definisi alat kutipan
Untuk mengaktifkan alat kutipan VisualEditor di wiki Anda, Anda perlu membuat sebuah pesan konfigurasi istimewa di wiki Anda:. Ini dikarenakan setiap wiki berbeda-beda dan akibatnya perlu menyesuaikan fitur mana yang ingin digunakan; sebagai contoh, nama templat yang digunakan di wiki Anda mungkin berbeda dari yang ada di wiki lain.

Tujuan pesan konfigurasi
Pesan konfigurasi:

Once the  configuration message is created, the citation tool will be live for all VisualEditor users on your wiki within a few minutes.
 * Katakan templat apa yang wiki Anda gunakan untuk rujukan standar (Anda bisa menyebutkan paling banyak 5).
 * Perhatikan bahwa setiap templat harus memiliki Data Templat yang telah didefinisikan atau sistem akan sangat menyulitkan pengguna yang ingin memahaminya. Jika wiki Anda tidak mendukung templat kutipan saat ini, cukup umum untuk menyalin templat dari Wikipedia bahasa Inggris sebagai kumpulan dasar yang baik.
 * Katakan labal mana yang Anda ingin gunakan untuk setiap tipe rujukan.
 * Ada empat rujukan standar, "web", "book", "news" dan "journal", yang bersesuaian dengan  dst.
 * Says which icon you wish to use for each type of citation.
 * There are a standard four, "ref-cite-web", "ref-cite-book", "ref-cite-news" and "ref-cite-journal", which correspond to CSS classes with the icon as a background SVG image called  etc.

Jenis tambahan
If you are considering adding an additional type, the development team would really like to talk with you first, to give advice, help create an appropriate icon, and so we can consider whether other wikis might also want this type defined for all wikis.

Untuk menambah jenis tambahan, Anda harus:


 * 1) Memutuskan jenis apa yang akan dibuat
 * 2) * In this example, say you wished to have a database reference, you could call the type "database".
 * 3) Buat labelnya
 * 4) * For the example, you could make the label name "db" and add a label at   with the value "database". This should be in your wiki's content language. If your wiki uses multiple languages or scripts, you may need to create several of these labels.
 * 5) Buat ikonnya
 * 6) * For the example, you could make the icon label "ref-cite-dbase", and create the icon as an SVG file uploaded to commons, create the icon class " " in  and add the icon you want with " " or similar.

Contoh
You can see example definition messages on the English Wikipedia, Polish Wikipedia, French Wikipedia, Italian Wikipedia. Copy the code to your wiki and adapt the names to the local context.

Pemecahan masalah
If you navigate to Special:Version and TemplateData is installed, but fields aren't showing up in the citation dialog, you may need to open the citation template for editing, make no changes, and save it again. This is due to a bug where TemplateData which is transcluded (i.e. present in Template:Cite_web/doc instead of directly on Template:Cite_web) is not loaded into the database until the parent template is edited; see.

Please note that the user experience will differ slightly when using your own templates other than the standard 4. For instance, a list of fields won't show up initially in the citation dialog, but you will be able to request a list of all possible fields by clicking a button.