扩展名:VisualEditor

来自MediaWiki.org
跳转到导航 跳转到搜索
这个分机MediaWiki 1.35附带以及以上。因此,您不必再次下载它。但是,您仍然需要遵循提供的其他说明。
MediaWiki扩展手册
OOjs UI icon advanced.svg
视觉编辑器
发布状态: 贝塔
VisualEditor-logo.svg
实施 页面操作 ,扩展语法 ,Beta功能 ,皮肤
说明 允许将页面编辑为丰富的内容
最新版本 持续更新
兼容性策略 释放分支
维基百科 1.36-α
数据库更改
许可证 麻省理工学院执照
下载
自述文件

  • $wgVisualEditorPluginModules
  • $wgVisualEditorReloadModules
  • $wgVisualEditorReferenceModules
  • $wgVisualEditorRestbaseURL
  • $wgVisualEditorFullRestbaseURL
  • $wgVisualEditorSerializationCacheTimeout
  • $wgVisualEditorAvailableNamespaces
  • $wgVisualEditorAvailableContentModels
  • $WgVisualEditorUseChangeTaging
  • $wgVisualEditorEnableWikitext
  • $wgVisualEditorEnableDiffPage
  • $wgVisualEditorEnableDiffPageBetaFeature
  • $wgVisualEditorUseSingleEditTab
  • $wgVisualEditorSingleEditTabSwitchTime
  • $wgVisualEditorTab位置
  • $wgVisualEditorTabMessages
  • $wgVisualEditorAutoAccountEnable
  • $wgVisualEditorDisableForAnons公司
  • $wgVisualEditorTransitionDefault
  • $wgVisualEditor显示欢迎
  • $WgVisualEditorNewAccountEnable比例
  • $WgVisualEditor反馈标题
  • $WgVisualEditor反馈API URL
  • $wgVisualEditorSkinToolbarScrollOffset
  • $wgVisualEditorBrowserBlacklist
  • $wgVisualEditorEnableTocWidget
  • $wgVisualEditorRebaserURL
转换VisualEditor扩展
检查使用情况和版本矩阵。
流浪角色 视觉编辑器
问题 打开的任务·报告错误

这个视觉编辑器扩展允许将页面编辑为丰富的内容。还有一个项目其目标是为Web和MediaWiki创建一个可靠的富文本编辑器。

VisualEditor扩展依赖于基于欧芹需要安装并启用的解析器服务,以便使用它编辑页面。

用户指南

参见帮助:VisualEditor/用户指南.

下载

对于一般用户:如果您使用的是MediaWiki的最新稳定版本,则需要从中下载VisualEditor MediaWiki扩展ExtensionDistributor页.

对于高级用户:

以下下载说明用于仅限MediaWiki的最新夜间版本.

cd扩展
 git克隆https://gerrit.wikimedia.org/r/mediawiki/extensions/VisualEditor.gitcd-VisualEditor 
 git子模块更新--init

注释 注:

  • VisualEditor MediaWiki的主分支包含Wikimedia中使用的最新代码。这段代码可能有轻微的缺陷或不稳定,但可能比旧版本有更少的bug和更多的特性。
  • 主分支需要MediaWiki的alpha版本(目前,1.34.0-wmf.13)并且不能与旧版的MediaWiki(如1.31)一起使用;为此,请使用REL1\u 31号分支(命令:git克隆-b REL1\u 31wiki.wiki.wiki/media扩展名).
  • 这个git子模块更新——initVisualEditaleCore需要VisualEditCore作为子模块。如果不使用此命令,VisualEditor将无法工作.

如果你不能使用git(例如如果您使用的是气隙式安装),则可以从下载VisualEditor MediaWiki for master或MediaWiki发行版的快照ExtensionDistributor页. 得到代码后,将其保存到扩展/可视化编辑器你的wiki目录。

皮肤相容性

已知VisualEditor与以下皮肤兼容:

其他皮肤不受官方支持,但它应该与任何使用所需HTML结构的皮肤兼容–请参阅视觉编辑器/皮肤要求. 对皮肤样式表进行一些修改可能是必要的,以使一切看起来很好。如果匹配特征检测,它将加载到任何皮肤上。

设置VisualEditor

建立Parsoid服务

没有欧芹js服务您将无法编辑页面或保存页面!

如果您想使用VisualEditor编辑现有页面并保存页面,则需要一个Parsoid服务,该服务可以在wikitext和VisualEditor显示用于编辑的HTML之间进行转换。

