Extension:FlaggedRevs/zh

標記修訂擴展允許編輯者和審核員用戶對條目的修訂版本進行評級，並將這些修訂設定為在普通查看頁面時的預設版本. 即使包含的模板或圖片被更改，這些修訂也將保持不變. 這讓MediaWiki更像是一個內容管理系統（CMS）.

配置
请按照以下步骤安装Flagged Revs：


 * 1) 確保您所運行的是MediaWiki版本1.17或以上. 否則，您必需要先升級以安裝FlaggedRevs.
 * 2) 下载FlaggedRevs.  选择与您正在使用的MediaWiki版本匹配的FlaggedRevs版本. 例如：如果您正在运行MediaWiki 1.17，请下载FlaggedRevs 1.17.
 * 3) 将下载的文件解压缩到MediaWiki安装的 目录. 例如：
 * 4) 通过运行维护脚本确保图像的哈希值是最新的. 例如：
 * 5) 确保 目录可由Web服务器读取（以便Web服务器可以提供FlaggedRevs CSS，图像和JavaScript. ） 例如：假设Web服务器用户没有 目录，请运行：
 * 6) 启用条目审阅统计信息的收集. 
 * 7) 禁用按需统计信息生成.  参见中的 .  这将阻止在访问条目时生成统计信息（当同时访问许多没有当前统计信息的文章时，这会导致性能不佳）
 * 8) 设置计划的统计信息生成.  创建一个cron作业以定期运行  运行 以查看脚本运行所需的时间并适当地设置cron作业间隔.  例如，建立一個cron任務在每個小時以 的身分執行 ：
 * 1) 启用条目审阅统计信息的收集. 
 * 2) 禁用按需统计信息生成.  参见中的 .  这将阻止在访问条目时生成统计信息（当同时访问许多没有当前统计信息的文章时，这会导致性能不佳）
 * 3) 设置计划的统计信息生成.  创建一个cron作业以定期运行  运行 以查看脚本运行所需的时间并适当地设置cron作业间隔.  例如，建立一個cron任務在每個小時以 的身分執行 ：


 * 1) 通过将以下行添加到来启用FlaggedRevs：
 * 2) 透過執行 來更新MediaWiki的資料庫結構.  This must be done after the above step is saved or you will receive a database error when accessing any page.
 * 3) 授權用户成为审阅者.  首次安装FlaggedRevs后，没有用户可以看到审阅者的工具集.  To fix this, login as a wiki bureaucrat and go to Special:UserRights, then grant review rights to one or more users. 審閱者將會在可編輯頁面的底部看到審閱者的工具集.
 * 1) 授權用户成为审阅者.  首次安装FlaggedRevs后，没有用户可以看到审阅者的工具集.  To fix this, login as a wiki bureaucrat and go to Special:UserRights, then grant review rights to one or more users. 審閱者將會在可編輯頁面的底部看到審閱者的工具集.

用户权限和用户组
預設情況下，沒有人可以進行審核，因此第一步是設定用戶權限.

用户权限
標記修訂新增以下用戶權限：
 * – 用戶可以審核修訂
 * – 用戶可以審核修訂，並能夠設定任何標記為任何級別
 * – 用戶所做的任何新修訂都會被自動標記為已審核
 * – 用戶進行的回退被自動標記為審核.
 * – 用戶可以查看Special:UnreviewedPages
 * – 用戶可以更改任何頁面的穩定版本設定
 * – 用戶可以移動有穩定版本的頁面

用户组
標記修訂新增以下用戶組：


 * – 擁有 ，以及MediaWiki標準用戶權限
 * – 擁有 ，以及MediaWiki標準用戶權限
 * – 擁有

如何分配用户权限
用戶權限可以透過兩種方式授予：

將這些用戶權限授予給 中已存在的用戶組：
 * 授予權限到用戶組

透過Special:UserRights手動將用戶帳號添加到對應的用戶組.
 * 授予權限給特定用戶
 * 默认值：
 * 行政员可以添加/移除复核者
 * 管理員可以添加/移除自動審核員和編輯者.

