可视化编辑器VisualEditor的安装,要是顺利的话按照教程一步步来不会有什么太大问题。所有的难点基本上都集中在Parsoid的安装和配置上面,比如说防火墙或者是服务器安全组对端口的限制,Selinux没有禁用,node的版本问题,这些从网络上也都能搜索到。
最近碰到个新问题,服务器中有一个老的Wiki,是从其他服务器迁移过来用于调试的,都由于有新的需要,还得继续新安装一个Wiki。常规安装和使用都OK,唯一的难点就是可视化编辑器。
我们知道,可视化编辑器VisualEditor是依赖于Parsoid的支持的,并且其配置文件config.yaml中都只定义一个域名地址,如下:

mwApis:
        - # This is the only required parameter,
          # the URL of you MediaWiki API endpoint.
          uri: 'https://wiki.mindseed.cn/api.php'
          # The "domain" is used for communication with Visual Editor
          # and RESTBase.  It defaults to the hostname portion of
          # the `uri` property above, but you can manually set it
          # to an arbitrary string. It must match the "domain" set
          # in $wgVirtualRestConfig.
          domain: 'wiki.mindseed.cn'  # optional

那么,两个域名的话又该怎么弄呢?根据官网上的教程,实践如下:

mwApis:
        - # This is the only required parameter,
          # the URL of you MediaWiki API endpoint.
          uri: 'https://wiki.sinoema.com/api.php'
          # The "domain" is used for communication with Visual Editor
          # and RESTBase.  It defaults to the hostname portion of
          # the `uri` property above, but you can manually set it
          # to an arbitrary string. It must match the "domain" set
          # in $wgVirtualRestConfig.
          domain: 'wiki.sinoema.com'  # optional
        - # Another wiki,
          uri: 'https://wiki.psyseed.cn/api.php'
          domain: 'wiki.psyseed.cn'

其中- # Another wiki,这里是必须的,注释内容可以不同,但是横线必须有,否则重启Parsoid会提示duplicated mapping key错误。

至于MediaWiki配置文件LocalSettings.php,基本上维持原样就可以了,这里再贴一下:

$wgVirtualRestConfig['modules']['parsoid'] = array(
     // URL to the Parsoid instance
     // Use port 8142 if you use the Debian package
     'url' => 'localhost:8000',
     // Parsoid "domain", see below (optional)
     'domain' => 'wiki.mindseed.cn',
     // Parsoid "prefix", see below (optional)
     'prefix' => 'wiki.mindseed.cn'
 );

最后,有个好消息是,从1.35版开始MediaWiki对Parsoid的安装有了大的改动,以后会越来越便利,所以不急的朋友可以静待最近的新版本发布。

参考:
https://www.mediawiki.org/wiki/Parsoid/JS/Setup#Configuration

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