要建立自己的Parsoid服务,请遵循Parsoid安装说明在设置VisualEditor之前。注意,设置Parsoid和节点.js在非标准系统中,如运行Windows或Debian的系统。

下面是非官方的某些MediaWiki版本上的VisualEditor与欧芹服务。一般来说,如果在安装过程中遇到问题完全匹配版本(VisualEditor、Parsoid和MediaWiki)应该是您首先尝试的事情之一,即使此表中指出不匹配的集合可能会起作用。

帕索德→
MediaWiki↓
0.4.1款 0.6.0 0.6.1款 0.7.0 0.7.1款 0.8.0 0.9.0
兼容
0.9.0 0.9.0+ 0.10.0 0.11.0
1.34
1.33
1.32
1.31 -(四) -(四)
1.30 -(四) -(四) -(二) -(二)
1.29 -(二) -(二)
1.28 -(二) -(二)
1.27 - -(二) -(二)
1.26 -(三) -(三) -
1.25 -(一) -
1.24 -
1.23 -

标题:

X=测试,工作
-=测试,非工作

注意事项:

(a) =与0.6.1不兼容(实验室:T100681)
(b) =与0.9.0不兼容(邮箱:wikitech-l/2018年3月/089690.html);从0.9.0之后的版本(当前未发布)中没有更多兼容模式
(c) =在很大程度上,可以添加文本,但不能修改现有文本
(d) =Parsoid 0.6+MW 1.30和可能1.31的图像问题(主题:Ufpghq2hidcj3d3w)
0.9 compat=修改的Parsoid代码(查看此博客)或者是一个特定的Parsoid结构(查看此主题)

Node.js和Parsoid兼容性矩阵

帕索德→
节点.js↓
0.4.1款 0.6.0 0.6.1款 0.7.0 0.7.1款 0.8.0 0.8.1款 0.9.0 0.10.0 0.11.0
12
10
8
六+

MediaWiki VisualEditor的基本配置

默认情况下,MediaWiki VisualEditor不会为用户启用自身。要使其可用,请将以下行添加到您的wiki本地设置.php下载扩展名后:

wfLoadExtension( '可视化编辑器' );

//默认为所有人启用
$wgDefaultUserOptions[“visualeditor启用”] = 1;

//可选:将VisualEditor设置为匿名用户的默认值
//否则他们将不得不切换到VE
//$wgDefaultUserOptions['visualeditor-editor']=“visualeditor”;

//不允许用户禁用它
$wgHiddenPrefs美元[] = “visualeditor启用”;

//可选:启用VisualEditor的实验性代码功能
#$wgDefaultUserOptions['visualeditor-enable-experimental']=1;

请注意,您可以在安装之前执行此操作Parsoid node.js服务尝试使用VE;这意味着您可以在自己的wiki上以“创建”模式试用编辑器,但您将无法保存或编辑现有页面。

如果您使用的是MediaWiki 1.25或更高版本,那么可以在VE之前或之后加载其他加载VE插件的扩展;这些插件应该都能正常工作。

更改活动命名空间

默认情况下,VisualEditor仅对名称空间“Main”、“User”、“File”和“Category”启用。但是,可以添加或删除名称空间。有很多方法可以做到这一点,但建议使用为各个名称空间定义的规范名称。请注意,这与MediaWiki核心和几乎所有扩展不同。

删除命名空间(例如“File”)
$wgVisualEditorAvailableNamespaces = [
    “文件” => 
];
添加命名空间(例如“Help”和“Extra”是自定义名称空间)
$wgVisualEditorAvailableNamespaces = [
    “帮助” => 是的,
    “额外” => 是的
];
添加和删除名称空间(例如“File”和“Extra”是自定义名称空间)
$wgVisualEditorAvailableNamespaces = [
    “文件” => ,
    “额外” => 是的
];

与Parsoid连接

要让VisualEditor与Parsoid对话,请将以下代码添加到本地设置.php要指定Parsoid实例:

$wgVirtualRestConfig['模块']['帕索德'] = 阵列(
    //Parsoid实例的URL
    //如果使用Debian软件包,请使用端口8142
    '网址' => 'http://localhost:8000',
    //Parsoid“域”,见下文(可选)
    '域' => '本地主机',
    //Parsoid“prefix”,见下文(可选)
    '前缀' => '本地主机'
);

一个Parsoid服务器可以处理多个wiki。帕司样体设置将wiki配置标识为Parsoid。是否设置显式或可选地接受默认值$wgVirtualRestConfig必须与Parsoid的值匹配配置.yaml. 默认情况下,它被设置为名为的主机名$wgCanonicalServer,但可以选择任意字符串。旧版本的Parsoid还使用一个唯一的“前缀”来标识服务器;您可能还需要在这里列出它。

