Umum Bantuan:Templat

Pengenalan

Templat-templat mungkin mengandungi apa wikiteks yang mungkin kita inginkan, termasuklah panggilan-panggilan ke templat-templat lain. Mereka mempunyai kapasiti pengaturcaraan terhad: nilai-nilai yang mengikut batasan tertentu (dipanggil parameter), pengiraan dan pemecahan (menggunakan fungsi Parser), dan laluan kepada pemboleh -pemboleh ubah wiki-spesifik (perkataan-perkataan ajaib), seperti tarikh, masa dan nama-nama halaman.

Untuk menggunakan satu templat dalam satu artikel atau halaman, satu tag templat (dalam bentuk {{template name}}; name templat yang ditutup di dalam kedua-dua kurungan) ditambah di mana anda hendak ia ditimbulkan. Apabila seseorang itu hendak membaca halaman itu, pelayan-pelayan Wikimedia akan ambil isi kandungan pada templat, buatkan apa-apa pengiraan yang tidak perlu dibuat, dan gantikan tag templat dalam wikitext dengan isi kandungan templat itu yang diproses.

Muka surat templat dan ruang nama

Templat-templat mempunyai ruang nama mereka sendiri yang menggunakan prefiks "Templat:" (serupa dengan ruang nama "Pengguna:", "Bantuan:", dan "Talk:" yang dikenali). (Bahasa-bahasa Wikipedia lain mungkin menggunakan prefiks berbeza, seperti "Vorlage:", "Modèle:", "Sjabloon:", walaupun "Template:" boleh digunakan pada tempat-tempat ini.)

Kebanyakan templat wujud di dalam ruang nama, dan boleh ditemui dalam halaman bertajuk "Template:Template name". Walau bagaimanapun, pengguna kadangkala membuat templat dalam ruang nama lain seperti User: namespace. Transklusi boleh diguna pakai dari mana-mana ruang nama,[1] tetapi kelebihan ruang nama templat ialah awalan "Templat:" tidak diperlukan apabila mentransklusi.

Nama-nama templat adalah sama dengan nama halaman yang lain: kes-sensitif melainkan huruf pertama dan ruang tidak diperlainkan dengan tanda garis bawah. Andai simbol # (biasanya digunakan bagi memaut bahagian suatu halaman) muncul dalam transklusi, simbol tersebut dan mana-mana karakter susulan tidak diendahkan.

Halaman templat, seperti kebanyakan halaman lain, ada halaman perbincangan yang berkaitan di mana penyunting boleh membincang apa-apa isu berkaitan templat itu. (atas sebab ini, templat tidak sepatutnya diletakkan di ruang nama "Talk:", meskipun dengan tujuan menggunakannya pada halaman perbincangan; lantaran halaman perbincangan tidak mempunyai halaman perbincangannya sendiri, tiada halaman untuk membincangkan templat.)

Templat hanya berkesan dalam projek Wikimedia tertentu. Salinan templat tersebut mesti dibuat dalam setiap projek andai templat itu hendak digunakan dalam projek lain.

Templat penggunaan

To transclude a template into another page, use the following syntax (called a template tag):

{{ template name | parameter | parameter | ... }}

This consists of the template name and various parameters that are passed to the template, where each parameter is separated by a vertical bar (or pipe), and the entirety is surrounded by doubled curly braces, {{...}}. The template tag should be placed in a page or article wherever the template is intended to appear. The "Template:" prefix is never needed for transclusion, only for finding and editing the template itself (though if the template is created in a different namespace that prefix is needed). Not all templates have parameters, and not all templates that have parameters need to have values provided, so sometimes {{ template name }} is sufficient to use a template. If a parameter is needed, but a value not provided by the user, the template may render with something like {{{...}}} in the text, where the '...' might be a number or a parameter name. This is to inform the user that a named or unnamed parameter is missing, and can be avoided by using default values for the parameter.

Parameters come in two basic forms:

  • unnamed parameters: values that are put into the template in the order they appear {{ template name|parameter1|parameter2|...}}
  • named parameters: values associated with a particular named key in the template{{ template name | parametername1 = parameter1 | parametername2 = parameter2 | ... }}

These may be mixed:

{{ template name |parameter1|parameter2| parametername1 = parameter3 | parametername2 = parameter4 | ... }}

By convention named parameters are listed last, though that is not a requirement. Whitespace characters (spaces, tabs, returns) are stripped from the beginnings and ends of named parameter values (unnamed parameters are unaffected), but not from the middle: thus {{ ... | myparam = this is a test }} will be treated as though the user had typed {{ ... |myparam=this is a test}}.

Template pages themselves may include material that is not transcluded with the template (such as documentation or Wikimedia categories that the template itself belongs to), or material that is only used when the page is transcluded (such as categories that apply to the transclusion page, but not the template). See the discussion of the includeonly and noinclude tags, below.

Attempting to transclude a template that does not exist produces a redlink, just like linking to any other nonexistent page. Following the link allows one to create that particular template.