引言

MediaWiki的复杂与强大不是短短一篇文章就能表达清楚的，如果你无意间进入这里，而你又恰巧对它感兴趣，那么它能引领你进入这个神奇的世界。如果你已经是资深的wiki玩家，不嫌弃的话也可以帮忙指正一下其中的错误，我将不甚感激。

作此文一则为了督促自己继续学习，不要有一搭没一搭的。二则也是在过程中遇到了很多问题，常常花了很多精力都没办法处理。所以痛定思痛，老老实实地整理总结。

一、什么是MediaWiki？

MediaWiki是一个最初为维基百科量身打造的自由开源的wiki套件，用PHP语言写成。现在，非营利的维基媒体基金会下辖的所有wiki项目、互联网上的众多其他wiki网站以及MediaWiki主页都建基于此套软件上。Wiki是一种在万维网上开放且可供多人协同创作的超文本系统，由沃德·坎宁安于1995年首先开发。沃德·坎宁安将wiki定义为“一种允许一群用户用简单的描述来创建和连接一组网页的社会计算系统”。

二、为什么使用MediaWiki？

MediaWiki的最大作用在于对知识的归档，可用于构建企业/个人知识库。

不过有一点需要明确，能实现Wiki功能的系统可不止MediaWiki一家，它之所以最为出名完全得益于维基百科的影响力，而它开源的特性也使得全世界所有人都可以对它的代码进行优化。对于其他Wiki软件及其优劣对比，可参考维基百科上的文章《Wiki软件比较》。

虽然国内关于MediaWiki的资料不多，但其良好的开放性可以让你轻易地从其他采用该系统的站点上查看到相应的代码和内容，以便你能快速理解条目编辑、模板创建等工作。如果你愿意，甚至可以直接复制你所需要的代码到你的网站上。

另外，强大的扩展功能也会使得站点如虎添翼，事半功倍。只是千万别忘了它的存在是为了知识的收集和整理，如果整日想着让它更加炫酷是否违背了初衷还请自行思量（因为我就很容易犯这样的问题）。

建议：

如果你从未接触过wiki系统却又打算采用MediaWiki，那么强烈建议你先在维基百科上尝试一下各种操作并且阅读基本的操作手册。

三、安装MediaWiki

注意：

1. 为方便演示，本文均在虚拟机下操作

2. 安装过程中会有帮助提示，可点击参考

3. 所有安装设置都能通过修改配置文件重新调整，所以在不确定选项的情况下请选择默认

4. 服务器和数据库的搭建不在本教程范围之内

你可以从官网上下载最新版本的MediaWiki程序（截至本文发布时，该软件的稳定版本已升级至1.31）。

PS：从MediaWiki 1.31版开始，PHP如果低于7.0以下版本是不支持安装的。为方便演示，以下采用MediaWiki 1.30版本。

将压缩包解压到网站根目录下，用浏览器打开出现如下界面：

可以看到提示没有LocalSettings.php文件(这是MediaWiki的配置文件，在后面的简易设置和进阶教程中我们还会用到它)，我们通过逐步设置来生成该文件。

点击“complete the installation”来到下一个页面

首先来到的是语言设置界面，MediaWiki1.30支持超过350种以上的语言，其中光中文选项就有9种（还不包括粤语、文言文等其他跟中文相关的语言）

从消息文件（关于消息文件的内容会在另一篇文章中详细讲）中我们可以看到，每个语言文件的大小都不一样，最大的就是简体中文。

默认选择中文（支持简体及繁体），点击继续。

这次是环境检查，Mediawiki1.30的配置要求是

• PHP 5.5.9或更高版本
• MySQL 5.5.8或更高版本

具体要求在官网上都有说明。从图片上我们能够看到虽然有警告内容，但并没有妨碍我们继续安装下去，只是说官方建议开启某些服务（这也是为了更好地运行系统或某些扩展所需要的），这里暂时忽略，点击继续。

紧接着就是数据库的配置，默认使用root账号并且密码正确的话，可以自动生成相应的数据库。但建议为MediaWiki单独建立一个数据库账户和新数据库，以减少风险；或者在下一步中另建一个用户。

如果你跟我一样在上一步中直接采用root账号继续的，那么到这一步最好还是新建一个权限相对低一些的账号以确保数据库安全。如果本身是权限较低的数据库管理账号，那么使用同一个也无所谓。

在这里我使用默认的wikiuser账号添加一个新密码，然后继续。

记得给你的网站以及作为管理员的你起个霸气点的名字。

其中一项“项目名字空间”可能会让你产生疑惑，但建议你还是选择默认。

如果你玩过维基百科，就会知道很多以“维基百科:”开头的条目都是跟网站的使用及管理有关的，而这个前缀就是所谓的项目名字空间。

如果你是第一次玩MediaWiki，对皮肤及扩展等毫无概念，那么可以选择“我已经不耐烦了，赶紧安装我的wiki。”完成安装。

或者你的好奇心很强，那就继续往下看

