帮助:模板
如果您有想要包含在多页中的标准文本,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>
然后,编辑人员只需复制并粘贴该示例,即可创建类似的页面。