MediaWiki中有一个很强大的插件叫做Gadget(神探加杰特?),很多新手朋友在安装完系统之后可能都没有意识到它的存在,但在浏览维基百科或者其他百科时常会发现某些很有意思的小功能,它们往往都是通过Javascript和css来实现的,比如下面这个收缩侧边栏的功能(仅适用Vector主题)。
MediaWiki-CollapsibleSidebar.png
我们都知道,MediaWiki中如果要使用上述两种代码,最方便的就是加入到MediaWiki:Common.js或者MediaWiki:Common.css中,但试想一下,如果每一项功能的代码都要往上面填的话,以后维护的时候估计要疯。
所以这时候就需要用到Gadget这个插件(中文名叫小工具),官方介绍如下:

小工具扩充功能提供了一种方式,能让使用者选择其他wiki使用者提供基于JavaScript和CSS的小工具。
小工具由位于MediaWiki命名空间页面中的JavaScript和CSSsnippets组成。每个小工具由MediaWiki:Gadgets-definition中的一行所定义,并提供了小工具的名称及描述,以及JS和CSS程式码片段的列表。

如果安装过该插件的话,我们打开参数设置就会发现其中有个选项卡就叫做小工具,如下图:
mediawiki-prefsection-gadgets.png
在其中可以选择我们为网站准备的各种小工具。
接下去就简单介绍一下如何创建小工具。
打开特殊页面,找到小工具链接,在首行内容中有个定义的链接并点击。
mediawiki-specialpage-gadgets.png
或者你也可以直接在浏览器中输入MediaWiki:Gadgets-definition
MediaWiki-Gadgets-definition.png
它的格式大体上是这么个样子

* 小工具名称 [选项(可选)] | js名|css名

js名会对应到MediaWiki:Gadgets-js名的页面上(css类同)。关于选项可参考官方文档。
我们可以根据小工具的功能划分成不同的类别,放在对应的标题下,如上图中的edit标题。
定义完之后,回到之前的特殊页面:小工具页面,刚刚添加的内容就出现了。此时刚刚的标题也好,小工具名称也好都还只是以一对⧼ ⧽ 符号包围的英文字符,我们可以通过旁边的编辑按钮给其添加说明注解以便于阅读。
最后,我们点击相应的js名,进入MediaWiki:Gadgets-js名的页面添加代码吧。
如果你有好的想法和创意,那就可以通过小工具来实现了。如果不懂JavaScript和CSS(比如我),那就只能靠借(bai)鉴(piao)其他站点(首选当然是维基百科)的代码了。

参考文档

官方文档

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