MediaWiki实用扩展程序介绍

忆兰居士

“不务正业”的奶爸

2022年5月22日更新

写在前面

下文中提到的Tabber扩展已经停用了，现在改为 TabberNeue ，当然我仍然倾向于用 HeaderTabs 。
Math扩展从1.38版以后内置了，还是蛮期待的，有兴趣的可以去测试下。

HidePrefix

作者就是觉得前缀很难看，所以才开发了这款扩展，因为他觉得用户根本就不关心你的前缀是什么。先看看效果：

注意页面标题和地址栏中的页面标题，少了前缀 图书: ，确实看上去舒服多了。
不过该扩展也有另外一个后遗症，就是在搜索结果中，如果关键字在标题中则会有前缀显示而不在标题中的则省略掉了前缀，所以强迫症患者慎用。

ShortDescription

在标题下面加上简介，维基百科有类似功能，不过是通过模板的形式。另外WikiData有专用的简介魔术字，跟该扩展同名，不过既然我们用不上WikiData的数据，不如自己弄一个，结合语义化扩展更是如虎添翼。

WikidataPageBanner

虽然很早就用上了，但是一直没办法设计一条好的横幅，所以选择性地没放在之前的介绍中。

CSS

对的，就是这么简单直接，有了它你可以直接在页面中嵌入CSS代码或者是CSS文件。至于是选择模板样式还是它，看自己的喜好了（前者用于维基基金会，后者用于MyWikis等维基农场，维护应该都不是什么问题）。

2021年9月13日更新

再次补充一个扩展，也是网友在其他文章的回复中提到过的，那就是 Labeled Section Transclusion 。

标记式章节嵌入扩展允许选择性地嵌入已标记的章节文本并正常解析Wiki格式。它的功能类似普通维基中‎<onlyinclude>标签的增强版本，可选择要包含的部分。这已在所有维基媒体的wiki上启用。
普通嵌入主要用来将小模板的大部分内容传入，而标记式章节嵌入主要用于将大型页面的一小部分嵌入。
两者也存在一些差异。在原生的模板嵌入中，章节是以结果标记，因此只能完全包含或跳过一个可能是不连续的章节。
而在这里，章节以名称标记，且由调用者选择行为，可以按需要包含或跳过章节。不同的页面可以包括或排除自己选择的章节，不限数量且可任意重叠。
通过名称而非行为标记章节将允许“编辑章节”链接对从较大文本中摘录的内容更适当体现，因为扩展现在可以考虑在页面开头跳过的部分，从而允许适当地偏移包含的部分。