Parsoid必须配置为匹配,例如与Parsoid中的配置.yaml:

    姆瓦皮斯:
        - #这是唯一必需的参数,
          #MediaWiki API终结点的URL。
          uri: 'http://path/to/my/wiki/api.php'
          : '本地主机'
        - #还有另一个MediaWiki
          uri: 'http://path/to/my/otherwiki/api.php'
          : '唯一标识符'

如果使用的是早于0.6.0的Parsoid,则应该在Parsoid的本地设置.js比如:

parsoidConfig.塞姆瓦皮({ uri: 'http://path/to/my/wiki/api.php', : '本地主机', 前缀: '本地主机' });

同样,“domain”属性在Parsoid配置中是可选的;它默认为在uri属性(如果未指定)。“prefix”属性也可以省略,除非您运行的是非常旧的Parsoid版本。

看到了吗安装/PAROID配置更多细节。

在Wikitext编辑和VisualEditor之间切换
警告 警告: 不要在私有wiki上安装RESTBase!RESTBase当前无法配置为保持页面内容私有,但将使所有页面内容公开访问。

VisualEditor允许您在wikitext和可视化编辑之间来回切换。

但是,没有RESTBase公司服务器,从wikitext切换到可视编辑可能会导致脏的差异保存时(非语义空白更改为wikitext格式)。如果您希望能够在wikitext编辑和VisualEditor之间切换,并且保存更改而不存在脏差异,则必须安装RESTBase服务器。(之前T214542型,根本不可能在没有RESTBase的情况下进行切换。)

如果你不能在你的wiki基础上仔细地设置你的wiki,如果你不能使用你不想要的改变$wgVisualEditorAllowLossySwitching=错误.

当切换不可能,并且您试图从wikitext编辑环境切换到VisualEditor时,您唯一的选择是取消放弃更改并切换;如果您切换,您所做的任何更改都将被放弃。[1]

用于切换的RESTBase设置

要设置自己的RESTBase服务,请遵循RESTBase安装说明. 请注意,如果您成功地设置了Parsoid服务,那么设置RESTBase服务器是类似的,因为它也运行在Node.js下。

对于VisualEditor,您不需要中的配置部分配置.yamlRESTBase配置部分.

RESTBase服务器运行后,将以下代码添加到本地设置.php:

$wgVirtualRestConfig['模块']['restbase'] = [
  '网址' => “http://yourRESTBaseserver.com:7231”,
  '域' => {域}',
  'parsoidCompat' => 
];

VisualEstFullEditorWgURL = 'http://yourRESTBaseserver.com:7231/{domain}/';

哪里{域}是的价值'域'您在Parsoid配置文件中指定(您应该在配置中更改它)。确保您在此处指定的端口(例如。:7231个)与您在RESTBase配置中指定的端口相同。

如果您无法访问RESTBase端口(例如。:7231个),您可以通过httpd代理绕过。参考如果Restbase端口被阻塞. 如果您的wiki是通过HTTPS提供服务的,RESTBase必须通过HTTPS提供服务;否则用户可能会遇到“混合内容”错误,并且从wikitext到VisualEditor的切换无法工作。

现在,当您在wikitext编辑器中进行更改时,您可以切换到可视化编辑器而不会造成脏的差异。

如果您通过https(2018年的标准程序)为wiki提供服务,则必须通过https服务RESTbase与欧司体相似也不能避免混合内容错误. 有简明易懂的讨论在这里. 别忘了把下面的混合起来文档. 记住在使用stunnel时不要忘记调整端口号。
具有多个虚拟站点的服务器

