Wikipedia:Ruang nama templat

Dari Wikipedia bahasa Indonesia, ensiklopedia bebas
Halaman ini tidak sama dengan Templat:Ruang nama
Struktur data Wikipedia
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
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.

  • 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[sunting sumber]

Merujuk ke templat[sunting sumber]

Terkadang 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}}.

Lihat dokumentasi templat di Templat:Tl untuk opsi lain, seperti {{tlb}} (cetak tebal), {{tlx}} (kode), dan masih banyak lagi.

Nama templat[sunting sumber]

Nama 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[sunting sumber]

Jika 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[sunting sumber]

Untuk 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[sunting sumber]

Beberapa 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[sunting sumber]

Memanggil 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[sunting sumber]

Karena 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[sunting sumber]

Modul 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.

  1. ^ Ruang nama yang tidak diizinkan untuk disisipi ditentukan pada sebuah wiki dengan variabel $wgNonincludableNamespaces