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