Manual:Running MediaWiki on Debian or Ubuntu/ja

このガイドはUbuntuサーバ上でMediaWikiをインストール作業を手助けするためにあります. いくつかのPCの知識、アプリケーションのインストール方法、オペレーティングシステムや、viエディタ(vi in 10 minutesを参照)の使い方に関する知識が必要です.

必要なソフトウェアを集める
http://www.ubuntu.com から最新のUbuntuのサーババージョンのISO形式のファイルをダウンロードします.

Ubuntuをインストールする
ISOイメージをCDに焼いてそれでPCを起動させて下さい. CDから起動できるようにするためにBIOSの調整が要求されることがあります.

セットアップは本当にとてもシンプルで一目瞭然です. 唯一の大切なステップは初期のUbuntuサーバのインストレーションメニューで、LAMPサーバをインストールすることを選択することです.

インストレーションの手続きを終了します.

サーバを再起動してサインインして下さい

Ubuntuを更新する
プロンプトから、次のコマンドを入力します... この作業によってUbuntuは最新のバージョンに更新されます. Windowsのサービスパックのようなものです.

sudo apt-get update sudo apt-get upgrade

終わったら次のコマンドを入力して下さい

sudo reboot

サーバが再起動したら再びログインして下さい. すべてが完了しているか確認をするために次のupgradeコマンドを入力して下さい.

sudo apt-get upgrade

次のパッケージをインストールすることでPHPアプリケーションをコマンドラインから実行できるようになります. オプションですがお勧めします(注:メンテナンススクリプトを実行するために必要です):

sudo apt-get install php5-cli

場合によっては、Apache, PHP5, MySQLがOSにインストールされていない場合があります. その時は次のコマンドを入力してください

sudo apt-get install apache2 sudo apt-get install php5 php5-mysql sudo apt-get install mysql-client mysql-server

MySQLを設定する
大抵の場合、Mysqlのrootのパスワードを利用する必要があります. システムのrootとmysqlのrootの両方で同じパスワードを使わないようにして下さい. 他のユーザがパスワードを入手できないように次のコマンドでコマンド履歴をクリアします.

mysqladmin -u root password "" history -c

注意: MediaWikiを設定するときにユーザidとパスワードが必要になります.

PHPを設定する
''これらのステップはシンプルに経験に基づいたものです. このステップをすべてスキップできます(もしくは後でも十分で行うことができます)''

次に、設定ファイルを設定する必要があります...

sudo vi /etc/php5/apache2/php.ini

アップロード可能なファイルサイズの上限
様々なファイルがWikiにコンテンツとしてアップロードされることを想定すると、アップロード可能なファイルサイズの上限を調整しなければなりません. このセクションの後半の半分はファイルのアップロードに関することを取り扱います.

upload_max_filesize = 2M

上記のディレクティブを少なくとも8MBに変更して下さい. 将来再びこの値を変更しなければならないことがあります.

メモリの制限
21％ほどページダウンをして次のエントリーを変更して下さい...

memory_limit = 8M

少なくとも20Mです.

拡張機能
さらに少しページダウンをして(約48%)次の行をアンコメントして下さい...

extension=mysql.so extension=gd.so

保存してVIエディタから抜け出してApacheを再起動して下さい...

sudo apache2ctl restart

最新のMediaWikiを入手する
'''システムが利用できるようになる新しいバージョンのmediawikiとしてaptを使用してアップグレードできない限りこの方法はUbuntuのビルドシステムを壊すことに注意して下さい. '''

次にhttp://download.wikimedia.org/mediawiki/ から最新のMediaWikiをダウンロードして下さい. 最新のバージョンはです.

次のコマンドを入力して下さい(をダウンロードしたバージョンで置き換えて下さい)...

cd /var/www sudo wget http://download.wikimedia.org/mediawiki/1.11/mediawiki-1.11.0.tar.gz

ダウンロードが終わったら、次にファイルを展開する必要があります...

sudo tar vxfz mediawiki-1.11.0.tar.gz

展開されたディレクトリをwikiにリネームして下さい

sudo mv mediawiki-1.11.0 wiki

wikiを設定するためにウェブサーバがconfigサブディレクトリを書き込みできるようにしなければなりません.

cd /var/www/wiki sudo chmod a+w config

...この設定によって誰でも書き込みができるという脆弱性が存在するようになります. 代わりに私は書き込み権限をウェブサーバに付与することにしました:

chown www-data:www-data config

MediaWikiを設定する
http://server_ip_address/wiki にブラウザでアクセスをしてインストール作業を続けて下さい. IPアドレスを知らない場合、次のコマンドを入力して下さい...

ifconfig そして"inet addr"を探して下さい(通常は2番目か3番目の行の下にあります)

MediaWikiのインストールスクリプトで"Checking environment..."を注目して下さい. MediaWikiのインストール作業を成功させるためにこの情報によって多くの問題を解決できます. 設定フォームを記入して続けて下さい.

設定が終わると生成されたLocalSettings.phpを親ディレクトリに移動させます. より安全性を高めるためにconfigサブディレクトリを完全に削除することができます.

cd /var/www/wiki/config/ sudo mv LocalSettings.php .. cd .. sudo rm -rf config

新しいwikiを見るためにブラウザで http://server_ip_address/wiki にアクセスをして下さい.

やりました！ 稼働しているwikiを手に入れました！！

wikiの追加設定
wikiは/var/www/wikiで見つかるLocalSettings.phpファイルによって設定されます. LocalSettings.phpで役に立つかもしれない詳細な情報があります. 次は一般的に役立つと思われる変更です.

LocalSettings.phpを編集するために次のコマンドを入力して下さい sudo vi /var/www/wiki/LocalSettings.php

アップロードを有効にする
デフォルトでは、Wikiは画像のアップロードを許可しません、これを変更するためには$wgEnableUploadsを見つけて値をfalseからtrueに変更して下さい.

アップロード可能なファイルタイプを指定する
$wgFileExtensions配列の範囲内で受け入れられる拡張子のリストを修正したい場合を考えます. 例えば、デフォルトではPDFファイルをアップロードできません.

$wgFileExtensionsがLocalSettings.phpに存在しない場合はファイルの最後の方( ?> の前)に追加して下さい:

画像のアップロードを許可する
imagesディレクトリを書き込み可能にしなければなりません: sudo chmod a+w /var/www/wiki/images

画像のサポートが有効になっている場合、image:タグに追加される|thumbオプションは自動的にサムネイルバージョンの画像を生成します.

LocalSettings.phpにおいて、次の設定内容を設置してコメントアウトしないで下さい. それらは通常"To enable image uploads"と書かれた80行の下辺りにあります:

ImageMagickのパッケージは次のコマンドでインストールしなければなりません:T

sudo apt-get install imagemagick

ロゴを変更する
$wgLogo変数はデフォルトで左上コーナーに表示されるグラフィカルなロゴを指定します. $wgScriptPath変数はwikiのトップディレクトリを含みます - この場合/var/www/wikiです. ロゴ画像は135x135ピクセルが想定されています; それよりも大きい場合、想定サイズに合うように左上コーナーに表示されます.