跳转到内容

使用笔记/扩展程序篇:修订间差异

添加的内容 删除的内容
Lakejason0
Lakejason0留言 | 贡献 (文本替换 - 替换“——”为“{{——}}”)
(未显示2个用户的7个中间版本)
第16行: 第16行:
如果你的站点会有很多不那么熟悉wiki语法的人,那么装上这个绝对没错。
如果你的站点会有很多不那么熟悉wiki语法的人,那么装上这个绝对没错。


但是,由于MediaWiki本身的设计原因,可视化编辑器目前使用了[[mw:Parsoid|Parsoid]]这个东西。简单来说,这导致每一次可视化编辑都需要把Wikitext变成HTML,再变成Wikitext。这种时候就会出现一些奇奇怪怪的问题——比如莫名其妙出现的不可见字符,把原本好好的Wikitext搞得一团糟,反而会加重巡查负担。
但是,由于MediaWiki本身的设计原因,可视化编辑器目前使用了[[mw:Parsoid|Parsoid]]这个东西。简单来说,这导致每一次可视化编辑都需要把Wikitext变成HTML,再变成Wikitext。这种时候就会出现一些奇奇怪怪的问题{{——}}比如莫名其妙出现的不可见字符,把原本好好的Wikitext搞得一团糟,反而会加重巡查负担。


同时,可视化编辑器需要配合[[mw:Extension:TemplateData|模板数据]]这个扩展才能更好的插入模板,否则可视化编辑器对模板很难下手。这是因为模板数据提供了一些关键信息,比如“这个模板一共有多少参数”“这个模板源代码中应该写在一行里面还是写成好几行”“这些参数到底是什么意思,例子有哪些”等等等等,方便用户选择和Parsoid转换。
同时,可视化编辑器需要配合[[mw:Extension:TemplateData|模板数据]]这个扩展才能更好的插入模板,否则可视化编辑器对模板很难下手。这是因为模板数据提供了一些关键信息,比如“这个模板一共有多少参数”“这个模板源代码中应该写在一行里面还是写成好几行”“这些参数到底是什么意思,例子有哪些”等等等等,方便用户选择和Parsoid转换。
第33行: 第33行:
=== Gadgets ===
=== Gadgets ===
{{main|mw:Extension:Gadgets}}
{{main|mw:Extension:Gadgets}}
'''小工具(Gadgets)'''允许站点载比Common.css、Common.js、Mobile.css、Mobile.js等更多的自定义CSS与JS。小工具们只能由管理员或特定的用户组成员编辑,比较安全。
'''小工具(Gadgets)'''允许站点载比Common.css、Common.js、Mobile.css、Mobile.js等更多的自定义CSS与JS。小工具们只能由管理员或特定的用户组成员编辑,比较安全。


与表面意思一样,这个扩展的原本目的是载一些提高体验的小脚本小样式。但其实不止于此。比如,如果你希望一些CSS或JS同时在移动端和桌面端载,就可以在Gadget定义里面写明都载,不用都复制一遍了。
与表面意思一样,这个扩展的原本目的是载一些提高体验的小脚本小样式。但其实不止于此。比如,如果你希望一些CSS或JS同时在移动端和桌面端载,就可以在Gadget定义里面写明都载,不用都复制一遍了。


=== ConfirmEdit ===
=== ConfirmEdit ===
第44行: 第44行:
=== TemplateData、TemplateStyles、TemplateWizard和TemplateSandbox ===
=== TemplateData、TemplateStyles、TemplateWizard和TemplateSandbox ===
{{main|mw:Extension:TemplateStyles|mw:Extension:TemplateData|mw:Extension:TemplateWizard|mw:Extension:TemplateSandbox}}
{{main|mw:Extension:TemplateStyles|mw:Extension:TemplateData|mw:Extension:TemplateWizard|mw:Extension:TemplateSandbox}}
'''模板样式(TemplateStyles)'''是一个允许绕过系统消息而应用样式的扩展程序。其提供了一个标签{{cd|<nowiki><templatestyles></nowiki>}},指定需要载的样式表。安装这个扩展程序后,模板的样式就可以拆分出来,避免多次申请修改系统消息(比如Common.css),并且由于自带Sanitize,也会更安全。
'''模板样式(TemplateStyles)'''是一个允许绕过系统消息而应用样式的扩展程序。其提供了一个标签{{cd|<nowiki><templatestyles></nowiki>}},指定需要载的样式表。安装这个扩展程序后,模板的样式就可以拆分出来,避免多次申请修改系统消息(比如Common.css),并且由于自带Sanitize,也会更安全。


