可视化编辑器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