Extension:Approved Revs/ja

'Approved Revs は、管理者がページの特定のリビジョンを「承認済み」としてマークできるようにする拡張機能です. 承認されたリビジョンは、ユーザーがそのメインURLでページを表示したときに表示されるものです.

Approved Revsは、拡張機能に代わるシンプルでより軽量なものとして設計されました. FlaggedRevsは、リビジョン承認だけでなくレビューや関連機能も提供する、非常に機能豊富でヘビーデューティーな拡張機能です. 4つのユーザー権限、3つのユーザーグループ、15のグローバル変数、3のログタイプ、11の特別ページ、9のデータベーステーブルを定義します（対照的にApproved Revsでは、3のユーザー権限、ユーザーグループなし、7のグローバル変数、1のログタイプ、1の特別ページ、2のデータベーステーブルが定義されます）. 例えばWikipediaのような大規模なWikiを運営している場合、どのリビジョンを「公式」リビジョンとして表示するかは、多くの人が決定するか、少なくとも受け入れる必要があるため、FlaggedRevsは最も適したツールであると言えます. しかし、小規模または中規模のWikiを運営しており、管理者が数人しかいない場合は、Approved Revsがより適切な解決策となるかもしれません.

リビジョンが承認されたとしても、ページの内容を取得するほとんどの拡張機能は、承認されたリビジョンではなく、最後のリビジョンを取得します(この2つが異なる場合). Extensions that get specific data from pages, however, such as, and , will, fortunately, display the correct (i.e., approved) data.

ダウンロード
You can download the Approved Revs code, in .zip format, here.

また、MediaWikiのソースコードリポジトリからGit経由で直接ダウンロードすることもできます. コマンドラインからは、次のように呼び出せます.

各ファイルのバージョン履歴を含むコードをオンラインで見るには、diffusion/EARE/browse/master/にアクセスしてください.

インストール
この拡張機能をインストールするには、'1' ディレクトリを作成し (圧縮ファイルを展開するか Git 経由でダウンロードします)、このディレクトリをメインの MediaWiki 'extensions' ディレクトリ内に配置します. そして、ファイル ' ' に、次の行を追加します.

You will also need to install two database tables for this extension: "approved_revs" and "approved_revs_files". You can do this in one of two ways: either run the script "" in MediaWiki's /maintenance directory, or call the SQL directly in your database - you can find it in the files  and , both located in the extension's /sql directory.

If you were running a version of Approved Revs older than 1.4, and are upgrading to version 1.4 or higher, you will need to call update.php again, in order to have the latest DB table structure.

Finally, there are the following user rights defined for Approved Revs:


 * ' ' - ページの修正の承認・非承認の権限です. デフォルトでは、'sysop' グループの全メンバーに与えられています.
 * ' ' - 承認されたリビジョンを持つページの上部に、ユーザーが見ているものが必ずしも最新のリビジョンではないことを説明する注記を表示する許可を与えること. By default it is given to everyone (i.e, '*').
 * ' ' - 承認されたリビジョンを持つページの上部に、誰が最後に承認したかを示す別のメモを表示する許可を得ました. デフォルトでは、'sysop' グループの全メンバーに与えられています.

これらの権限のいずれかを持つユーザーの集合を変更することができます. For example, to have the "view most recent revision" link show up only for administrators, you could add the following, below the inclusion of Approved Revs:

作者
Approved RevsはYaron Korenが書いたものです. また、Raimond Spekking, Siebrand Mazeland, Jeroen De Dauw, Eli Handel, Andrew Engelbrecht, hashar, Anomie, Mark Hershberger, Flo, Addshore, James Montalvo, Fodagus, Kris Fieldなどによるコードの貢献も重要なものでした.

使用法
Once the extension is installed, anyone with the ' ' permission will see a link that reads "(approve)" on each row of a page history page. そのリンクをクリックすると、そのリビジョンが承認されたものとして設定されます. If you then go back to the history page, you will see an "approve" link next to every other revision, along with an "unapprove" link for the approved revision; the approved revision's row will also have a star next to it. Clicking "approve" for any other revision will re-set the approval to that revision; while clicking "unapprove" will mean that there will no longer be an approved revision for this page.