基本設定
FlaggedRevs.php附帶了許多可設定的變數. 這些應該在LocalSettings.php中進行設定.


 * – 設定可以進行審核的命名空間. 這是一個整數的陣列.  查閱includes/Defines.php的開頭，找到預設命名空間所對應的整數，並使用已定義的常數來提高可讀性.
 * – 設定標籤及它們三個設定：「levels」、「quality」和「pristine」
 * 定义
 * 是一個關聯陣列，鍵為所對應的標籤名稱，值為「levels」、「quality」和「pristine」設定的陣列.
 * 「levels」控制審核等級的數量.
 * 「quality」決定哪個標籤級別是「優良」的.
 * 「pristine」決定哪個標籤級別是「完美」的.
 * 標籤
 * 每個標記可以透過編輯頁面「MediaWiki:revreview-」來設定標籤.
 * 每個標記等級可以透過編輯頁面「MediaWiki:revreview--」來設定標籤.
 * 範例
 * 假設有人想要有「accuracy」、「depth」和「tone」標籤，每個標籤有3個等級.
 * 管理員還希望至少第二級的「accuracy」和「depth」才能是「優良」的. 以下設定將這麼運作：
 * 預設情況下，標記的標籤在$wgFlaggedRevsTags陣列中設定. 在這個範例中表示標籤顯示為「accuracy」、「depth」和「tone」.
 * To show tags for example as their capitalized name, the admins have to edit these pages with the shown content:
 * {|class="wikitable"
 * {|class="wikitable"

!标签 !標籤頁面 !内容
 * accuracy
 * MediaWiki:revreview-accuracy
 * depth
 * MediaWiki:revreview-depth
 * tone
 * MediaWiki:revreview-tone
 * 語調
 * }
 * tone
 * MediaWiki:revreview-tone
 * 語調
 * }
 * }


 * 要標籤標記級別，管理員必須建立這些頁面來顯示內容：


 * {|class="wikitable"

!标签 !等級 !標籤頁面 !内容
 * rowspan=3|accuracy
 * 0
 * MediaWiki:revreview-accuracy-0
 * 1
 * MediaWiki:revreview-accuracy-1
 * 2
 * MediaWiki:revreview-accuracy-2
 * rowspan=3|depth
 * 0
 * MediaWiki:revreview-depth-0
 * 1
 * MediaWiki:revreview-depth-1
 * 2
 * MediaWiki:revreview-depth-2
 * rowspan=3|tone
 * 0
 * MediaWiki:revreview-tone-0
 * 糟
 * 1
 * MediaWiki:revreview-tone-1
 * 好
 * 2
 * MediaWiki:revreview-tone-2
 * 優良
 * }
 * rowspan=3|tone
 * 0
 * MediaWiki:revreview-tone-0
 * 糟
 * 1
 * MediaWiki:revreview-tone-1
 * 好
 * 2
 * MediaWiki:revreview-tone-2
 * 優良
 * }
 * 2
 * MediaWiki:revreview-tone-2
 * 優良
 * }


 * 設定結果將會是：


 * {|class="wikitable"

!標籤名稱 !colspan=3|等級名稱
 * 語調
 * 糟
 * 好
 * 優良
 * }
 * 語調
 * 糟
 * 好
 * 優良
 * }
 * 語調
 * 糟
 * 好
 * 優良
 * }
 * }


 * – 穩定版本是否是頁面的預設內容.
 * – 關聯陣列，鍵為每個標籤的類型，值為可以設定最高標籤等級的對應權限陣列（整數的標籤等級）.
 * 範例
 * – 標題的字串陣列 這些標題的頁面將被標記修訂豁免. 它們不能被審核，不顯示標記UI.  在標題中用'_'替換' '（例如：「Main page」->「Main_page」）
 * – 標題的字串陣列 這些標題的頁面將被標記修訂豁免. 它們不能被審核，不顯示標記UI.  在標題中用'_'替換' '（例如：「Main page」->「Main_page」）
 * – 標題的字串陣列 這些標題的頁面將被標記修訂豁免. 它們不能被審核，不顯示標記UI.  在標題中用'_'替換' '（例如：「Main page」->「Main_page」）

用戶介面

 * – 啟用後將使用更簡單基於圖示的UI. Does not affect the tags shown in edit mode.
 * – This setting hides the review status box/bar for pages that are reviewed in their latest version. Explanatory text is also removed from some places.

