帮助:Templates/zh

来自Ubuntu中文
Qiii2006留言 | 贡献2010年4月21日 (三) 21:37的版本
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索

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

创建模板

模板的页面名称最前面都有 Template:,只要和其他页面一样创建就可以了。

使用模板

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

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

在模板中使用变量

用数字编号的变量
 
'''A little thank you...'''<br>
<small>for {{{1}}}.<br>
hugs, {{{2}}}</small>
你键入 你得到
{{thankyou|你所有的努力|小明}}
Example sunflower image
Example sunflower image
A little thank you...
for 你所有的努力.
hugs, 小明
用名称的变量
 
'''A little thank you...'''<br>
<small>for {{{reason}}}.<br>
hugs, {{{signature}}}</small>
你键入 你得到
{{thankyou|
reason=你所有的努力|
signature=小明}}
Example sunflower image
Example sunflower image
A little thank you...
for 你所有的努力.
hugs, 小明

你可以用两种方法在模板中定义变量:按数字编号的变量,例如 {{{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>

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

参见

  • 变量 -- 可能在某些模板中找到的花哨的东西