模板是在知识库文章中复用内容片段的一种方式。您无需多次编写同一套说明,只需在一个地方创建并更新它,然后在其他页面中引用即可。当模板更新时,引用它的页面将自动保持最新!
什么是模板
模板只是一个特殊的 Wiki 页面,其名称以 "Template:" 开头。它拥有 Wiki 页面的所有特性:可以进行本地化、拥有历史记录、支持 Wiki 标记语法。
如何创建模板
- 创建一篇新的知识库文章。您可以在我们的测试服务器上创建新文章进行尝试。
- 确保名称以 "Template:" 开头 - 例如:Template:aboutconfig。
- 将分类设置为 "Template"。
- 像编写其他任何知识库文章一样继续编写模板内容。
如何在文章中引入模板
要在 Wiki 页面中使用模板,您只需“链接”到该模板即可。
例如:
[[Template:某个模板]] 或 [[T:某个模板]]
这不会创建一个普通链接,而是会将 Template:某个模板 的内容引入到当前页面中。模板中的任何 Wiki 标记都会被渲染呈现。
模板与编号列表
在大多数情况下,在模板中使用编号列表的方式与其他知识库文档中完全相同。但有一个重要的例外:如果您的模板是一个编号列表,并且将被用作更大编号列表的一部分,那么编号将会中断。
解决方法:
不要在任何步骤中使用 "#",并且务必在第二个及后续步骤周围添加 <li> 和 </li> 标签,像这样:
这是您列表中的第一步
<li>这是第二步</li>
<li>这是第三步</li>
然后,当将模板添加到文章中时,在模板前面添加 "#":
#[[T:List]]
#这是不属于模板的另一个步骤
效果将如下所示:
- 这是模板列表中的第一步
- 这是模板列表中的第二步
- 这是模板列表中的第三步
- 这是不属于模板的另一个步骤
另一个要点:您不能在这些模板中使用块级 {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]]
结果:
(译者注:此示例引用自《辛普森一家》角色)
- Milhouse 喜欢 Lisa。
- Janey 喜欢 Milhouse。
- 全班注意!没人喜欢 Milhouse!
跟踪所有这些数字可能会让人困惑,因此您还可以为模板参数命名:
Template:XPrecededY:
先来的是 {{{first}}},然后来的是 {{{second}}}。
使用它:
[[Template:XPrecededY|first=love|second=marriage]]
使用命名参数时,您在使用模板时无需担心顺序:
[[Template:XPrecededY|second=marriage|first=love]]
上面两个使用Template:XPrecededY的例子将产生相同的结果。
知识库指南
要查看更多关于知识库贡献的指南,请点击此处。