Bantuan:Kata ajaib: Perbedaan antara revisi
Konten dihapus Konten ditambahkan
Tidak ada ringkasan suntingan Tag: Suntingan perangkat seluler Suntingan peramban seluler Suntingan seluler lanjutan |
|||
(35 revisi perantara oleh 16 pengguna tidak ditampilkan) | |||
Baris 1:
{{Shortcut|Kata magis}}
{{Templat:Bantuan:Bantuan/seri tab}}<!-- templat ini hanya digunakan untuk halaman Bantuan: , bukan Wikipedia:-->
{{Templat:Bantuan:Bantuan/sidebar}}<!-- templat ini hanya digunakan untuk halaman Bantuan: , bukan Wikipedia:-->
{{redirect|WP:MAGIC|teks wiki|Bantuan:Magic}}
'''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:
# '''''[[Bantuan:Variabel#Behavior switches
# '''''Variables''''' atau '''{{WP|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 {{<
# '''''Parser functions''''' atau '''{{WP|fungsi parser}}''': Kata ajaib jenis ini berbentuk sebuah kata yang
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'' ==
{{hatnote|Untuk dokumentasi, lihat [[mw:Help:Magic words#Behavior switches|Behavior switches]] di situs MediaWiki.}}
* <code><nowiki>__NOTOC__</nowiki></code> (dapat muncul di mana saja di Wikitext tersebut; menekan daftar isi)
* <code><nowiki>__FORCETOC__</nowiki></code> (dapat muncul di mana saja di Wikitext tersebut; membuat daftar isi muncul dalam posisi normal di atas judul pertama)
* <code><nowiki>__TOC__</nowiki></code> (menempatkan daftar isi pada posisi kata itu)
* <code><nowiki>__NOEDITSECTION__</nowiki></code> (menyembunyikan bagian "edit" link di samping semua judul atau header pada halaman) (gunakan tag <nowiki><h2></nowiki> untuk menyembunyikan link edit untuk satu pos saja)
* <code><nowiki>__NEWSECTIONLINK__</nowiki></code> (menambahkan link "+" untuk menambahkan bagian baru pada halaman yang bukan-"Pembicaraan")
* <code><nowiki>__NONEWSECTIONLINK__</nowiki></code> (menghapus link "+" pada halaman "Pembicaraan" )
* <code><nowiki>__NOGALLERY__</nowiki></code> (pada halaman kategori, menggantikan thumbnail dengan link normal)
* <code><nowiki>__HIDDENCAT__</nowiki></code> (pada halaman kategori, membuatnya menjadi [[Bantuan:Kategori|kategori tersembunyi]])
* <code><nowiki>__INDEX__</nowiki></code> (memberitahu mesin pencari untuk mengindeks halaman)
* <code><nowiki>__NOINDEX__</nowiki></code> (memberitahu search engine tidak mengindeks halaman)
* <code><nowiki>__STATICREDIRECT__</nowiki></code> (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 ==
{{Utama|Bantuan:Variabel}}
{{hatnote|Untuk dokumentasi, lihat bagian [[mw:Help:Magic words#Variables|Variables]] di halaman MediaWiki.}}
* <code><nowiki>{{ARTICLEPAGENAME}}</nowiki></code> (halaman non-pembicaraan dari halaman yang sekarang) (identik dengan <nowiki>{{SUBJECTPAGENAME}}</nowiki> )
* <code><nowiki>{{ARTICLESPACE}}</nowiki></code> (ruang nama non-pembicaraan dari halaman yang sekarang) (identik dengan <nowiki>{{SUBJECTSPACE}}</nowiki> )
* <code><nowiki>{{BASEPAGENAME}}</nowiki></code> (judul halaman tidak temasuk [[Bantuan:Subhalaman|subhalaman]] yang ''sekarang'' dan ruang nama - dengan kata lain, judul halaman induk tanpa ruang namanya)
* <code><nowiki>{{FULLPAGENAME}}</nowiki></code> ([[Bantuan:Nama halaman|judul halaman]] termasuk [[Bantuan:Ruang nama|ruang nama]]nya)
* <code><nowiki>{{NAMESPACE}}</nowiki></code> (ruang nama halaman yang sekarang)
* <code><nowiki>{{PAGENAME}}</nowiki></code> (judul halaman tidak termasuk ruang namanya)
* <code><nowiki>{{SUBJECTPAGENAME}}</nowiki></code> (halaman non-pembicaraan dari halaman yang sekarang) (identik dengan <nowiki>{{ARTICLEPAGENAME}}</nowiki> )
* <code><nowiki>{{SUBJECTSPACE}}</nowiki></code> (ruang nama non-pembicaraan dari halaman yang sekarang) (identik dengan <nowiki>{{ARTICLESPACE}}</nowiki> )
* <code><nowiki>{{SUBPAGENAME}}</nowiki></code> (bagian subhalaman dari judulnya)
* <code><nowiki>{{TALKPAGENAME}}</nowiki></code> (halaman pembicaraan dari halaman yang sekaranag)
* <code><nowiki>{{TALKSPACE}}</nowiki></code> (ruang nama pembicaraan dari halaman yang sekarang)
* <code><nowiki>{{FULLPAGENAMEE}}, {{NAMESPACEE}}</nowiki></code> 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 <nowiki>{{TALKPAGENAME:WP:MOS}}</nowiki> kembali ke "{{TALKPAGENAME:WP:MOS}}"''.
* <code><nowiki>{{SITENAME}}</nowiki></code> ({{SITENAME}})
* <code><nowiki>{{SERVER}}</nowiki></code> ({{SERVER}})
* <code><nowiki>{{SERVERNAME}}</nowiki></code> ({{SERVERNAME}})
* <code><nowiki>{{SCRIPTPATH}}</nowiki></code> ({{SCRIPTPATH}})
* <code><nowiki>{{CURRENTVERSION}}</nowiki></code> (versi MediaWiki yang sekarang)
* <code><nowiki>{{REVISIONID}}</nowiki></code> (revisi terbaru untuk saat ini halaman-itu tidak dapat diganti dan juga tidak bekerja di pratinjau)
* <code><nowiki>{{REVISIONDAY}}, {{REVISIONDAY2}}, {{REVISIONMONTH}}, {{REVISIONYEAR}}, {{REVISIONTIMESTAMP}}, {{REVISIONUSER}}</nowiki></code> (tanggal, waktu, dan penyunting di suntingan terbaru)
* <code><nowiki>{{CURRENTYEAR}}, {{CURRENTMONTH}}, {{CURRENTMONTHNAME}}, {{CURRENTMONTHABBREV}}, {{CURRENTDAY}}, {{CURRENTDAY2}}, {{CURRENTDOW}}, {{CURRENTDAYNAME}}, {{CURRENTTIME}}, {{CURRENTHOUR}}, {{CURRENTWEEK}}, {{CURRENTTIMESTAMP}}</nowiki></code> (variabel tanggal/waktu)
* <code><nowiki>{{LOCALYEAR}}</nowiki></code> dll. (seperti sebelumnya, berdasarkan waktu lokal situs)
* <code><nowiki>{{NUMBEROFPAGES}}, {{NUMBEROFARTICLES}}, {{NUMBEROFFILES}}, {{NUMBEROFEDITS}}, {{NUMBEROFVIEWS}}, {{NUMBEROFUSERS}}, {{NUMBEROFADMINS}}, {{NUMBEROFACTIVEUSERS}}</nowiki></code> (statistik di Wikipedia ini; tambahkan <code>:R</code> untuk mendapatkan angka tanpa tanda koma)
== Fungsi parser ==
{{Shortcut|WP:PF}}
{{hatnote|Untuk dokumentasi, lihat [[mw:Help:Magic words|halaman kata ajaib MediaWiki]] atau [[mw:Help:Extension:ParserFunctions|halaman ekstensi ParserFunctions]], kecuali bila dikatakan sebaliknya.}}
=== Metadata ===
* <code><nowiki>{{PAGEID}}</nowiki></code> (nomor pengenal halaman yang unik)
* <code><nowiki>{{PAGESIZE:</nowiki>''page name''<nowiki>}}</nowiki></code> (ukuran halaman dalam satuan byte)
* {{anchor|PROTECTIONLEVEL}}<code><nowiki>{{PROTECTIONLEVEL:</nowiki>''action''<nowiki>|</nowiki>''pagename''<nowiki>}}</nowiki></code> (tingkat perlindungan untuk tindakan yang diberikan di halaman yang disebutkan)
* <code><nowiki>{{PENDINGCHANGELEVEL}}</nowiki></code> (tingkat perlindungan [[Wikipedia:Perubahan tertunda|perubahan tertunda]] di halaman yang sekarang)
* <code><nowiki>{{PAGESINCATEGORY:</nowiki>''categoryname''<nowiki>}}</nowiki></code> (banyak halaman dalam [[Bantuan:Kategori|kategori]] yang diberikan)
* <code><nowiki>{{NUMBERINGROUP:</nowiki>''groupname''<nowiki>}}</nowiki></code> (banyak pengguna dalam [[Wikipedia:Kelompok pengguna|kelompok]] tertentu)
Tambahkan <code>|R</code> untuk mendapatkan angka tanpa tanda koma.
=== Pemformatan ===
* <code><nowiki>{{lc:</nowiki>''string''<nowiki>}}</nowiki></code> (mengubah semuanya menjadi huruf kecil)
* <code><nowiki>{{lcfirst:</nowiki>''string''<nowiki>}}</nowiki></code> (mengubah karakter pertama menjadi huruf kecil)
* <code><nowiki>{{uc:</nowiki>''string''<nowiki>}}</nowiki></code> (mengubah semuanya menjadi huruf besar)
* <code><nowiki>{{ucfirst:</nowiki>''string''<nowiki>}}</nowiki></code> (mengubah karakter pertama menjadi huruf besar)
* <code><nowiki>{{formatnum:</nowiki>''unformatted num''<nowiki>}}</nowiki></code> (memformat angka dengan pemisah tanda koma; tambahkan <code><nowiki>|</nowiki>R</code> untuk menghapus pemformatan tersebut). Separator ribuan harus dihilangkan
** Baca di [https://wiki-indonesia.club/w/index.php?title=Pembicaraan_Bantuan:Kata_ajaib&oldid=21274613#Masalah_pada_formatnum_di_berbagai_templat halaman pembicaraan] untuk permasalahan tentang formatnum dan solusinya.
* <code><nowiki>{{#formatdate:</nowiki>''date''|''format''<nowiki>}}</nowiki></code> (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 <code>dmy</code>, <code>mdy</code>, <code>ymd</code> atau <code>ISO 8601</code> manapun, dengan preferensi pengguna membatalkan format yang diberikan)
* <code><nowiki>{{padleft:xyz|</nowiki>''stringlength''<nowiki>}}</nowiki></code>, <code><nowiki>{{padright:xyz|</nowiki>''stringlength''<nowiki>}}</nowiki></code> (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)
* <code><nowiki>{{plural:</nowiki>''n''|''is''<nowiki>|</nowiki>''are''<nowiki>}}</nowiki></code> (menghasilkan teks alternatif apabila ''n'' lebih besar daripada 1)
* <code><nowiki>{{#time:</nowiki>''format string''|''date/time object''<nowiki>}}</nowiki></code> (untuk pemformatan tanggal/waktu; juga <code>#timel</code> untuk waktu lokal. Dibahas di [[mw:Help:Extension:ParserFunctions##time|halaman dokumentasi ekstensi]].)
* <code><nowiki>{{gender:</nowiki>''username''|''masculine''|''feminine''|''neutral''}}</code> (menghasilkan teks alternatif tergantung jenis kelamin yang diberikan di preferensi penggunanya)
* <code><nowiki>{{#tag:</nowiki>''tagname''|''content''|''parameter1''=''value1''|''parameter2''=''value2''}}</code> (ekuivalen dari sebuah atau sepasang tag HTML; bisa digunakan untuk membuat [[Bantuan:Catatan kaki|referensi di dalam referensi]])
=== Jalur ===
* <code><nowiki>{{localurl:</nowiki>''page name''<nowiki>}}</nowiki></code>, <code><nowiki>{{localurl:</nowiki>''page name''<nowiki>|</nowiki>''query string''<nowiki>}}</nowiki></code> (jalur relatif ke judul)
* <code><nowiki>{{fullurl:</nowiki>''page name''<nowiki>}}</nowiki></code>, <code><nowiki>{{fullurl:</nowiki>''page name''<nowiki>|</nowiki>''query_string''<nowiki>}}</nowiki></code> (jalur absolut ke judul, tanpa prefiks protokol)
* <code><nowiki>{{canonicalurl:</nowiki>''page name''<nowiki>}}</nowiki></code>, <code><nowiki>{{canonicalurl:</nowiki>''page name''<nowiki>|</nowiki>''query_string''<nowiki>}}</nowiki></code> (jalur absolut ke judul, dengan prefiks protokol)
* <code><nowiki>{{filepath:</nowiki>''file name''<nowiki>}}</nowiki></code> (URL absolut ke berkas media)
* <code><nowiki>{{urlencode:</nowiki>''string''<nowiki>}}</nowiki></code> (input dikodekan untuk digunakan di string kueri URL: {{urlencode:seperti ini}})
** <code><nowiki>{{urlencode:</nowiki>''string''<nowiki>|PATH}}</nowiki></code> (input dikodekan untuk digunakan di jalur URL: {{urlencode:seperi ini|PATH}})
** <code><nowiki>{{urlencode:</nowiki>''string''<nowiki>|WIKI}}</nowiki></code> (input dikodekan untuk digunakan di nama halaman MediaWiki: {{urlencode:seperti ini|WIKI}})
* <code><nowiki>{{anchorencode:</nowiki>''string''<nowiki>}}</nowiki></code> (input dikodekan untuk digunakan di jangkar bagian URL MediaWiki)
* <code><nowiki>{{ns:</nowiki>''n''<nowiki>}}</nowiki></code> (nama dari [[Bantuan:Ruang nama|ruang nama]] yang memiliki indeks ''n''; lihat <code><nowiki>{{nse:}}</nowiki></code> untuk metode ekuivalen yang mengodekan untuk URL MediaWiki)
* <code><nowiki>{{#rel2abs:</nowiki> ''path'' <nowiki>}}</nowiki></code> (mengubah jalur berkas relatif menjadi absolut; lihat [[mw:Help:Extension:ParserFunctions|dokumentasi ekstensi]])
* <code><nowiki>{{#titleparts:</nowiki> ''pagename'' | ''number of segments to return'' | ''first segment to return'' <nowiki>}}</nowiki></code> (membagi judul menjadi bagian-bagian; lihat [[mw:Help:Extension:ParserFunctions|dokumentasi ekstensi]])
=== Ekspresi kondisional ===
{{hatnote|Untuk dokumentasi, lihat [[mw:Help:Extension:ParserFunctions|halaman Ekstensi ParserFunctions]]. Perhatikan bahwa beberapa parameter bersifat opsional.}}
* <code><nowiki>{{#expr:</nowiki> ''expression'' <nowiki>}}</nowiki></code> (menghitung ekspresi yang diberikan; lihat [[Bantuan:Penghitungan]])
* <code><nowiki>{{#if:</nowiki> ''test string'' | ''value if non-empty'' | ''value if empty'' <nowiki>}}</nowiki></code> (memilih satu di antara dua nilai bergantung pada apakah string yang diuji kosong atau tidak)
* <code><nowiki>{{#ifeq:</nowiki> ''string 1'' <nowiki>|</nowiki> ''string 2'' <nowiki>|</nowiki> ''value if equal'' <nowiki>|</nowiki> ''value if unequal'' <nowiki>}}</nowiki></code> (memilih satu di antara dua nilai bergantung apakah kedua string yang diuji sama atau tidak – secara numerik jika bisa)
* <code><nowiki>{{#iferror:</nowiki> ''test string'' <nowiki>|</nowiki> ''value if error'' <nowiki>|</nowiki> ''value if correct'' <nowiki>}}</nowiki></code> (memilih nilai berdasarkan apakah string yang diuji menghasilkan kesalahan parser atau tidak)
* <code><nowiki>{{#ifexpr:</nowiki> ''expression'' <nowiki>|</nowiki> ''value if true'' <nowiki>|</nowiki> ''value if false'' <nowiki>}}</nowiki></code> (memilih nilai berdasarkan penghitungan ekspresi)
* <code><nowiki>{{#ifexist:</nowiki> ''page title'' | ''value if exists'' | ''value if doesn't exist'' <nowiki>}}</nowiki></code> (memilih nilai bergantung pada apakah judul halaman tersebut ada atau tidak)
* <code><nowiki>{{#switch:</nowiki> ''test'' | ''case1'' = ''value for case 1'' | ... | ''default'' <nowiki>}}</nowiki></code> (memberikan berbagai alternatif sesuai dengan nilai yang mana yang menyamai string yang diuji)
Perhatikan bahwa dengan ekspresi <code>#if:</code>, variabel seperti <code><nowiki>{{{1}}}</nowiki></code> selalu membutuhkan pipa diujung: <code><nowiki>{{{1|}}}</nowiki></code>. Jika tidak ada, maka apabila parameter 1 dikosongkan, bukannya tidak menghasilkan apa-apa perangkat lunak malah akan menghasilkan teks ''<code>{{{1}}}</code>'' 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 ===
* <code><nowiki>{{#babel:</nowiki> ''babelcode1'' | ''babelcode2'' | ... <nowiki>}}</nowiki></code> (pengganti tabel {{tlx|babel}}; lihat [[mw:Extension:Babel#Usage|Extensi:Babel]])
* <code><nowiki>{{#coordinates:</nowiki> ''arg1'' | ''arg2'' | ... <nowiki>}}</nowiki></code> (lihat [[mw:Extension:GeoData|Extensi:GeoData]])
* <code><nowiki>{{#invoke:</nowiki> ''module'' | ''function'' | ''arg1'' | ''arg2'' | ... <nowiki>}}</nowiki></code> (memanggil fungsi yang terletak di modul Scribunto; lihat [[Wikipedia:Lua]])
* <code><nowiki>{{#language:</nowiki> ''code1'' | ''code2'' <nowiki>}}</nowiki></code> (mengubah kode bahasa menjadi nama bahasa; lihat [[mw:Help:Magic words#Miscellaneous]])
** <code><nowiki>{{#language:ar}}</nowiki></code> → {{#language:ar}}
** <code><nowiki>{{#language:ar|en}}</nowiki></code> → {{#language:ar|en}}
** <code><nowiki>{{#language:ar|fr}}</nowiki></code> → {{#language:ar|fr}}
* <code><nowiki>{{#property:</nowiki> ''arg1'' | ''arg2'' | ... <nowiki>}}</nowiki></code> (lihat [[m:Wikidata/Notes/Inclusion syntax v0.3]])
== Lihat pula ==
* [[mw:Localisation]]
* [[mw:Manual:Extending wiki markup]]
* [http://svn.wikimedia.org/viewvc/mediawiki/trunk/phase3/includes/parser/CoreParserFunctions.php?view=log CoreParserFunctions.php]
* [[:en:User:Cacycle/wikEd|wikEd]], sebuah penyunting MediaWiki dengan penyorotan sintaks untuk templat dan fungsi parser
* [[Bantuan:Fungsi parser]]
* [[Bantuan:ParserFunctions]]
{{Navbox Gabungan Pedoman WBI}}
[[Kategori:Bantuan Wikipedia]]
|