Lihat sumber Wikipedia:Ruang nama templat

{{Sedang ditulis}}

{{for|Untuk mengetahui cara kerja templat|Bantuan:Panduan singkat mengenai templat|Bantuan:Templat}}
{{for|Untuk informasi teknis yang lebih lengkap|m:Help:Template|m:Help:Advanced templates}}
:''Halaman ini tidak sama dengan [[Templat:Ruang nama]]''
{{Subcat guideline|WP:TMP|WP:RN10}}
{{Nutshell| 
* Templat: Ruang nama di Wikipedia yang berisi templat yang dibuat untuk pemformatan, pemeliharaan, dan navigasi yang konsisten.
* Templat biasanya tidak boleh digunakan untuk menaruh [[Wikipedia:Apa yang dinamakan artikel|teks artikel]]. Konten seperti itu ada di halaman artikel itu sendiri.
}}
<!-- {{Guideline list}} -->
{{namespaces}}

'''Ruang nama Templat''' di Wikipedia digunakan untuk menyimpan [[Bantuan:Templat|templat]], yang berisi [[Wikipedia:Markah wiki|markah Wiki]] yang dimaksudkan untuk dimasukkan ke dalam beberapa halaman, biasanya melalui [[Bantuan:Transklusi|transklusi]]. Meskipun ruang nama Templat digunakan untuk meletakkan sebagian besar templat, namun ada kemungkinan untuk menyisipkan dan mengganti dari ruang nama lain,<ref>Ruang nama yang tidak diizinkan untuk disisipi ditentukan pada sebuah wiki dengan variabel [[mw:Manual:$wgNonincludableNamespaces|$wgNonincludableNamespaces]]</ref> 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 [[Bantuan:Templat#Parameter|parameter]] untuk memungkinkan penggunaan secara khusus. Templat juga digunakan untuk membantu berbagai macam tugas [[Wikipedia:Pemeliharaan|pemeliharaan Wikipedia]]. Setiap templat memiliki halaman <code>Pembicaraan templat:</code> yang sesuai di mana para penyunting dapat mendiskusikan desain dan implementasi templat terkait (lihat [[Wikipedia:Halaman pembicaraan|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 [[WP:Nama Halaman|nama halaman]] templat yang dikelilingi oleh tanda kurung kurawal ganda, misalnya {{tlc|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 <code>Templat:</code>, misalnya <code><nowiki>[[Templat:Disambiguasi]]</nowiki></code>. Pranala ini menuju ke halaman yang secara langsung berisi templat dasar dan sering kali dokumentasi.

== Panduan ==
{{further|Wikipedia:Jangan ragu menyunting artikel}}
* Templat biasanya tidak boleh digunakan untuk menyimpan [[Wikipedia:Apa yang dinamakan artikel|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 [[Wikipedia:Ruang nama templat#Nama templat|nama templatnya]], tetapi [[Wikipedia:Pengalihan|pengalihan]] dapat dibuat untuk membantu penggunaan sehari-hari dari templat yang sangat populer.
* [[Wikipedia:Templat berisiko tinggi|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 [[Wikipedia:Ruang nama templat#Dokumentasi|didokumentasikan]] dengan jelas mengenai penggunaan dan cakupannya.
* Templat tidak boleh digunakan untuk membuat daftar tautan ke artikel lain ketika [[Wikipedia:Kategori, daftar, dan templat navigasi#Kategori|kategori]], [[Wikipedia:Kategori, daftar, dan templat navigasi#Daftar|halaman daftar]], atau daftar [[Wikipedia:Pedoman tata letak#Bagian lihat pula|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 [[Wikipedia:Ruang nama templat#Substitusi|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 ==
=== Merujuk ke templat ===
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 <code><nowiki>{{tl|Rapikan}}</nowiki></code> akan menghasilkan {{tl|Rapikan}}. Anda juga dapat menambahkan parameter menggunakan [[Templat:Tlp]]; sebagai contoh, <code><nowiki>{{tlp|Convert|1|m}}</nowiki></code> akan menghasilkan {{tlp|Convert|1|m}}. 

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

=== Nama templat ===
Nama templat dapat terdiri dari satu kata atau lebih, seperti {{tlc|Perkeretaapian}}. Karakter mungkin saja tidak menggunakan huruf besar/kecil, jadi {{tlc|rapikan}} dan {{tlc|Rapikan}} adalah templat yang sama, namun {{tlc|cfd}} dan {{tlc|cfD}} tidak. Nama templat paling mudah diingat jika mengikuti ejaan, spasi, dan huruf besar bahasa Indonesia yang baku (lihat juga [[Wikipedia:Pedoman penamaan|pedoman penamaan artikel]]). Hindari memiliki templat yang namanya hanya berbeda dalam huruf besar kecil, spasi, atau tanda baca. 

=== Bak pasir untuk uji coba ===
{{main|Wikipedia:Bak pasir templat dan kasus uji}}
Jika Anda ingin bereksperimen dengan templat (dan tidak ingin eksperimen Anda dihapus sebelum selesai), Anda dapat melakukannya di [[Templat:Bak pasir templat|bak pasir templat]]. Anda juga dapat menggunakan templat [[Templat:X1|X1]], [[Templat:X2|X2]], [[Templat:X3|X3]], [[Templat:X4|X4]], [[Templat:X5|X5]], [[Templat:X6|X6]], [[Templat:X7|X7]], [[Templat:X8|X8]], [[Templat:X9|X9]], [[Templat:X10|X10]], [[Templat:X11|X11]], dan [[Templat:X12|X12]] untuk tujuan eksperimen. Untuk menyertakan templat uji, gunakan bentuk {{tlc|X1}} untuk templat X1, {{tlc|X2}} untuk templat X2, dst. 

Templat yang ada saat ini sering kali memiliki [[Wikipedia:Bak pasir templat dan kasus uji|kotak pasir dan halaman kasus uji coba]] sendiri (terutama yang menggunakan {{tl|Dokumentasi}}). Perubahan harus diuji secara menyeluruh di sana sebelum diterapkan ke templat utama, untuk mencegah galat yang tidak disengaja pada banyak halaman.

=== Keterbacaan ===
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. 

<pre><nowiki>{{Contoh nama templat
| parameter_pertama = Teks dari nilai_pertama
| parameter_kedua = Teks dari nilai_kedua
| parameter_ketiga = Teks dari parameter_ketiga
| dst = dst
}}</nowiki></pre>

=== Jeda baris ===
Beberapa templat mungkin secara tidak sengaja menyebabkan jeda baris tambahan pada artikel yang dirender. Hal ini terutama terjadi pada [[Wikipedia:Pedoman gaya/Kotak info|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 ===
{{main|Wikipedia:Substitusi}}
Memanggil templat menggunakan form
: '''<code>{{subst:nama templat (|parameter |...)}}</code>''' 
(yaitu, memasukkan '''<code>subst:</code>''' 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 {{tlx|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 === 
{{utama|Wikipedia:Dokumentasi templat}}
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 &lt;noinclude&gt; untuk menambahkan deskripsi kecil langsung ke dalam templat, misalnya: 
<pre>Ini adalah sebuah artikel {{{1}}}.'''&lt;noinclude&gt;
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.'''
&lt;/noinclude&gt;
</pre>

Alternatif lain adalah membuat subhalaman [[Wikipedia:DOC|subhalaman /doc]] untuk dokumentasi (lebih disukai untuk templat dengan banyak parameter, dll.) dan menambahkan <code>&lt;noinclude&gt;{{tl|Dokumentasi}}&lt;/noinclude&gt;</code> setelah templat yang sebenarnya. Tag "noinclude" pertama harus ditempatkan pada baris yang sama dengan tanda kurung akhir dari templat yang sebenarnya dengan cara berikut: 
<pre>
{{(nama template)
(parameter yang di berikan)
}}<noinclude>...
</pre>

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 ===
Modul [[Wikipedia:Lua|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 <code>#invoke</code> 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 ==
Secara historis, awalan "msg:" harus ditambahkan di depan nama templat ketika digunakan pada halaman. Sebagai contoh, <nowiki>{{msg:stub}} was typed instead of {{stub}}</nowiki>. 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. [[Bantuan:Ruang nama MediaWiki|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 <nowiki>{{msg:&nbsp;...}}</nowiki>. Fungsi ini digantikan dengan [[Wikipedia:Ruang nama templat|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:Usulan penghapusan|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.