(Translated by https://www.hiragana.jp/)
Extension:Disambiguator - MediaWiki Jump to content

Extension:Disambiguator

From mediawiki.org
This page is a translated version of the page Extension:Disambiguator and the translation is 92% complete.
MediaWiki 拡張かくちょう機能きのうマニュアル
Disambiguator
リリースの状態じょうたい: 安定あんてい
実装じっそう 特別とくべつページ
説明せつめい 曖昧あいまい回避かいひページの指定していをマジックワードでめる拡張かくちょう機能きのう
作者さくしゃ Ryan Kaldari (Kaldariトーク)
最新さいしんバージョン 継続けいぞくてき更新こうしん
互換ごかんせい方針ほうしん MediaWiki とともにリリースされるスナップショット。 master には後方こうほう互換ごかんせいがありません。
MediaWiki 1.28+
PHP 5.4+
ライセンス MIT ライセンス
ダウンロード
ヘルプ Help:Extension:Disambiguator/ja

  • $wgDisambiguatorIndicateLinks
四半期しはんきごとのダウンロードすう 59 (Ranked 76th)
使用しようちゅう公開こうかいウィキ 6,730 (Ranked 31st)
translatewiki.net で翻訳ほんやく利用りようできる場合ばあいは、Disambiguator 拡張かくちょう機能きのう翻訳ほんやくにご協力きょうりょくください
問題もんだいてん 解決かいけつのタスク · バグを報告ほうこく

Disambiguator 拡張かくちょう機能きのうはプログラムじょう動作どうさしやすい曖昧あいまい回避かいひページを簡単かんたん作成さくせいするよう設計せっけいしてあります。 すべての曖昧あいまい回避かいひページの指定してい__DISAMBIG__ マジックワード (もしくは同等どうとう別名べつめい) で実行じっこうでき、データベースじょう指定してい変更へんこうします。 これにより、通常つうじょうページとみなされているものが、曖昧あいまい回避かいひページというべつ種類しゅるいのページとしてあつかうことが可能かのうになります。

インストール

  • ダウンロードして、ファイルをextensions/フォルダーないDisambiguatorという名前なまえのディレクトリない配置はいちします。
    開発かいはつしゃとコード寄稿きこうしゃは、上記じょうきわりに以下いか使用しようしてGitからインストールします:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Disambiguator
  • 以下いかのコードを LocalSettings.php ファイルの末尾まつび追加ついかします:
    wfLoadExtension( 'Disambiguator' );
    
  • 必要ひつようおうじて設定せっていします。
  • Yes 完了かんりょう – ウィキの「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.

使用しようほう

end-user helpについては、Help:Extension:Disambiguator参照さんしょうしてください。

ウィキじょう

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

曖昧あいまい回避かいひのためのページであれば、そのページプロップに「曖昧あいまい回避かいひ」がふくまれます。 曖昧あいまい回避かいひのためのページプロップが存在そんざいする場合ばあい、そのそら文字もじれつ設定せっていされるので、真偽しんぎとしてテストする場合ばあい注意ちゅうい必要ひつようです。

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

今後こんご開発かいはつあん