LocalSettings.phpファイルを使用してMediaWikiをカスタマイズする方法

投稿日: 2022-04-20 2022-10-17
タグ: Applications, CMS, php

序章

MediaWikiは、カスタマイズ可能なWikiサイトを作成できるオープンソースのWikiアプリケーションです。もともとはウィキペディアのニーズに応えるためにウィキメディア財団によって開発されましたが、個人や小規模な組織に適合させることができます。

このガイドは、MediaWikiがVPSにインストールされており、Webブラウザで初期設定手順を完了していることを前提としています。そうでない場合は、こちらの手順に従ってMediaWikiをインストールしてください。

以前のガイドでは、Ubuntu12.04インストールにMediaWikiをインストールしました。この記事では、を介して実行できるいくつかの基本的な構成について説明します。 LocalSettings.php ファイル。

Webインターフェイスを介して設定を編集できますか？

多くの設定の変更とサイト管理タスクは通常のwikiWebインターフェイスを介して管理できますが、サーバー上のテキストファイルの編集を必要とする変更がいくつかあります。

The 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

サイト名を変更する方法

初期構成時にサイトの名前を選択しました。次の2つの変数を編集して、サイトの名前を変更できます。 wgSitename と wgMetaNamespace.

 $ 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の最後まで。

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]]

ウィキメディアの画像がウィキに表示されます。

https://assets.digitalocean.com/articles/mediawiki_config/commons_image.png ” alt =“ MediaWiki Commonsサンプル画像” />

Wikiロゴを変更する方法

一般的に要求される情報の1つは、ページの左上隅にあるロゴをサイトに関連するものに変更する方法です。

デフォルトでは、Wikiページには次の画像が表示されます。

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 ファイル。

MediaWikiで利用できる構成設定はたくさんありますが、 LocalSettings.php デフォルトでは。にあるデフォルト設定ファイルを読むことを忘れないでください /etc/mediawiki/includes/DefaultSettings.php その他の構成オプションを見つけるため。ファイルはよくコメントされています。特定の変数に関するその他の情報は、ここにあります。

ジャスティン・エリングウッド

getdocs

13036