帮助:魔术字

来自瑾齋好學
跳转至: 导航搜索

魔術字是MediaWiki軟體所識別的特定字符串,它們可以返回特定的值或觸發其他的功能:比如時間、站點設置或是頁面名稱等等。此頁面只解釋標準魔術字的用法。

魔術字有三種類型:

  • 狀態開關:以兩個下劃線「__」為前後綴的大寫單詞,例如__FOO__
  • 變量:字符被兩個大括號括起來,所有字母大寫,例如{{FOO}}。用法與模板類似。
  • 解析器函數:一些形如{{foo:...}}{{#foo:...}}的魔術字,在使用時包含參數,且大小寫不敏感。

變量和解析器函數可以像模板一樣使用subst:。無論這個魔術字是通過被引用的模板添加的或者被包含的系統信息中添加的,依賴頁面的魔術字均將(默認)起作用或者返回當前頁面的數據。

行為開關

狀態開關可以控制頁面的顯示方式或其他行為。它往往用於排除或加入特定的頁面內容。

文字 描述 版本
目錄
__NOTOC__ 隱藏目錄(TOC)。
__FORCETOC__ 強制於默認位置(第一個章節標題上方,忽略__NOTOC__的設置)顯示目錄。
__TOC__ 在魔術字的位置插入目錄(忽略__NOTOC__的設置)。如果這個魔術字在一個頁面內被多次使用,目錄將會被放置在首個__TOC__出現的位置。
編輯
__NOEDITSECTION__ 隱藏章節標題旁的編輯連結。這個特別有用,當章節標題在模板中被創建時,普通的編輯連結將用戶帶到編輯模板代碼界面,這與用戶的直覺不符。如果模板包括多個標題,有必要在每個標題後加上「$noeditsection」。
__NEWSECTIONLINK__ 在非討論頁頂端「編輯頁面」標籤右側加入一個按鈕,用於在頁面結尾加入新的章節。 >=1.7
__NONEWSECTIONLINK__ 移除討論頁頂端「編輯頁面」右側的加入新章節連結。 >=1.15
分類
__NOGALLERY__ 用於分類頁面。不顯示分類中所包含文件的縮略圖,而以普通連結代替。 >=1.7
__HIDDENCAT__ 用於分類頁面。加入後此分類成為隱藏分類,將不會顯示在上級分類其及成員頁面的分類列表中。 >=1.13
語言轉換
__NOCONTENTCONVERT__
__NOCC__
在語言有不同變體時(如中文簡體和繁體),不對當前頁面進行字詞轉換。比如只顯示中文,而不是顯示大陸簡體、台灣繁體、新加坡繁體和香港繁體。
__NOTITLECONVERT__
__NOTC__
在語言有不同變體時(如中文簡體和繁體),不對當前頁面進行標題轉換(其他內容照常轉換)。
其他
__START__ 無影響。 <=1.10
__END__ 明確表明文章的結尾,來防止Mediawiki刪除文末的空格。 1.1 - 1.8
__INDEX__ 允許搜尋引擎檢索本頁(忽略$wgArticleRobotPolicies的參數設置,但無法忽略robots.txt)。服從$wgExemptFromUserRobotsControl的設定。 >=1.14
__NOINDEX__ 禁止搜尋引擎檢索本頁。服從$wgExemptFromUserRobotsControl的設定。 >=1.14
__STATICREDIRECT__ 用於重定向頁。當有人移動頁面並勾選「更新所有指向原始標題的重定向」時,禁止MediaWiki更新本頁的重定向。(需要變量$wgFixDoubleRedirects) >=1.13

變量