模板: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>的开头直接接在模板原始代码或文字的最后一行后方，不要新起一行。

@@ 第2行： / 第2行： @@
   --><div class="template-documentation-header" style="padding-bottom:3px; border-bottom: 1px solid #aaa; margin-bottom:1ex"><!--
      --><span style="font-weight: bold; font-size: 125%">{{#switch:{{NAMESPACE}}
-     |{{ns:template}}=[[File:Template-info.svg|50px|link=]] 模板文档
+     |{{ns:template}}=[[File:Icon-info.svg|50px|link=]] 模板文档
-     |{{ns:module}}=[[File:Template-info.svg|50px|link=]] 模块文档
+     |{{ns:module}}=[[File:Icon-info.svg|50px|link=]] 模块文档
-     |{{ns:widget}}=[[File:Template-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|{{Documentation/docname}}}}}
+     |{{#ifexist: {{{1|{{Utils/Docname}}}}}
-       |<!--**/doc 存在  **-->[[{{fullurl:{{{1|{{Documentation/docname}}}}}}} 查看]] [[{{fullurl:{{{1|{{Documentation/docname}}}}}|action=edit}} 编辑]] [[{{fullurl:{{{1|{{Documentation/docname}}}}}|action=history}} 历史]]
+       |<!--**/doc 存在  **-->[[{{fullurl:{{{1|{{Utils/Docname}}}}}}} 查看]] [[{{fullurl:{{{1|{{Utils/Docname}}}}}|action=edit}} 编辑]] [[{{fullurl:{{{1|{{Utils/Docname}}}}}|action=history}} 历史]]
-       |<!--**/doc 不存在**-->[[{{fullurl:{{{1|{{Documentation/docname }}}}}|action=edit}} 创建]]
+       |<!--**/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|}}}|
-        <!--内联文档**-->这个[[zhwiki:Wikipedia:模板文件頁模式|文档]]是内联文档。
+        <!--内联文档**-->这个文档是内联文档。
-        |{{#ifexist: {{{1|{{Documentation/docname}}}}}
+        |{{#ifexist: {{{1|{{Utils/Docname}}}}}
-          |<!--**/doc存在**-->这个[[zhwiki:Wikipedia:模板文件頁模式|文档]][[zhwiki:Wikipedia:嵌入包含|嵌入]]自[[{{{1|{{Documentation/docname}}}}}]]。
+          |<!--**/doc存在**-->这个文档嵌入自[[{{{1|{{Utils/Docname}}}}}]]。
         }}
       }}
   </div>
-{{#if:{{{content|}}}|{{{content}}}|{{#ifexist:{{{1|{{Documentation/docname}}}}} | {{ {{{1|{{Documentation/docname}}}}} }} }}}}
+{{#if:{{{content|}}}|{{{content}}}|{{#ifexist:{{{1|{{Utils/Docname}}}}} | {{ {{{1|{{Utils/Docname}}}}} }} }}}}
 </div>