'''模板数据(TemplateData)'''是一个提供对模板使用的额外标记的扩展程序。和上面说的一样,这些数据对可视化编辑器的完整运作至关重要,其本身也可以在模板文档内通过机器生成出一个十分简明的参数表格。'''模板向导(TemplateWizard)'''也会使用其提供的数据。
'''模板数据(TemplateData)'''是一个提供对模板使用的额外标记的扩展程序。和上面说的一样,这些数据对可视化编辑器的完整运作至关重要,其本身也可以在模板文档内通过机器生成出一个十分简明的参数表格。'''模板向导(TemplateWizard)'''也会使用其提供的数据。
第51行: 第51行:


=== TwoColConflict ===
=== TwoColConflict ===
{{main|mw:Extennsion:TwoColConflict}}
{{main|mw:Extension:TwoColConflict}}
'''双栏编辑冲突(TwoColConflict)'''提供了更好的编辑冲突视图,能更好的处理编辑冲突(比如冲突的部分采用谁的版本)。时常遭遇冲突可以装。
'''双栏编辑冲突(TwoColConflict)'''提供了更好的编辑冲突视图,能更好的处理编辑冲突(比如冲突的部分采用谁的版本)。时常遭遇冲突可以装。


第117行: 第117行:
'''BetaFeatures(测试功能)'''可以把一些扩展程序的开关移动到测试功能这个参数设置的Tab里。
'''BetaFeatures(测试功能)'''可以把一些扩展程序的开关移动到测试功能这个参数设置的Tab里。
=== Social tools系列 ===
=== Social tools系列 ===
{{main|mw:Extension:Social tools}}
{{main|mw:Social tools}}
'''社交工具(Social tools)'''是以扩展程序[[mw:Extension:SocialProfile|SocialProfile]]为中心的扩展程序系列。


想要你的wiki有头像,有评论,有博客?可以试试看。

但是由于开发年代过于久远,代码品质不咋地,谨慎使用。

头像和评论部分也有代替用的扩展程序,应该是国人开发的[[mw:Extension:Avatar|Avatar]]和FlowThread。

=== TabberNeue ===
{{main|mw:Extension:TabberNeue}}
'''TabberNeue(标签器重制)'''是基于HydraWiki的[[mw:Extension:Tabber|标签器]]制作的提供页面内标签页结构的扩展,使用了OOUI。如果有需要使用这类结构组织内容,可以装一个。
{{使用笔记}}
{{使用笔记}}

2022年8月15日 (一) 13:00的版本

该页面的编辑正在进行中。 讨论

请帮助我们扩充或改进这篇文章。

当你的网站有了一定的规模,或者还没正式开始的时候,你就得面对扩展程序(Extension)这篇汪洋大海。

你可以在这里查看所有在MediaWiki.org上有记录的扩展程序。真的很多,非常多。你也可以在Special:版本查看我站的情况。

最新版本自带的扩展程序都建议启用。如果你的MediaWiki版本比较旧,那么也建议装上新版本自带的扩展程序(当然,扩展程序对应的版本一定要选对)。

自带的扩展程序 

Visual Editor

可视化编辑器(Visual Editor)是一个提供了“所见即所得”体验的编辑器扩展程序。对于初入wiki的新人来说很友好。

如果你的站点会有很多不那么熟悉wiki语法的人,那么装上这个绝对没错。

但是,由于MediaWiki本身的设计原因,可视化编辑器目前使用了Parsoid这个东西。简单来说,这导致每一次可视化编辑都需要把Wikitext变成HTML,再变成Wikitext。这种时候就会出现一些奇奇怪怪的问题比如莫名其妙出现的不可见字符,把原本好好的Wikitext搞得一团糟,反而会加重巡查负担。

同时,可视化编辑器需要配合模板数据这个扩展才能更好的插入模板,否则可视化编辑器对模板很难下手。这是因为模板数据提供了一些关键信息,比如“这个模板一共有多少参数”“这个模板源代码中应该写在一行里面还是写成好几行”“这些参数到底是什么意思,例子有哪些”等等等等,方便用户选择和Parsoid转换。

Scribunto 

TextExtracts

文本提取(TextExtracts)提供了一个提取实际文章文本的API。这对机器抓取比较重要,比如一些聊天机器人(Wiki-Bot小可)可能会通过这个API提取文本。启用即可。

MultimediaViewer

多媒体查看器(MultimediaViewer)提供了页面内预览图片的视图。启用它可以更好地查看页面内的所有图片,但是这个查看器的加载速度可能有些慢。

Gadgets 

小工具(Gadgets)允许站点加载比Common.css、Common.js、Mobile.css、Mobile.js等更多的自定义CSS与JS。小工具们只能由管理员或特定的用户组成员编辑,比较安全。

与表面意思一样,这个扩展的原本目的是加载一些提高体验的小脚本小样式。但其实不止于此。比如,如果你希望一些CSS或JS同时在移动端和桌面端加载,就可以在Gadget定义里面写明都加载,不用都复制一遍了。

ConfirmEdit

编辑确认(ConfirmEdit)允许为站点插入验证码,以防受到恶意机器人的破坏。要正式启用这个扩展程序,需要进行额外的配置。详见主条目。

