用MediaWiki有一段時間了,整理幾個必備插件,做個備忘.
- SyntaxHighlight_GeSHi 代碼高亮,使用相當方便
效果見圖
下載方法:SVN Checkout就行,SVN地址:
用方法,修改LocalSettings.php,加入下面的代碼。
1: require_once("extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php");
2.FCKeditor
高級編輯器,MediaWiki默認的那個實在是簡單的慘不忍睹
效果:
對比一下原來的: ,差距大吧…
下載地址:
1: http://mediawiki.fckeditor.net/nightly/svn/mediawiki_fckeditor_ext_N.zip
2: http://svn.fckeditor.net/MediaWiki/trunk (SVN地址)
使用方法:
- 首先下載最新版的FCKeditor,解壓,然後拷貝全部文件到extensions\FCKeditor\fckeditor文件夾。
- 然後修改LocalSettings.php,加入下面的代碼便可。
1: require_once( "extensions/FCKeditor/FCKeditor.php" );
3.圖片擴展,MediaWiki添加圖片是在是不方便,用了LinkedImages就方便多了。加了這個插件後引用圖片就可以這樣來寫:
1: <linkedimage>
2: wikipage=Main_Page
3: tooltip=Main Page
4: img_src=Image:Sample.gif
5: img_width=10%
6: img_height=10px
7: img_alt=Sampletext
8: </linkedimage>
怎麼樣,方便吧。
- 下載以及安裝方法見鏈接
4. Cooltable,小插件一個。
它的主要功能就是給MediaWiki的表格增加了一個特效,當你鼠標移動至表格中某一單元格時改變其背景,類似於選中後高亮的那種效果。見圖:
具體的顏色可以在插件的源代碼裏修改,搜索coolTable.php中的”objRef.style.backgroundColor=’#EEE’;” 把#EEE’替換成你要的顏色便可。
下載地址見http://paulgu.com/wiki/Cool_Table
使用方法還是老樣子,修改LocalSettings.php,加入 include(“extensions/coolTable.php”);搞定。
使用方法很簡單:<cooltable> 你的表格代碼 </cooltable> 。
注意,只能是HTML的表格,MediaWiki的表格無效。
V 0.2 於 20090526 更新了fckeditor的安裝方法,加了個Cooltable插件
插件安裝
原生的mediawiki的默認使用方式十分晦澀,需要使用者具備相當的html語言功底和足夠的耐心,這個大概也是開源軟件的通病,相對易用性而言,它們更願意將注意力放在提升軟件性能來接近商業軟件。
不過好在國內外無數的meidawiki愛好者們爲其開發了若干第三方插件,大大的豐富了它的功能,有興趣的同學,可以在這個網站上進行一一尋找:mediawiki extensions擴展
同樣與商業軟件相比,開源的插件在兼容性上有着相對糟糕的表現。通過這些天的不斷遴選,我認爲如下幾個插件很有必要安裝。
WYSIWYG extension (版本1.5.6_0 [B551], CKEditor 3.6 (revision 6902))
評價
WYSIWYG的全稱是What You See Is What You Get,所見即所得。通俗點說就是富文本編輯器。CKEditor只是其中的一個版本,mediawiki在1.18版本開始,會在extensions中默認放置另外一種富文本編輯器WikiEditor,只需要在LocalSettings.php設置對應選項即可激活。
進入文本編輯條目時,選擇框上方的“使用富文本編輯器”即可以激活CKEditor編輯器。
在對比了CKEditor,WikiEditor,MeanEditor等多個編輯器之後,筆者還是選擇了CKEditor這個版本,因爲無論從界面表現還是選項豐富程度而言,這款WYSIWYG的表現都是最好的。但是美中不足的是,由於筆者缺乏經驗,該款富文本編輯器仍然有一些瑕疵,希望後來的同學能夠給出更好的建議。
- CKEditor的使用會帶來一定的冗餘代碼。當掌握了一定的wiki語法之後,可能同學們更願意自己排版頁面以達到最好的使用效果,這時候筆者建議”禁用富文本“編輯器,直接使用默認的wiki編輯器即可。
- CKEditor在有一欄toolbar(即Semantic tools一欄)在默認安裝的模式下並未激活,需要安裝其他的插件纔可以,筆者嘗試了幾次,以失敗告終,導致某些功能無法激活。
- CKEditor有些功能並未集成到toolbar當中,比如說添加分類,加文本框等等,但是可以通過一些小技巧達到目的。
- CKEditor在IE瀏覽器下無法正常顯示。
- 使用CKEditor會造成某些wiki語句不顯示,直接以使用結果的方式表現,比如說分類語句([[Category:xxx]]),添加該語句後你你無法在文本框中找到它。這是個非常糟糕的嚴重問題,以至於必須得用第三方插件來避規,筆者正在研究解決方法……
當然,CKEditor的優點自不用說。
- 你終於可以自定義字體的大小,可以直觀的選擇文本的各級標題了。
- 你可以自由的添加表格,插入圖畫(雖然這個功能比word又差了很多)
- 你可以在ctrl-z之外,還有個”撤銷“按鍵來回退。
- 最重要的是,你可以通過”從MS Word粘貼“的框欄中,將你的文檔導入到wiki當中,可以基本保證你原本文檔的排版風格,只需要做稍微修改就可以達成美化目的,而不需要從頭再寫一遍。
安裝
進入網站,選擇1.18x的安裝文件(雖然是1.18版本,不過1.19確實也能使用)。
下載完成後,解壓存放到/mediawiki/extensions/目錄下。
進入LocalSettings.php文件,激活該插件
- require_once("$IP/extensions/WYSIWYG/WYSIWYG.php");
- $wgDefaultUserOptions['usebetatoolbar'] = 1;
- $wgDefaultUserOptions['usebetatoolbar-cgd'] = 1;
- $wgDefaultUserOptions['wikieditor-preview'] = 1;
Vector(版本0.3.0)
評價
如果你注意到了左邊側邊欄的分類摺疊效果,那麼恭喜你,這個條目是你應該讀的。在mediawiki的早期版本中,如果想做出側邊欄的摺疊效果必須在skin/目錄下更改對應皮膚文件的css效果,這個對筆者來說不亞於晴天霹靂。不過當安裝了這個插件後,vector皮膚的摺疊效果自然就出來了。
同時,安裝了這款插件之後,一些原本會出現的css顯示問題也都被解決了(比如富文本編輯器的顯示),不知道兩者之間是否有關聯。
安裝
下載完成後,解壓存放到/mediawiki/extensions/目錄下。
進入LocalSettings.php文件,激活該插件
- # add Vector
- require_once( "$IP/extensions/Vector/Vector.php" );
SelectCategory(版本0.8.1)
評價
SelectCategory是爲了在編輯條目過程中,方便添加條目分類項所加入的插件。加入該插件後,條目編輯者可以看見在所編輯文本框的下方有關於“分類”的樹形圖。編輯者可以根據自己的情況將本條目置於對應的一個或多個分類名稱下。
但是,該插件在MW1.19版本下仍有一些問題:
無法通過AJAX將分類樹形圖層次化,日後分類項多了勢必會非常冗餘。在引入插件CategoryTree之後,分類可以以分類樹的方式展現,直觀漂亮。- 無法通過該工具添加新的分類,只能在已有的分類中進行選取。如果要添加新的分類,仍需要使用wiki語法:[[Category:分類]]來添加。
- 當某條目編輯完成時已經選取對應的分類,如果用戶再次編輯該條目,用戶需要再次選取該條目對應分類,否則有可能造成此條目分類爲空的情況。
總體上說,該工具對於初次使用mediawiki的人來說,還是比較直觀方便。因此筆者安裝了此插件。對於上述的若干問題,也會在將來爭取解決。
當掌握了一定的wiki語法之後,筆者仍然建議大家拋棄富文本編輯器,以純文本的方式添加分類名稱。
安裝
下載完成後,解壓存放到/mediawiki/extensions/目錄下。
進入LocalSettings.php文件,激活該插件
- require_once('extensions/SelectCategory/SelectCategory.php');
UploadLocal
評價
mediawiki自帶的上傳功能比較糟糕,即使對上傳設置進行了配置,仍然難以達到批量上傳的目的。爲此筆者安裝了插件UploadLocal,通過該插件可以ftp的方式批量上傳文件,且文件類型不受限制(exe文件不可以直接上傳,需要打包)。
總體來說,該插件在mediawiki下的表現尚佳,用戶只很方便就可以將大量的文件上傳至服務器,唯一的缺陷是對中文支持不好,因此注意需要在文件命名時使用英文。
安裝
下載完成後,解壓存放到/mediawiki/extensions/目錄下。
進入LocalSettings.php文件,激活該插件
- require_once("$IP/extensions/UploadLocal/UploadLocal.php");
- $wgUploadLocalDirectory=your/upload/directory;
SyntaxHighlight
評價
SynataxHighlight是用來爲代碼高亮的插件,當代碼文件較多時可以使用該插件達到代碼高亮的目的,支持目前流行的多種編程語言。
安裝
下載完成後,解壓存放到/mediawiki/extensions/目錄下。
進入LocalSettings.php文件,激活該插件
- require_once("$IP/extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php");
- $wgSyntaxHighlightDefaultLang = "java";