幫助:模板
如果你需要在多個頁面上包含同樣的文本的話, MediaWiki 的模板功能就起到作用了 (就像上面的幫助文檔都會有的標籤一樣)。
創建模板[編輯]
模板的頁面名稱最前面都有 Template:
,只要和其他頁面一樣創建就可以了。
使用模板[編輯]
模板除了作為普通的 wiki 頁面之外,還可以有以下三種使用方法:
{{模板名称}}
會將模板的當前內容包含在頁面內。{{subst:模板名称}}
會在保存後將模板的內容以平常可以編輯的方式 (wiki 代碼) 插入頁面源代碼中。{{msgnw:模板名称}}
會將模板的源代碼包含在頁面中,類似<nowiki>
一樣。
在模板中使用變量[編輯]
用數字編號的變量 | |
'''A little thank you...'''<br> <small>for {{{1}}}.<br> hugs, {{{2}}}</small> | |
你鍵入 | 你得到 |
{{thankyou|你所有的努力|小明}}
|
|
用名稱的變量 | |
'''A little thank you...'''<br> <small>for {{{reason}}}.<br> hugs, {{{signature}}}</small> | |
你鍵入 | 你得到 |
{{thankyou| reason=你所有的努力| signature=小明}} |
你可以用兩種方法在模板中定義變量:按數字編號的變量,例如 {{{1}}}
,或是命名的變量,例如 {{{变量名}}}
。
例子:你想要在別人的對話頁上插入一個小小的感謝留言。它將會包含一個原因和你的簽名。(這個例子的確很爛。)你可以創建 Template:Thankyou 來鍵入你的文字,就像表格中的例子一樣。
在頁面中使用模板的時候,填入變量的值,用管道符 (|) 分開:{{thankyou|你所有的努力|小明}}
。命名的變量,用"名字"="值",管道符分開:{{thankyou|reason=你所有的努力|name=小明}}
。在模板中使用命名變量的好處是次序可以隨意指定。並且,如果模板有很多變量的話,利用命名變量也比較容易理解。如果你需要改變編號變量的次序的話,需要把它們明寫出來:{{thankyou|2=小明|1=你所有的努力}}
你也可以為變量提供默認值,也就是沒有為變量填入值的時候會使用的值。舉例來說,如果沒有給 reason 提供值的話,{{{reason|你所有的努力|}}}
會得到「你所有的努力」。
控制模板嵌入[編輯]
你可以用<noinclude>
和 <includeonly>
來控制模板的哪些部分會被嵌入。
任何在<noinclude>
和 </noinclude>
之間的標記,都只會在直接查看模板頁面的時候顯示出來,而不會被包含在頁面中。
可能的使用方式有:
- 為模板分類
- 連接到其他語言版本中的類似模板的跨語言鏈接
- 關於如何使用該模板的解釋文字
與此相對的是<includeonly>
。在<noinclude>
和 </noinclude>
之間的文字只會在嵌入頁面的時候才會被處理或顯示。很明顯的一個使用方式是將所有有某個模板的頁面加入某個分類,而不將模板本身加入這個分類。
注意: 當你改變模板中的分類的時候,使用這個模板的分類可能不會立即改變;這會在工作排隊中處理。
整理模板[編輯]
為了使模板起作用,用戶需要找到並且了解如何使用模板。一個簡單的技巧是在模板頁面中插入一個例子。
例如:
<noinclude> == 用法 == 用这个模板来初始化水属性魔法: {{模板名称|关键字1+关键字2+关键字3}} </noinclude>
然後,編輯者就可以剪切粘貼來插入這個模板。
參見[編輯]
- 變量 -- 可能在某些模板中找到的花哨的東西