Wikipedia:Ruang nama templat: Perbedaan antara revisi
Konten dihapus Konten ditambahkan
Tidak ada ringkasan suntingan |
Ariandi Lie (bicara | kontrib) |
||
| (3 revisi perantara oleh satu pengguna lainnya tidak ditampilkan) | |||
Baris 1:
{{for|Untuk mengetahui cara kerja templat|Bantuan:Panduan singkat mengenai templat|Bantuan:Templat}}
Baris 60 ⟶ 59:
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 <noinclude> untuk menambahkan deskripsi kecil langsung ke dalam templat, misalnya:
<pre>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>
</pre>
Alternatif lain adalah membuat subhalaman [[Wikipedia:DOC|subhalaman /doc]] untuk dokumentasi (lebih disukai untuk templat dengan banyak parameter, dll.) dan menambahkan <code><noinclude>{{tl|Dokumentasi}}</noinclude></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: ...}}</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.
| |||