Help:MediaWiki 1.25

Help:MediaWiki 1.26 >

本页引自 https://www.mediawiki.org/wiki/MediaWiki_1.25 ，使用CC BY-SA 3.0协议授权。由于MW自身的翻译器太垃圾于是我们整个复制过来翻译。
注意这里的版本很有可能不是最新版本，请记得两边对照翻译。

MediaWiki 1.25 是MediaWiki当前的稳定版本。 完整更新列表详见RELEASE-NOTES。 通过2014年9月至2015年4月wmf-分支的增量更新部署在维基媒体基金会的wiki上。 1.25.0的稳定版已于2015年5月25日（周一）发布。 1.25.1的稳定版（紧急修复）于2015年5月25日（周一）发布修复了 ConfirmEdit 在打包时包含的一个致命错误。 140余名开发者提交了2000多个更改，众多翻译人员也做出了贡献。

下载REL1_25或者查看 REL1_25 分支下的in Git 以关注最新的发布。

新特性

• Help: 页面状态指示符。如果你想在页面右上角加入图标，你可以在wiki上使用某些模板和脚本。

可用性

指示符（Indicators）

在页面右上角（及更多地方）添加图标的模板可以升级使用新的页面状态指示符功能。

增强版最新修改

File:Enhanced recent changes expanding screencast.ogv

15秒的功能展示视频：分组，展开和文件差异

preference "Group changes by page in recent changes and watchlist" MediaWiki 现在默认使用扩展的监视列表和所谓增强版最新修改(偏好设置“最近更改和监视列表的分组变更”)，它们在 MediaWiki 1.24和1.25版本中得到了若干改进(会话37785)。

这意味着 Special:RecentChanges 和 Special:Watchlist 可以显示在给定的日期中每个页面得到的所有修改，根据页面而不是时间排序。在简洁的概览上，每个页面的改动是默认折叠的，概览也包含整理的文件差异、每位用户的操作数的链接。只要单击就可以显示单独页面的全部操作。

用户不需要详细知道修改的显示顺序就可以了解当天该页面发生了什么，也不需要细览一长列不相关的条目就可以心中有数。这一变动是 MediaWiki 界面改善的一环，其目的是默认设置更明晰、少杂乱，而整体上同样易于操作（得益于JavaScript）。另一方面（分组）布局也是对非JavaScript用户的改善。

实时预览

在编辑过程中，不确定wikitext句法会产生什么效果？这不再是问题了，因为实时预览不再只是试验功能。在偏好中激活这一功能，MediaWiki可以显示编辑效果而无需重新加载页面，这样就可以快速修正错误。

性能

前端性能持续得到改进。

• 每个 MediaWiki 页面减小了约4KB。

导入

导入与你不同命名空间的wiki内容现在变得更加简单了。（例如其他语言的内容）

移除页面点击数计数器

根据一则评论的要求，MediaWiki不再内置点击计数器。也就是说特殊:流行页面（Special:PopularPages）和特殊:统计（Special:Statistics）中的“最常浏览页面”（"Most Viewed Pages"）部分被移除。我们计划在一个插件里重新加入这个功能。

国际化

登录与语法性别

延续MediaWiki 1.18和1.19的工作，Special:日志的多种日志类型已被迁移至新的日志系统，该系统支持全面国际化，包括词序和语法性别。迁移工作仍在继续，详细列表见会话T26620。

新语言

新增了以下本地化语言:

• अवधी
• بلوچی رخشانی
• Koyraboro Senni

给MediaWiki管理员的升级须知

重大更改

• 运行MediaWiki需要PHP 5.3.3 或更新的版本（原为PHP 5.3.2）。
• 自动发现皮肤的老版换肤系统已被移除（自1.23版本就不建议使用了），取而代之的是皮肤注册系统。这一换肤系统自从 MediaWiki 1.12版本就已存在，日后也经过了一些小改动。
• OpenSearchXml插件已加入MediaWiki的核心代码。如果你已经安装了此插件，就应该把它卸载。
• 默认关闭的jQuery Migrate库已被移除。请参阅 http://jquery.com/upgrade-guide/1.9/ 了解如何修复本地JavaScript。
• 使用git安装的用户现在需要获取外部库. 详情见以下#外部库。
• Special:Cite 已从 Cite 插件转移至独立的 CiteThisPage 代码目录。 require_once "$IP/extensions/Cite/SpecialCite.php"; 应替换为 wfLoadExtension( 'CiteThisPage' );
• 如果你不在默认路径($IP/extensions, $IP/skins)保存你的插件和皮肤，见以下#Changes to extension loading。

