帮助:模板

来自 PostgreSQL wiki
跳至导航跳至搜索

如果您有想要包含在多页中的标准文本,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}}
Example sunflower image
小小感谢...
感谢您一直以来的努力。
爱你的 Joe
具有带名称的参数
 
'''A little thank you...'''<br>
<small>for {{{reason}}}.<br>
hugs, {{{signature}}}</small>
您输入 您将获得
{{Thankyou
|reason=all your hard work
|signature=Joe}}
Example sunflower image
小小感谢...
感谢您一直以来的努力。
爱你的 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>

然后,编辑人员只需复制并粘贴该示例,即可创建类似的页面。

另请参见