帮助:模板
如果您有想要包含在多页中的标准文本,MediaWiki 模板功能将派上用场(如上述标签,该标签包含在帮助命名空间的页面中)。
创建模板
模板名称的前缀为 Template:,您可以像创建其他任何 wiki 页面一样创建模板。
使用模板
模板是 wiki 页面,可以在其他页面中使用,有以下三种方式
{{Name}}包含模板的内容,在获取包含该模板的页面时,即为 "[[Template:Name]]"。{{subst:Name}}将模板的内容以通常可编辑的形式插入到页面的代码中,即在您保存文本后为 "[[Template:Name]]"。{{msgnw:Name}}当获取包含该模板的页面时,将以原始 wiki 语法形式包含模板,如<nowiki>所做的那样
在模板中使用参数
| 具有带编号参数的模板 | |
'''A little thank you...'''<br>
<small>for {{{1}}}.<br>
hugs, {{{2}}}</small>
| |
| 您输入 | 您将获得 |
{{Thankyou|all your hard work|Joe}}
|
|
| 具有带名称的参数 | |
'''A little thank you...'''<br>
<small>for {{{reason}}}.<br>
hugs, {{{signature}}}</small>
| |
| 您输入 | 您将获得 |
{{Thankyou
|reason=all your hard work
|signature=Joe}}
|
|
您可以通过将参数定义为编号型({{{1}}})或命名型({{{param}}})来定义模板中的参数。
示例: 您想要一份小小的感谢信,可以放在其他用户的讨论页面中。它将包含一个理由和您的签名。您可以创建 Template:Thankyou 来输入您的文本,如表格中的示例。
在页面上使用模板时,您需要填写用竖线字符 (|) 分隔的参数值:{{Thankyou|all your hard work|Joe}}。对于命名参数,请使用以竖线字符分隔的 "name=value" 对:{{Thankyou|reason=all your hard work|signature=Joe}}。在模板中使用命名参数的好处是,它们在顺序上很灵活。如果您的参数较多,这也让模板更易于理解。如果您想要更改带编号参数的顺序,则必须明确提及它们:{{Thankyou|2=Joe|1=all your hard work}}。
您还可以为参数提供默认值,即如果未为参数提供值,则将使用的值。例如,{{{reason|all your hard work}}} 将在未为此参数提供值时导致“all your hard work”原因.
控件模板包含
你可以通过使用 <noinclude> 和 <includeonly> 标记控制模板包含。
<noinclude> 和 </noinclude>之间的任何内容只有在直接查看该页面时才会被处理和显示,不会被包含。
可能的应用是
- 对模板进行分类
- 指向其他语言中类似模板的语言间链接
- 关于如何使用模板的说明性文本
相反的是 <includeonly>。<includeonly> 和 </includeonly>之间的文本只有在包含页面时才会被处理和显示。明显的应用是将包含给定模板的所有页面添加到分类中,而不用将模板本身放入该分类中。
注意:当你更改模板应用的分类时,使用该模板的页面的分类可能要过一段时间才会更新:这是由作业队列处理的
组织模板
为了使模板有效,用户需要找到模板并能够使用模板。一种简单的方法是在模板页面中包含一个示例。例如
<noinclude>
==Usage==
Allows to establish a link to a subject:
{{NameOfTemplate|Term1+Term2+Term3}}
</noinclude>
然后,编辑人员只需复制并粘贴该示例,即可创建类似的页面。