Extension:Disambiguator/ja

Disambiguator 拡張機能はプログラム上で動作しやすい曖昧さ回避ページを簡単に作成するよう設計してあります. すべての曖昧さ回避ページの指定は __DISAMBIG__ (もしくは同等の別名) で実行でき、データベース上の指定を変更します. これにより、通常ページとみなされているものが、曖昧さ回避ページという別の種類のページとして扱うことが可能になります.

設定
利用者のLocalSettings.phpファイルから以下の設定変数を書き込みます.
 * $wgDisambiguatorIndicateLinks - 'mw-disambig' CSS クラスを追加し、曖昧さ回避ページへのリンクを作るかどうか (既定は true)
 * $wgDisambiguatorNotifications - ウィキテキストエディタで曖昧さ回避ページへのリンクを入力する際に警告を出すかどうか（デフォルトは false）

特徴
この拡張機能は以下の機能を提供します:


 * プログラム上で __DISAMBIG__ を使い、曖昧さ回避ページを検出
 * 特別ページを新設して曖昧さ回避ページと、それにリンクするページをすべてまとめる
 * 上記の特殊ページに相当する新たなAPI関数と、あるページが曖昧さ回避ページであるかどうかを照会するAPI関数を追加
 * 曖昧さ回避のためのページを無視するようにSpecial:LonelyPagesを変更する
 * Special:Randomで曖昧さ回避のためのページを無視するように変更(MediaWiki 1.26.0が必要)
 * が有効な場合、ページのプロパティ・インターフェースを使って、ページを曖昧さ回避のためのページとしてマークすることができます.
 * が有効な場合、リンクインスペクタでページが曖昧さ回避ページであるかどうかを表示します.
 * が有効な場合、リンクダイアログでページが曖昧さ回避ページであるかどうかを表示する
 * 設定されている場合、曖昧さ回避のためのページへのリンクに 'mw-disambig' CSSクラスを追加します (上記の #Configuration を参照).
 * Warns a user when linking to a disambiguation page, and allows them to fix the link.

ウィキ上で
Disambiguatorをインストールした後は、 のマジックワードをテンプレートに追加し、それをすべての曖昧さ回避ページに含めるのが最も良い使い方です.

このマジックワードが設定されると、あなたの曖昧さ回避ページはすべて、データベース内で「曖昧さ回避」ページプロパティが割り当てられます. このプロパティは、テーブルに存在します.

さらに2つのを生成します. それはこちらです:
 * Special:DisambiguationPages - これは、Wikiのすべての曖昧さ回避ページを一覧表示します.
 * Special:DisambiguationPageLinks - これは、曖昧さ回避のためのページにリンクしている、あなたのウィキのすべてのページをリストアップするものです. (これは、古いSpecial:Disambiguationsのページが非推奨になったことを受けてのものです. )

APIとの組み合わせ
すべての曖昧さ回避のためのページを一覧表示する.

api.php?action=query&list=querypage&qppage=DisambiguationPages

すべての曖昧さ回避のためのページのリンクを一覧表示する.

api.php?action=query&list=querypage&qppage=DisambiguationPageLinks

なお、MiserModeで動作しているWiki（すべてのWMF Wiki）では、DisambiguationPageLinksの特設ページとAPIインターフェイスの両方が、特定の数の結果に制限されています（通常は1000～5000件）.

個々のページが曖昧さ回避ページであるかどうかを確認する.

api.php?action=query&titles=Bug&prop=pageprops&ppprop=disambiguation

曖昧さ回避のためのページであれば、そのページプロップに「曖昧さ回避」が含まれます. 曖昧さ回避のためのページプロップが存在する場合、その値は空の文字列に設定されるので、真偽値としてテストする場合は注意が必要です.

今後の開発案

 * 曖昧さ回避ページを非表示にするオプションを追加します. Special:AllPages (task #9936), Special:PrefixIndex (task #11319), Special:WhatLinksHere (task #9935), Special:AncientPages (task #76287)
 * ウィキテキストエディタのリンクダイアログを拡張し、検索結果の曖昧さを検出してリンクのリストを引き出す機能を検討します.
 * この拡張機能のすべてのバグ