Extension:Disambiguator/ja
Disambiguator 拡張機能はプログラム上で動作しやすい曖昧さ回避ページを簡単に作成するよう設計してあります。
すべての曖昧さ回避ページの指定は__DISAMBIG__ マジックワード (もしくは同等の別名) で実行でき、データベース上の指定を変更します。
これにより、通常ページとみなされているものが、曖昧さ回避ページという別の種類のページとして扱うことが可能になります。
インストール
- ダウンロードして、ファイルを
extensions/フォルダー内のDisambiguatorという名前のディレクトリ内に配置します。
開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Disambiguator
- 以下のコードを LocalSettings.php ファイルの末尾に追加します:
wfLoadExtension( 'Disambiguator' );
- 必要に応じて設定します。
完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。
設定
利用者の LocalSettings.php ファイルから以下の設定変数を書き込みます。
- $wgDisambiguatorIndicateLinks - 'mw-disambig' CSS クラスを追加し、曖昧さ回避ページへのリンクを作るかどうか (既定は true)
- $wgDisambiguatorNotifications - ウィキテキスト エディターで曖昧さ回避ページへのリンクを入力する際に警告を出すかどうか (既定は false)
特徴
この拡張機能は以下の機能を提供します:
- プログラム上で__DISAMBIG__ マジックワードを使い、曖昧さ回避ページを検出
- 特別ページを新設して曖昧さ回避ページと、それにリンクするページをすべてまとめる
- 上記の特殊ページに相当する新たなAPI関数と、あるページが曖昧さ回避ページであるかどうかを照会するAPI関数を追加
- 曖昧さ回避のためのページを無視するようにSpecial:LonelyPagesを変更する
- Special:Randomで曖昧さ回避のためのページを無視するように変更(MediaWiki 1.26.0が必要)
- VisualEditorが有効な場合、ページのプロパティ・インターフェースを使って、ページを曖昧さ回避のためのページとしてマークすることができます。
- VisualEditorが有効な場合、リンクインスペクタでページが曖昧さ回避ページであるかどうかを表示します。
- VisualEditorが有効な場合、リンクダイアログでページが曖昧さ回避ページであるかどうかを表示する
- 設定されている場合、曖昧さ回避のためのページへのリンクに 'mw-disambig' CSSクラスを追加します (上記の #Configuration を参照)。
- Warns a WikiEditor user when linking to a disambiguation page, and allows them to fix the link.
使用法
ウィキ上で
Disambiguatorをインストールした後は、__DISAMBIG__のマジックワードをテンプレートに追加し、それをすべての曖昧さ回避ページに含めるのが最も良い使い方です。
このマジックワードが設定されると、あなたの曖昧さ回避ページはすべて、データベース内で「曖昧さ回避」ページプロパティが割り当てられます。 このプロパティは、page_propsテーブルに存在します。
さらに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
曖昧さ回避のためのページであれば、そのページプロップに「曖昧さ回避」が含まれます。 曖昧さ回避のためのページプロップが存在する場合、その値は空の文字列に設定されるので、真偽値としてテストする場合は注意が必要です。
With Lua
For wikis with Scribunto installed, Disambiguator adds a isDisambiguationPage property to mw.title objects.
SQL
To see if an individual page is a disambiguation page, check the page_props table for the presence of a pp_propname = 'disambiguation'.
Pages that are not disambiguation pages will not have this pp_propname.
The pp_value isn't important.
SELECT page_title, pp_propname
FROM page
LEFT JOIN page_props ON pp_page = page_id AND pp_propname = 'disambiguation'
WHERE page_namespace = 0
AND page_title IN ('John', 'COVID-19') -- John is a disambiguation page on enwiki, COVID-19 is not
今後の開発案
- 曖昧さ回避ページを非表示にするオプションを追加します。 Special:AllPages (task #9936), Special:PrefixIndex (task #11319), Special:WhatLinksHere (task #9935), Special:AncientPages (task #76287)
- ウィキテキストエディタのリンクダイアログを拡張し、検索結果の曖昧さを検出してリンクのリストを引き出す機能を検討します。
- この拡張機能のすべてのバグ
 | この拡張機能は 1 つ以上のウィキメディアのプロジェクトで使用されています。 これはおそらく、この拡張機能が安定していて高いトラフィックのウェブサイトでも十分に動作することを意味します。 この拡張機能がインストールされている場所を確認するには、ウィキメディアの設定ファイル CommonSettings.php および InitialiseSettings.php 内で、この拡張機能の名前を探してください。 特定のウィキにインストールされている拡張機能の完全な一覧は、そのウィキの Special:Version ページにあります。 |
 | この拡張機能は以下のウィキ ファーム/ウィキ ホスト/パッケージに含まれています:
|