MediaWikiの設定 - 拡張のソースを表示

== 概要 ==
拡張機能を追加することにより、MediaWikiの外観や動作をカスタマイズできる。<br>
<br>
MediaWikiの管理者の場合、MediaWiki上の拡張機能を管理することができ、インストールおよび削除することができる。<br>
<br>
拡張機能には、MediaWikiの開発者によって保守されているものもあるが、サードパーティーの開発者により記述されたものもある。<br>
そのため、拡張機能の多くがバグを有しており、相互に互換性があることを保証されているわけではない。<br>
<br>
また、一部の拡張機能はメンテナンスがされていないものもある。<br>
したがって、全ての拡張機能がMediaWikiで動作するわけではない。<br>
<br>
特に、安全ではないというタグが付けられたものについては、自己責任で使用する。<br>
<br>
コアソフトウェアにパッチを適用する必要がある拡張機能を使用する場合、データベースのバックアップを取ることを推奨する。<br>
<br><br>

== CirrusSearch ==
==== CirrusSearchとは ====
CirrusSearch (シーラスサーチ) は、MediaWikiの検索機能を強化する拡張機能である。<br>
Wikipediaをはじめ、ウィキメディアプロジェクトは全てこの拡張を使用している。<br>
<br>
検索エンジンにはElasticsearch拡張機能を使用しており、軽量に全文検索を行うことができる。<br>
ただし、複雑な依存関係であるため、インストールは煩雑である。<br>
<br>
==== CirrusSearchのインストール ====
まず、[https://www.mediawiki.org/wiki/Extension:Elastica Elasticsearchの公式Webサイト]にアクセスして、Elasticsearchをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf Elastica-REL<バージョン>.tar.gz
<br>
次に、[https://www.mediawiki.org/wiki/Extension:CirrusSearch CirrusSearchの公式Webサイト]にアクセスして、CirrusSearchをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf CirrusSearch-REL<バージョン>.tar.gz
<br>
解凍したディレクトリをextensionsディレクトリに配置する。<br>
<br>
Localsettings.phpファイルを、以下に示すように編集する。<br>
 <syntaxhighlight lang="php">
 # Localsettings.phpファイル
 
 wfLoadExtension( 'Elastica' );
 wfLoadExtension( 'CirrusSearch' );
 </syntaxhighlight>
<br><br>

== アカウントの統合 ==
==== UserMergeとは ====
UserMerge拡張機能は、usermerge権限を持つWiki利用者が、ある利用者を別の利用者へ統合できるようにする。<br>
<br>
* UserMergeの特長
** 統合 (アカウントAの投稿記録、テキスト、ウォッチリスト、編集回数をアカウントBへ統合)
** 統合後のアカウントAを削除する。(オプションボックス)
*: <br>
* 制限事項
** 既に統合されたアカウントを統合することはできない。
*: 自身のアカウント(ログイン済利用者)を別の利用者に統合することはできない。
<br>
==== UserMergeのインストール ====
[https://www.mediawiki.org/wiki/Extension:UserMerge UserMergeの公式Webサイト]にアクセスして、UserMergeをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf UserMerge-REL<バージョン>.tar.gz
<br>
解凍したディレクトリをextensionsディレクトリに配置する。<br>
<br>
Localsettings.phpファイルを、以下に示すように編集する。<br>
 <syntaxhighlight lang="php">
 # Localsettings.phpファイル
 
 wfLoadExtension( 'UserMerge' );
 $wgGroupPermissions['sysop']['usermerge'] = true;  // 管理者のみ有効にする場合
 </syntaxhighlight>
<br>

==== UserMergeの使用手順 ====
[特別ページ] - [利用者の統合と削除]ページにアクセスする。<br>
<br>
[旧利用者 (統合元):]項目に統合元ユーザを入力して、[利用者 (統合先):]項目に統合先ユーザを入力する。<br>
統合元ユーザを削除する場合は、[旧利用者を削除]チェックボックスにチェックを入力する。<br>
最後に、[利用者の統合]ボタンを押下する。<br>
<br><br>

== WikiSEOエクステンション ==
WikiSEOエクステンションは、HTMLのタイトルタグの内容を置換、追加、前置することができる。<br>
また、HTMLファイルの<code>head</code>タグに<code>keywords</code>や<code>description</code>といった一般的なSEO（検索エンジン最適化）メタ要素を追加することも可能である。<br>
<br>
[https://www.mediawiki.org/wiki/Extension:WikiSEO WikiSEOエクステンションの公式Webサイト]にアクセスして、WikiSEOエクステンションをダウンロードする。<br>
ダウンロードしたファイルを解凍して、MediaWikiのメインディレクトリにあるextensionディレクトリに配置する。<br>
<br>
MediaWikiのメインディレクトリにあるLocalSettings.phpファイルに、以下の設定を追記する。<br>
 <syntaxhighlight lang="php">
 # LocalSettings.phpファイル
 
 # ...略
 
 wfLoadExtension( 'WikiSEO' );
 $wgWikiSeoDefaultImage= '<ロゴ画像ファイルのパス>';  # Webサイトに画像が設定されていない場合に使用する
　　　　　　　　　　　　　　　　　　　　　　　　　　　　    # この変数が設定されていない場合、Webサイトのロゴが使用される
 $wgGoogleSiteVerificationKey = '<Google向けに使用するGoogle Search Consoleのキー>';
 
 # ...略
 </syntaxhighlight>
<br>
変数<code>$wgGoogleSiteVerificationKey</code>を設定する場合、[https://support.google.com/webmasters/answer/9008080 Google Search Console]にアクセスして、[設定]からキーを取得する。<br>
# 画面左ペインにある[設定] - 画面右ペインにある[ユーザーと権限]を選択する。
# [ユーザー]からユーザ名の右にある[︙]から、[所有権の確認の詳細]を選択する。
# [HTMLタグ]項目にキーが記述されている。
<br>
以下の例では、MediaWikiの任意のページの任意の箇所にメタキーワードである<code>name</code>タグ(keywords)および<code>content</code>タグ(description)を埋め込んでいる。<br>
<br>
 <nowiki> {{#seo:
 |title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
 |keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板
 |description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
 |image=<ロゴ画像ファイルのパス>
 }}</nowiki>
<br><br>

== Canonicalタグ ==
<u>この機能はMediaWikiの標準機能のため、拡張をダウンロードする必要はない。</u><br>
<br>
Webコンテンツが重複または類似しているページURLを正規化するHTMLタグをCanonicalタグという。<br>
<br>
重複コンテンツが存在する場合、検索エンジンからはコピーコンテンツとみなされるため、ページ評価を下げる可能性がある。<br>
<br>
重複コンテンツの対策として、Canonicalタグを設定してクローラにどのページがメインページなのかを伝える方法がある。<br>
<br>
CanonicalタグでURLを1つにする場合、BingやGoogle等の検索エンジンは正規化されたメインページのみをインデックスに登録する。<br>
同じ内容のページが複数のURLでインデックス登録されている場合は、Canonicalタグが設定してあるページのみインデックスが登録される。<br>
<br>
検索エンジンが重複コンテンツとみなすページとしては、端末ごとにWebサイトを持つ場合、ECサイトでサイズや色が異なるページ、AMPを使用しているページ等がある。<br>
<br>
 <syntaxhighlight lang="php">
 # 各ページの<head>タグにCanonicalタグが挿入される
 $wgEnableCanonicalServerLink = true;
 
 $wgServer = "<プロトコル + ドメイン  例: http://www.example.com>";
 # または
 $wgCanonicalServer = "<プロトコル + ドメイン  例: http://www.example.com>";
 </syntaxhighlight>
<br><br>

== デスクトップ向けスキン ==
[https://www.mediawiki.org/wiki/Category:All%20skins MediaWikiの公式Webサイト]にアクセスして、任意のスキンをダウンロードする。<br>
ダウンロードしたファイルを解凍する。<br>
<br>
解凍したディレクトリをMediaWikiのルートドキュメント下にあるskinsディレクトリに配置する。<br>
<br>
LocalSettings.phpファイルを編集して、スキンを設定する。<br>
 cd <MediaWikiのあるディレクトリ>
 vi LocalSettings.php
<br>
 <syntaxhighlight lang="php">
 # LocalSettings.phpファイル
 
 wfLoadSkin( '<スキン名>' );
 
 $wgDefaultSkin = '<スキン名>';
 </syntaxhighlight>
<br>
以下に示すようなデスクトップ向けスキンがある。<br>
* Foreground
*: https://www.mediawiki.org/wiki/Skin:Foreground
* Liberty
*: https://www.mediawiki.org/wiki/Skin:Liberty
<br><br>

== モバイル向けスキン ==
各スキンをダウンロードする。<br>
 cd /<MediaWikiのあるディレクトリ>/skins
 
 wget https://extdist.wmflabs.org/dist/skins/Vector-<バージョン>.tar.gz
 wget https://extdist.wmflabs.org/dist/skins/MinervaNeue-<バージョン>.tar.gz
<br>
また、各スキンのURLを以下に示す。<br>
* Vector
*: https://www.mediawiki.org/wiki/Skin:Vector
* Minerva Neue
*: https://www.mediawiki.org/wiki/Skin:Minerva_Neue
<br>
ダウンロードしたファイルを解凍する。<br>
 tar xf Vector-<バージョン>.tar.gz
 tar xf MinervaNeue-<バージョン>.tar.gz
<br>

<br>
LocalSettings.phpを編集して、拡張機能とスキンを有効化する。<br>
<br>
<u>※注意 1</u><br>
<u><code>$wgDefaultMobileSkin</code>の設定は、<code>$wgDefaultSkin</code>の設定よりも前に記述する必要がある。</u><br>
 cd <MediaWikiのあるディレクトリ>
 vi LocalSettings.php
<br>
 <syntaxhighlight lang="php">
 # LocalSettings.phpファイル
 
 wfLoadExtension( 'MobileFrontend' );
 wfLoadSkin( 'Vector' );
 wfLoadSkin( 'MinervaNeue' );
 
 # モバイル向けスキンは、$wgDefaultSkinよりも先に記述する
 $wgDefaultMobileSkin = 'minerva';
 
 # デスクトップ向けスキン
 $wgDefaultSkin = 'vector';
 </syntaxhighlight>
<br>
<u>※注意 2</u><br>
<u>もし、モバイル向けスキンが表示されない場合、[https://www.mediawiki.org/wiki/Extension:MobileFrontend MediaWikiの公式Webサイト]にアクセスして、最新のMobileFrontendをダウンロードする。</u><br>
ダウンロードしたファイルを解凍する。<br>
 tar xf MobileFrontend-<バージョン>.tar.gz
<br>
現在使用しているMobileFrontendをバックアップする。<br>
 cd /<MediaWikiのあるディレクトリ>/extensions
 mv MobileFrontend MobileFrontend_org
<br>
LocalSettings.phpファイルを編集して、MobileFrontend拡張機能を読み込む。<br>
 <syntaxhighlight lang="php">
 # LocalSettings.phpファイル
 
 wfLoadExtension( 'MobileFrontend' );
 </syntaxhighlight>
<br>
MobileFrontendのGithubを以下に示す。<br>
Github : https://github.com/wikimedia/mediawiki-extensions-MobileFrontend<br>
<br><br>


__FORCETOC__
[[カテゴリ:MochiuWikiの設定]]