这个模板用来显示并格式化一些模板的说明文档,包括你正在阅读的本文。
Template:Documentation既可以用来嵌入/doc子页面,也可以用来进行内联嵌入;同时,将有一定的样式来标记文档部分。
使用Template:Documentation能够将模板及其页面分离,从而避免内联文档的缺点(如页面被保护/数据库被锁定后无法编辑说明、只选一个目录编辑可能会被系统误判为无限递归使用等问题)。
使用方法极其简单,仅需在目标模板的最后加入<noinclude>{{Documentation}}</noinclude>
即可,然后在模板下方就会出现文档内容。
{{Documentation}}
, 亦可实现嵌入模板时不显示说明文档的效果。<onlyinclude>
同样用于控制嵌入显示内容,仅允许被标签包含其中的内容可被嵌入显示。注意:请确保HTML标签<noinclude>直接接在模板原始码或文字的最后一行后方,不要新起一行。
另起一行时的呈现效果 |
---|
萌娘百科,万物皆可萌的百科全书。 <noinclude>{{Documentation|content=内联文档 }}</noinclude> 萌娘百科,万物皆可萌的百科全书。
|
点击模板中的“创建”按钮就能在模板的/doc子页面中创建所需的文档。创建完以后模板页就会自动包含这个文档,效果即如本文档般。
虽然不推荐内联文档,但对于一些内容精简的文档,内联呈现方式的确更加方便。这时候可以使用该模板的content
属性:
<noinclude>{{Documentation|content= 内联文档 }}</noinclude>
{{Documentation/docname}}
;解析后的结果为“(页面名字)/doc”。例如,在本页面(Template:Documentation/doc)下,参数1的默认值是Template:Documentation/doc/doc。content
的默认值为空。{{Doc}}
等效于{{Documentation}}
。