https://wiki.xdi8.top/index.php?action=history&feed=atom&title=Template%3ADocumentation%2Fdoc
Template:Documentation/doc - 版本历史
2026-04-17T18:13:04Z
本wiki上该页面的版本历史
MediaWiki 1.43.0
https://wiki.xdi8.top/index.php?title=Template:Documentation/doc&diff=5360&oldid=prev
QWERTY 52 38：建立内容为“这个模板用来显示和格式化模板的说明文档（一般写在模板的<code>/doc</code>子页面），包括你正在阅读的本文。 {{tl|Documenta…”的新页面
2021-07-27T14:40:40Z
<p>建立内容为“这个模板用来显示和格式化模板的说明文档（一般写在模板的<code>/doc</code>子页面），包括你正在阅读的本文。 {{tl|Documenta…”的新页面</p>
<p><b>新页面</b></p><div>这个模板用来显示和格式化模板的说明文档（一般写在模板的<code>/doc</code>子页面），包括你正在阅读的本文。<br />
<br />
{{tl|Documentation}}既可以用来嵌入<code>/doc</code>子页面，也可以用来进行内联嵌入；同时，将有一定的样式来标记文档部分。<br />
<br />
使用{{tl|Documentation}}能够将模板及其页面分离，从而避免'''内联文档'''的缺点（如被锁定后无法编辑说明、只选一个目录编辑可能会被系统误判为无限递归使用等）。<br />
<br />
== 用法 ==<br />
<br />
这个模板用法非常简单：<br />
<br />
# 在主模板页面底部添加<code><nowiki><noinclude>{{doc}}</noinclude></nowiki></code>。<br />
# 点击“创建”链接，打开<code>/doc</code>子页面，并在子页面中填写文档。<br />
# 在<code>/doc</code>子页面的底部添加<code><nowiki><noinclude>[[分类:模板文档]]</noinclude></nowiki></code>。<br />
<br />
至于效果，如你所见，这个显示在模板:Documentation页面的文档就是。<br />
<br />
; 注意<br />
# 模板主要内容的<code><nowiki><includeonly></includeonly></nowiki></code>与作为模板说明内容的<code><nowiki><noinclude></noinclude></nowiki></code>之间'''不要换行'''，否则模板使用时会出现莫名其妙的空格或空行。<br />
# 推荐使用<code><nowiki>{{doc}}</nowiki></code>而不是<code><nowiki>{{Documentation}}</nowiki></code>，因为前者更加简洁明了且不易出现拼写错误。<br />
<br />
=== 其他模板的文档 ===<br />
<br />
你可以选择显示其他模板的文档，免去搬运或重定向重复文档的麻烦。<br />
<pre><noinclude>{{doc|模板:其他模板/doc}}</noinclude></pre><br />
<br />
=== 内联文档 ===<br />
<br />
内联文档是不显示<code>/doc</code>子页面内容，直接编写的文档。<br />
<br />
虽然不推荐内联文档，但是对于一些短小的文档，内联的确更加方便。这时候可以使用该模板的content参数：<br />
<pre><noinclude>{{doc|content=<br />
内联文档<br />
}}</noinclude></pre><br />
<!--<noinclude>{{doc|content=<br />
内联文档<br />
}}</noinclude><br />
* 因为使用了<code>noinclude</code>标签，请点击文档左上角的“查看”，进入这个文档来查看效果。--><br />
<noinclude>[[分类:模板文档]]</noinclude></div>
QWERTY 52 38