这是官网给的说明，简单来说就是它能实现将某个条目中的章节嵌入到新的条目中，并且可以自定义哪些章节需要嵌入而无需考虑是否连续。
如果你去查看维基百科的某些模板或模块的说明文档，你可能会发现之前很多重复工作维基都是用模板来实现的，比方说我把某些信息汇总成一个表格并保存为一个模板，需要的时候加入该模板即可。而采用Labeled Section Transclusion之后，只要你在某个特定页面建立过该表，那么通过 {{#lst:xxxx}} 的方式同样可以实现这种效果。至于选哪种方式就看自己的习惯了，不过在我看来，后者将大大减少模板的数量。

2021年1月11日更新

最近又陆陆续续地测试了几个扩展，包括官方系统中新增的，补充如下：
开始前先上几张图，下面很多扩展都跟它们有关。

Cargo

Cargo是MediaWiki的一项扩展，可以提供轻量的方式来存储和查询数据，这些数据是通常通过信息框（infobox）等模板调用的。Cargo在概念上类似于Semantic MediaWiki扩展，但是有许多优点，比如容易安装，容易使用。
Cargo将所有的数据存在数据库表中，而这些表可以被MediaWiki自己的数据库（默认）或分开的数据替换。在大多数情况下，每个模板都会将其数据存储在单个数据库表中，每个相关模板参数对应一列。有少量例外：包含数组/列表以及包含地理位置的字段的处理会更复杂一些，这是因为大多数数据库系统缺乏对这些类型的原生支持。多个模板也可以将它们的数据存储在同一个数据库表中。

跟Semantic MediaWiki一样，都是用于语义化的插件，只是复杂程度会比后者小很多，适合新手入门。网上教程较少，官方的文档很多地方讲得不是很清晰，需要慢慢琢磨。
自打用上这个和后面的Page Forms，简直就是为自己打开了新世界的大门，MediaWiki的可玩性瞬间提高N倍。
有兴趣的可以参考本站的文章《 MeidaWiki教程之Cargo篇》。

Page Forms

页面表单（Page Forms），在2016年以前曾称语义表单（Semantic Forms），是MediaWiki的一个扩展，可供用户利用表单的方式，来新增、编辑和查询数据。在最初创建时，该扩展仅仅是Semantic MediaWiki扩展的分支之一，旨在能够利用SMW来编辑模板，并存储模板参数。这也正是为何它曾经称作“语义表单”的原因。不过，如今，该扩展也可以与另外的扩展:Cargo扩展配合使用，或在两者皆未安装的情况下工作。
很简单地说，页面表单可让您能够在自己的wiki站点之上备有用来创建和编辑页面的表单以及用来查询数据的表单，且无须进行任何的编程。不但管理员可以创建和编辑表单，用户自己也可以这样。

这款插件最初就是为了配合Semantic MediaWiki使用的，如今同样能够适用于Cargo，当然你也可以单独使用。它可以通过表单的方式快速添加数据，如果能够熟练掌握，某些特定类型的条目基本上可以直接用表单生成了。
本站的《如何用插件创建我的第一个MediaWiki信息框模板》中也已经提到过它（那是我第一次接触Page Forms），有兴趣的可以去翻看，至于教程文章正在翻译整理中，敬请期待。

VEForAll

这个完全是为了Page Forms而生的扩展，前身就是VEForPageForms，它的作用就是为了能够在表单中使用可视化编辑器。因为从1.31版之后，表单对WikiEditor的支持就有问题，需要修改源码。索性就用可视化编辑器好了，尤其是1.35版之后，不再需要单独安装Parsoid服务，便捷度大大提高。
上面第二张图中，条目内容就是开启了可视化编辑器的效果，在插入部分只支持少数（至少不支持模板，尝试开启还是失败了）。
目前为测试版，可能会存在不确定的错误，比如跟下面的扩展“神仙打架”。

HeaderTabs

补充：最近还是用回了Tabber，HeaderTabs虽然显示效果要强于前者，但因为它把选项卡的标签定义为一级标题（H1)，所以从结构上来看欠妥。

想要使用选项卡，那么还是推荐使用这个，虽然文后提到另一款Tabber，但个人还是喜欢这款（上面第一张图有显示效果）。
注意：

该扩展也可以用于表单中，但是可能会因为CSS的关系导致VEForAll无法正常使用，所以还是老老实实放在页面内容中好了。
如果你把所有内容全部做成选项卡来显示，那么popup扩展的显示效果就会变成空白，所以最理想的方式就是不要将简介内容放进去（哪怕写简单一两句至少弹窗时也有内容显示）。

SemanticRating

一个样式扩展，功能很简单，就是显示评分的“小星星”（上面第一张图，书籍信息框最下面的评分就是它生成的）。
注意： 这款插件在可视化编辑器中可能会出错，导致模板内容看不见，但不影响使用。

Lockdown

不想随随便便让人把你网站上的劳动成果窃取掉，那么就可以使用这款插件（虽然不符合互联网的开放精神）。该扩展可以限制特定的用户群体对特定命名空间和特殊的页面的各类动作（包括浏览、编辑等）。

CommentStreams

MediaWiki的评论系统，需要的人可以考虑（官方的样式跟网站有点格格不入，可以考虑美化一下）。

WikiSEO

SEO扩展，允许你添加常见的例如“关键字”和“描述”等元信息。

2018年9月29日

其实早在几个月之前就已经写好了这篇文章，只是一直懒得贴到知乎上，因为图片比较多，还要一一对号入座。

才发现一个有意思的现象，MediaWki的安装包里竟然自带了很多的插件，只是都没有启用。它是希望我们自己探索并发现吗？

这两天开始逐渐地倒腾起插件来，往站点上传的时候才注意到大凡实用的插件它都带了，可能会存在版本略低的现象。对于使用惯了默认不带插件或者仅有一两个插件的其他系统来说，官方内置这么多还真有些受宠若惊了！

注：这段话写于第一次安装完MediaWiki之时，估计那时连配置过程都没好好研究，所以才会提出这种问题。

相对于WordPress这种只带一两个插件的做法，MediaWiki实在是太厚道了，安装包内竟然自带了这么多的扩展。而且随着版本的不断升级，所带的扩展也越来越多。

这次趁着升级，把用到的插件都整理一下，不然时间一久难免又忘。

官方自带扩展

以下扩展截止于1.31.1版（感觉这一版自带的扩展更多），并以字母顺序排列。

CategoryTree

动态导航分类结构。

Cite

增加用于引用的 <ref[ name=id]> 和 <references/> 标签。

添加参考引用的必备插件。

CiteThisPage

添加引用特殊页面和工具箱链接。

可以将条目的引用生成不同的引用格式，除了像维基百科这种相对具有权威性的站点，其引用还有些价值，个人站点貌似不实用。

CodeEditor

使用Ace编辑器实现编辑JavaScript和CSS页面时的语法高亮功能。

这个在编辑代码（更准确的说是在线浏览代码，微调代码）时有用，但如果只是从其他站点搬运代码过来的话，用处同样不大。

ConfirmEdit

提供验证码技术防止垃圾信息和密码破解破坏。

见仁见智的插件，安全这东西不用麻烦，用了也麻烦。

Gadgets

MediaWiki的小工具扩展工具，可以说是整个系统强大功能的基石。

这部分可以单独开一篇文章来介绍。

ImageMap

容许客户端可以使用 <imagemap> 标签整可点击图像地图。

鼠标在图片不同区域会有不同的动作，但是编辑数据比较麻烦，实用性不高。

InputBox

允许包含预先设置的HTML表单。

Interwiki

新增特殊页面以查看和编辑跨wiki表。

除了像维基百科这种大型站点存在跨wiki的情况，基本上个人站长都用不到。

LocalisationUpdate

自动更新本地化的信息，换句话说，就是在使用过程中如果发现系统、插件和皮肤有适合自己语言的更新就升级。

MultimediaViewer

在全屏界面中以较大尺寸显示缩略图。

Nuke

让管理员可以批量删除页面。

OATHAuth

提供使用基于HMAC的一次性密码的身份验证支持。

ParserFunctions

用逻辑函数加强解析器。如果你不希望自己从维基百科上下载的模板无法使用，那还是老老实实启用它。

PdfHandler

在图像模式中查看PDF文件的处理器。

Poem

添加 <poem> 标签用于诗歌格式。

装不装就看你的需求了。

Renameuser

添加更改用户名的特殊页面（需要renameuser权限）。

如果站点的用户数不多，其实用处不大。甚至有很多个人的维基站都是站长自己在维护，所有条目也都出自站长之手就更没有必要了。

ReplaceText

允许管理员在内容页面的文本和标题上进行全局字符串查找和替换。

SpamBlacklist

基于正则表达式的反垃圾工具允许将页面URL及注册用电子邮件地址列入黑名单。

SyntaxHighlight_GeSHi

使用Pygments - Python syntax highlighter以提供语法高亮 <syntaxhighlight> 。

TitleBlacklist

允许管理员通过黑名单和白名单禁止页面和用户帐户的创建。

WikiEditor

提供高级、可扩充的wiki文本编辑界面。

维基的经典编辑器，功能简单，跟可视化编辑器VisualEditor比起来简直弱爆了，但其优点就是稳定。另外，如果你从维基百科等上扒资料的话，使用wiki编辑器进行复制粘贴会方便很多。

其实以上所带的官方插件有很多都用不上，如果你去看看维基网站甚至是MediaWiki自己的官网，就会发现他们也只用到一部分，所以安装或升级时可以考虑删掉部分无用的。
注：即便删了，官网都会提供单独的插件可供下载。

接下来我们看看维基百科这个业内标杆所带的插件（以下按照使用率和功能性排序）。

VisualEditor

MediaWiki的可视化编辑器。

对新手而言绝对是编辑利器，安装颇为麻烦（需要parsoid的支持），后续会开一篇如何安装可视化编辑器的文章。

TemplateData

实现模板参数的数据存储（使用JSON）。

配合可视化编辑器使用的一大利器，加入模板数据之后，可以自动生成模板参数表方便用户查阅，更重要的是在编辑条目时可以方便快速地添加数据。

添加链接至相关页面的页脚。

增加同类主题的相关页面，方便用户的阅读体验。可以根据Cirrus Search在算法上确定也可以手动添加。

Disambiguator

添加标签 __DISAMBIG__ 以标记消歧义页面。并且增加两个新的特殊页面：

Special：DisambiguationPages - 列出维基上的所有消歧页面。
Special：DisambiguationPageLinks - 列出维基上链接到消歧页面的所有页面。

该外部数据扩展允许链接到MediaWiki网页进行检索、过滤和格式化从一个或多个源的结构化数据。这些来源可以包括外部URL、常规Wiki页面、上传的文件、本地服务器上的文件、数据库或LDAP目录。

总之看上去很强大，但还没到研究它的地步（精力不够）。

Semantic MediaWiki

让您更亲近wiki——对机器与人都是如此。高阶玩家的扩展。

好了，以上就是常用的各种插件，大家有兴趣可以慢慢尝试。

以上同样来自本人的个人小站

编辑于 2022-05-22 11:25

MediaWiki

维基百科

插件