帮助:Templates/zh
如果你需要在多个页面上包含同样的文本的话, 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>
之间的文字只会在嵌入页面的时候才会被处理或显示。很明显的一个使用方式是将所有有某个模板的页面加入某个分类,而不将模板本身加入这个分类。
模板:Note/zh 当你改变模板中的分类的时候,使用这个模板的分类可能不会立即改变;这会在工作排队中处理。
整理模板
为了使模板起作用,用户需要找到并且了解如何使用模板。一个简单的技巧是在模板页面中插入一个例子。
例如:
<noinclude> == 用法 == 用这个模板来初始化水属性魔法: {{模板名称|关键字1+关键字2+关键字3}} </noinclude>
然后,编辑者就可以剪切粘贴来插入这个模板。
参见
- 变量 -- 可能在某些模板中找到的花哨的东西