如果你刚刚安装完MediaWiki,打算要提高一下默认的文本编辑器,那么基本上会有两个选择:使用WikiEditor插件,从2015年开始它已经成功地运用于绝大多数的MediaWiki站点上——当然也包括维基百科——或者是它的另一个分支——新的可视化编辑器VisualEditor,它从2015年开始被维基百科官方运用而逐渐闻名。

快速对比

首先,对于我们所谈论的做一个快速浏览。这是MediaWiki编辑器,很有可能是你现在正在使用的:
mediawiki-default-editor.jpg
这是WikiEditor
mediawiki-wiki-editor.jpg
而这个就是VisualEditor
mediawiki-visual-editor.jpg
从纯粹的可视化要求看,我们可以很清晰地找出优胜者。无论如何,在自己的MediaWiki环境中安装可视化编辑器Visual Editor都不是件轻而易举的事:需要足够的经验(大量的实践),你的主机服务器也能满足大量的控制请求——或者其他你能使用的——因为你不必安装其他东西,包括专门的Node.js替代要求的Parsoid服务。
如果你真对此感兴趣,我们有一个易于理解的指南,你可以通过官方网站《VisualEditor/Installation on a shared host》来了解。
相反地,安装WikiEditor仅仅需要几分钟的时间,如果你想提高编辑者的体验而又不想花费太多的时间,它将是一个很好的选择。

下载WikiEditor

事实上,你可能都已经拥有它了——除非你是几年前安装的MediaWiki——WikiEditor扩展从MediaWiki的1.18版开始就默认包含在安装包内。为了确认这一点,你可以打开/extensions/目录看看里面是否有/WikiEditor/这个文件夹。如果有的话你可以直接跳到下一段,否则就按照下面的方法:

  • Download MediaWiki extension页面上下载插件
  • 将文档解压缩到/extension/WikiEditor/目录中,不要创建额外的子目录(最初的php文件必须在那里)

    安装和设置

    打开MediaWiki安装根目的LocalSetting.php文件,查找到扩展的那部分,开头几行如下所示:

    # Enabled Extensions. Most extensions are enabled by including the base extension file here
    # but check specific extension documentation for more details
    # The following extensions were automatically enabled:

    在那后面你可以看到很多wfLoadExtension('SOME_NAME')这样的代码行,每一个都是已经安装的扩展。在这个清单后面添加如下内容,或者它早已存在却被注释掉的话,取消注释就可以了。
    wfLoadExtension('WikiEditor');
    如果你使用的是MediaWiki 1.24或者是更老的版本,你将看到一行行的include声明代替了wfLoadExtension。那是因为wfLoadExtension方法直到MediaWiki 1.25版才被添加。如果你是在早期版本上安装这个扩展,可以用下面的代码代替前面的:
    require_once "$IP/extensions/WikiEditor/WikiEditor.php";

    测试

    在你保存完已经设置好的LocalSettings.php文件后,WikiEditor就可以取代默认的编辑器供所有用户使用了。你可以很容易地通过创建新文件或者是编辑之前的内容来检验是否已经成功。
    好了,就到这里:祝你书写愉快!

本文翻译自https://www.ryadel.com/en/enable-wikieditor-mediawiki/

另外,也可参见本站的另一篇文章《为MediaWiki安装可视化编辑器

最后修改:2019 年 01 月 14 日
如果觉得我的文章对你有用,请随意赞赏