Bantuan:Kata ajaib

(Dialihkan dari Bantuan:Magic words)
 Seri Bantuan
Selamat datang! Halaman ini memberikan bantuan mengenai hal yang sering ditanyakan di Wikipedia. Untuk memulai, silakan mengeklik pranala yang Anda butuhkan di bawah ini, atau gunakan fitur pencari yang tersedia.

Kata ajaib adalah fitur dari teks wiki yang memungkinkan berbagai instruksi untuk diberikan ke perangkat lunak MediaWiki, misalkan untuk menampilkan variabel yang sering digunakan dalam menulis artikel atau dalam templat.

Jenis-jenis

Beberapa jenis kata ajaib adalah:

  1. Behavior switches: Kata ajaib jenis ini berbentuk sebuah kata yang ditulis menggunakan huruf kapital dan diapit oleh 2 (dua) garis bawah, contoh
  2. Variables atau variabel: Kata ajaib jenis ini berbentuk sebuah kata yang ditulis menggunakan huruf kapital dan dikelilingi oleh 2 (dua) tanda kurung kurawal sehingga terlihat seperti templat, contoh {{PAGENAME}}
  3. Parser functions atau fungsi parser: Kata ajaib jenis ini berbentuk sebuah kata yang dikelilingi oleh 2 (dua) tanda kurung kurawal dan diawali dengan tanda pagar (#), contoh {{#expr:2+2}}

Beberapa kata ajaib adalah case-insensitive, tetapi tidak semuanya. Ruang putih dilucuti dari awal dan kata kunci akhir dan parameter, seperti dalam sintaks templat.

Halaman yang tergantung kata-kata ajaib akan mempengaruhi atau mengembalikan data tentang halaman ini, even if the word is added through a transcluded template or included system message.

Behavior switches

  • __NOTOC__ (dapat muncul di mana saja di Wikitext tersebut; menekan daftar isi)
  • __FORCETOC__ (dapat muncul di mana saja di Wikitext tersebut; membuat daftar isi muncul dalam posisi normal di atas judul pertama)
  • __TOC__ (menempatkan daftar isi pada posisi kata itu)
  • __NOEDITSECTION__ (menyembunyikan bagian "edit" link di samping semua judul atau header pada halaman) (gunakan tag <h2> untuk menyembunyikan link edit untuk satu pos saja)
  • __NEWSECTIONLINK__ (menambahkan link "+" untuk menambahkan bagian baru pada halaman yang bukan-"Pembicaraan")
  • __NONEWSECTIONLINK__ (menghapus link "+" pada halaman "Pembicaraan" )
  • __NOGALLERY__ (pada halaman kategori, menggantikan thumbnail dengan link normal)
  • __HIDDENCAT__ (pada halaman kategori, membuatnya menjadi kategori tersembunyi)
  • __INDEX__ (memberitahu mesin pencari untuk mengindeks halaman)
  • __NOINDEX__ (memberitahu search engine tidak mengindeks halaman)
  • __STATICREDIRECT__ (Pada halaman redirect, jangan biarkan MediaWiki untuk secara otomatis memperbarui link ketika seseorang bergerak halaman dan cek "Update setiap pengalihan yang mengarah ke judul asli"​​, juga digunakan untuk memberitahu interwikibots bahwa redirect ini dapat dilihat sebagai sebuah artikel)

Variabel

  • {{ARTICLEPAGENAME}} (halaman non-pembicaraan dari halaman yang sekarang) (identik dengan {{SUBJECTPAGENAME}} )
  • {{ARTICLESPACE}} (ruang nama non-pembicaraan dari halaman yang sekarang) (identik dengan {{SUBJECTSPACE}} )
  • {{BASEPAGENAME}} (judul halaman tidak temasuk subhalaman yang sekarang dan ruang nama - dengan kata lain, judul halaman induk tanpa ruang namanya)
  • {{FULLPAGENAME}} (judul halaman termasuk ruang namanya)
  • {{NAMESPACE}} (ruang nama halaman yang sekarang)
  • {{PAGENAME}} (judul halaman tidak termasuk ruang namanya)
  • {{SUBJECTPAGENAME}} (halaman non-pembicaraan dari halaman yang sekarang) (identik dengan {{ARTICLEPAGENAME}} )
  • {{SUBJECTSPACE}} (ruang nama non-pembicaraan dari halaman yang sekarang) (identik dengan {{ARTICLESPACE}} )
  • {{SUBPAGENAME}} (bagian subhalaman dari judulnya)
  • {{TALKPAGENAME}} (halaman pembicaraan dari halaman yang sekaranag)
  • {{TALKSPACE}} (ruang nama pembicaraan dari halaman yang sekarang)
  • {{FULLPAGENAMEE}}, {{NAMESPACEE}} dll. (ekuivalen untuk dikodekan dan digunakan di URL MediaWIki)

Catatan: semua variabel sebelumnya masing-masing dapat mengambil parameter, untuk beroperasi pada halaman selain halaman saat ini. misalnya {{TALKPAGENAME:WP:MOS}} kembali ke "Pembicaraan Wikipedia:MOS".

  • {{SITENAME}} (Wikipedia)
  • {{SERVER}} (//id.wikipedia.org)
  • {{SERVERNAME}} (id.wikipedia.org)
  • {{SCRIPTPATH}} (/w)
  • {{CURRENTVERSION}} (versi MediaWiki yang sekarang)
  • {{REVISIONID}} (revisi terbaru untuk saat ini halaman-itu tidak dapat diganti dan juga tidak bekerja di pratinjau)
  • {{REVISIONDAY}}, {{REVISIONDAY2}}, {{REVISIONMONTH}}, {{REVISIONYEAR}}, {{REVISIONTIMESTAMP}}, {{REVISIONUSER}} (tanggal, waktu, dan penyunting di suntingan terbaru)
  • {{CURRENTYEAR}}, {{CURRENTMONTH}}, {{CURRENTMONTHNAME}}, {{CURRENTMONTHABBREV}}, {{CURRENTDAY}}, {{CURRENTDAY2}}, {{CURRENTDOW}}, {{CURRENTDAYNAME}}, {{CURRENTTIME}}, {{CURRENTHOUR}}, {{CURRENTWEEK}}, {{CURRENTTIMESTAMP}} (variabel tanggal/waktu)
  • {{LOCALYEAR}} dll. (seperti sebelumnya, berdasarkan waktu lokal situs)
  • {{NUMBEROFPAGES}}, {{NUMBEROFARTICLES}}, {{NUMBEROFFILES}}, {{NUMBEROFEDITS}}, {{NUMBEROFVIEWS}}, {{NUMBEROFUSERS}}, {{NUMBEROFADMINS}}, {{NUMBEROFACTIVEUSERS}} (statistik di Wikipedia ini; tambahkan :R untuk mendapatkan angka tanpa tanda koma)

Fungsi parser

Metadata

  • {{PAGEID}} (nomor pengenal halaman yang unik)
  • {{PAGESIZE:page name}} (ukuran halaman dalam satuan byte)
  • {{PROTECTIONLEVEL:action|pagename}} (tingkat perlindungan untuk tindakan yang diberikan di halaman yang disebutkan)
  • {{PENDINGCHANGELEVEL}} (tingkat perlindungan perubahan tertunda di halaman yang sekarang)
  • {{PAGESINCATEGORY:categoryname}} (banyak halaman dalam kategori yang diberikan)
  • {{NUMBERINGROUP:groupname}} (banyak pengguna dalam kelompok tertentu)

Tambahkan |R untuk mendapatkan angka tanpa tanda koma.

Pemformatan

  • {{lc:string}} (mengubah semuanya menjadi huruf kecil)
  • {{lcfirst:string}} (mengubah karakter pertama menjadi huruf kecil)
  • {{uc:string}} (mengubah semuanya menjadi huruf besar)
  • {{ucfirst:string}} (mengubah karakter pertama menjadi huruf besar)
  • {{formatnum:unformatted num}} (memformat angka dengan pemisah tanda koma; tambahkan |R untuk menghapus pemformatan tersebut). Separator ribuan harus dihilangkan
  • {{#formatdate:date|format}} (memformat tanggal sesuai preferensi pengguna; sebuah default bisa diberikan sebagai parameter peka-kapital opsional kedua bagi pengguna yang tidak punya preferensi tanggal; bisa mengubah tanggal dari format yang ada menjadi format dmy, mdy, ymd atau ISO 8601 manapun, dengan preferensi pengguna membatalkan format yang diberikan)
  • {{padleft:xyz|stringlength}}, {{padright:xyz|stringlength}} (mengisi dengan nol di kanan atau kiri; string pengisi alternatif bisa diberikan sebagai parameter ketiga; pengisi alternatif bisa jadi terpotong jika panjangnya tidak membagi rata banyak karakter yang diperlukan)
  • {{plural:n|is|are}} (menghasilkan teks alternatif apabila n lebih besar daripada 1)
  • {{#time:format string|date/time object}} (untuk pemformatan tanggal/waktu; juga #timel untuk waktu lokal. Dibahas di halaman dokumentasi ekstensi.)
  • {{gender:username|masculine|feminine|neutral}} (menghasilkan teks alternatif tergantung jenis kelamin yang diberikan di preferensi penggunanya)
  • {{#tag:tagname|content|parameter1=value1|parameter2=value2}} (ekuivalen dari sebuah atau sepasang tag HTML; bisa digunakan untuk membuat referensi di dalam referensi)

Jalur

  • {{localurl:page name}}, {{localurl:page name|query string}} (jalur relatif ke judul)
  • {{fullurl:page name}}, {{fullurl:page name|query_string}} (jalur absolut ke judul, tanpa prefiks protokol)
  • {{canonicalurl:page name}}, {{canonicalurl:page name|query_string}} (jalur absolut ke judul, dengan prefiks protokol)
  • {{filepath:file name}} (URL absolut ke berkas media)
  • {{urlencode:string}} (input dikodekan untuk digunakan di string kueri URL: seperti+ini)
    • {{urlencode:string|PATH}} (input dikodekan untuk digunakan di jalur URL: seperi%20ini)
    • {{urlencode:string|WIKI}} (input dikodekan untuk digunakan di nama halaman MediaWiki: seperti_ini)
  • {{anchorencode:string}} (input dikodekan untuk digunakan di jangkar bagian URL MediaWiki)
  • {{ns:n}} (nama dari ruang nama yang memiliki indeks n; lihat {{nse:}} untuk metode ekuivalen yang mengodekan untuk URL MediaWiki)
  • {{#rel2abs: path }} (mengubah jalur berkas relatif menjadi absolut; lihat dokumentasi ekstensi)
  • {{#titleparts: pagename | number of segments to return | first segment to return }} (membagi judul menjadi bagian-bagian; lihat dokumentasi ekstensi)

Ekspresi kondisional

  • {{#expr: expression }} (menghitung ekspresi yang diberikan; lihat Bantuan:Penghitungan)
  • {{#if: test string | value if non-empty | value if empty }} (memilih satu di antara dua nilai bergantung pada apakah string yang diuji kosong atau tidak)
  • {{#ifeq: string 1 | string 2 | value if equal | value if unequal }} (memilih satu di antara dua nilai bergantung apakah kedua string yang diuji sama atau tidak – secara numerik jika bisa)
  • {{#iferror: test string | value if error | value if correct }} (memilih nilai berdasarkan apakah string yang diuji menghasilkan kesalahan parser atau tidak)
  • {{#ifexpr: expression | value if true | value if false }} (memilih nilai berdasarkan penghitungan ekspresi)
  • {{#ifexist: page title | value if exists | value if doesn't exist }} (memilih nilai bergantung pada apakah judul halaman tersebut ada atau tidak)
  • {{#switch: test | case1 = value for case 1 | ... | default }} (memberikan berbagai alternatif sesuai dengan nilai yang mana yang menyamai string yang diuji)

Perhatikan bahwa dengan ekspresi #if:, variabel seperti {{{1}}} selalu membutuhkan pipa diujung: {{{1|}}}. Jika tidak ada, maka apabila parameter 1 dikosongkan, bukannya tidak menghasilkan apa-apa perangkat lunak malah akan menghasilkan teks {{{1}}} dan tidak akan bisa dikosongkan.

Untuk penggunaan fungsi-fungsi tersebut di tabel, lihat Bantuan:Tabel kondisional.

Untuk contoh dan penjelasan lebih lanjut, lihat Bantuan:Ekspresi kondisional dan Bantuan:Fungsi parser switch.

Lain-lain

Lihat pula