小工具

小工具（Gadgets）是MediaWiki的一项拓展，让用户可以自由启用或关闭由JavaScript或CSS编写的工具，已于BWIKI安装。

由于缓存与ES5等原因，小工具在BWIKI的表现一般。

小工具定义

站点的所有小工具都需要经过位于MediaWiki:Gadgets-definition的定义页进行定义。定义页一般可分为三类内容：

1. 章节标题

   即一般的二级标题，形如== test ==，对应的界面信息须在MediaWiki:Gadget-section-test创建

2. 小工具列表

   对于各个小工具的核心定义，需符合正则表达式：/^\*+ *([a-zA-Z](?:[-_:.\w ]*[a-zA-Z0-9])?)(\s*\[.*?\])?\s*((\|[^|]*)+)\s*$/，此处内容可见下节的详细说明

3. 其它内容

   即不属于上述二者的其它内容。定义页面允许输入wikitext，在不属于上述二者之一的情况下将被忽略，不被视为定义内容，但仍可在定义页正常浏览，不影响小工具定义。

注意，尽管定义页的内容模型为wikitext，但其仅能由界面管理员进行编辑。

可用选项

小工具定义的大致格式为：

* 小工具名[选项]|脚本1|脚本2|或更多

建议此处的脚本1与脚本2等名称与小工具名相同，尽管这不是必须的。

下面仅列出BWIKI所处的MediaWiki 1.37可用选项。

ResourceLoader

是否启用资源加载器。一般情况下开启即可，若小工具仅包含CSS样式则可不启用。

例如：

* test[ResourceLoader]|test.js

dependencies

小工具的依赖项，将在该小工具的脚本执行前加载。

例如：

* test[ResourceLoader|mediawiki.api,mediawiki.user,ext.gadget.deps]|test.js

rights

仅对拥有这些权限的用户可见。可用权限参见特殊:用户组权限。

例如：

* test[ResourceLoader|rights=edit,delete]|test.js

hidden

是否在参数设置中可见。注意，当启用该选项时，若该小工具不是其它小工具的依赖，则应当同步启用default使其默认启用，否则将无法启用。

例如：

* test[ResourceLoader|hidden]|test.js

skins

小工具可用的皮肤。在BWIKI中一般无需设定。

default

是否默认启用该小工具。注意，默认启用的前提是用户已满足其它选项的要求（例如已拥有某个特定权限）。

例如：

* test[ResourceLoader|default]|test.js

type

小工具的类型，默认为general。若小工具仅包含CSS样式，可设置为styles（将不会加载任何指定的JavaScript文件）。

例如：

* test[ResourceLoader|type=general]|test.js

其它

如果对某个小工具设定了不存在的选项（例如rights=missingrights），则该小工具无法被用户于参数设置中所看到，但其它小工具仍可通过dependencies选项启用该小工具。

可以通过特殊:小工具来查看当前站点的小工具列表，通过特殊:小工具使用统计查看小工具的使用情况。

参见

• MediaWiki拓展文档