查看“帮助:Templates/zh”的源代码

{{PD Help Page/zh}}
如果你需要在多个页面上包含同样的文本的话， MediaWiki 的模板功能就起到作用了 (就像上面的帮助文档都会有的标签一样)。

== 创建模板 ==
模板的页面名称最前面都有 <code>Template:</code>，只要和其他页面一样创建就可以了。

== 使用模板 ==
模板除了作为普通的 wiki 页面之外，还可以有以下三种使用方法：

*<code><nowiki>{{模板名称}}</nowiki></code> 会将模板的当前内容包含在页面内。
*<code><nowiki>{{subst:模板名称}}</nowiki></code> 会在保存后将模板的内容以平常可以编辑的方式 (wiki 代码) 插入页面源代码中。
*<code><nowiki>{{msgnw:模板名称}}</nowiki></code> 会将模板的源代码包含在页面中，类似<code>&lt;nowiki&gt;</code>一样。

== 在模板中使用变量 ==
<div style="float:right; margin:8px;">
{| {{Prettytable}} 
|-
|{{Hl2}} colspan="2" align="center" |'''用数字编号的变量'''	
|-
| colspan="2" |
<pre><nowiki> 
'''A little thank you...'''<br>
<small>for {{{1}}}.<br>
hugs, {{{2}}}</small>
</nowiki></pre> 
|-
|{{Hl2}}|'''你键入'''	
|{{Hl2}}|'''你得到'''
|-
|<code><nowiki>{{thankyou|你所有的努力|小明}}</nowiki></code>
|
{{thankyou|你所有的努力|小明}}
|-
|{{Hl2}} colspan="2" align="center" |'''用名称的变量'''	
|-
| colspan="2" |
<pre><nowiki> 
'''A little thank you...'''<br>
<small>for {{{reason}}}.<br>
hugs, {{{signature}}}</small>
</nowiki></pre> 
|-
|{{Hl2}}|'''你键入'''	
|{{Hl2}}|'''你得到'''
|-
|<pre><nowiki>{{thankyou|
reason=你所有的努力|
signature=小明}}</nowiki></pre>
|
{{thankyou|你所有的努力|小明}}
|}</div>
你可以用两种方法在模板中定义变量：按数字编号的变量，例如 <code><nowiki>{{{1}}}</nowiki></code> ，或是命名的变量，例如 <code><nowiki>{{{变量名}}}</nowiki></code> 。

'''例子'''：你想要在别人的对话页上插入一个小小的感谢留言。它将会包含一个原因和你的签名。（这个例子的确很烂。）你可以创建 Template:Thankyou 来键入你的文字，就像表格中的例子一样。

在页面中使用模板的时候，填入变量的值，用管道符 (|) 分开：<code><nowiki>{{thankyou|你所有的努力|小明}}</nowiki></code>。命名的变量，用"名字"="值"，管道符分开：<code><nowiki>{{thankyou|reason=你所有的努力|name=小明}}</nowiki></code>。在模板中使用命名变量的好处是次序可以随意指定。并且，如果模板有很多变量的话，利用命名变量也比较容易理解。如果你需要改变编号变量的次序的话，需要把它们明写出来：<code><nowiki>{{thankyou|2=小明|1=你所有的努力}}</nowiki></code>

你也可以为变量提供默认值，也就是没有为变量填入值的时候会使用的值。举例来说，如果没有给 reason 提供值的话，<code><nowiki>{{{reason|你所有的努力|}}}</nowiki></code> 会得到“你所有的努力”。

== 控制模板嵌入 ==
你可以用<code><nowiki><noinclude></nowiki></code> 和 <code><nowiki><includeonly></nowiki></code> 来控制模板的哪些部分会被嵌入。

任何在<code><nowiki><noinclude></nowiki></code> 和 <code><nowiki></noinclude></nowiki></code>之间的标记，都只会在直接查看模板页面的时候显示出来，而不会被包含在页面中。

可能的使用方式有：
* 为模板分类
* 连接到其他语言版本中的类似模板的跨语言链接
* 关于如何使用该模板的解释文字

与此相对的是<code><nowiki><includeonly></nowiki></code>。在<code><nowiki><noinclude></nowiki></code> 和 <code><nowiki></noinclude></nowiki></code>之间的文字只会在嵌入页面的时候才会被处理或显示。很明显的一个使用方式是将所有有某个模板的页面加入某个分类，而不将模板本身加入这个分类。

{{note/zh}} 当你改变模板中的分类的时候，使用这个模板的分类可能不会立即改变；这会在[[m:Help:Job queue|工作排队]]中处理。

== 整理模板 ==
为了使模板起作用，用户需要找到并且了解如何使用模板。一个简单的技巧是在模板页面中插入一个例子。

例如：

<div style="display:table; width:auto;"><pre>
<noinclude>
== 用法 ==
用这个模板来初始化水属性魔法：
{{模板名称|关键字1+关键字2+关键字3}}
</noinclude>
</pre></div>

然后，编辑者就可以剪切粘贴来插入这个模板。

== 参见 ==
*[[Help:Variables/zh|变量]] -- 可能在某些模板中找到的花哨的东西

[[Category:Help/zh|{{PAGENAME}}]]
[[Category:Template/zh]]
{{Languages|Help:Templates}}