Template:Documentation/doc:修订间差异

来自魔学
W​(留言 | 贡献)
无编辑摘要
W​(留言 | 贡献)
清空全部内容
标签:清空 已被回退
第1行: 第1行:
Template:Documentation既可以用来嵌入'''/doc'''子页面,也可以用来进行内联嵌入;同时,将有一定的样式来标记文档部分。


使用Template:Documentation能够将模板及其页面分离,从而避免'''内联文档'''的缺点(如被锁定后无法编辑说明、只选一个目录编辑可能会被系统误判为无限递归使用等)。
使用方法极其简单,仅需在模板的最后加入<code><nowiki><noinclude>{{Documentation}}</noinclude></nowiki></code>即可,然后在模板下方就会出现文档内容。
注意,請確保'''&lt;noinclude&gt;'''的開頭直接接在模板原始碼或文字的最後一行後方,'''不要新起一行'''。否則,一個多餘的新行會插入到包含该模板的頁面中,往往該頁面不需要這個新行。
点击创建就能在模板的'''/doc'''子页面中创建所需的文档。创建完以后模板页就会自动包含这个文档,效果即如本文档般。
===内联文档===
虽然不推荐内联文档,但是对于一些短小的文档,内联的确更加方便。这时候可以使用该模板的content属性:
<pre><noinclude>{{Documentation|content=
内联文档
}}</noinclude></pre>
<noinclude>{{Documentation|content=
内联文档
}}</noinclude>
同样地,請確保'''&lt;noinclude&gt;'''的開頭直接接在模板原始碼或文字的最後一行後方,'''不要新起一行'''。
*參數1的默認值是<code>{{tl|Documentation/docname}}</code>;其解析为“(页面名字)/docname”。例如,在本页面({{FULLPAGENAME}})下,参数1的默认值是{{Documentation/doc}}。
*參數content的默認值為空。
<!-- 本行下加入模板的分類 -->
<includeonly>[[Category:模板页的模板]][[en:Template:Documentation]][[ja:Template:Documentation]]</includeonly><noinclude>[[Category:模板文档]]</noinclude>

2023年3月31日 (五) 22:57的版本