工作流

 * – 讓在這些用戶組中的用戶預設查看當前/草稿修訂版本.
 * – 如果啟用，則具有「autoreview」權限的用戶在每次保存編輯都會被自動審核. 無需點擊「送出審核」按鈕.  此功能要求以前的修訂版本已被審核，否則將不會發生自動審核.
 * – 如果 啟用，此設定控制自動審核的每個標籤層級. 如果允許，標籤將被自動審核為與之前修訂相同的級別.  這是一個關聯陣列. 每個鍵都是一個標記，每個值都是一個標記等級.
 * 例子

自動授權用戶

 * – 為一個包含鍵的陣列，鍵可以為年齡、編輯數、編輯時間間隔、benchmarks、是否確認電子郵件、最近內容頁面編輯數、總內容頁面編輯數、編輯內容頁面的數量、使用編輯摘要的數量、IP uniqueness和是否存在用戶頁. 這些值對應為用戶帳戶被自動授予「編輯者」狀態所需的天數/編輯數，以及是否通過電子郵件確認和擁有用戶頁.  用戶必須至少在Y或更多天分別有至少X次編輯，其中X是benchmarks，Y是時間間隔.  將此變數設定為false可完全停用此變數.
 * 例子
 * $wgFlaggedRevsAutopromote可能包含：
 * 例子
 * $wgFlaggedRevsAutopromote可能包含：

進階
有關配置選項的完整列表，請參閱FlaggedRevs.php（帶有一些解釋性註釋）. 請務必確認僅更改localsettings.php以設定配置選項，而不是編輯此文件.

要讓維基的未註冊用戶只能看到條目的穩定版本，請參閱.

使用

 * 参见： 

批准页面
擁有某些審核狀態級別的用戶將在檢視頁面（位於頁面底部）和差異（位於頁面頂部）時有小的評級表單，供他們審核修訂版本. 每個標記必須至少達到最低的批准級別. 在審核之前用戶應該查看整個頁面，包括模板和圖片. 與穩定版本間差異的連結對於加速此過程非常有用.

用戶無法審核他們無法編輯的頁面. 他們不能降低修訂級別為他們無法設定的級別. 被封鎖的用戶不能做任何事情.



在Special:StableVersions中，你可以列出特定頁面已審核的修訂或檢視已審核的修訂版本.



維護
在Special:UnreviewedPages中，有從未被審核過的頁面列表，僅對編輯者可見. 必須選擇命名空間，也有一個分類過濾器可供選擇.



在Special:OldReviewedPages中，有已審核頁面但包含待定更改的頁面列表. 僅對編輯者可見. 也有一個分類過濾器可供選擇.



Pages that cannot be reviewed can still be patrolled for anti-vandalism purposes by Editors to see what has been checked already.

為主要審核級別的已審核頁面列表可以在Special:ReviewedPages找到.



日誌
所有相关操作都会被永久记录，因此可以正确跟踪和监督所有操作.


 * 被授權/除權的編輯者及原因的日誌被保存在Special:Log/userrights.
 * 批准/拒絕批准修訂的日誌保存在Special:Log/review.
 * 更改頁面穩定版本設定的日誌在Special:Log/stable.

Also, a new page, Special:QualityOversight shows only flaggings log entries related to quality revisions. This is useful if the main log is too flooded with page "sightings".

备注

 * 被此擴展啟用. 對於可審核的頁面，巡查被停用，但已標記的版本在最近更改中被標示為已巡查.  這表示巡查可審核修訂的唯一方法是標記它.  不可審核的頁面仍然表現正常（取決於站點巡查設定）.
 * 管理員可以對特定頁面更改預設要優先顯示有質量的修訂版本還是穩定版本. 要禁用此功能，在LocalSettings.php添加.
 * 頁面連結、分類、圖片、模板、語言和外部連結仍然基於當前版本的頁面.
 * 用戶無法移動他們無法審核的頁面. 這是故意的，見T15994.  要解決這個問題，在LocalSettings.php中添加.
 * 要除去編輯者權限，你可以暫時封鎖他們，或透過Special:UserRights來永久除權. 為了跟踪目的將出現額外的除權日誌項目.

