QWERTY 52 38：创建页面，内容为“这个模板用来显示和格式化模板的说明文档（一般写在模板的`/doc`子页面），包括你正在阅读的本文。 {{tl|Documentatio…”

2021-08-24T01:59:55Z

创建页面，内容为“这个模板用来显示和格式化模板的说明文档（一般写在模板的<code>/doc</code>子页面），包括你正在阅读的本文。 {{tl|Documentatio…”

新页面

这个模板用来显示和格式化模板的说明文档（一般写在模板的<code>/doc</code>子页面），包括你正在阅读的本文。

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

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

== 用法 ==

这个模板用法非常简单：

# 在主模板页面底部添加<code><nowiki><noinclude>{{doc}}</noinclude></nowiki></code>。
# 点击“创建”链接，打开<code>/doc</code>子页面，并在子页面中填写文档。
# 在<code>/doc</code>子页面的底部添加<code><nowiki><noinclude>[[分类:模板文档]]</noinclude></nowiki></code>。

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

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

=== 其他模板的文档 ===

你可以选择显示其他模板的文档，免去搬运或重定向重复文档的麻烦。
<pre><noinclude>{{doc|模板:其他模板/doc}}</noinclude></pre>

=== 内联文档 ===

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

虽然不推荐内联文档，但是对于一些短小的文档，内联的确更加方便。这时候可以使用该模板的content参数：
<pre><noinclude>{{doc|content=
内联文档
}}</noinclude></pre>

<noinclude>[[分类:模板文档]]</noinclude>

模板:Documentation/doc - 版本历史

QWERTY 52 38：​创建页面，内容为“这个模板用来显示和格式化模板的说明文档（一般写在模板的/doc子页面），包括你正在阅读的本文。 {{tl|Documentatio…”

QWERTY 52 38：创建页面，内容为“这个模板用来显示和格式化模板的说明文档（一般写在模板的`/doc`子页面），包括你正在阅读的本文。 {{tl|Documentatio…”