模板:Documentation

模板文档

此模板复制或改编自MediaWiki wiki。

这是{{Documentation}}模板, 几乎在每个 (?) 模板页面上都使用它来包含该模板的文档化指令和信息。

有关如何以及何时使用此模板的详细说明, 请参见Wikipedia:Template_documentation

此模板创建一个蓝色的文档框, 就像您现在看到的那样, 并自动从模板的 /doc 子页面加载内容。如果需要, 它还可以从其他地方加载内容。

This template is intended for documenting templates and other pages that are transcluded onto other pages. It can be used in the template namespace and most other namespaces.

使用此模板可以在必要时保护模板, 同时允许任何人编辑模板信息和分类。

使用

通常使用这个模板不需要使用任何参数, 将{{Documentation}}放置在 <noinclude>...</noinclude>之中, 如下示:

<!-- 模板代码的最后一行 --><noinclude>
{{Documentation}}
<!-- Add categories to the /doc subpage, interwikis to Wikidata, not here -->
</noinclude>

然后, 该模板就会自动从所使用的模板的 /doc 子页面加载内容。

此模板还可以从任何其他页面加载内容。如下:

<!-- 模板代码的最后一行 --><noinclude>
{{Documentation |Template:Other page/doc}}
</noinclude>

提示: 当从本地 /doc 子页面以外的页面加载文档时, 处理分类会变得很棘手。

内容也可以直接作为文本提供 (就是内联) 。如下:

<!-- 模板代码的最后一行 --><noinclude>
{{Documentation
 | content =
 (一些描述文本) 
}}</noinclude>

当使用content参数时, doc框通常不会在右上角显示 "[编辑] [清除缓存]" 链接。注意, 如果 /doc 子页面存在, 它的链接仍然显示在doc框下面的链接框中。

模板数据

这是用于新版可视化编辑器及其他工具的模板数据文档。

Documentation模板数据

用于创建一个蓝色的文档框, 并自动从模板的 /doc 子页面加载内容

模板参数[编辑模板数据]
此模板有自定义格式。
参数		描述	类型	状态
链入页面	`1`	从任意 /doc 子页面加载文档	字符串	可选
内联文档	`content`	内联文档的内容	内容	可选
标题文本	`heading`	设置文档页的标题文本, 如果此处留空, 整个标题行 (包括第一个 [编辑] 链接) 也将隐藏。	字符串	可选
头部 CSS 样式	`heading-style`	设置文档页的头部的 CSS 样式	字符串	可选
link box	`link box`	无描述	未知	可选

脚注