模板:Documentation：修订间差异

可视化Wikitext

2022年5月20日 (五) 17:49的最新版本

模板文档 [查看] [编辑] [历史] [刷新]

这个文档嵌入自模板:Documentation/doc。

本模板用來显示和格式化一些重要模板的说明文件，包括你正在阅读的本文。

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

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

使用方法极其简单，仅需在模板的最后加入<noinclude>{{Documentation}}</noinclude>即可，然后在模板下方就会出现文档内容。

注意，请确保<noinclude>的开头直接接在模板原始代码或文字的最后一行后方，不要新起一行。

点击创建就能在模板的/doc子页面中创建所需的文档。创建完以后模板页就会自动包含这个文档，效果即如本文档般。

内联文档

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

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

同样地，请确保<noinclude>的开头直接接在模板原始代码或文字的最后一行后方，不要新起一行。

@@ 第1行： / 第1行： @@
-{{#invoke:documentation|main|_content={{ {{#invoke:documentation|contentTitle}}}}}}<noinclude>
+<div class="template-documentation" style="background: aliceblue; padding: 1em; border: 1px solid #aaa;"><!--
-<!-- Categories go on the /doc subpage, and interwikis go on Wikidata. -->
+ --><div class="template-documentation-header" style="padding-bottom:3px; border-bottom: 1px solid #aaa; margin-bottom:1ex"><!--
-</noinclude>
+    --><span style="font-weight: bold; font-size: 125%">{{#switch:{{NAMESPACE}}
+    |{{ns:template}}=[[File:Icon-info.svg|50px|link=]] 模板文档
+    |{{ns:module}}=[[File:Icon-info.svg|50px|link=]] 模块文档
+    |{{ns:widget}}=[[File:Icon-info.svg|50px|link=]] 小部件文档
+    |#default=文档
+  }}</span>&nbsp;&nbsp;<span class="editsection plainlinks" style="font-size:small;" id="doc_editlinks">{{#if:{{{content|}}}|
+      <!--内联文档-->[[{{fullurl:{{FULLPAGENAME}}|action=edit}} 编辑]]
+    |{{#ifexist: {{{1|{{Utils/Docname}}}}}
+      |<!--**/doc 存在  **-->[[{{fullurl:{{{1|{{Utils/Docname}}}}}}} 查看]] [[{{fullurl:{{{1|{{Utils/Docname}}}}}|action=edit}} 编辑]] [[{{fullurl:{{{1|{{Utils/Docname}}}}}|action=history}} 历史]]
+      |<!--**/doc 不存在**-->[[{{fullurl:{{{1|{{Utils/Docname }}}}}|action=edit}} 创建]]
+     }} [[{{fullurl:{{FULLPAGENAME}}|action=purge}} 刷新]]
+   }}</span></div><!--
+ --><div id="template_doc_page_transcluded" class="dablink plainlinks" style="font-size:84%;"><!--
+  -->{{#if:{{{content|}}}|
+       <!--内联文档**-->这个文档是内联文档。
+       |{{#ifexist: {{{1|{{Utils/Docname}}}}}
+         |<!--**/doc存在**-->这个文档嵌入自[[{{{1|{{Utils/Docname}}}}}]]。
+       }}
+     }}
+ </div>
+{{#if:{{{content|}}}|{{{content}}}|{{#ifexist:{{{1|{{Utils/Docname}}}}} | {{ {{{1|{{Utils/Docname}}}}} }} }}}}
+</div>