“模板:Documentation”的版本间差异

来自橘猪小站
跳到导航 跳到搜索
 
(未显示同一用户的1个中间版本)
第2行: 第2行:
  --><div class="template-documentation-header" style="padding-bottom:3px; border-bottom: 1px solid #aaa; margin-bottom:1ex"><!--
  --><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}}
     --><span style="font-weight: bold; font-size: 125%">{{#switch:{{NAMESPACE}}
     |{{ns:template}}=[[File:Template-info.svg|50px|link=]] 模板文档
     |{{ns:template}}=[[File:Template-info.png|50px|link=]] 模板文档
     |{{ns:module}}=[[File:Template-info.svg|50px|link=]] 模块文档
     |{{ns:module}}=[[File:Template-info.png|50px|link=]] 模块文档
     |{{ns:widget}}=[[File:Template-info.svg|50px|link=]] 小工具文档
     |{{ns:widget}}=[[File:Template-info.png|50px|link=]] 小工具文档
     |#default=文档
     |#default=文档
   }}</span>&nbsp;&nbsp;<span class="editsection plainlinks" style="font-size:small;" id="doc_editlinks">{{#if:{{{content|}}}|
   }}</span>&nbsp;&nbsp;<span class="editsection plainlinks" style="font-size:small;" id="doc_editlinks">{{#if:{{{content|}}}|
第15行: 第15行:
  --><div id="template_doc_page_transcluded" class="dablink plainlinks" style="font-size:84%;"><!--
  --><div id="template_doc_page_transcluded" class="dablink plainlinks" style="font-size:84%;"><!--
   -->{{#if:{{{content|}}}|
   -->{{#if:{{{content|}}}|
       <!--内联文档**-->这个[[zhwiki:Wikipedia:模板文件頁模式|文档]]是内联文档。
       <!--内联文档**-->这个文档是内联文档。
       |{{#ifexist: {{{1|{{Documentation/docname}}}}}
       |{{#ifexist: {{{1|{{Documentation/docname}}}}}
         |<!--**/doc存在**-->这个文档嵌入自[[{{{1|{{Documentation/docname}}}}}]]。
         |<!--**/doc存在**-->这个文档嵌入自[[{{{1|{{Documentation/docname}}}}}]]。

2022年3月8日 (二) 14:09的最新版本

Template-info.png 模板文档  [查看] [编辑] [历史] [刷新]

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

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

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

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

注意,请确保<noinclude>的开头直接接在模板源代码或文字的最后一行后方,不要新起一行。否则,多余的一行会被插入到包含该模板的页面中,往往该页面不需要这一行。

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

内联文档

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

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

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

  • 參數1的默認值是{{Documentation/docname}};其解析为“(页面名字)/doc”。例如,在本页面(模板:Documentation)下,参数1的默认值是模板:Documentation/doc。
  • 参数content的默认值为空。


本文引自萌娘百科同名页面。