新增的內容 刪去的內容
無編輯摘要 |
NSun200512(對話 | 貢獻) (修正代码) |
||
(未顯示2個用戶的8個中間版本) | |||
第5行: | 第5行: | ||
}} |
}} |
||
{{操作指南|QW:DOC}} |
{{操作指南|QW:DOC}} |
||
模板文档页模式是一种机制,用来将模板帮助文档从模板源代码中安全地分离成为帮助文档页面。这能够使得模板本身处于完全保护状态下,而说明部分保持未保护状态,让每个人仍然可以编辑模板帮助文档。 |
|||
== 能 |
== 能够解决什么问题? == |
||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
本'''說明'''頁面進一步闡釋對策和'''技巧''',用以滿足需要更新瀏覽器暫存記憶的人(or most commonly, learn from the first exposure! 解說文件是必須的,特別是為了停留在陡峭的維基學習曲線上的新加入編輯者。),以及增進效益使建構頁面變得更快、與擺脫伺服器處理(更新)時的讀取。(我們都希望頁面能夠更快地被載入!) |
|||
⚫ | |||
⚫ | |||
总括来说,有个双重办法可以将解说和使用方法置于一个“解说模板”,以取代<nowiki><noinclude>...</noinclude></nowiki>区块所围住的工具模板(若妥善运用的话,可以涵盖数个相关的工具型模板),这个方法同时具有两个明显的附加效果: |
|||
⚫ | |||
這個方法同時具有兩個明顯的附加效果: |
|||
⚫ | |||
⚫ | |||
⚫ | |||
== 使用方法 == |
== 使用方法 == |
||
假 |
假设有一个模板Template:X ,在Template:X的模板源代码底下加入以下的标示: |
||
:<code style="display:table; line-height:1.2em;">< |
:<code style="display:table; line-height:1.2em;"><span style="background-color: #FFFF66">[--模板的最后一行文字--]</span><noinclude><br>'''{{Documentation}}'''<br><nowiki> |
||
< |
</noinclude></nowiki><br><nowiki> |
||
</noinclude></nowiki><br/><nowiki> |
|||
</nowiki></code> |
</nowiki></code> |
||
保存 |
保存后,单击模板文档中的“创建”按钮,即可以对 Template:X/doc 进行编辑模板说明。如果该文档模板没有建立,以下的源代码会自动产生:(参见[[Template:Documentation/preload]]) |
||
<pre> |
<pre> |
||
{{NoteTA |
{{NoteTA |
||
第36行: | 第33行: | ||
}} |
}} |
||
{{Documentation subpage}} |
{{Documentation subpage}} |
||
<!-- 在本行下 |
<!-- 在本行下编辑模板说明 --> |
||
== 概要 == |
== 概要 == |
||
== |
== 参数及使用方法 == |
||
== |
== 范例 == |
||
== 注意事项 == |
== 注意事项 == |
||
第49行: | 第46行: | ||
== 模板编辑说明 == |
== 模板编辑说明 == |
||
== |
== 参见 == |
||
<includeonly>{{Sandbox other|| |
<includeonly>{{Sandbox other|| |
||
<!-- 本行下加入模板的分 |
<!-- 本行下加入模板的分类 --> |
||
}}</includeonly> |
}}</includeonly> |
||
第63行: | 第60行: | ||
:此外,子頁面的標題請'''必定要'''使用"/doc"的型式。 |
:此外,子頁面的標題請'''必定要'''使用"/doc"的型式。 |
||
:''''X/doc''''文件頁面的分類應該只有[[:Category:模板說明文件]],請調整原始碼讓屬於模板的分類只存在於模板主頁面。 |
:''''X/doc''''文件頁面的分類應該只有[[:Category:模板說明文件]],請調整原始碼讓屬於模板的分類只存在於模板主頁面。 |
||
:你可以將 /doc 子頁面的討論頁重定向到模板本身的討論頁,那麼最後所有有關模板及其文件頁的討論就會在同一討論頁上,舉個例,將 Template talk:X/doc 重定向到 Template talk:X。 |
:你可以將 /doc 子頁面的討論頁重定向到模板本身的討論頁,那麼最後所有有關模板及其文件頁的討論就會在同一討論頁上,舉個例,將 Template talk:X/doc 重定向到 Template talk:X。 |
||
現在這個模板可以被完全保護了。因為它的''''X/doc''''文件頁面並沒有被保護,所以任何人可以編輯該文件頁面。然而,注意[[ |
現在這個模板可以被完全保護了。因為它的''''X/doc''''文件頁面並沒有被保護,所以任何人可以編輯該文件頁面。然而,注意[[Qiuwen:保护方针|連鎖保護]]模板會使得文件頁面也被保護。 |
||
== 分类链接 == |
== 分类链接 == |