' '権限を持たないユーザーには、承認されたリビジョンの行に星のアイコンが表示されるだけで、履歴ページには特に何も表示されません.

デフォルトでは、' '権限を持つユーザーが、すでに承認されたリビジョンを持つページに対して編集を行った場合、その編集、つまりページの最新リビジョンは、自動的に承認済みとマークされるようになりました. 一方、承認されたリビジョンがないページ（もちろん新規ページも含まれます）には、自動承認は適用されません.

Approved Revsを含む の下に以下を追加することで、自動承認を排除し、その結果、すべての承認を手動で行う必要があります.

同様の理屈は、新しいバージョンのファイルにも当てはまります. これらの自動承認も、次の行で自動的にオフにすることができます.

Conversely, if you set " " or " " to true in  (see below), every edit to pages and/or files made by a user with ' ' permission becomes approved - even edits to pages/files that don't have an approved revision.

手動によるリビジョンの承認と承認取り消しは「承認」ログに保存されますが、承認権を持つ誰かがページを編集した結果、自動的に発生した承認は保存されません.

Special:ApprovedRevs page
Approved Revsでは、4つの別々のリストを表示する特別なページ「 」を定義しています.


 * 承認されたリビジョンが最新でないページ
 * 承認されたリビジョンを持つすべてのページ
 * "unapproved pages" (all pages without an approved revision)
 * 無効な承認を受けたページ（以前は承認可能だったが、現在は承認されていない名前空間のページなど）.

3つ目のリストである承認済みリビジョンのないページについては、オプションで各ページにそのページの最新リビジョンを承認済みとしてマークするためのリンクを含めることができます. To include such links, add the following to :

承認情報の保管
Information about approvals - who made them, and when they were made - is stored in the "Revision approval" log, which can be viewed at the page Special:Log. 最近の承認状況もSpecial:RecentChangesで表示されています.

未承認のページを空白で表示する
If you want to, you can have pages that have no approved revision show up as blank - users will still be able to see all the revisions if they click on the "history" tab, but the main display will be a blank page. To do that, just add the following line to, anywhere after the inclusion of Approved Revs:

Similarly, you can set files with no approved version to not show up when embedded in other pages, by adding the following line:

未承認ページの表示
デフォルトでは、リビジョンが承認されていないページは、そのステータスを示すことなく、単に普通に表示されます. You can have such pages display a message at the top saying, "This is the latest revision of this page; it has no approved revision." To do that, add the following line to :

ページを承認制にする
Wikiのページには、改訂を承認できるものとできないものがあります. これは、3つの方法のうちの1つで決定されます.

名前空間内のすべてのページを承認可能に設定する
A global variable,, exists, which determines which namespaces are handled by the extension. This variable is an array, and by default it holds six namespaces:  (the main namespace),   (user pages),   (files),   (templates),   (help pages) and   (the project namespace, which usually has the same name as the wiki). You can add additional namespaces to this set - after the inclusion of Approved Revs in LocalSettings.php, add something like:

It is not recommended to add the Category or MediaWiki namespaces to this array, because, due to their special implementation in MediaWiki, approvals will not work correctly on those pages.

デフォルトの名前空間を承認可能なものとして削除するには、その値をfalseに設定します. 例えば、ファイルを許可しないようにするには、次のように追加します.

Making pages approvable with #approvable_by
Approved Revsは、特定のページを特定の個人ユーザーやグループによって承認可能であると定義することができる パーサー機能を定義します. たとえば、次の呼び出しは、ユーザーAlice Jones、およびBureaucratとSysopグループのユーザーに、呼び出されたページを承認させることができます.

このパーサー機能によってページの編集を許可されたユーザーが、この機能が追加されるbeforeのリビジョンを承認した場合、管理者が来てその行為を取り消すまで、そのユーザーは他の承認を行う能力を失います（承認されたリビジョンにはこの呼び出しが含まれていないため）.

