(Translated by https://www.hiragana.jp/)
Manual:拡張機能 - MediaWiki Jump to content

Manual:拡張かくちょう機能きのう

From mediawiki.org
This page is a translated version of the page Manual:Extensions and the translation is 100% complete.
Languages:
拡張かくちょう機能きのう:

拡張かくちょう機能きのうは、MediaWiki の外観がいかんや動作どうさをカスタマイズできるようにします。

拡張かくちょう機能きのうには、MediaWiki の開発かいはつ者しゃによって保守ほしゅされているものもありますが、サードパーティーの開発かいはつ者しゃによって書かかれたものもあります。 その結果けっか、拡張かくちょう機能きのうの多おおくがバグを有ゆうし、相互そうごに互換ごかん性せいがあることを保証ほしょうされているわけではありません。 一部いちぶのものはメンテナンスがされていません。したがって、すべての拡張かくちょう機能きのうが、MediaWikiのすべてのバージョンで動作どうさするわけではありません。 どの拡張かくちょう機能きのうであっても、特とくに安全あんぜんではないというタグが付つけられたものについては、自己じこ責任せきにんで使用しようして下ください。 コアソフトウェアにパッチを適用てきようする必要ひつようがある拡張かくちょう機能きのうを使つかう場合ばあい、データベースのバックアップをとるようにしてください。 これはウィキが壊こわれてしまうリスクを回避かいひするのに役立やくだちます。

拡張かくちょう機能きのうの種類しゅるい

パーサー タグ

パーサータグはあらかじめ組くみ込こまれたウィキマークアップに機能きのうを追加ついかします。対象たいしょうは単純たんじゅんな文字もじ列れつ処理しょりから本格ほんかく的てきな情報じょうほう検索けんさくにまでおよびます。
→ パーサータグについてより詳くわしく知しる

パーサー関数かんすう

パーサー関数かんすうは特別とくべつなマークアップ文法ぶんぽうで、ページ内ないにある他ほかのウィキ要素ようそと'やり取とり'したり、特別とくべつな内容ないようを出力しゅつりょくしたりすることができます。
→ パーサー関数かんすうについてより詳くわしく知しる

フック

フックを使つかうと、ある決きめられたイベント（ページの保存ほぞん、ユーザのログインなど）が発生はっせいしたときに独自どくじのコードを実行じっこうすることができるようになります。
→ フックについてより詳くわしく知しる

特別とくべつページ

特別とくべつページは、特定とくていの機能きのうを実行じっこうするためソフトウェアがその都度つど作成さくせいするページです。
→ 特別とくべつページについてより詳くわしく知しる

外装がいそう

外装がいそうを使つかってMediaWikiの見みた目めや雰囲気ふんいきを自分じぶんの好このみに合あわせて調整ちょうせいすることができます。
→ 外装がいそうについてより詳くわしく知しる

マジックワード

マジックワードは、さまざまなウィキテキスト文字もじ列れつをある機能きのうに関かんする単一たんいつのIDに対応たいおうづけるための手法しゅほうの一ひとつです。
→ マジックワードについてより詳くわしく知しる

API

MediaWiki は、認証にんしょう、ページ操作そうさ、検索けんさくなどのウィキ機能きのうを扱あつかうウェブサービスを提供ていきょうする API を提供ていきょうしています。
→ MediaWiki APIについてより詳くわしく知しる

ページのコンテンツ モデル

MediaWiki 1.21 で導入どうにゅうされたContentHandler を使つかうと、JSONやマークダウンのようなウィキテキスト以外いがいで構成こうせいすることができます。
→ コンテンツモデルについてより詳くわしく知しる

認証にんしょう

MediaWiki は SessionManager と AuthManager という 2 つの認証にんしょうに関かんする仕組しくみを備そなえていて、これを使用しようするとカスタマイズした認証にんしょうの仕組しくみを使用しようしてセキュリティを向上こうじょうできます。
→ 認証にんしょうについてより詳くわしく知しる

拡張かくちょう機能きのうを見みつける

拡張かくちょう機能きのうの参照さんしょう

カテゴリ:‎カテゴリごとの拡張かくちょう機能きのう では、これまで書かかれたあらゆる種類しゅるいの拡張かくちょう機能きのうを閲覧えつらんすることができます。 これらの拡張かくちょう機能きのうをインストールしたり、独自どくじに拡張かくちょう機能きのうを作つくったりするための情報じょうほうについては、下記かきをご覧らん下ください。

インストールされた拡張かくちょう機能きのうの確認かくにん

MediaWikiに拡張かくちょう機能きのうをインストールできるのは、サーバのファイルシステム（データベースを含ふくむ場合ばあいも多おおい）にアクセスできる管理かんり者しゃに限かぎられますが、誰だれでも Special:Version ページにアクセスすることで、MediaWikiのインスタンスでどの拡張かくちょう機能きのうがアクティブになっているかを確認かくにんすることができます。 たとえば、ここにあげている拡張かくちょう機能きのうは、英語えいご版ばんウィキペディアでは有効ゆうこうです。

人気にんきの拡張かくちょう機能きのう

人気にんきの拡張かくちょう機能きのうを見みつける方法ほうほうは複数ふくすうあります。

最初さいしょのセットは MediaWiki にバンドルされているものです (定期ていき的てきにレビューされ、誰だれでも追加ついかを提案ていあんできます)。

MediaWiki.org から ExtensionDistributor メカニズムを介かいしてダウンロードされる拡張かくちょう機能きのうには、いくつかの統計とうけいが収集しゅうしゅうされます。 上位じょうい 15 の最もっともダウンロードされた拡張かくちょう機能きのうが Special:ExtensionDistributor に列挙れっきょされており、該当がいとうする拡張かくちょう機能きのうにはそのダウンロード数すうが情報じょうほうボックスに表示ひょうじされます。 これらの数字すうじには Git や Composer などの別べつの方法ほうほうでの拡張かくちょう機能きのうのインストールが含ふくまれていないことにご注意ちゅういください。

3 番ばんめの選択肢せんたくしは、拡張かくちょう機能きのうがインストールされているウィキの数かずを示しめす WikiApiary の集計しゅうけいを確認かくにんすることです。 これには、単たんなるダウンロードではなく実際じっさいのインストールを表あらわすという利点りてんがあります (つまり、ウィキの API に問とい合あわせます)。しかし (2023年ねん現在げんざい) 完全かんぜんに最新さいしんというわけではありません。 また、非公開ひこうかいウィキでのインストールを数かぞえません。


拡張かくちょう機能きのうのインストール

詳くわしい手引てびきについては、Manual:Extensions/Installation and upgrade を参照さんしょう

MediaWiki はインストールが終おわった直後ちょくごに既すでに拡張かくちょう機能きのうを受うけ入いれる用意よういができています。 拡張かくちょう機能きのうを追加ついかするために以下いかのステップに従したがいます:

  1. 始はじめる前まえに
    いくつかの拡張かくちょう機能きのうはパッチのインストールが要求ようきゅうされます。それらの多おおくはunixコマンドの使用しようによるインストールのために設計せっけいされた手引てびきを提供ていきょうしています。 拡張かくちょう機能きのうヘルプページにリスト表示ひょうじされたこれらのコマンドを入力にゅうりょくするためにシェルアクセス(SSH)の権限けんげんが要求ようきゅうされることもあります。
  2. 拡張かくちょう機能きのうをダウンロードする。
    Extension Distributorは、よく用もちいられている拡張かくちょう機能きのうを選えらび、ダウンロードする手助てだすけをしてくれます。
    通常つうじょう、拡張かくちょう機能きのうはモジュール パッケージとして配布はいふされます。 それらは一般いっぱん的てきに $IP /extensions/ の独自どくじの下位かいディレクトリに入はいります。 ウィキメディアの Git リポジトリに保存ほぞんされた拡張かくちょう機能きのうの一覧いちらんは git:mediawiki/extensions にあります。 拡張かくちょう機能きのうの中なかには、履歴りれき管理かんりをしていないものがあり、使用しようは推奨すいしょうされません。
    拡張かくちょう機能きのうのなかにはbundles、composer 、package repositoriesで利用りよう可能かのうなものもあります。
    インストール前まえにREADMEファイルを読よむことをお勧すすめします。 これには通常つうじょう、設定せっていに関かんする重要じゅうような情報じょうほうが含ふくまれています。
  3. 拡張かくちょう機能きのうをインストール
    LocalSettings.php ファイルの末尾まつびに、以下いかを追加ついかします:
    wfLoadExtension( 'ExtensionName' );
    この行くだりはPHPインタプリタに拡張かくちょう機能きのうファイルを読よみ込こむことを強制きょうせいし、その結果けっかMediaWikiにアクセス可能かのうにします。
    拡張かくちょう機能きのうの中なかには、メンテナンススクリプトと衝突しょうとつするものもあります。例たとえば $_SERVER に直接ちょくせつアクセスする（非ひ推奨すいしょう）場合ばあいです。
    この場合ばあい、メンテナンススクリプトが動作どうさするように、条件じょうけん文ぶんで包つつむことができます。
    if ( !$wgCommandLineMode ) {
   wfLoadExtension ( 'ExtensionName' );
}
    上記じょうきの条件じょうけん文ぶんの中なかで加くわえられる特別とくべつな名前なまえ空間くうかんを必要ひつようとするすべての拡張かくちょう機能きのうに対たいして、メンテナンススクリプト importDump.php は失敗しっぱいします。そのような拡張かくちょう機能きのうは、例たとえば Extension:Semantic MediaWiki や Extension:Page Forms です。
拡張かくちょう機能きのう用ように必要ひつような権限けんげんが設定せっていされていることを確認かくにんしてください！
このインストール手順てじゅんは、ほとんどの拡張かくちょう機能きのうにあてはまりますが、異ことなったインストール手順てじゅんが必要ひつようなものもあります。 詳細しょうさいは、拡張かくちょう機能きのうのドキュメントを確認かくにんして下ください。
LocalSettings.php で設定せっていの変数へんすうを変更へんこうしたい場合ばあいは、通常つうじょうは拡張かくちょう機能きのうのインクルードの後あとで行おこなう必要ひつようがあります。 そのようにしない場合ばあい、拡張かくちょう機能きのう内ないで定義ていぎされている既定きてい値ちがあなたの設定せっていを上書うわがきします。

拡張かくちょう機能きのうのアップグレード

拡張かくちょう機能きのうのなかには、複数ふくすうのバージョンで動作どうさするものもありますが、MediaWikiの更新こうしんごとにアップデートしなければならないものもあります。 拡張かくちょう機能きのうを新あたらしいバージョンにアップグレードするためには：

  1. 新あたらしいバージョンの拡張かくちょう機能きのうをダウンロードします。
  2. extensions/ExtensionName ディレクトリにある拡張かくちょう機能きのうのすべてのファイルを、新あたらしいファイルに置おき換かえます。 LocalSettings.php にある拡張かくちょう機能きのうの設定せっていは、削除さくじょしないでください
  3. 拡張かくちょう機能きのうが MediaWiki データベースの変更へんこうを必要ひつようとする場合ばあい、メンテナンス スクリプトの update.php を実行じっこうする必要ひつようがあるかもしれません。 ほとんどの拡張かくちょう機能きのうは、このスクリプトを実行じっこうする必要ひつようがあるかどうかについて言及げんきゅうしています。 (スクリプト実行じっこう前まえにデータのバックアップを取とってください)。 もしコマンドラインにアクセスできない場合ばあいには、web updaterを使つかうこともできます。
この説明せつめいは、拡張かくちょう機能きのうの99％にあてはまります。 もし、あなたがアップグレードしようとしている特殊とくしゅな拡張かくちょう機能きのうが、上うえと異ことなる説明せつめいをしていたならば、その拡張かくちょう機能きのうの説明せつめいに従したがうべきでしょう。

拡張かくちょう機能きのうのアンインストール

アンインストールするには、拡張かくちょう機能きのうの名前なまえが書かかれた行くだりを LocalSettings.php から削除さくじょしてください。 

wfLoadExtension( 'ExtensionName' );
  • 拡張かくちょう機能きのうの設定せっていに関係かんけいする行くだりはすべて削除さくじょする必要ひつようがあります。

関連かんれん項目こうもく

拡張かくちょう機能きのう :
Retrieved from "https://www.mediawiki.org/w/index.php?title=Manual:Extensions/ja&oldid=6768515"