MediaWiki插件

用MediaWiki有一段时间了,整理几个必备插件,做个备忘.

1. SyntaxHighlight_GeSHi 代码高亮，使用相当方便

效果见图

下载方法:SVN Checkout就行，SVN地址:

   1: http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/SyntaxHighlight_GeSHi/

     用方法,修改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文件，激活该插件
[php] view plaincopy
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文件，激活该插件
[php] view plaincopy
# add Vector  
require_once( "$IP/extensions/Vector/Vector.php" );  
SelectCategory（版本0.8.1）
评价
SelectCategory是为了在编辑条目过程中，方便添加条目分类项所加入的插件。加入该插件后，条目编辑者可以看见在所编辑文本框的下方有关于“分类”的树形图。编辑者可以根据自己的情况将本条目置于对应的一个或多个分类名称下。
但是，该插件在MW1.19版本下仍有一些问题：
无法通过AJAX将分类树形图层次化，日后分类项多了势必会非常冗余。在引入插件CategoryTree之后，分类可以以分类树的方式展现，直观漂亮。
无法通过该工具添加新的分类，只能在已有的分类中进行选取。如果要添加新的分类，仍需要使用wiki语法：[[Category:分类]]来添加。
当某条目编辑完成时已经选取对应的分类，如果用户再次编辑该条目，用户需要再次选取该条目对应分类，否则有可能造成此条目分类为空的情况。
总体上说，该工具对于初次使用mediawiki的人来说，还是比较直观方便。因此笔者安装了此插件。对于上述的若干问题，也会在将来争取解决。
当掌握了一定的wiki语法之后，笔者仍然建议大家抛弃富文本编辑器，以纯文本的方式添加分类名称。
安装
进入网站，通过svn工具下载插件。
下载完成后，解压存放到/mediawiki/extensions/目录下。
进入LocalSettings.php文件，激活该插件
[php] view plaincopy
require_once('extensions/SelectCategory/SelectCategory.php');  
UploadLocal
评价
mediawiki自带的上传功能比较糟糕，即使对上传设置进行了配置，仍然难以达到批量上传的目的。为此笔者安装了插件UploadLocal，通过该插件可以ftp的方式批量上传文件，且文件类型不受限制（exe文件不可以直接上传，需要打包）。
总体来说，该插件在mediawiki下的表现尚佳，用户只很方便就可以将大量的文件上传至服务器，唯一的缺陷是对中文支持不好，因此注意需要在文件命名时使用英文。
安装
进入网站，下载插件。
下载完成后，解压存放到/mediawiki/extensions/目录下。
进入LocalSettings.php文件，激活该插件
[php] view plaincopy
require_once("$IP/extensions/UploadLocal/UploadLocal.php");  
$wgUploadLocalDirectory=your/upload/directory;  
SyntaxHighlight
评价
SynataxHighlight是用来为代码高亮的插件，当代码文件较多时可以使用该插件达到代码高亮的目的，支持目前流行的多种编程语言。
安装
进入网站，下载插件。
下载完成后，解压存放到/mediawiki/extensions/目录下。
进入LocalSettings.php文件，激活该插件
[php] view plaincopy
require_once("$IP/extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php");  
$wgSyntaxHighlightDefaultLang = "java";