用戶:妹空醬/Wikiplus/設置說明

在1.5.0版本之後您將可以自定義wikiplus的某些設置，設置以json格式存儲在localstorage中。

設置格式為

{
    "设置名" : "设置值",
    "设置名" : "设置值",
}

請注意，設置值中如果有半角單引號'出現，請以\'轉義。

說在前面

設置值為字符串

您可以將設置值定義為靜態字符串，按上一小節所示格式即可。

設置值為匿名函數

您還可以把設置值設置為匿名函數。

示例：

{
    "defaultSummary" : "function(){return '正在使用wikiplus编辑页面[[' + mw.config.get('wgPageName') + ']]'}"
}

注意的事項有以下幾點

1. 匿名函數請放在雙引號內。
2. 在匿名函數內的引號請使用單引號，或使用\"來轉義。
3. Wikiplus將先嘗試用new Function()來解析您的設置值，如果解析失敗或認為是非函數類型將作為字符串返回。
4. 上述示例的效果是(以此頁為例)：默認編輯摘要將會是："正在使用Wikiplus编辑页面[[User:妹空酱/Wikiplus/设置说明]]"
5. 匿名函數有無限的可能性，請自行探索~
6. 在匿名函數內可以調用mediawiki的一些常量(參考Manual:Interface/JavaScript)和wikiplus提供的一些私有變量，具體設置具體說明。
7. 函數必須有返回值，且返回值與undefined在非嚴格判斷下不相等。如果您的函數沒有返回，請使用return true。（此時編輯摘要將會為「//快速編輯 via Wikiplus」）

在匿名函數內調用私有變量

要求wikiplus版本>=1.5.2

需要當前設置項提供了私有變量支持

如果您需要在匿名函數內調用私有變量。請為您的匿名函數設置一個形參，名稱不限。

示例：

function(w){
	return w.sectionName;
}

所有提供的私有變量將集成為一個對象傳入，請以object[key]或object.key的方式調用具體值。

注意，此處的w接受wikiplus傳入的一個參數，並非全局變量，並隨着使用情況可變。

設置列表

defaultSummary

鍵名：defaultSummary

接受類型：String

可插入的內聯變量：

1. sectionName 當前編輯的段落名，如編輯全頁返回頁面名。
2. sectionNumber 當前編輯的段落編號，如編輯全頁返回0。

escToExitQuickEdit

鍵名：escToExitQuickEdit

接受類型：Boolean

說明：將本值設為true則可以使用esc來退出快速編輯頁面

disableEditEveryWhere

鍵名：disableEditEveryWhere

接受類型：Boolean

說明：將本值設為true可以禁用外部連結的快速編輯功能。

language

鍵名：language

接受類型：String

說明：本值不為空時，會把語言版本強制指定為該值。