使用說明:MediaWiki 1.25
注意這裡的版本很有可能不是最新版本,請記得兩邊對照翻譯。
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)
在頁面右上角(及更多地方)添加圖標的模板可以升級使用新的頁面狀態指示符功能。
增強版最新修改
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修改
花費了大量的時間清理了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[1] |