LocalSettings.phpファイルを使用してMediaWikiをカスタマイズする方法
序章
MediaWikiは、カスタマイズ可能なWikiサイトを作成できるオープンソースのWikiアプリケーションです。 もともとはウィキペディアのニーズに応えるためにウィキメディア財団によって開発されましたが、個人や小規模な組織に適合させることができます。
このガイドは、MediaWikiがVPSにインストールされており、Webブラウザで初期設定手順を完了していることを前提としています。 そうでない場合は、こちらの手順に従ってMediaWikiをインストールしてください。
以前のガイドでは、Ubuntu12.04インストールにMediaWikiをインストールしました。 この記事では、LocalSettings.phpファイルを介して実行できるいくつかの基本的な構成について説明します。
Webインターフェイスを介して設定を編集できますか？
多くの設定の変更とサイト管理タスクは通常のwikiWebインターフェイスを介して管理できますが、サーバー上のテキストファイルの編集を必要とする変更がいくつかあります。
LocalSettings.phpファイルは、セキュリティ対策としてWebインターフェイスからアクセスできません。 ファイルを編集するには、このファイルを手動で編集するためにVPSにSSHで接続します。
MediaWikiはデフォルト値をどこに保存しますか？
デフォルト設定はDefaultSettings.phpというファイルに保存されます。
DefaultSettings.phpは絶対に編集しないでください。ただし、それを確認することは非常に価値があります。 ファイルは編集しないので、ポケットベルで開きます。
less /etc/mediawiki/includes/DefaultSettings.php
このファイルに変更したい値が表示されている場合は、その値に注意してください。 後で、LocalSettings.phpファイルに値を追加できます。
デフォルト値をどのように編集しますか？
設定はLocalSettings.phpファイルで行う必要があります。 DefaultSettings.phpと非常によく似ていますが、短いです。 次のコマンドを入力して、編集用にファイルを開きます。
sudo nano /etc/mediawiki/LocalSettings.php
このファイルはPHPプログラミング言語で書かれていますが、構文は比較的理解しやすいものです。 ほとんどの場合、次の構文が表示されます。
$ VariableName =“ VariableValue ”;
このファイルにはさまざまな構成設定がありますが、使用可能なすべての設定がここで定義されているわけではありません。 通常、DefaultSettings.phpにあるデフォルトと矛盾する値を持つ設定のみがここにあります。
DefaultSettings.phpにあるものの設定を変更したい場合は、LocalSettings.phpで変数を探してください。 存在しない場合は、下部に追加してください。
共通の構成設定
変更を加える前に、何かが期待どおりに機能しない場合に備えて、構成ファイルをバックアップしてください。
sudo cp /etc/mediawiki/LocalSettings.php /etc/mediawiki/LocalSettings.php.bak
LocalSettings.phpファイルを再度開いて、以下の値を編集します。
sudo nano /etc/mediawiki/LocalSettings.php
サイト名を変更する方法
初期構成時にサイトの名前を選択しました。 wgSitenameとwgMetaNamespaceの2つの変数を編集して、サイトの名前を変更できます。
$ wgSitename =“新しいサイト名”; $ wgMetaNamespace =“ New_Site_Name ”;
2番目の変数は、Wiki自体を参照するページの名前空間を設定します。 スペースを含めることはできないため、代わりにアンダースコアを使用します。
サイトの言語を変更する方法
サイトの言語エンコーディングを変更する必要がある場合は、wgLanguageCode変数の値を変更できます。
$ wgLanguageCode =“ language_code ”;
この場合の「language_code」は、このファイルで定義されている任意の値を指します。
less /etc/mediawiki/languages/Names.php
言語を変更した後、変更を実装するためのスクリプトを実行する必要があります。
cd /etc/mediawiki/maintenance sudo php rebuildmessages.php --rebuild
画像のアップロードを許可する方法
Wikiでの画像のアップロードを許可する前に、「imagemagick」スイートからいくつかの追加の画像処理ソフトウェアをインストールする必要があります。
sudo apt-get install imagemagick
LocalSettings.phpファイルを再度開きます。
sudo nano /etc/mediawiki/LocalSettings.php
Wikiのユーザーが自分の画像をページにアップロードできるようにするには、wgEnableUploads変数を「true」に変更します。
$wgEnableUploads = true;
次の2つの変数のコメントを外して、画像のサイズ変更、変換、操作にimagemagickを使用するようにMediaWikiを構成します。
$wgUseImageMagick = true; $wgImageMagickConvertCommand = "/usr/bin/convert";
これらの設定により、ユーザーのアップロードにサムネイル画像を使用できるようになります。
デフォルトでは、これらの設定により、「png」、「gif」、および「jpeg/jpg」形式でのアップロードが可能です。 追加のフォーマットを許可する場合は、次のようにwgFileExtensions変数をファイルの最後に追加します。
$ wgFileExtensions = array（'png'、'gif'、'jpg'、'jpeg'、' pdf '、' additional_format '、' … '）
注：ユーザーからのコンテンツを受け入れるWebサイトは、ある程度のリスクを負っています。 ユーザーのアップロードを許可することの影響を認識し、これらの危険を軽減するための適切な手順を実行するようにしてください。
ウィキコモンズの画像を許可する方法
「true」に設定したい追加の変数はwgUseInstantCommonsです。
これにより、ウィキはウィキメディアコモンズのコンテンツへのアクセスを自動的に構成できます。 これらはあなた自身のページに組み込むことができます。
$wgUseInstantCommons = true;
ウィキメディアコモンズの画像を使用するには、次の場所で使用する画像を見つけてください。
http://commons.wikimedia.org/
画像に移動します。 URLで、File:からURLの末尾にコピーします。
[[File:“%3Ca]] https://assets.digitalocean.com/articles/mediawiki_config/wikimedia_url.png ” alt =“ MediaWikiファイルのURL” />
次に、ページを開くか編集して、コピーしたものを二重角かっこで囲みます。
[[File:Parson_Russell_Terrier_Puppy_3_Months_Old.jpg]]
画像がページに表示されます。
代わりにサムネイルを作成する場合は、ファイル名の後にパイプ文字（|）と「thumb」を続けます。
[[File:Parson_Russell_Terrier_Puppy_3_Months_Old.jpg|thumb]]
ウィキメディアの画像がウィキに表示されます。
[[File:“%3Ca]] https://assets.digitalocean.com/articles/mediawiki_config/commons_image.png ” alt =“ MediaWiki Commonsサンプル画像” />
Wikiロゴを変更する方法
一般的に要求される情報の1つは、ページの左上隅にあるロゴをサイトに関連するものに変更する方法です。
デフォルトでは、Wikiページには次の画像が表示されます。
[[File:“%3Ca]] https://assets.digitalocean.com/articles/mediawiki_config/default_logo.png ” alt =“ MediaWikiのデフォルトロゴ” />
まず、ロゴとして使用するファイルをVPSの適切なディレクトリにコピーします。
scp /path/to/local/image.png username @ server_ip ：/ etc / mediawiki / skins / common / images /
これで、Wikiサーバーに画像が作成されました。 wgLogoのパスを変更して、イメージ名を反映します。
$ wgLogo = "$ wgStylePath / common / images / image_name.png
これで、以前のメッセージがロゴに置き換わります。
電子メールオプションを構成する方法
バグレポートを含む管理用メールを受信するには、wgEmergencyContact変数の後にメールを含めてください。
$ wgEmergencyContact =“ your_email @住所 .com 」
また、wgPasswordSender電子メールが実際の電子メールアドレスを指すように構成して、ユーザーが問題が発生した場合に電子メールに返信できるようにすることもできます。
$ wgPasswordSender =“ password_email @住所 .com 」
結論
これで、LocalSettings.phpファイル内にあるいくつかの一般的な設定を構成する方法を理解する必要があります。
デフォルトでLocalSettings.phpに存在しないMediaWikiで利用可能な多くの構成設定があります。 /etc/mediawiki/includes/DefaultSettings.phpにあるデフォルト設定ファイルを読んで、他の構成オプションを見つけることを忘れないでください。 ファイルはよくコメントされています。 特定の変数に関するその他の情報は、ここにあります。