如果在虚拟站点配置中配置了多个站点访问权限(默认情况下),则只有在虚拟站点配置中才可以访问多个站点。若要检查此问题,请运行curl“[http://your wiki base url]/api.php”在服务器上。

如果响应以以下内容开头:

<!DOCTYPE html><html格式 =“英语GB” 方向=“ltr” =“客户编号”><>< 字符集=“UTF-8” /><标题>MediaWiki API帮助-['''''wiki的名称''''']</标题>

那么您就没有问题了,但是如果没有问题,您可能需要配置Parsoid可以使用的主机别名:

查看托管wiki的虚拟服务器的apache2配置文件,在文件顶部附近应该有一行类似于:

<VirtualHost*:80>

如果存在“*”,则别名可以指向localhost,如果有IP地址替换“*”,则别名必须指向该IP地址。

在同一文件中添加一行:

ServerAlias我的维基别名

对于虚拟主机,如果在虚拟主机配置中为apa.0服务器添加一个/che2地址,则添加一个/che2地址。

最后,在Parosoid本地设置.js文件,找到parsoidConfig.setMwApi设置,并将其设置为:

parsoidConfig.塞姆瓦皮({
  uri: 'http://my_wiki_别名:80/path to my wiki/api.php',
  : '/*my Parsoid“domain”与LocalSettings.php中的值匹配*/',
  前缀: '/*my Parsoid“prefix”匹配LocalSettings.php中的值*/'
});

重新加载network config、apache config和Parsoid config,然后重新测试上面的curl命令。

相同的方法适用于主机上多个虚拟服务器上托管的多个wiki(使用不同的别名并添加parsoidConfig.setMwApi为每个wiki设置)。

与私有wiki中的Parsoid链接
警告 警告: 所有当前选项都有重大、严重的安全隐患. 在应用这些技巧之前请仔细考虑。现在最好的选择是提供HTTPS上的Parsoid. 将来,这将与MediaWiki适当集成,不需要采取特殊措施。

尝试以下三个选项之一:

将Cookie转发给Parsoid
警告 警告: 只有在了解通过HTTP向Parsoid发送Cookie头的安全含义的情况下,才在私有wiki上启用此功能!但请参见下面的HTTPS部分)
//此功能需要非锁定会话存储。会话将不起作用
//尝试使用此功能时将导致死锁(Parsoid的连接超时)。仅适用于MediaWiki 1.26.x及更早版本!
$wgSessionsInObjectCache = 是的;

//将用户的Cookie:headers转发到Parsoid。私有wiki所需(需要登录才能阅读)。
//如果wiki不是私有的(即$wggroupermissions['*']['read']为true),则此配置
//变量将被忽略。
//
//警告:只有在了解安全含义的情况下,才在私有wiki上启用此功能
//通过HTTP向Parsoid发送Cookie头。出于安全原因,强烈建议
//如果启用此设置,$wgVirtualRestConfig['modules']['parsoid']['url']将指向localhost。
$wgVirtualRestConfig['模块']['帕索德'][“转发Cookies”] = 是的;
Parsoid绕过身份验证,不转发cookies

上述方法的另一种选择是显式地为来自parsoid服务器的请求授予读取权限。有两种建议的解决方案:

注意 注:将这两个示例解决方案中的127.0.0.1替换为运行Parsoid的服务器的IP地址。当然,只有在Parsoid服务器位于“受信任”网络上时,才应该这样做。

1) 使用网络认证延伸

Cookie的转发(以及$wgSessionsInObjectCache以及转发Cookies属性)可以通过添加用户(可以调用欧芹)添加到wiki,然后添加网络认证扩展名为“php.settings:

需要一次 "美元IP/扩展名/NetworkAuth/NetworkAuth.php“;
$wgNetworkAuthUsers[] = [
	'iprange' => [ '127.0.0.1' ],
	'用户'    => '帕索德'
];

其中IP地址与Parsoid服务器的IP地址匹配,用户与您添加到wiki中的地址匹配。

2) 绕过权限设置方式
警告 警告: 你的wiki将允许你的Parsoid在这个端口上可读。您应该确保Parsoid端口不允许外部通信。

设置后$wggroup权限在“LocalSettings.php”中添加以下内容:

如果 ( !伊塞特( $服务器['远程地址'] ) 或者 $服务器['远程地址'] == '127.0.0.1'	) {
	$wggroup权限['*']['阅读'] = 是的;
	$wggroup权限['*']['编辑'] = 是的;
}

其中IP地址与Parsoid服务器的IP地址匹配。解决方案如下:按IP地址显式删除Parsoid的限制.

HTTPS上的Parsoid

默认情况下,Parsoid只支持HTTP连接。但是,使用Stunnel很容易提供HTTPS Parsoid,Stunnel是一个为任意套接字提供SSL包装的实用程序。大多数Unix发行版在存储库中都有“stunnel”或“stunnel4”包。首先安装stunnel:

sudo apt安装stunnel

