Help:Magic words/id

Kata ajaib adalah untaian teks yang dihubungkan oleh MediaWiki dengan suatu nilai atau fungsi balikan, seperti waktu, detail situs, atau nama laman. Laman ini hanya menjelaskan penggunaan kata ajaib standar; untuk rujukan teknis, lihat.

Ada tiga jenis kata ajaib secara umum:


 * Behavior switch: ini biasanya ditulis sebagai kata berhuruf kapital yang dikelilingi oleh garis bawah ganda, contoh:  .
 * Variabel: ini berupa kata berhuruf kapital yang dikelilingi tanda kurung kurawal ganda, contoh:  . Oleh karena itu, mereka terlihat seperti templat.
 * Fungsi parser: yang ini mengambil parameter-parameter dan berbentuk   atau  , contoh: . Lihat juga dan.

Variabel dan fungsi parser bisa menggunakan subst:, seperti templat. Kata ajaib yang bergantung pada halaman akan mempengaruhi atau memberikan data mengenai halaman yang sekarang (secara default), meskipun kat tersebut ditambahkan melalui transklusi templat atau pesan sistem yang dimasukkan.

Behavior switch
Behavior switch mengendalikan tata letak atau perilaku halaman (jika didukung oleh kulitnya) dan biasanya digunakan untuk menetapkan konten yang ingin dikeluarkan dan dimasukkan. Beberapa dari kata di bawah tidak didukung oleh kulit Minerva.

Variabel
Variabel memberikan informasi mengenai halaman, wiki, atau tanggal sekarang. Sintaksnya mirip dengan templat. Variabel yang ditandai sebagai " [expensive] " akan dilacak oleh perangkat lunak, dan banyaknya dalam suatu halaman dibatasi.

Jika nama templat bertentangan dengan sebuah variabel, variabellah yang akan digunakan (jadi untuk mentransklusikan templat    :PAGENAME Anda harus mengetik $codePAGENAME$code-end). Dalam beberapa kasus, menambahkan parameter akan membuat parser memanggil templat; misalnya, $tpl-currentdayname-code mentransklusikan $tpl-currentdayname-result, bukan variabel. In some cases, adding parameters will force the parser to invoke a template; for example,  transcludes     :CURRENTDAYNAME, not the variable.

Tanggal dan waktu
Variabel-variabel berikut memberikan tanggal dan waktu sekarang dalam UTC.

Karena tembolok MediaWiki dan peramban, variabel-variabel berikut kerap kali menunjukkan waktu ketika halaman ditembolok dan bukan waktu sekarang.

Penggunaan variabel ini akan menyembabkan halaman ditembolok untuk waktu yang lebih sedikit. Ini dikonfigurasikan di MagicWordFactory.

Kata ajaib tanggal dan waktu diformat dalam bahasa konten wiki. Sejak, mereka bergantung pada bahasa konten halaman.

Variabel berikut ini melakukan hal yang sama dengan yang sebelumnya tetapi menggunakan konfigurasi server situs atau.



Untuk pemformatan waktu yang lebih seksama, atau untuk menampilkan tahun dan minggu sekarang dengan bentuk yang lebih sesuai dengan ISO-8601, Anda mungkin mau memasang agar bisa menggunakan fungsi parser .

Statistik
Angka yang diberikan oleh variabel-variabel berikut biasanya mengandung pemisah (tanda koma, titik, atau spasi, tergantung bahasa lokalnya) tapi bisa memberikan angka murni dengan flag ":R" (contoh:  &rarr;  dan   &rarr; ).

Gunakan "|R" untuk kata ajaib yang memerlukan parameter seperti PAGESINCATEGORY (contoh:  dan , atau   dan  ). Juga belaku untuk.

Kata ajaib bilangan diformat dalam bahasa konten wiki. Sejak, mereka bergantung pada bahasa konten halaman.

Nama halaman
Di antara kata-kata di atas, tidak ada yang dipengaruhi oleh perubahan tampilan judul yang dihasilkan oleh ; nilai yang diberikan adalah judul halaman yang asli.

Kata ajaib  dan   hanya bekerja di ruang nama yang diaktifkan subhalamannya. Lihat untuk informasi mengenai pengaktifan subhalaman.

Sejak 1.15+, semua kata tersebut bisa menerima parameter, sehingga membolehkan untuk menetapkan halaman yang dikerjakan oleh kata ajaibnya, tidak harus halaman yang sekarang:



Nama halaman kode URL
Kata-kata berikut ini adalah versi yang digunakan untuk URL MediaWiki (spasi diganti dengan garis bawah dan beberapa karakter menghindari HTML menggunakan kode karakter numerik):



Perhatikan bahwa,  , dan   memiliki implementasi yang berbeda. Lihat untuk rinciannya.

Ruang nama
Berikut ini adalah ekuivalen yang dikodekan untuk digunakan di URL MediaWiki (spasi diganti dengan garis bawah dan beberapa karakter diganti dengan kode-persen):



Sejak 1.15+, kata-kata tersebut bisa menerima parameter nama halaman penuh dan akan memberikan ruang nama yang diminta sesuai halaman itu, bukan sesuai halaman yang sekarang:

Parameter tidak boleh merupakan nama ruang nama:
 * &rarr; 
 * &rarr;  (Pages in main space will return empty)
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr; 
 * &rarr;   (Empty)

Fungsi parser
Fungsi parser bersifat mirip dengan variabel tetapi menerima satu atau lebih parameter (secara teknis, kata ajaib manapun yang menerima parameter merupakan sebuah fungsi parser), dan namanya biasanya diberi awalan tanda pagar untuk membedakannya dari templat.

Halaman ini hanya menjelaskan fungsi parser yang termasuk dalam perangkat lunak MediaWiki. Fungsi parser lainnya bisa ditambahkan menggunakan ekstensi MediaWiki seperti. Untuk fungsi parser yang begitu, lihat.

Ruang nama
memberikan nama lokal dari ruang nama dengan indeks tersebut, nama kanonik, atau alias lokal. Jadi,  , dan   (nama lama untuk ruang nama Berkas) semuanya akan memberikan "    ". Di wiki yang menggunakan bahasa Prancis sebagai bahasa konten,  juga valid, tapi   (lokalisasi "Berkas" dalam bahasa Jerman) tidaklah valid.

adalah ekuivalen yang dikodekan untuk URL MediaWiki. Yang dilakukan hampir sama, tapi fungsi itu juga mengganti spasi dengan garis bawah, membuatnya bisa dipakai di pranala luar.

Jangan samakan ruang nama lokal dengan ruang nama custom.

Pemformatan
Lihat pula:.

Lokalisasi
Berikut ini adalah kata-kata ajaib yang digunakan sebagai peralatan lokalisasi utama. Kata-kata ajaib lainnya kadang bergantung pada lokal dan konfigurasi wiki atau pada bahasa yang dipilihan: lihat terutama #Tanggal dan waktu, #Pemformatan, #Lain-lain. Kata ajaib lainnya ditambahkan menggunakan.

Penggunaan kata-kata ajaib berikut bisa jadi sangat rumit, dan dokumentasinya sekarang belum lengkap; ada lebih banyak info di PLURAL, GRAMMAR, GENDER.

Pengubah transklusi
biasanya mentransklusikan halaman lain, standarnya dari ruang nama Templat:. Kata-kata ajaib berikut mengubah perilaku tersebut.

Lain-lain
Untuk fungsi parser #invoke, lihat w:Wikipedia:Lua.