Help:範本
如果你需要在多个页面上包含同样的文本的话, MediaWiki 的模板功能就起到作用了 (就像上面的帮助文档都会有的标签一样)。
创建模板
模板的页面名称最前面都有 Template:,只要和其他页面一样创建就可以了。
使用模板
模板除了作为普通的 wiki 页面之外,还可以有以下三种使用方法:
{{模板名称}}会将模板的当前内容包含在页面内。{{subst:模板名称}}会在保存后将模板的内容以平常可以编辑的方式 (wiki 代码) 插入页面源代码中。{{msgnw:模板名称}}会将模板的源代码包含在页面中,类似<nowiki>一样。
在模板中使用变量
| 用数字编号的变量 | |
'''A little thank you...'''<br>
<small>for {{{1}}}.<br>
hugs, {{{2}}}</small>
| |
| 你键入 | 你得到 |
{{thankyou|你所有的努力|小明}}
|
|
| 用名称的变量 | |
'''A little thank you...'''<br>
<small>for {{{reason}}}.<br>
hugs, {{{signature}}}</small>
| |
| 你键入 | 你得到 |
{{thankyou|
reason=你所有的努力|
signature=小明}}
|
|
你可以用两种方法在模板中定义变量:按数字编号的变量,例如 {{{1}}} ,或是命名的变量,例如 {{{变量名}}} 。
例子:你想要在别人的对话页上插入一个小小的感谢留言。它将会包含一个原因和你的签名。(这个例子的确很烂。)你可以创建 Template:Thankyou 来键入你的文字,就像表格中的例子一样。
在页面中使用模板的时候,填入变量的值,用管道符 (|) 分开:{{thankyou|你所有的努力|小明}}。命名的变量,用"名字"="值",管道符分开:{{thankyou|reason=你所有的努力|name=小明}}。在模板中使用命名变量的好处是次序可以随意指定。并且,如果模板有很多变量的话,利用命名变量也比较容易理解。如果你需要改变编号变量的次序的话,需要把它们明写出来:{{thankyou|2=小明|1=你所有的努力}}
你也可以为变量提供默认值,也就是没有为变量填入值的时候会使用的值。举例来说,如果没有给 reason 提供值的话,{{{reason|你所有的努力|}}} 会得到“你所有的努力”。
控制模板嵌入
你可以用<noinclude> 和 <includeonly> 来控制模板的哪些部分会被嵌入。
任何在<noinclude> 和 </noinclude>之间的标记,都只会在直接查看模板页面的时候显示出来,而不会被包含在页面中。
可能的使用方式有:
- 为模板分类
- 连接到其他语言版本中的类似模板的跨语言链接
- 关于如何使用该模板的解释文字
与此相对的是<includeonly>。在<noinclude> 和 </noinclude>之间的文字只会在嵌入页面的时候才会被处理或显示。很明显的一个使用方式是将所有有某个模板的页面加入某个分类,而不将模板本身加入这个分类。
当你改变模板中的分类的时候,使用这个模板的分类可能不会立即改变;这会在工作排队中处理。
整理模板
为了使模板起作用,用户需要找到并且了解如何使用模板。一个简单的技巧是在模板页面中插入一个例子。
例如:
<noinclude>
== 用法 ==
用这个模板来初始化水属性魔法:
{{模板名称|关键字1+关键字2+关键字3}}
</noinclude>
然后,编辑者就可以剪切粘贴来插入这个模板。
参见
- 变量 -- 可能在某些模板中找到的花哨的东西
