SyntaxHighlight 是「Syntax highlighter」指令碼的分叉版本,原作者是 MediaWiki.org 上的 Remember the dot。
這個指令碼將過去在 Fandom 舊平台上可用的語法醒目提示帶回 UCP 的原始碼編輯器 (又名 WikiEditor 或 2010 年版 Wikitext 編輯器)。
Installation
Usage
要想使用這個指令碼,必須保證您使用的是 2010 年版編輯器,只需移至編輯器的偏好設定,將偏好的編輯器變更為 [原始碼編輯器] 即可。
[原始碼編輯器] 必須是您的偏好編輯器
然後,您需要點選編輯器工具列上的麥克筆圖示以停用預設的語法醒目提示。
保證麥克筆圖示為非使用狀態
Configuration
指令碼支援各種控制外觀和行為的自訂選項。
色彩
指令碼的設定適合所有 Fandom Wiki,所有的色彩配置都使用與舊 Fandom 平台上相同的色彩集:
淺色 Wiki
- bold or italic
#e4e5f3for syntax$boldOrItalicColor - comments
#f8dbdafor syntax$commentColor - entities
#e8ebdafor syntax$entityColor - external links
#dbecebfor syntax$entityColor - headings
#e4e5f3for syntax$headingColor - hr syntax
#e4e5f3for syntax$hrColor - list and indents
#f8dbdafor syntax$listOrIndentColor - parameters
#f5e0d8for syntax$parameterColor - signatures
#f5e0d8for syntax$signatureColor - tags
#f6dde9for syntax$tagColor - tables
#f0ebdbfor syntax$tableColor - templates
#f0ebdbfor syntax$templateColor - internal links
#d9eaf6for syntax$wikilinkColor
深色 Wiki
- bold or italic
#44466dfor syntax$boldOrItalicColor - comments
#4d1a19for syntax$commentColor - entities
#474d23for syntax$entityColor - external links
#244d491for syntax$entityColor - headings
#44466dfor syntax$headingColor - hr syntax
#44466dfor syntax$hrColor - list and indents
#4d1a19for syntax$listOrIndentColor - parameters
#66331efor syntax$parameterColor - signatures
#66331efor syntax$signatureColor - tags
#662946for syntax$tagColor - tables
#5e5129for syntax$tableColor - templates
#5e5129for syntax$templateColor - internal links
#245477for syntax$wikilinkColor
自訂色彩
然而,透過您可以透過編輯 window.syntaxHighlighterConfig 物件,並將其新增至 Wiki 上的「MediaWiki:Wikia.js」頁面來自訂 Wiki 的醒目提示選項。接受下列設定:
window.syntaxHighlighterConfig = {
boldOrItalicColor: '',
commentColor: '',
entityColor: '',
externalLinkColor: '',
headingColor: '',
hrColor: '',
listOrIndentColor: '',
parameterColor: '',
signatureColor: '',
tagColor: '',
tableColor: '',
templateColor: '',
wikilinkColor: ''
};
設定範例:
window.syntaxHighlighterConfig = {
externalLinkColor: '#FFCC66',
wikilinkColor: '#E6FFFF'
}
其他選項
您可以於 Syntax highlighter 文件 (英文網頁) 中了解其他更多可用的設定選項。
原始指令碼
這個指令碼的原始程式碼可在 MediaWiki.org 頁面「User:Remember the dot/Syntax highlighter.js」中取得,由以及其他貢獻者創建。這個指令碼在 MediaWiki.org 以及其他維基媒體基金會 Wiki 中作為小工具使用。
A version of the original upon which this script has been based can be found in the top comment on MediaWiki:SyntaxHighlight.js.
如果您認為這個指令碼存在一般問題,即不只是特指在 Fandom 上執行時出現的問題,請考慮在上游的原始指令碼討論頁面中向 Remember the dot 回報問題。
相較於原始版本的變更
為確保這個指令碼可以在 Fandom 正確運作,對於原始版本,這個版本做出了一些必要的修改。這些包括:
- Added support for i18n-js library to assure easy and user-friendly translation updates.
- 一些效能改進。
- 為深淺色佈景主題的 Wiki 變更預設色彩設定,以反映舊平台上常用的設計。
- 對於原始標籤的延伸預設設定,新增
<infobox>與<templatedata>標籤的支援。 - 這個版本專門為 Fandom 的 UCP Wiki 製作,所以這個指令碼刻意不會在 MediaWiki 1.19 版本的 Wiki 上執行。
可能問題
儘管這個指令碼現應能夠在所有 Fandom Wiki 上運作,但仍有一些問題可能會發生:
- 不適當的 Wiki 佈景主題偵測導致色彩無法讀取
- 這個版本的指令碼使用與 Fandom 舊平台上使用的版本不同的 Wiki 佈景主題指示器,這可能會導致不正確的行為,但非常罕見。如果您遇到這個問題,請套用自訂的色彩設定。
- 指令碼未載入,並顯示錯誤訊息
- 與 Fandom 舊平台上使用的版本不同,這個指令碼具有預設的、更嚴格的逾時組態,如果已超過逾時,則將擲回錯誤訊息。如果您遇到這個問題,請將自訂的逾時組態套用為
150毫秒,而非25毫秒。
- 與 Fandom 舊平台上使用的版本不同,這個指令碼具有預設的、更嚴格的逾時組態,如果已超過逾時,則將擲回錯誤訊息。如果您遇到這個問題,請將自訂的逾時組態套用為