模板:Documentation/doc

来自希顶维基
QWERTY 52 38留言 | 贡献2021年7月27日 (二) 22:40的版本 (建立内容为“这个模板用来显示和格式化模板的说明文档(一般写在模板的<code>/doc</code>子页面),包括你正在阅读的本文。 {{tl|Documenta…”的新页面)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)

这个模板用来显示和格式化模板的说明文档(一般写在模板的/doc子页面),包括你正在阅读的本文。

{{Documentation}}既可以用来嵌入/doc子页面,也可以用来进行内联嵌入;同时,将有一定的样式来标记文档部分。

使用{{Documentation}}能够将模板及其页面分离,从而避免内联文档的缺点(如被锁定后无法编辑说明、只选一个目录编辑可能会被系统误判为无限递归使用等)。

用法

这个模板用法非常简单:

  1. 在主模板页面底部添加<noinclude>{{doc}}</noinclude>
  2. 点击「创建」链接,打开/doc子页面,并在子页面中填写文档。
  3. /doc子页面的底部添加<noinclude>[[分类:模板文档]]</noinclude>

至于效果,如你所见,这个显示在模板:Documentation页面的文档就是。

注意
  1. 模板主要内容的<includeonly></includeonly>与作为模板说明内容的<noinclude></noinclude>之间不要换行,否则模板使用时会出现莫名其妙的空格或空行。
  2. 推荐使用{{doc}}而不是{{Documentation}},因为前者更加简洁明了且不易出现拼写错误。

其他模板的文档

你可以选择显示其他模板的文档,免去搬运或重定向重复文档的麻烦。

<noinclude>{{doc|模板:其他模板/doc}}</noinclude>

内联文档

内联文档是不显示/doc子页面内容,直接编写的文档。

虽然不推荐内联文档,但是对于一些短小的文档,内联的确更加方便。这时候可以使用该模板的content参数:

<noinclude>{{doc|content=
内联文档
}}</noinclude>