マジックワードで承認可能なページを設定
Individual pages not within one of the specified namespaces can also be made approvable, by adding the  magic word anywhere within the page. このマジックワードは、テンプレートでページに追加することをお勧めします. If  is added directly to a page, just be careful not to approve a revision of the page from before that string was added; this could lead to unexpected behavior.

Letting non-administrators "own" pages
Sometimes it's helpful to allow those without the general ' ' permission to be able to approve revisions of certain pages - in other words, to have ownership of certain pages. たとえば、ユーザーページでは、各ユーザーが自分のユーザーページでリビジョンを承認できるようにすることは理にかなっています. For namespaces other than "User", you can choose to have the user who originally created any page in that namespace be designated as the page owner, who then has revision-approval permission for that page.

To have this kind of "ownership" for a specific namespace, you need to add the namespace to the variable. To allow users to "own", i.e. be able to approve, pages in the main and user namespaces, for instance, you should add the following to LocalSettings.php:

A namespace needs to belong to  before it can be added to.

Displaying approval information
Approved Revs defines five "magic words" that can be used to display approval information about a specific page (or file). They are:


 * - the year in which the page was last approved
 * - the month in which the page was last approved
 * - the day of the month in which the page was last approved
 * - the full timestamp of the date/time in which the page was last approved
 * - the user who last approved the page.

All five can be simply called by themselves (which will return that information for the page on which the call is located), or called with a page name passed in (which will return that information for the specified page). So, for example, in the page "Main Page", the call  will display the year in which the page "Main Page" was last approved, while the call   will display the year in which the page "Employees list" was last approved.

If any of these magic words are called for a page that has no approved revision, or for a page that does not exist, they will simply not display anything.

The first four of these magic words can also be called for files; the last one, APPROVALUSER, unfortunately will not work.

Note that, if you began using Approved Revs before version 1.4, the first four magic words, which all have to do with the time in which the revision was made, will most likely display a blank for any page whose revision was approved while Approved Revs was still on an older version.

API
Approved Revs defines an API action, "approve", which lets you either approve or (if the extra parameter "unapprove" is added) unapprove any revision via the MediaWiki API. See here for an explanation of the syntax for this API.

Marking all pages as approved
For pages that do not yet have an approved revision, you may want to automatically approve their latest revision, as a way to quickly initialize their content. For that, you can use the command line script ' '. This script approves the latest revision of all pages that can be approved but do not have an approved revision. (The script has various optional flags, including one that lets you also handle pages that already do have an approved revision.)

File approvals
You can also approve file revisions with Approved Revs. It should be noted that only revisions to the actual file are approvable; revisions to the wikitext of the file pages are not. As such, approval of files is not done by clicking the "view history" link in the top-right of the file's page. Instead, scroll to the "File history" section near the bottom of the file page, and click "approve" on the right of the file history table.

When a version of an image is approved, that version is displayed when the image is included on other pages. For non-image uploads (e.g. PDFs), any links directly to the file will go to the approved version, not the latest.

Just like the  script, there is another script, , that exists specifically for file approvals.

バージョン履歴
Approved Revs is currently at version 1.7.2. See the entire version history.

既知の問題点

 * Approved Revs does not seem to work with the extension - approving a revision leads to a "Deny_action" error.

バグ / 機能の要望
Send any bug reports and requests to Yaron Koren (yaron57@undefinedgmail.com).

Contributing patches to the project
If you found some bug and fixed it, or if you wrote code for a new feature, please either do a Git commit for it, or create a patch by going to the " " directory, and typing:

git diff > descriptivename.patch

If you create a patch, please send it, with a description, to Yaron Koren.

翻訳
Translation of Approved Revs is done through translatewiki.net. The translation for this extension can be found here: https://translatewiki.net/w/?title=Special:Translate&group=ext-approvedrevs. To add language values or change existing ones, you should create an account on translatewiki.net, then request permission from the administrators to translate a certain language or languages on this page (this is a very simple process). Once you have permission for a given language, you can log in and add or edit whatever messages you want to in that language.

関連項目

 * - edits remain private until they're approved
 * - the more complex alternative to Approved Revs