維基百科:維基百科工具/Ultrafilter

Ultrafilter是一個維基百科的過濾工具，它可以根據你的興趣設置，通過過濾最近更新以獲得你感興趣的條目變化或者討論線索。它提供以下四個服務：

根據類目設置，過濾最近更新，獲得該類目下的條目變化
根據類目設置，過濾最近更新，獲得該類目下的最新討論
用戶以前參與過某條目的討論，如果該條目再有討論，則通知用戶
它還附加了一個專門服務於維基百科的縮址服務

維基百科用戶既可以訪問外部網站獲得上述四個服務，也可以通過使用用戶腳本將這些功能集成到維基百科內部。

用戶腳本

Ultrafilter提供的服務都可以通過站內用戶腳本（User Script）集成進來，腳本提供了以下功能：

瀏覽本用戶關心的分類更新和討論
瀏覽本用戶的關注的討論
有新討論時，浮現警示條提醒用戶

功能預覽

浮動的警示條

更新和討論

背後的想法

沃德·坎寧安在C2上曾經寫到，可觀察性是Wiki的一個基本特性。在維基百科及其他眾多Wiki，可觀察主要是通過最近更新來實現的。早期的維基百科參與者有限，那時通過最近更新可以有效的獲知你感興趣的變化；但隨着維基百科越來越大，最近更新數據量巨大，它逐漸失去了早期的作用。這是作者開發本工具的主要意圖。

另一方面，可有效觀察不只是服務於維基百科站內用戶；隨着RSS的發明，混搭（Mashup）和開放API隨之流行，對外界有意義的RSS輸出，成為一個站點宣傳自己的有力工具。所以，有效觀察，對站內外用戶是同等重要的。

原理

獲得某分類的條目及討論更新並不困難，這裏值得提到的是我們的更新並不只是跟蹤單單一層分類，而是跟蹤其下的三層子分類的所有變更。沿着分類樹（其實是DAG）傳播變化三層，是根據經驗確定下來的。下溯的層級太少則不能有效的跟蹤變化，而下溯的層級太多則容易出現錯誤。

比如：「黃霑」－「分類:金馬獎獲獎者」－「分類:金馬獎」－「分類:台灣電影」－「分類:台灣文化」－「分類:台灣」，如果我們傳播變化的層級太多，最終就會讓香港人「黃霑」出現在分類「分類:台灣」的變化裏，這是有違直觀的。

安裝步驟

（一）在你的Vector.js或者Mononbook.js引入下面的Javascript。

importScript("User:Mountain/shorturl.js");//如果需要缩短的维基百科条目网址
importScript("User:Mountain/ultrafilter.js");
 
addOnloadHook(function() {
   $j(function() {
     ultrafilter('数学|物理学|哲学');//填入你感兴趣的分类，用|分隔，注意填入项目必须在维基百科存在且繁简体一致。
   });
});

（二）在你的用戶頁增加一個子頁面Ultrafilter，裏面的內容如下（三項內容可以調整成自己喜歡的順序）：

 __NOEDITSECTION__
 {| style="width:100%;" border="0"
 |-
 |style="width:33％;vertical-align:top;" |
 ===分类更新===
 <div id="ultrafilter-rc"></div>
 |style="width:33％;vertical-align:top;" |
 ===最近讨论===
 <div id="ultrafilter-rt"></div>
 |style="width:33％;vertical-align:top;" |
 ===关注的讨论===
 <div id="ultrafilter-ntf"></div>
 |}

示例可以參考 User:Mountain/vector.js 和 User:Mountain/Ultrafilter 。

開放API

Ultrafilter.org開放了以下API供外界使用：

分類更新： http://ultrafilter.org/api/rc/zh/:CAETGORIES/:UNIXTIMESTAMP
分類討論： http://ultrafilter.org/api/rt/zh/:CAETGORIES/:UNIXTIMESTAMP
用戶關注的討論： http://ultrafilter.org/api/ntf/zh/:USERNAME
父分類查詢： http://ultrafilter.org/api/cat/zh/:CAETGORY/parents
子分類查詢：http://ultrafilter.org/api/cat/zh/:CAETGORY/children

其中的參數說明如下：

:CAETGORIES ：多個分類，以「|」分隔（分類必須存在且繁簡體必須和站內一致）
:UNIXTIMESTAMP ：用整數表示的時間，從1970年1月1日零時起到該時間的毫秒數
:USERNAME ：用戶名（不帶User前綴）
:CAETGORY ：一個分類（分類必須存在且繁簡體必須和站內一致）

數據的輸出格式為JSON和JSONP，RSS輸出還在開發中。