然后你需要一个stunnel的配置文件。它位于/etc/stunnel/*.conf,请使用您喜欢的编辑器在此处创建,例如nano:

sudo nano/etc/stunnel/parsoid.conf

给文件类似的内容如下:

证书 = /etc/ssl/my\certs/parsoid.crt
钥匙 = /密钥/myu密钥
咖啡馆 = /etc/ssl/my_ca/ca.crt

[帕索德]
接受  = 8143
连接 = 8142

首先定义服务器使用的ssl密钥的路径。 然后在括号中为服务指定一个您喜欢的名称。它只是为了知道这个配置应该做什么,并在同一个文件中分离不同的配置接受为公共传入连接写入端口号,该端口号是ssl加密的连接key写入intern端口号,stunnel应该将来自接受端口的流量路由到该端口,但是没有ssl。这是你的监听端口。如果你使用Parsoid/显影剂设置使用端口号8000,否则8142是标准端口。

如果使用的是“让我们加密”,则可以使用以下命令(将“<domain>”替换为您拥有证书的主URL):

证书 = /etc/letsencrypt/live/<domain>/fullchain.pem
钥匙 = /etc/letsencrypt/live/<domain>/privkey.pem

[帕索德]
接受  = 8143
连接 = 8142

这个例子使用它自己的parsoid子域并用letsencrypt保护它。

stunnel配置文件现在已经准备好,但是您还需要两件事来激活配置:

首先让stunnel在重启后工作。因此在'1'文件中启用了更改/etc/默认/stunnel4

sudo nano/etc/default/stunnel4
启用=1

第二,如果你现在不想重启,你必须启动服务

sudo/etc/init.d/stunnel4重新启动

对于Ubuntu16.x,命令改为

sudo systemctl重新启动stunnel4.service

要测试配置,您可以在浏览器中检查,如果parsoid服务器正在通过ssl连接应答。(例如,在浏览器的地址行中写下:“https://parsoid.mydomain.com:8143”)。如果答案是“欢迎使用Parsoid web服务”,那么恭喜您-您已成功地安装了Parsoid。剩下的一步是:一旦这是有效的,你必须使用适当的网址(例如'https://parsoid.mydomain.com:8143')在VisualEditor的MediaWiki配置中。注意从http到https的更改,以及您在stunnel配置文件中的accept下设置的端口号。

如果您不想像这里一样为parsoid创建额外的子域,您也可以使用现有的子域(例如[wiki]如果它列在.阴极射线管文件,然后相应的URL将变成:https://wiki.mydomain.com:8143)。

  • 不能将这种类型的配置与通过“localhost”访问的Parsoid一起使用,因为localhost的证书链(几乎肯定是自签名的)将无法验证。您必须为Parsoid服务器使用正确的主机名,以及适当颁发和签名的SSL证书。
  • 您可以为stunnel启用SSL隧道。参见Debian/etc/default/stunnel4

设置这样的配置可以避免在明文中传输parsoid cookies的安全隐患。

生成和安装SSL证书超出了本文档的范围。 阅读有关stunnel的更多信息:

Windows和其他系统上的Parsoid

在非标准系统(如运行Windows或非标准Linux的系统)中使用Parsoid设置VisualEditor尤其复杂且耗时—这些困难甚至可能会妨碍某些人在某些平台上成功安装VisualEditor:

设置共享宿主时

看到了吗在共享主机上安装VisualEditor

快速配置指南

特征 Beta功能选择加入状态 允许所有人选择加入 允许所有人选择退出 为所有未选择退出的用户启用
视觉模式 开箱即用。
$wgDefaultUserOptions['visualeditor自动禁用'] = 是的;
$wgDefaultUserOptions[“visualeditor启用”] = 1;
$wgDefaultUserOptions[“visualeditor启用”] = 1;
$wgHiddenPrefs美元[] = “visualeditor启用”;
Wikitext模式
$wgVisualEditorEnableWikitextBetaFeature = 是的;
$wgVisualEditorEnableWikitext = 是的;
$wgVisualEditorEnableWikitext = 是的;
$wgDefaultUserOptions[“visualeditor newwikitext”] = 1;
$wgVisualEditorEnableWikitext = 是的;
$wgDefaultUserOptions[“visualeditor newwikitext”] = 1;
$wgHiddenPrefs美元[] = “visualeditor newwikitext”;
单个编辑选项卡 不是受支持的配置。
$wgVisualEditorUseSingleEditTab = 是的;
$wgDefaultUserOptions['可视化编辑器选项卡'] = '多选项卡';
$wgVisualEditorUseSingleEditTab = 是的;
默认的“编辑”选项卡将记住最后一个编辑器,并使用wikitext编辑器打开进行首次编辑;如果您希望它成为可视化编辑器,还可以添加:
$wgDefaultUserOptions['可视化编辑器'] = “可视化编辑器”;
$wgVisualEditorUseSingleEditTab = 是的;
$wgDefaultUserOptions['可视化编辑器'] = “可视化编辑器”;
$wgHiddenPrefs美元[] = '可视化编辑器选项卡';
历史页面上的视觉差异
$wgVisualEditorEnableDiffPageBetaFeature = 是的;
当前不支持配置。 当前不支持配置。
$wgVisualEditorEnableDiffPage = 是的;

配置选项的完整列表

显示的每个配置选项都没有$wgVisualEditor为简洁起见,请在使用时替换“…”。

选项 默认值 有用的… 文档
…插件模块
[]
扩展开发人员 当加载的是VisualEditAlloader的字符串数组时,应该加载该数组。扩展VisualEditor的其他扩展应该添加到此数组中。
警告 警告: 移除生产站点上的模块时(例如Wikimedia),首先将其从数组中删除,等待更改传播,然后才删除模块代码和模块注册。否则,可能会有一段时间VisualEditor依赖于不存在/不再存在的模块。
…预装模块
[
    “站点”,
    “用户”
]
扩展开发人员 应在加载VisualEditor之前加载的ResourceLoader模块名称(字符串)数组。扩展VisualEditor并需要在加载前设置其环境的其他扩展应添加到此数组中。
警告 警告: 移除生产站点上的模块时(例如Wikimedia),首先将其从数组中删除,等待更改传播,然后才删除模块代码和模块注册。否则,可能会有一段时间VisualEditor依赖于不存在/不再存在的模块。
…首选项
{
	“visualeditor启用实验”: “ext.visualEditor.实验性”
}
扩展开发人员 加载VisualEditor时应加载的ResourceLoader模块名称(字符串)的关联数组如果当前用户具有首选项集。如果其他扩展VisualEditor的扩展希望添加的内容是opt-in或opt-out,则应该将其添加到此数组中。键是首选项名称,值是ResourceLoader模块名称。

还记得设置默认值$wgDefaultUserOptions!

…RestbaseURL

系统管理员 用于访问主RESTbase调用的URL。页面名称将直接附加到此值之后,因此需要将其设置为类似于'https://en.wikipedia.org/api/rest_v1/page/html/'包括尾随的斜杠。

如果设置了此选项,则将从RESTbase请求页面HTML。如果未设置,则将从API请求页面HTML,API将向Parsoid或RESTbase(如果可用)发送HTTP请求。

…FullRestbaseURL

系统管理员 用于访问RESTbase其余部分的URL。页面名称将直接附加到此值之后,因此需要将其设置为类似于'https://en.wikipedia.org/api/rest_'排除尾随的斜杠。
…全自动开关
是的
系统管理员 是否允许从wikitext切换到visualeditor,即使这样做也可能导致脏的差异。看到了吗#在Wikitext编辑和VisualEditor之间切换.
…序列化缓存超时
3600
系统管理员 序列化缓存超时(秒)
…可用的名称空间
[
    “用户” => 是的,
    “文件” => 是的,
    “类别” => 是的,
    “合并策略” => “array\u plus”
]
系统管理员 要在其中启用VisualEditor的命名空间(从命名空间规范名称映射到布尔标志),位于$wgContentNamespaces.
…可用的内容模型
[
    “维基文本” => “文章”,
    “合并策略” => “array\u plus”
]
扩展开发人员 要在其中启用VisualEditor的内容模型(从内容模型名称映射到布尔标志)。
…使用更改标记
是的
系统管理员 是否将更改标签在每次使用VisualEditor进行编辑时。
…启用WikiText

系统管理员 是否启用wikitext源模式在VisualEditor内。
…启用DiffPage

系统管理员 是否启用视觉差异历史专题页上的函数。
…启用DiffPageBetaFeature

系统管理员 是否允许用户启用视觉差异作为测试版功能在历史特别页面上运行。
…可视化启用编辑

系统管理员 是否允许用户启用节编辑。
…使用SingleEditTab

系统管理员 是只使用一个编辑选项卡,来回切换,还是在现有选项卡旁边添加一个专用的VisualEditor编辑选项卡。
…单一编辑选项卡切换时间
20160101000000
系统管理员 警告现有编辑器安装已从两个编辑选项卡切换到一个编辑选项卡的时间戳。一般来说,你应该忽略这一点。
…标签位置
'之前'
系统管理员 如果显示两个编辑选项卡,那么VisualEditor编辑选项卡相对于系统(或WikiEditor)的位置:
  • “之前”:将其放在旧的“编辑”选项卡之前
  • “之后”:将其放在旧的编辑选项卡之后
…标签消息
{
	“编辑”: 无效的,
	“编辑源”: “visualeditor ca editsource”,
	“创建”: 无效的,
	“createsource”: “visualeditor ca createsource”,
	“editlocaldescriptionsource”: “visualeditor ca editlocaldescriptionsource”,
	“createlocaldescriptionsource”: “visualeditor ca createlocaldescriptionsource”,
	“编辑部分”: 无效的,
	“editsectionsource”: “visualeditor ca editsource节”
}
系统管理员 如果显示两个编辑选项卡,则配置用于各种编辑选项卡用户可以看到的消息:

'编辑–用于VisualEditor编辑选项卡的i18n消息键;如果无效的,将使用默认的“编辑”选项卡标题visualeditor虚拟编辑'消息可用于此。

'编辑源'–用于旧编辑选项卡的i18n消息键;如果无效的,则不会更改选项卡的标题

'创造–用于VisualEditor创建选项卡的i18n消息键;如果无效的,将使用默认的“创建”选项卡标题visualeditor可以创建'消息可用于此

'createsource公司–i18n消息键,用于旧的“创建”选项卡;如果无效的,则不会更改选项卡的标题

'editlocaldescriptionsource'–i18n消息键,用于外部回购文件页面上的旧编辑选项卡;如果无效的,选项卡的标题将不会更改

'createlocaldescriptionsource–i18n消息键,用于外部回购文件页面上旧的“创建”选项卡;如果无效的,选项卡的标题将不会更改

'编辑部'–用于VisualEditor部分编辑链接的i18n消息键;如果无效的,将使用默认的编辑节链接标题

'editsectionsource–用于源部分编辑链接的i18n消息键;如果无效的,链接的标题将不会更改

…自动帐户启用

系统管理员 是否为每个新帐户启用VisualEditor。

这样你就可以保持visualeditor启用'默认情况下禁用首选项,但仍有VisualEditor可供新登录用户使用(通过将其设置为是的).

…不适用于Nons

系统管理员 是否为未登录的用户禁用VisualEditor

这允许您启用'visualeditor启用'默认情况下首选项,但仍对已注销用户禁用VisualEditor(通过将此设置为是的).

…过渡故障

系统管理员 对于计划使用'visualeditor betatempdisable'在默认情况下为所有现有用户启用自动退出现有用户的首选项,是否开始记录显式退出与隐式退出。
…显示欢迎
是的
系统管理员 是否在用户第一次使用VisualEditor时显示“欢迎使用beta”对话框
…新帐户启用比例

运行用户分析的系统管理员 是否基于userID为所有新帐户的一部分(埃及分数)启用VisualEditor。
…反馈标题

系统管理员 是否在VisualEditor的“帮助”菜单中启用MediaWiki反馈工具。如果启用,则为指向MediaWiki反馈工具的页面标题。
…反馈API URL

系统管理员 如果已设置,则为指向MediaWiki反馈工具的远程wiki的API。
…SkinOffset工具栏
[]
皮肤显影剂 映射到要设置工具栏滚动偏移的像素值的蒙皮名称数组。
…浏览器列表
{
	“火狐”: [
		[
			"<=",
			11
		]
	],
	“狩猎”: [
		[
			"<=",
			6
		]
	],
	“歌剧”: [
		[
			"<",
			12
		]
	],
	“msie”: [
		[
			"<",
			10
		]
	]
}
VisualEditor开发人员 与VisualEditor不兼容的浏览器列表。看到了吗jquery.客户端用于规范。如果用户的浏览器匹配,VisualEditor将拒绝加载。

火狐——维基链接存在腐败([[./]])Firefox14及以下版本的bug(任务T52720)这阻碍了更广泛的可用性。

游猎–旧版本的Safari存在各种旧浏览器插件的损坏问题。

歌剧–低于版本12,Opera未经测试,由于其用户群几乎不存在,因此它被封锁了。

Internet Explorer–版本9或更低版本,在布局和功能支持方面存在各种不兼容。版本10和11应该可以正常工作。

没有单独列出,因为它是从MediaWiki本身继承的,安卓在3.x及以下版本支持CE,但不会触发键盘输入或有其他问题,这对用户来说毫无用处。

…启用Widget

VisualEditor开发人员 是否启用(目前正在试验的)目录小部件
…重新设置URL

VisualEditor开发人员 用于访问实验性的rebar技术的URL。如果为false,则不加载该技术。

旧配置参数

警告 警告: 在VisualEditor的最新版本中不再使用这些参数;为了与建议的升级路径兼容,这里对它们进行了说明。

如上所示,每个配置选项都没有$wgVisualEditor简洁的前缀。

选项 MW版本 默认值 文档
…名称空间 1.22至1.25
  • 1.22(PHP配置):
    $wgContentNamespaces
    
  • PHP(配置文件23.1-1):
    阵列合并( $wgContentNamespaces, 阵列( NS_用户 ) )
    
  • 1.25(extension.json):
    []
    
名称空间ID的列表,其中VisualEditor被激活。

此参数基本上已被替换为…可用的名称空间从1.26开始。

…支持皮肤 1.22至1.28
[
	“矢量”,
	“顶点”,
	“单行本”,
	“密涅瓦”,
	“蓝图”
]
VisualEditor集成支持的外观列表。如果用户的皮肤不匹配,VisualEditor将拒绝加载。

这被需求的动态检查所代替(表161373).

相关配置参数

另请参见上载对话框配置(适用于wiki系统管理员)有关配置拖放/复制粘贴功能以通过VisualEditor上载媒体文件的信息。

整合“2017维基文本编辑器”

由于发布分支“REL1_29”(MediaWiki 1.29及更高版本),还可以激活所谓的“2017维基文本编辑器”. 要启用它并同时使其在默认情况下可供所有用户使用,请在“LocalSettings.php”文件中添加以下内容:

$wgVisualEditorEnableWikitext = 是的;
$wgDefaultUserOptions[“visualeditor newwikitext”] = 1;
$wgHiddenPrefs美元[] = “visualeditor newwikitext”;

如果您希望所有用户都能将2017 wikitext editor作为测试版功能提供,即让用户自行选择,请安装Beta功能将以下内容添加到“LocalSettings.php”文件中:

$wgVisualEditorEnableWikitext = 是的;
目前还没有合适的用户偏好,因为开发人员正在等待beta特性的运行,然后再继续。[2]
启用wikitext语法突出显示

还可以为“2017 wikitext editor”启用wikitext语法高亮显示。为此,您必须另外安装码镜扩展。

展开可视化编辑器

故障排除

从服务器HTTP 500加载数据时出错。是否要重试?
出现此问题的可能原因:
  • 在新安装时,服务器上不会安装“curl”、“php5 curl”或“php7.0-curl”(或其他适合您的PHP版本的包)。
  • setMwApi uri设置不正确,例如https而不是http。
  • apache配置中的错误重写规则会导致API失败。
  • SSL/TLS证书已过期。
  • 使用Apache运行Windows身份验证时,需要在Apache conf中列出127.0.0.1,因为Apache没有读取权限。
1<目录 “D:/Wiki/htdocs”>
2...
4    允许127.0.0.1条
5    满足 任何
6</Directory>
parsoidserver http curl错误:无法连接到主机。
Parsoid没有运行,或者$wgVirtualRestConfig['modules']['parsoid']['url']设置不正确
parsoidserver http curl错误:无法连接到….:权限被拒绝。
可能是由上的cURL请求引起的安全增强式Linux(SELinux,如CentOS)到非标准端口(如上述示例配置中的8000),请参阅拒绝连接http://www.kak-php-curl.com/https://www.centos.org/forums/viewtopic.php?f=47&t=53223&p=225372#p225372
parsoidserver http错误状态:401
由读取或编辑限制引起的。如果您已经设置了一个私有wiki并且不想使用cookie转发,那么可以按IP地址显式删除Parsoid的限制.
找不到parsoidserver http:404(或超时)
由指向MediaWiki API终结点的错误路径导致。将正确的url设置为api.php文件在帕索德家本地设置.js配置文件。如果您已按照建议进行设置,则API路径将为“http://localhost/w/api.php". {localpath:'mwoidjs.Add“pars.API”设置http://localhost/w/api.php' });".
parsoidserver http不可接受:406
由Parsoid 0.9强制客户端在头中返回1.6.0及更高版本的HTML版本字符串所导致。这很可能会影响到Debian用户,因为他们在使用Mediawiki的Parsoid APT存储库时使用稍旧的Mediawiki版本。这可以通过降级到0.8(不容易,因为存储库中不再存在0.8)或编辑/usr/lib/parsoid/src/lib/config/ParsoidConfig.js以便ParsoidConfig.prototype.strictAcceptCheck=假;. 后者将在任何包升级时被覆盖,因此由管理员手动锁定包并保持最新状态。
无可见错误(似乎永远加载)
检查parsoid日志文件,并查阅Parsoid/故障排除.

工具书类

另请参见