其他选择默认就可以了，单看扩展程序这里，建议其中的“Cite（引用扩展）”、“ParserFunctions（解析器扩展）”、“ConfirmEdit（反垃圾扩展）”和“WikiEditor（wiki编辑器）”一定要勾选。

如果不知道该选什么也没关系，后面的内容会讲到如何开启这几项扩展的。

一切都OK的话，点击继续，有可能会出现一个全部配置完毕的页面，下面的文本框中可以添加你想新增的设置代码，我们同样直接点击继续。

提示你下载LocalSettings.php文件，保存后将它添加至你的Wiki站点根目录下。

重新输入你的网站地址，如果能看到跟下面差不多的画面，那么恭喜你，你的安装成功了！

提示：如果你想重新设置MediaWiki，可以在浏览器中输入http://domain/directory/mw-config/index.php（ 将 directory 换成您MediaWiki的解压位置 如果是本地安装的话将 domain 替换成localhost），然后点击右侧的“重新开始安装”。当然，你也可以通过下面的内容进一步设置。

注意：一旦你的配置完成，强烈建议你将mw-config目录给删除，以防止被别有用心的人利用。

四、MediaWiki简易设置

其实大部分设置在你的安装过程中都已经被配置完毕并保存在了LocalSettings.php文件中，接下去的说明都是围绕这个文件展开，我们将着重介绍最常用的几个变量（新安装完毕的用户，在首页“新手入门”的第一项内容“MediaWiki配置设置列表”中有详细说明）。

注意：

你用账户登录之后，右上角会有个参数设置，在其中调整的都是跟你本人有关的内容（如语言、皮肤等），对其他用户并没有影响，请不要将其等同于系统设置。

五、MediaWiki扩展安装

MediaWiki作为一款优秀的开源Wiki软件系统，其强大之处就是有大量配套插件为其服务，打开看看维基百科的版本页面，你会发现它使用的所有扩展。

如果你的目标很简单，就是做一个跟维基百科差不多的网站，那么照着它里面的扩展下载安装就成了。我们找几个最常用和最经典的来学习一下。

基本说明：

• 通常从网上下载的扩展压缩包，解压后将其上传至extensions/目录下；
• 要启用该扩展，只需在LocalSettings.php文件中添加相应的启用代码（后续所述的扩展中都附上了启用代码）。

1. Cite

描述：

增加用于引用的和标签。

基本效果：

说明：它可以将标签内的参考引用自动编号并汇总在一起，然后由以列表形式自动生成。启用：

wfLoadExtension("Cite");

2. ParserFunctions

描述：用逻辑函数加强解析器。说明 ：ParserFunctions扩展提供11个附加解析器函数以补充MediaWiki固有的“魔术字”。在维基百科的模板中，有时候你能在{{后面看到某些诸如#ifeq:、#ifexist:这样开头的内容，这就是解析器的函数。可以这样说，不管是你打算直接复制维基百科的模板，还是未来打算直接制作模板都可能会用上它。启用：

wfLoadExtension("ParserFunctions");

3. WikiEditor

描述：提供可扩充的维基文本编辑界面及功能组件。基本效果：

说明：比起MediaWiki原始简陋的编辑器而言，这款可以说是极大地提升了工作效率。虽然比不上可视化编辑器，但也足够了，况且安装又是如此便捷。启用：

wfLoadExtension( "WikiEditor" );

备注：如果希望体验可视化编辑器请关注后续文章。

以上几项都是安装包中自带的扩展，更多内容请关注后续文章。

七、维基农场

所谓“维基农场”是指Wiki多站点(也称维基自助托管平台）——就是用同一份MediaWiki代码去开多个站点。如果你玩过WordPress的多站点，那么相信对于这个也不会太陌生。对于很多想开Wiki站点又懒得维护的朋友，找一个维基农场还是一个不错的主意，所有的维护和开发工作都交由“农场主”来负责，而你的任务就是专心写你的百科。国内目前做得最好的农场就是灰机Wiki。如果有兴趣可以参考一下官网的《手册:Wiki多站点》，我这里就不详述了。

八、相关网站

1. MediaWiki官网及维基百科：如果没有语言障碍，强烈建议将其作为首选。大量的技术文档、操作手册和讨论几乎涵盖你能遇到或者想到的所有问题。至于中文资料，翻译的质和量都不高，况且因为政策缘由也无法直接浏览（指维基百科的中文站点）。这里强烈呼吁各位能够多帮忙翻译一下技术文档。
2. 灰机Wiki国内最知名的维基农场，本土化和二次开发的能力相当强。他家的技术文档和使用手册都是用心之作，没事去转转，汲取点灵感。
3. 萌娘百科同样知名的MediaWiki站点，而且属于一眼就能看出是wiki的站点。
4. 森亮号航海见识该网站貌似很久没有更新了，系统版本仍停留在1.26.4。但不可否认其中有很多内容还是值得一看的，尤其玩维基百科的朋友可能会发现其中有部分汉化的配置就出自该站长之手。