推荐的扩展程序 

TemplateData、TemplateStyles、TemplateWizard和TemplateSandbox

模板样式(TemplateStyles)是一个允许绕过系统消息而应用样式的扩展程序。其提供了一个标签<templatestyles>,指定需要加载的样式表。安装这个扩展程序后,模板的样式就可以拆分出来,避免多次申请修改系统消息(比如Common.css),并且由于自带Sanitize,也会更安全。

模板数据(TemplateData)是一个提供对模板使用的额外标记的扩展程序。和上面说的一样,这些数据对可视化编辑器的完整运作至关重要,其本身也可以在模板文档内通过机器生成出一个十分简明的参数表格。模板向导(TemplateWizard)也会使用其提供的数据。

模板沙盒(TemplateSandbox)提供了在编辑模板的时候在其他页面上查看效果的功能。可以减少模板测试的错误和尴尬。

TwoColConflict 

双栏编辑冲突(TwoColConflict)提供了更好的编辑冲突视图,能更好的处理编辑冲突(比如冲突的部分采用谁的版本)。时常遭遇冲突可以装。

RevisionSlider 

修订滑块(RevisionSlider)提供了更好的历史浏览视图。此扩展程序允许以可视化方式查看页面差异,也可以用时间线方式选定比较的起止点,有时比较方便。

LinkSuggest

链接建议(LinkSuggest)在源代码模式下提供链接补全建议。建议安装。

Echo

Echo扩展程序提供了通知功能,相比原版MediaWiki单薄的“讨论页通知”来说要好太多。装上即可。

Interwiki

Interwiki扩展程序允许使用特殊页面编辑interwiki表。Interwiki(跨wiki)就是类似于[[mw:Extension:Interwiki]]这样的链接及其前缀等设置。通常为了避免搞坏数据库,装上并赋予适当的权限是极好的。

MobileFrontend

按需选取的扩展程序

DPLforum

DPLforum是一个借鉴了DPL格式的论坛扩展程序。

需要注意的是,这个扩展程序只是把论坛版块这个玩意简化了,实际上就自带的功能来说“每个帖子”仅仅只相当于一个独立的讨论页。如果你要搞出真正的论坛结构,一是不好用,二是虽然可以做到一定的结构但是需要配合模板(我站的Category:论坛模板可以看看,以及Fandom中文社区中心的也可以参照)。

DynamicPageList

DynamicPageList(动态页面列表,简称DPL)是一个功能强大的扩展程序,但是你不一定用得到。但是用得到的话,安装上绝对是好选择。

我站的公共沙盒未名残章/幻想系的人物页面的Infobox就是用了DPL去动态生成所需的页面链接列表。

由于一些原因,目前的扩展程序叫DynamicPageList3。这个是目前为止最新的版本。

AdminLinks

Admin Links(管理员链接)提供了Special:管理员链接,指向常用的特殊页面。

这个扩展程序本身的功能很少,大部分情况下你需要自己按照格式去修改代码,让它变得更好用。

Newsletter

Newsletter(新闻报)扩展程序允许新闻报发布者向订阅了新闻报的人发布通知,类似于一个邮件列表吧。

我站的茶馆周报就是用了这个扩展程序。

PortableInfobox

PortableInfobox(移动化信息框)是Fandom设计的信息框扩展程序,被某位Helper复刻出来,移植到了通用的MediaWiki平台上。

总的来说,除了移动端体验会变好以外,代码也会清爽不少。只不过就是和翻译扩展程序有点冲突。对Fandom熟悉的可以装一下。

Lockdown

这个扩展程序允许对特定用户组限制其对一些特殊页面和命名空间的访问。

虽然可以绕过(总会有方法),但是表达这种意愿也是好的。

AdvancedSearch和相关依赖

AdvancedSearch(高级搜索)提供了更完备的搜索体验,但是需要安装Elasticsearch这款软件。

Elasticsearch是一个基于Lucene库的、分布式、支持多租户的全文搜索引擎。很多企业用,很强,但是内存占用很大。如果服务器配置不好的话,就还是算了。

BetaFeatures

BetaFeatures(测试功能)可以把一些扩展程序的开关移动到测试功能这个参数设置的Tab里。

Social tools系列

社交工具(Social tools)是以扩展程序SocialProfile为中心的扩展程序系列。

想要你的wiki有头像,有评论,有博客?可以试试看。

但是由于开发年代过于久远,代码品质不咋地,谨慎使用。

头像和评论部分也有代替用的扩展程序,应该是国人开发的Avatar和FlowThread。

TabberNeue

TabberNeue(标签器重制)是基于HydraWiki的标签器制作的提供页面内标签页结构的扩展,使用了OOUI。如果有需要使用这类结构组织内容,可以装一个。

Cookie帮助我们提供我们的服务。通过使用我们的服务,您同意我们使用cookie。