配置变化

更改了更多的默认设置，从而多数管理员更容易完成合理的配置安装。详情参见完整的发布说明。

API修改

花费了大量的时间清理了API，使输出更合理，对新手开发者更友好。1.25版本包括下列修改:

• Backlinks, imageusage, and embeddedin as prop modules
• Warnings will be sent if no continuation parameter is passed
• API help overhaul (见下面)
• Breaking change in generator=search
• Deprecation of list=deletedrevs, and a minor BREAKING CHANGE for action=query revids=
• BREAKING CHANGE: Title-part parameters will no longer silently break on the '#' character
• BREAKING CHANGE: list=search redirecttitle is no longer an object
• Reminder: Breaking change to API continuation planned for 1.26

我们重制了API文档，这样的话以后就可以使用更国际化的信息，更美观的格式，并且可以更方便的浏览。可以通过代码Special:ApiHelp维基页面中嵌入或链接使用帮助。喜欢在单独页面显示所有文档的人可以使用recursivesubmodules=1。

如果客户端在请求中指定了新参数formatversion=2，API的format=json或php应答数据格式会更加合理（会话 T76728）。如果没有指定这一参数，API应答将会向下兼容，但是在某些情况下API模块的开发者需要升级其插件来确保兼容性。所有在Wikimedia Gerrit开发的插件均已被升级至1.25版本以确保向下兼容。详情参见API:JSON version 2和Special:ApiHelp/json | generated API help for json format。

模式

• 将 user_newtalk.user_id 更改为无符号整型（unsigned integer）
• 将各种评论和辩论区拉♂长，以备在需要的时候延长总结

插件加载方式更改

为了趋于合理的配置数据库，我们正在逐步更改插件和皮肤在 MediaWiki 注册的方式。插件和皮肤现在可以将其元信息转移至 extension.json 或 skin.json，并且可以使用 wfLoadExtension( 'FooBar' ); 或 wfLoadSkin( 'FooBar' ); 加载其支持。在.tar文件附带的所有插件和皮肤均支持此功能。为向下兼容性考虑，仍然支持使用 require_once "$IP/extensions/FooBar/FooBar.php"; 的旧加载方式。

如果你不在默认路径($IP/extensions, $IP/skins)保存你的插件和皮肤，你需要为插件设置wgExtensionDirectory，以及为皮肤设置（不良命名的）wgStyleDirectory。

如何转移插件的开发者档案参见插件注册。

低侵入性分析

使用xhprof extension重做了全部性能分析系统，使其更加灵活且降低侵入性。不再需要手动调用wfProfileIn和 wfProfileOut函数，所以应将其手动调用移除。 参见 Manual:Profiling 浏览新的选项以及如何升级StartProfiler.php。

外部库

作为MediaWiki库的基础构造项目的一部分, MediaWiki 内核现在使用组成器来管理外部依赖，而无需复制文件到代码目录下,如CSSJanus和lessphp。另外, 当初为 MediaWiki 开发，但现在已经不是其专用的代码（如 cdb 库）现在已经被分离至独立代码目录下。

原始码（.tar）将包含所需依赖，使用tar的用户的升级过程保持不变。从git克隆代码的用户需要根据说明Download from Git#Fetch external libraries升级。已安装的库将在Special:Version的专有区域显示。

更好的组件管理插件支持

composer.json 之前是用于组件管理的插件, 但是现在已被用于管理MediaWiki核心部分的依赖。在一个关于这个问题的讨论后, composer-merge-plugin被开发出来，使系统管理员可以通过 composer.local.json指定依赖。更多文档详见Composer/For extensions。

集成扩展

以下扩展被集成进MediaWiki 1.25 (T85126)，已用于Wikimedia网站。

• CiteThisPage — 增加了 对特定文章提供不同引用格式的特殊页面，之前集成在Cite插件中 ("SpecialCite.php")

发行时间表

1.25版的发布时间表：

发布版本	日期
1.25.0	2015-05-25
1.25.1	2015-05-25：修复了版本1.25.1中的一个QuestyCaptcha的bug
1.25.2	2015-08-10
1.25.3	2015-10-16