如何使用模板

Contributors Contributors 最后更新于:

模板是在知识库文章中复用内容片段的一种方式。您无需多次编写同一套说明,只需在一个地方创建并更新它,然后在其他页面中引用即可。当模板更新时,引用它的页面将自动保持最新!

本地化人员注意:本地化模板时,请勿翻译页面名称 - 请直接使用原始名称!例如,如果模板名为Template:browsersettings,请不要翻译名称中的任何元素 - 在您的语言版本中直接使用Template:browsersettings。这对模板正常运行至关重要。

什么是模板

模板只是一个特殊的 Wiki 页面,其名称以 "Template:" 开头。它拥有 Wiki 页面的所有特性:可以进行本地化、拥有历史记录、支持 Wiki 标记语法。

模板列表可在此页面查看。现有模板的字母顺序列表可在此处找到

如何创建模板

  1. 创建一篇新的知识库文章。您可以在我们的测试服务器上创建新文章进行尝试。
  2. 确保名称以 "Template:" 开头 - 例如:Template:aboutconfig
  3. 将分类设置为 "Template"。
  4. 像编写其他任何知识库文章一样继续编写模板内容。

如何在文章中引入模板

要在 Wiki 页面中使用模板,您只需“链接”到该模板即可。

例如:

[[Template:某个模板]] 或 [[T:某个模板]]

这不会创建一个普通链接,而是会将 Template:某个模板 的内容引入到当前页面中。模板中的任何 Wiki 标记都会被渲染呈现。

模板与编号列表

在大多数情况下,在模板中使用编号列表的方式与其他知识库文档中完全相同。但有一个重要的例外:如果您的模板是一个编号列表,并且将被用作更大编号列表的一部分,那么编号将会中断。

解决方法

不要在任何步骤中使用 "#",并且务必在第二个及后续步骤周围添加 <li> 和 </li> 标签,像这样:

这是您列表中的第一步
<li>这是第二步</li>
<li>这是第三步</li>

然后,当将模板添加到文章中时,在模板前面添加 "#":

#[[T:List]]
#这是不属于模板的另一个步骤

效果将如下所示:

  1. 这是模板列表中的第一步
  2. 这是模板列表中的第二步
  3. 这是模板列表中的第三步
  4. 这是不属于模板的另一个步骤

另一个要点:您不能在这些模板中使用块级 {for}。例如:
错误做法:
{for not fx10}
第一步 - Firefox 9 及更低版本
{/for}
{for fx10}
第一步 - Firefox 10 及更高版本
{/for}
<li>这是第二步</li>

正确做法: {for not fx10}第一步 - Firefox 9 及更低版本{/for}{for fx10}第一步 - Firefox 10 及更高版本{/for}
<li>这是第二步</li>

在模板中使用参数

模板支持传入参数,让您可以复用内容几乎相同但略有差异的部分。

例如,假设您有一个标准通知,告诉用户某文档仅适用于 Firefox 4,另一个版本的通知则说明仅适用于 Firefox 3.6。这些通知的文本可能除了 Firefox 版本号外完全相同——这正是使用模板的好时机!

Template:OnlyVersionX

{note}本文档或本节仅适用于 '''Firefox {{{1}}}'''!{/note}

然后,在一个 Wiki 页面中,您可以这样做:

[[Template:OnlyVersionX|4]]

在另一个页面中,您可以这样做:

[[Template:OnlyVersionX|3.6]]

您也可以使用多个参数或多次使用同一个参数!

您也可以使用多个参数或多次使用同一个参数!

Template:XLikesY

# {{{2}}} 喜欢 {{{1}}}。
# {{{3}}} 喜欢 {{{2}}}。
# 全班注意!没人喜欢 {{{2}}}!


然后使用它:

[[Template:XLikesY|Lisa|Milhouse|Janey]]

结果:

  1. Milhouse 喜欢 Lisa。
  2. Janey 喜欢 Milhouse。
  3. 全班注意!没人喜欢 Milhouse!
(译者注:此示例引用自《辛普森一家》角色)


跟踪所有这些数字可能会让人困惑,因此您还可以为模板参数命名:

Template:XPrecededY:

先来的是 {{{first}}},然后来的是 {{{second}}}。

使用它:

[[Template:XPrecededY|first=love|second=marriage]]

使用命名参数时,您在使用模板时无需担心顺序:

[[Template:XPrecededY|second=marriage|first=love]]

上面两个使用Template:XPrecededY的例子将产生相同的结果。

知识库指南

要查看更多关于知识库贡献的指南,请点击此处

此文章在这些用户的协助下写成:

Illustration of hands

志愿者

分享知识并培养专业技能。解答问题并改进我们的知识库。

详细了解