Wikipedia:Ruang nama templat
- Halaman ini tidak sama dengan Templat:Ruang nama
Halaman ini merupakan pedoman di Wikipedia bahasa Indonesia. Isinya telah diterima luas oleh para pengguna dan dianggap sebagai standar yang harus diikuti oleh semua pengguna, meskipun sebaiknya dipahami dengan akal sehat, dan pengecualian dapat berlaku sewaktu-waktu. Segala penyuntingan substansial yang dilakukan di halaman ini harus menggambarkan konsensus. Jika Anda ragu, diskusikan terlebih dahulu di halaman pembicaraan. |
Ruang nama | |||
---|---|---|---|
Ruang nama subjek | Ruang nama pembicaraan | ||
0 | (Utama/Artikel) | Pembicaraan | 1 |
2 | Pengguna | Pembicaraan Pengguna | 3 |
4 | Wikipedia | Pembicaraan Wikipedia | 5 |
6 | Berkas | Pembicaraan Berkas | 7 |
8 | MediaWiki | Pembicaraan MediaWiki | 9 |
10 | Templat | Pembicaraan Templat | 11 |
12 | Bantuan | Pembicaraan Bantuan | 13 |
14 | Kategori | Pembicaraan Kategori | 15 |
100 | Portal | Pembicaraan Portal | 101 |
126 | MOS | Pembicaraan MOS | 127 |
710 | TimedText | TimedText talk | 711 |
828 | Modul | Pembicaraan Modul | 829 |
2600 | Topik | 2601 | |
Tidak digunakan lagi | |||
2300 | [[Wikipedia:Perkakas|]] | 2301 | |
2302 | [[Wikipedia:Perkakas|]] | 2303 | |
Tidak dipasang | |||
90 | Thread | Thread talk | 91 |
92 | Summary | Summary talk | 93 |
108 | Buku | 109 | |
118 | Draf | 119 | |
442 | Course | Course talk | 443 |
444 | Institution | Institution talk | 445 |
446 | Program pendidikan | 447 | |
Dalam fitur beta | |||
1074 | Story | Pembicaraan Story | 1075 |
Ruang nama virtual | |||
-1 | Istimewa | ||
-2 | Media | ||
Daftar saat ini (panggilan API) |
Ruang nama Templat di Wikipedia digunakan untuk menyimpan templat, yang berisi markah Wiki yang dimaksudkan untuk dimasukkan ke dalam beberapa halaman, biasanya melalui transklusi. Meskipun ruang nama Templat digunakan untuk meletakkan sebagian besar templat, namun ada kemungkinan untuk menyisipkan dan mengganti dari ruang nama lain,[1] sehingga beberapa halaman templat diletakkan di ruang nama lain, seperti ruang nama Pengguna.
Templat membantu mempertahankan format yang konsisten dan membantu navigasi antar artikel. Templat sering kali menyertakan elemen opsional dan/atau variabel yang dikontrol oleh parameter untuk memungkinkan penggunaan secara khusus. Templat juga digunakan untuk membantu berbagai macam tugas pemeliharaan Wikipedia. Setiap templat memiliki halaman Pembicaraan templat:
yang sesuai di mana para penyunting dapat mendiskusikan desain dan implementasi templat terkait (lihat Bantuan:Menggunakan halaman pembicaraan untuk mengetahui cara berpartisipasi dalam diskusi halaman pembicaraan).
Templat disisipkan ke halaman lain dengan menyertakan tag templat di dalam konten halaman tersebut. Tag templat berisi nama halaman templat yang dikelilingi oleh tanda kurung kurawal ganda, misalnya {{Disambiguasi}}
. Jika nama halaman templat tidak diawali dengan ruang nama dan titik dua, maka diasumsikan berada di dalam ruang nama Templat.
Pranala internal ke halaman templat dapat dibuat dengan menggunakan awalan Templat:
, misalnya [[Templat:Disambiguasi]]
. Pranala ini menuju ke halaman yang secara langsung berisi templat dasar dan sering kali dokumentasi.
Panduan
sunting- Templat biasanya tidak boleh digunakan untuk menyimpan teks artikel, karena hal ini akan mempersulit pengeditan konten. Templat juga tidak boleh digunakan untuk "menutup" atau "menyembunyikan" konten dari pembaca.
- Templat yang digunakan di artikel dirancang untuk menyediakan informasi untuk membantu pembaca, seperti alat bantu navigasi, pemformatan, atau peringatan bahwa konten di bawah standar. Templat yang hanya menyediakan informasi layanan kepada penyunting tidak boleh muncul di halaman artikel - gunakan halaman pembicaraan artikel atau ruang nama non-artikel lainnya.
- Fungsi templat harus jelas dari nama templatnya, tetapi pengalihan dapat dibuat untuk membantu penggunaan sehari-hari dari templat yang sangat populer.
- Templat berisiko tinggi harus dilindungi sebagian atau dilindungi sepenuhnya sesuai kebutuhan (lihat Wikipedia:Kebijakan perlindungan). Hal ini juga berlaku untuk pengalihan templat yang sering digunakan.
- Templat harus didokumentasikan dengan jelas mengenai penggunaan dan cakupannya.
- Templat tidak boleh digunakan untuk membuat daftar tautan ke artikel lain ketika kategori, halaman daftar, atau daftar bagian "Lihat juga" dapat melakukan fungsi yang sama.
- Templat untuk pesan singkat dan sementara yang akan dihapus dengan cepat (seperti pada halaman Pembicaraan_pengguna:) atau yang berisi teks yang kemungkinan besar tidak akan pernah diubah harus dipanggil dengan substitusi atau ganti (subst: atau gnt:). Templat tipikal yang ditujukan untuk penggunaan jangka panjang dan kemungkinan besar memerlukan perubahan harus disisipkan untuk memudahkan pembaruan di masa mendatang.
- Templat yang melanggar pedoman di halaman ini, memiliki fungsi yang kurang jelas, berlebihan, menjadi yatim piatu atau hanya digunakan di satu halaman, atau melanggar kebijakan Wikipedia dapat dicalonkan untuk dihapus di Wikipedia:Templat untuk didiskusikan.
Saran penerapan
suntingMerujuk ke templat
suntingTerkadang Anda ingin merujuk ke sebuah template, daripada benar-benar memanggilnya. Cara mudah untuk melakukannya adalah dengan memanggil Templat:Tl (kependekan dari "template link"). Sebagai contoh, untuk mereferensikan templat Perapian, mengetik {{tl|Rapikan}}
akan menghasilkan {{Rapikan}}. Anda juga dapat menambahkan parameter menggunakan Templat:Tlp; sebagai contoh, {{tlp|Convert|1|m}}
akan menghasilkan {{Convert|1|m}}.
Lihat dokumentasi templat di Templat:Tl untuk opsi lain, seperti {{tlb}} (cetak tebal), {{tlx}}
(kode), dan masih banyak lagi.
Nama templat
suntingNama templat dapat terdiri dari satu kata atau lebih, seperti {{Perkeretaapian}}
. Karakter mungkin saja tidak menggunakan huruf besar/kecil, jadi {{rapikan}}
dan {{Rapikan}}
adalah templat yang sama, namun {{cfd}}
dan {{cfD}}
tidak. Nama templat paling mudah diingat jika mengikuti ejaan, spasi, dan huruf besar bahasa Indonesia yang baku (lihat juga pedoman penamaan artikel). Hindari memiliki templat yang namanya hanya berbeda dalam huruf besar kecil, spasi, atau tanda baca.
Bak pasir untuk uji coba
suntingJika Anda ingin bereksperimen dengan templat (dan tidak ingin eksperimen Anda dihapus sebelum selesai), Anda dapat melakukannya di bak pasir templat. Anda juga dapat menggunakan templat X1, X2, X3, X4, X5, X6, X7, X8, X9, X10, X11, dan X12 untuk tujuan eksperimen. Untuk menyertakan templat uji, gunakan bentuk {{X1}}
untuk templat X1, {{X2}}
untuk templat X2, dst.
Templat yang ada saat ini sering kali memiliki kotak pasir dan halaman kasus uji coba sendiri (terutama yang menggunakan {{Dokumentasi}}). Perubahan harus diuji secara menyeluruh di sana sebelum diterapkan ke templat utama, untuk mencegah galat yang tidak disengaja pada banyak halaman.
Keterbacaan
suntingUntuk templat yang menggunakan banyak parameter, akan sangat membantu jika Anda menempatkan setiap parameter pada baris terpisah dan menyelaraskan dengan tanda sama dengan. Hal ini membantu penyunting di masa depan untuk lebih mudah membaca wikicode.
{{Contoh nama templat | parameter_pertama = Teks dari nilai_pertama | parameter_kedua = Teks dari nilai_kedua | parameter_ketiga = Teks dari parameter_ketiga | dst = dst }}
Jeda baris
suntingBeberapa templat mungkin secara tidak sengaja menyebabkan jeda baris tambahan pada artikel yang dirender. Hal ini terutama terjadi pada templat kotak info dan kotak templat lainnya yang biasanya mengambang di sisi kanan artikel, karena baris tambahan tidak akan terlihat di halaman templat. Untuk informasi lebih lanjut, lihat Bantuan:Penanganan jeda baris.
Sebagai pedoman umum, hindari dua jeda baris yang berdekatan dalam templat Anda. Ini dapat "bertambah" dengan jeda baris lain dalam artikel dan ditampilkan sebagai ruang putih yang tidak diinginkan.
Substitusi
suntingMemanggil templat menggunakan form
{{subst:nama templat (|parameter |...)}}
(yaitu, memasukkan subst:
segera setelah pasangan kurung kurawal pembuka) akan membuat salinan teks templat dan menempatkannya di halaman, di mana teks tersebut akan dapat dilihat di sumbernya. Templat tidak lagi disisipkan dan perubahan di masa mendatang pada templat tidak akan mengubah teks. Sebagai pedoman, metode ini sebaiknya digunakan untuk pesan singkat dan sementara yang akan dihapus dengan cepat, seperti pada halaman pembicaraan_pengguna: Pesan {{Selamat datang}}
standar untuk pengguna baru adalah contoh yang tepat.
Gunakan subst: juga jika Anda perlu mengedit pesan setelah memasukkannya ke dalam halaman. Jika Anda tidak perlu mengeditnya, dan lebih suka pesan diperbarui secara otomatis bersama dengan perubahan yang dibuat pada templat, jangan gunakan subst:.
Dokumentasi
suntingKarena template merupakan langkah yang lebih sulit bagi editor pemula, dokumentasi harus disediakan yang menjelaskan penggunaannya (parameter opsional) dan cakupannya (di mana seharusnya digunakan). Ada dua cara yang berbeda untuk melakukan hal ini:
Salah satu alternatifnya adalah dengan menggunakan <noinclude> untuk menambahkan deskripsi kecil langsung ke dalam templat, misalnya:
Ini adalah sebuah artikel {{{1}}}.'''<noinclude> Letakkan templat ini di setiap artikel yang membutuhkan deskripsi. Ini membutuhkan satu parameter, sebuah kata sifat yang digunakan untuk mendeskripsikan artikel. Sebagai contoh, {{article-describe|bad}} menghasilkan teks, '''Ini adalah artikel yang buruk.''' </noinclude>
Alternatif lain adalah membuat subhalaman subhalaman /doc untuk dokumentasi (lebih disukai untuk templat dengan banyak parameter, dll.) dan menambahkan <noinclude>{{Dokumentasi}}</noinclude>
setelah templat yang sebenarnya. Tag "noinclude" pertama harus ditempatkan pada baris yang sama dengan tanda kurung akhir dari templat yang sebenarnya dengan cara berikut:
{{(nama template) (parameter yang di berikan) }}<noinclude>...
Jika tag "noinclude" dimulai pada baris di bawah tanda kurung penutup templat, maka spasi yang tidak diinginkan akan muncul di bagian bawah templat saat digunakan di artikel dan halaman lain.
Modul
suntingModul Lua terkadang digunakan sebagai pengganti templat untuk menyimpan materi yang dapat digunakan kembali. Alasannya antara lain karena penggunaan fitur khusus modul seperti perulangan atau nilai tersimpan, dan kode yang rumit sering kali lebih mudah dibaca dan dipelihara dalam modul. Jika sebuah modul mudah diimplementasikan dalam sebuah templat, maka modul tersebut seharusnya demikian, karena ada lebih banyak pengguna yang berpengalaman mengedit templat.
Jika sebuah modul dimaksudkan untuk digunakan di artikel atau halaman pembicaraan, sebuah pembungkus templat biasanya dibuat untuk menyederhanakan penggunaan tanpa secara langsung membutuhkan fungsi #invoke
parser. Dokumentasi biasanya ditempatkan di halaman /doc templat, dengan dokumentasi modul yang mengarah ke templat dan/atau menjelaskan detail teknis lebih lanjut yang tidak diperlukan di dokumentasi templat utama.
Sejarah
suntingSecara historis, awalan "msg:" harus ditambahkan di depan nama templat ketika digunakan pada halaman. Sebagai contoh, {{msg:stub}} was typed instead of {{stub}}. Hal ini sekarang sudah tidak diperlukan lagi.
Pada 35 bulan pertama Wikipedia, tidak ada templat atau mekanisme transklusi sama sekali. Halaman Wikipedia: Boilerplate text dibuat pada bulan September 2002 untuk mengumpulkan teks yang sering digunakan dalam berbagai proses Wikipedia. Ruang nama MediaWiki diperkenalkan bersama dengan MediaWiki 1.2.6 pada tanggal 6 Desember 2003, dan digunakan tidak hanya untuk antarmuka pengguna tetapi juga untuk membuat pesan teks boilerplate yang akan disisipkan di dalam artikel menggunakan sintaks {{msg: ...}}. Fungsi ini digantikan dengan ruang nama Templat selama pemutakhiran perangkat lunak ke MediaWiki 1.3 pada tanggal 30 Mei 2004. Sebagai fungsi dari "Skrip awal ruang nama Templat", semua pesan non-sistem dipindahkan ke ruang nama yang baru. Skrip awal juga menggantikan rujukan MediaWiki: di artikel dengan Template: untuk mem-bypass pengalihan yang dibuat oleh pemindahan tersebut.
Untuk waktu yang singkat, Wikipedia:Artikel yang akan dihapus (yang kemudian dikenal sebagai votes for deletion atau VfD) menggunakan pesan MediaWiki: yang diberi nama dengan format "MediaWiki:VfD-nama artikel". Ini dipindahkan ke ruang Templat: pada bulan Juni 2004 dan diberi nama "Template:VfD-Nama artikel" . Penggunaan ini sudah tidak digunakan lagi dan digantikan dengan subhalaman.
- ^ Ruang nama yang tidak diizinkan untuk disisipi ditentukan pada sebuah wiki dengan variabel $wgNonincludableNamespaces