API
FlaggedRevs adds API modules for reviewing revisions and configuring "stabilization" of pages, a module for retrieving flag configuration, and three list modules corresponding to the special pages for reviewed pages, unreviewed pages and "old" reviewed pages.

更多API的文档请参阅.

action = review
審核一個頁面.


 * 參數
 * : The revision ID for which to set the flags
 * : 通过取得的csrf權杖
 * : 审阅意见（可选）
 * : Set the flag named "accuracy" to the specified value; (replace "accuracy" with the flag name to set another flag)


 * 範例

action = stabilize
更改页面稳定版本设置.


 * 參數
 * : 稳定版本的页面标题
 * : 稳定版本的原因
 * : （已弃用？）稳定期限到期. 默认值：无限期
 * : 是否自动审核页面
 * : 是否监视页面
 * : 通过取得的編輯權杖
 * For protection-like configurations :
 * : The right users must have in order for their edits to not require review.
 * Otherwise :
 * : Default revision to show (latest | stable)
 * : Which stable revision should be shown (pristine | quality | latest). Default: quality
 * : Restriction level for the 'autoreview' right (sysop | none). Default: none


 * 範例

action = flagconfig
Shows information about review flag configuration.

The following parameters are returned for each tag:
 * : 权限的名称
 * : the number of possible levels the flag has (not counting the "unreviewed" level)
 * : level the flag must be for the revision to be considered "quality"
 * : level the flag must be for the revision to be considered "pristine"

The displayed name for each flag and the different level names for each flag are MediaWiki messages, so can be set and retrieved through the appropriate page; for example the name for the first level of the "accuracy" flag is located at MediaWiki:revreview-accuracy-1.


 * 範例

list = reviewedpages
Lists pages that have been reviewed.


 * 參數
 * : Start listing at this page id.
 * : Stop listing at this page id.
 * : In which direction to list.
 * : The namespaces to enumerate.
 * : 过滤重定向
 * : 按质量过滤 (0=sighted,1=quality)
 * : 要返回的总页数


 * 範例

list = unreviewedpages
列出从未审核过的页面.


 * 參數
 * : 从这一页面标题开始列出.
 * : 从这一页面标题停止列出.
 * : 要枚举的命名空间.
 * : 过滤重定向
 * : 按质量过滤 (0=sighted,1=quality)
 * : 要返回的总页数


 * 範例

list = oldreviewedpages
Lists pages that have at some point been reviewed, but for which the most recent revision is not reviewed.


 * 參數
 * : 从此时间戳开始列出
 * : 从此时间戳停止列出
 * : In which direction to list.
 * : The namespaces to enumerate.
 * : 过滤重定向
 * : 要返回的总页数.


 * 範例

prop=flagged
Use action=query&prop=flagged to get information about the flagging status of the given pages.

限制

 * 跨維基的嵌入引用不是穩定版本
 * 外部圖片（除了來自維基共享資源的）不是穩定版本
 * 有條件地引用其他模板的元模板，可能會在審核者載入頁面和審核頁面之間的時間內，條件發生變化. Therefore, there would be no pointers to the revision id for this different template to load from, making it blue linked. You will be notified if this happens during review.

解除安裝

 * 1) 移除在 中包含的行
 * 2) 刪除表格在的
 * 3) 刪除欄位 、 和 ， 表的 索引（如果存在；只有舊版本的標記修訂使用他們）
 * 4) 在命令列執行 以清除穩定版本連結
 * 5) 如果你使用 ，在命令列執行

測試平台

 * 
 * 
 * 

參見

 * – 编辑保持私密状态，直到它们获得批准
 * Flagged Revisions
 * – 关于此扩展程序创建的用户组和权限的文档，虽然它在mediawiki.org上使用
 * – 编辑保持私密状态，直到它们获得批准
 * Flagged Revisions
 * – 关于此扩展程序创建的用户组和权限的文档，虽然它在mediawiki.org上使用

外部連結

 * Quality Assurance in an Open Project – 2008维基媒体博客文章
 * 标记修订的图像 – 維基共享資源
 * 有關標記修訂 – 元维基

許可證
© GPL, Aaron Schulz, Joerg Baach, 2007