Bantuan:Template
Bantuan:Template adalah panduan teknis resmi mengenai penggunaan, pembuatan, dan pengelolaan Templat di Wikisporta.
Templat adalah fitur berdaya tinggi dalam perangkat lunak MediaWiki yang memungkinkan sebuah blok teks, kode wikitext, tabel, atau elemen antarmuka digunakan kembali di banyak halaman artikel secara berulang. Menggunakan templat membantu menjaga konsistensi tampilan, mempermudah pemeliharaan data, dan menghemat waktu penyuntingan.
1. Pengertian dan Ruang Nama Templat
Di Wikisporta, semua templat disimpan di dalam ruang nama (*namespace*) khusus, yaitu **`Templat:`** (atau **`Template:`** dalam bahasa Inggris).
A. Cara Kerja Transklusi
Proses memasukkan isi dari suatu templat ke dalam halaman artikel disebut transklusi. Ketika Anda menyisipkan kode templat pada suatu artikel, sistem MediaWiki akan membaca isi halaman templat tersebut secara otomatis dan menampilkannya di halaman artikel Anda secara *real-time*.
B. Sintaks Dasar Panggilan Templat
Untuk memanggil atau menyisipkan templat ke dalam halaman wikitext, gunakan kurung kurawa ganda `{{ }}`:
- Templat Tanpa Parameter:
* Kode: `
`
* Fungsi: Memanggil isi dari halaman `Templat:Reflist`.
- Templat Dengan Parameter:
* Kode: `Templat:IDN` * Fungsi: Memanggil bendera dan nama negara Indonesia.
2. Jenis-Jenis Templat Utama di Wikisporta
Templat di Wikisporta dikelompokkan berdasarkan fungsi dan peruntukannya:
A. Templat Kotak Info (*Infoboxes*)
Templat yang digunakan untuk menyajikan ringkasan data faktual di sudut kanan atas artikel (seperti profil atlet, statistik klub, atau arena pertandingan).
- Contoh: `Templat:Infobox Atlet`, `Templat:Infobox Klub Sepak Bola`.
- Panduan lengkap: Lihat Bantuan:Kotak info.
B. Templat Navigasi (*Navboxes*)
Templat kotak yang diletakkan di bagian paling bawah artikel untuk menyediakan daftar tautan cepat antar-artikel yang berada dalam satu topik/kategori yang sama.
C. Templat Pemeliharaan & Peringatan (*Maintenance Tags*)
Templat yang diletakkan di bagian atas artikel untuk memberi tahu pembaca dan penyunting lain mengenai status atau kualitas artikel tersebut.
- `Templat:Rintisan` — Menandai artikel yang masih sangat pendek (stub).
- `Templat:Butuh rujukan` — Menandai klaim kalimat yang belum memiliki rujukan.
- `
` — Menandai artikel yang melanggar Sudut Pandang Netral.
Artikel ini ini tidak netral, karena sebagian atau bahkan sepenuhnya teks artikel di dalam paragraf pada artikel ini cenderung terlalu memihak pada entitas di dalam artikel ini.
D. Templat Kutipan & Referensi (*Citation Templates*)
Templat yang digunakan untuk merapikan format penulisan catatan kaki dan rujukan sumber berita/buku.
- Contoh: ``, `Templat:Cite news`, `
`.
E. Templat Simbol & Bendera (*Flag Templates*)
Templat singkat untuk menampilkan ikon bendera dan nama negara secara otomatis dalam tabel statistik atau kotak info.
- `Templat:IDN` $\rightarrow$ Indonesia
- `
` $\rightarrow$ (menampilkan ikon bendera Brasil saja)
3. Cara Menggunakan Templat Berparameter
Sebagian besar templat yang kompleks menggunakan parameter untuk menerima data masukan dari penyunting.
A. Parameter Anonim / Posisional
Parameter yang diisi berdasarkan urutan posisinya, dipisahkan oleh tanda garis tegak (`|`).
- Kode: `20 Mei 1990 (umur 36)`
- Penjelasan: Angka `1990` adalah parameter 1 (tahun), `5` adalah parameter 2 (bulan), dan `20` adalah parameter 3 (tanggal).
B. Parameter Bernama (*Named Parameters*)
Parameter yang diisi dengan menyebutkan nama parameternya secara eksplisit diikuti tanda sama dengan (`=`).
- Kode:
{{Infobox Atlet
| nama = Taufik Hidayat
| cabang_olahraga = Bulu tangkis
| negara = Indonesia
}}
4. Panduan Membuat dan Menyunting Templat Baru
Jika Anda adalah penyunting berpengalaman atau pengurus yang ingin membuat templat baru di Wikisporta:
A. Langkah Membuat Halaman Templat
1. Ketik nama templat yang ingin dibuat pada kolom pencarian dengan awalan `Templat:` (contoh: `Templat:Infobox Olahraga Tradisional`). 2. Klik tautan merah untuk mulai membuat halaman baru. 3. Tuliskan kode wikitext atau HTML dasar templat tersebut.
B. Penggunaan Tag Spesial MediaWiki
Saat menyusun kode dasar di dalam halaman templat, gunakan tag berikut untuk mengontrol bagian mana yang ikut ter-transklusi ke artikel:
1. `` dan ``:
* Konten di dalam tag ini HANYA akan muncul di halaman templat itu sendiri dan TIDAK akan ikut muncul di artikel yang memanggil templat tersebut. * *Penggunaan:* Digunakan untuk menaruh dokumentasi templat, panduan cara pakai, dan kategori templat (``).
2. ``:
* Konten di dalam tag ini HANYA akan muncul di halaman artikel yang memanggil templat tersebut, dan TIDAK akan dieksekusi di halaman templat itu sendiri. * *Penggunaan:* Digunakan untuk menambahkan kategori artikel secara otomatis atau kode pemrosesan data.
C. Sintaks Parameter dalam Kode Templat
- Parameter posisional dalam kode templat ditulis dengan kurung kurawa tiga kali: `{{{1}}}`, `{{{2}}}`, dst.
- Parameter bernama dalam kode templat ditulis: `` (tanda garis tegak di dalam kurung kurawa berfungsi untuk memberikan nilai bawaan/kosong jika pengguna tidak mengisi parameter tersebut).
Contoh Kode Dasar Templat Sederhana (`Templat:Peringatan-Sederhana`):
<div style="border: 1px solid #f00; background-color: #fee; padding: 10px; margin: 10px 0;">
'''Peringatan:''' {{{1|Halaman ini sedang dalam pemeliharaan.}}}
</div><noinclude>
== Dokumentasi Templat ==
Gunakan templat ini untuk menampilkan kotak peringatan merah di atas artikel.
Contoh penggunaan: {{Peringatan-Sederhana|Konten ini butuh verifikasi.}}
[[Kategori:Templat Peringatan Wikisporta]]
</noinclude>
5. Praktik Terbaik Pengelolaan Templat
- Jangan Buat Templat Ganda: Sebelum membuat templat baru, periksa daftar templat yang sudah ada untuk menghindari duplikasi fungsi.
- Sediakan Dokumentasi yang Jelas: Setiap templat yang kompleks wajib memiliki bab dokumentasi di dalam tag `` agar penyunting lain tahu cara menggunakannya.
- Uji Coba Terlebih Dahulu: Gunakan Kotak Pasir atau halaman uji coba (*sandbox*) sebelum mengubah templat utama yang sudah digunakan di ratusan artikel untuk mencegah terjadinya eror massal (*breaking changes*).
--- Templat adalah fondasi penting dalam menjaga efisiensi dan keindahan tata letak di **Wikisporta**. Jika Anda membutuhkan bantuan pembuatan templat rumit, silakan tinggalkan pesan di Warung Kopi.