Manual:LocalSettings.php/ja

このファイルはMediaWikiインストールのローカルのconfiguration settingsを提供する. このファイルでの設定を見直すために時間をかけなければならない. このファイルは通常ウェブベースのMediaWikiのインストーラによって作成されるが、Apacheの設定に合わせて、 いくつかのパラメータを微調整したい場合がある.

設定を変更することは通常PHP変数の値を変更することを意味する. 取りかかる前にPHP構文に慣れておきたいと思うかもしれない. 大まかには、PHP変数は変数名の先頭に"$"の文字があることによってアクセスされることを覚えておく; 多くの変数は もしくは のどちらかを設定することで設定される.

ファイルを保存した後に変更は即座に実行される: 手作業で何か"再起動"させる必要はない. 場合によって変更内容を見るためにブラウザのキャッシュをクリアする必要があることもある.

多くの設定のデフォルト値はincludes/DefaultSettings.phpで設定されるが、編集すべきではない 変更を望む変数がまだLocalSettings.phpに記述されていない場合、DefaultSettingsから該当の行をコピーして適切に修正する. LocalSettings.phpの範囲内で最終行に新しい行を追加することが出来る. それらすべての行はrequire_once( "includes/DefaultSettings.php" );'を示す行の下に現れる

ファイルの範囲内で'require_once( "extensions/extension.php" );'という行がいくつも存在することがある. それらはwiki上で有効になった他のextensionsへのリンクである. これらのエクステンションはLocalSettings.phpで多くの変数の値を設定することを必要とするかもしれない; さらなる説明についてはエクステンションのドキュメントをチェックする. エクステンションのリストはExtension Matrixで利用可能である.


 * require_once( "includes/DefaultSettings.php" );の前にエクステンションを設定しない; エクステンションのセットアップ関数の配列を空にして、エクステンションがインストールされてないことを警告し、おそらくはwikiにアクセスできなくするからである.

LocalSettings.php</tt>のバージョンによって?&gt;</tt>のPHPの閉じタグで終わっていないものがある. このタグの後に新しい情報を追加されることを防止するためである. PHPは閉じタグが存在しなくてもきちんと機能する.

すべての変数が何をするのかを理解するためにconfiguration settings indexと設定ファイルに含まれるコメントを参照する. もっとも重要で要求される機能の変数の手短いリストは以下に示される.

もしMediaWiki wiki farm上でwikiを持つ場合、LocalSettings.phpファイルへの書き込み権限(および読み込み権限でさえ)を持っていないかもしれない(例えば次を参照:). wikiファーム企業はあなたの望みに合わせて変更してくれないかもしれない. おそらくはwikiファームのすべてのwiki群上でほとんど同じ設定をすることを望んでいる.

インクルードパス
$IP(インクルードパス)変数はwikiのベースインストールへのローカルファイルのパスを保持する. 正しいファイルパスであるか確認する. パスの終わりにスラッシュを含まない.

DefaultSettings.phpファイルはIP変数によって指定されたディレクトリから読み込まれる.

サイト名
$wgSitename変数はwikiのセットアップの名前を保持する. この名前はシステム全体で多く含まれる. 例えばWikipediaのタグラインの"'From Wikipedia, the free encyclopedia."'はこの設定を利用している.

サイトの言語
$wgLanguageCode変数はwikiのインターフェイスの言語をコントロールする. ユーザはpreferencesで見ることが出来る言語に切り替えることが出来る一方で、それらの変数はすべての匿名ユーザと大半の登録ユーザが見るデフォルトの言語を設定する.

スクリプトパス
$wgScriptPathはMediaWikiのコードの中心的なアクショニングピースである主要なMediaWikiスクリプトにアクセスするためのURLパスの接頭辞である. この設定はとりわけApacheのリライティングルールを使用している場合はApache settingsに対応しなければなりません.

サーバ名
wikiがそれが動作しているローカルホスト、イントラネットもしくはインターネットからアクセスされるとき、Eメール通知と他のコンピュータメッセージは通常異なるURLで配信される. wgServerは検知を上書きしサーバ名は定数になる.

www.domain.tld がインターネットから見られるwikiのサーバアドレスである場合、 次のような行を追加する.

マジックワード はwikiページに使用される; の値と等しい.

スクリプト名
$wgScriptはメインのMediaWikiのPHPスクリプトの名前で、デフォルトではindex.php</tt>である. スクリプト名を変更することはおそらくよいアイディアではない. しかしながら、そうしたいのであれば、変更する場所はここである. やっていることを理解していることを確認する.

リダイレクトスクリプト名
$wgRedirectScript変数はMediaWikiでリダイレクトを取り扱うリダイレクト　スクリプトへのURLパスを指定する. この設定は正確なスクリプト名を設定出来るwgScriptと似ている. 上記で説明したように、本当に何をしているのか理解していないのであれば、変更することはおそらくよいアイディアではない.

記事へのパス
$wgArticlePathはMediaWikiのページにアクセスするときに使用するパスである. パスはメインスクリプト(通常は を使用する)へのパスを含み記事の名前に$1</tt>プレースホルダを使用する.

プリティURLもしくはショートURLを作成するためにApacheのリライトルールを使用する場合、おそらく正しいパスを指し示す を調整する必要がある. wgArticlePathはMediaWikiの範囲内からURLを構築ために使用されることに注意. 間違いがあった場合、正しいURLを手作業で指定することでメインページにアクセスできるかもしれない一方で内部リンクは不正に表示される.

典型的な値は以下の通り:

スタイルシートの位置
設置されているMediaWikiインストールのためにCSSがある場所へのURLを設定するためには$wgStylePath変数を使用する. $wgStyleDirectory変数は同じ場所を指定するが、ファイルシステムにアクセスする内部スクリプトで使用されるためのローカルファイルシステムであることに注意.

アップロードの位置
アップロードディレクトリはユーザによってアップロードされたファイルが保存される場所である. $wgUploadPath変数はURLパスを指定し、$wgUploadDirectoryはローカルファイルシステムパスを指定する.

ロゴ
$wgLogo変数はデフォルトでトップ左コーナー上に表示されるグラフィカルを指し示す相対的URLを指定する. アップロードされたファイルによってロゴを交換することが出来るアップロードディレクトリへの変数を指定したい場合があるかもしれない.

は通常 である.

コンタクト情報
$wgEmergencyContact変数は何か起きたときにコンタクトするためのユーザのEメールアドレスである. Eメールアドレスは内部バグレポートを送るために使用される. アドミニストレータとして、あなたのEメールアドレスをここに掲載しておく.

$wgPasswordSender変数はパスワードを忘れたユーザにパスワードが送信されるときの使用されるEメールアドレスである. トラブルもしくは混乱の場合利用者が送信できるアドレスを選択する.

データベースの設定
ページ、ユーザ情報や多くのものを保存するためにMediaWikiはデータベース(現在はMySQLかPostgreSQLのどちらか)にアクセスする必要がある.

$wgDBserverはデータベースのホスト名を含む. 多くの場合、同じシステム上で動作しているデータベースとしては"localhost"が当てはまるが、様々なインストールのために、データベースが動作しているコンピュータの十分に確認されたドメイン名を入力する必要がある.

$wgDBnameはMediaWikiによって使用されるデータベース名である. 単独のMySQLもしくはPostgreSQLでは一つ以上のデータベースを保存することが出来、一つのサーバで多くのMediaWikiを動作させることが出来る. 正しいデータベース名を記載して同じデータベースサーバ上の異なるwikiインストールのために異なるデータベース名を使用することを確認する.

$wgDBuserと$wgDBpassword変数はデータベースにアクセスするためにMediaWikiによって使用されるログイン名とパスワードを含む. データベースサーバ上でwikiのテーブルを操作できる適切なアクセス権を指定されたユーザが持つことを確認する.

セキュリティに関連するデータに関してはLocalSettings.phpのパーミッションが他のユーザがこのファイルを見ることが出来るようにはすべきではないことを念頭に置いておく.

ユーザの権限
$wgGroupPermissionsは連想配列で、異なるユーザグループのためにページを作成と編集するパーミッションをコントロールする. この配列において、カスタムパーミッションレベルが作成され、異なるユーザグループのためにパーミッションレベルが設定される. 異なるパーミッションと利用可能なユーザグループについてはHelp:User rightsでもっと詳細な情報を参照.

大文字リンクの強制
デフォルトでは、小文字(Roman letter)でページ名は始まらず、最初の文字を大文字に変換しようとする. リンクターゲット、含まれるページ、画像もしくはカテゴリは小文字で始まる名前で指定され、実際のターゲットなどは大文字で始まるページに対応する.

代替的にはページ名は大文字、数字に加えて、小文字で始めることが出来る. そのためには$wgCapitalLinks変数を調整しなければならない. falseに設定することで小文字を許可し、trueはデフォルトの振る舞いを選択する.

サブページの有効化
$wgNamespacesWithSubpages変数を使用することで名前空間ごとのベースでサブページを有効にする. 例えばメインの名前空間でサブページを有効にする:

画像のアップロード
MediaWikiシステムにファイルをアップロードすることをユーザに許可するまえに、この機能を有効にしなければならない. アップロードディレクトリが適切に設定され、Apacheウェブサーバプロセスによって書き込み可能でなければならない. $wgEnableUploads変数をtrueに設定することでウェブユーザインターフェイスでアップロードすることを許可する.

次のコードはLocalSettings.phpの設定例でincludes/DefaultSettings.phpからの由来しているものである:

サムネイルをサポートするために手早く画像をリサイズすること出来るようにしたい場合、ImageMagickをシステム上にインストールしてテストしてから$wgUseImageResizeと$wgUseImageMagick変数をtrueに設定する. $wgImageMagickConvertCommand変数が適切なconvert</tt>コマンドの位置を指定し、コマンドがウェブサーバプロセスによって実行可能であることを確認する.

また、利用可能な拡張子の修正を行いたい場合、次のように$wgFileExtensions配列を設定する:

ImageMagickでトラブルに遭遇した場合、次のエラーメッセージを得る:
 * Fatal error: mime_magic could not be initialized, magic file is not available in includes/MimeMagic.php on line 506</tt>

その場合、次の行を追加してみる;

$wgMimeDetectorCommand = "file -bi";

次の記事も参照: Manual:Configuring file uploads、Manual:Mime type detectionとManual:Image thumbnailing

LaTeXインラインの方程式
LaTeXでmathematical formulaeを描画するために、LaTeXインストールをシステム上で動作させる必要がある. この機能を有効にするために$wgUseTeX変数をtrueに設定する. $wgMathPath、$wgMathDirectoryと$wgTmpDirectoryが適切に設定されていることを確認する. 変更するのにとてもよい理由がない限り、デフォルトの値を使う路線を進む方がよいだろう.

インターウィキのサポート
InterWikiサポートはMediaWikiに組み込まれているが、内部リンクのために使用される接頭辞を設定する必要がある. この接頭辞は通常$wgSitenameと同じであるが、変更する場合、$wgLocalInterwiki変数を望む名前に設定する.

ユーザインターフェイスの言語
MediaWikiは様々なローカライズされたユーザインターフェイスの言語を利用することが出来る. 英語ではない言語でwikiを運営する場合、$wgLanguageCodeを適切なlanguage codeに設定する(例えば、ドイツ語なら"de"、スペイン語なら"es")

languageディレクトリで見つかる言語を使用することが出来る. 例えば、MessagesEs.phpを見つけたのであれば、スペイン語の" "を使用することが出来る. 注意することは" "と大文字で始めない. 動作をするかもしれないが、すべてのテキストが翻訳されてないこともある.

ノート: 言語コードを変更した後でPHPスクリプトを動作させる必要がある. コマンドツールを使用するために"maintenance"ディレクトリに移動をして次のコマンドを入力する.

php rebuildMessages.php --rebuild

Windows上において、PHPコマンドのPATH環境変数が設定されていないことがあることを注意する.

サイトのための著作権の設定

 * $wgRightsPageはwiki上のページで該当する著作権を表示する. 通常はProject:Copyrightsになる.
 * $wgRightsTextは"Content is available under"に続くフッタに含まれるテキストである. に指定されたページにリンクする.
 * $wgRightsIconはフッタの左に設置される画像のURLである.
 * $wgRightsUrlはライセンスの全内容を記述したページである. (例えばGNU FDLであるならば、 になる)
 * ノート: が空ではない場合、著作権/ライセンス内のリンクはサイト上のそのページにリンクする.  が空の場合は代わりに にリンクする.
 * $wgEnableDublinCoreRdfと$wgEnableCreativeCommonsRdfはRDFメタデータをwikiページに追加する. RDFメタデータについて詳細な内容はRDF metadataを参照.

サイトの著作権宣言を修正するために次の行をLocalSettings.phpに追加する:

後で適切なメッセージを表示するためにMediaWiki:Copyrightを編集する. を使用して著作権ページへのリンクの位置を示す.

Example: setting a Creative Commons license

クリエイティブコモンズライセンスを設定するために以下のようにする:


 * ライセンスを選択する: http://creativecommons.org/text/publish-website
 * 返されたHTMLコードを検査する:

<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/2.5/"> <img alt="Creative Commons License" border="0" src="http://creativecommons.org/images/public/somerights20.png" /> </a> This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/2.5/"> Creative Commons Attribution-NonCommercial-ShareAlike 2.5 License</a>.


 * のために、最初のアンカーからhref情報を入力する:


 * のために2番目のアンカーからテキストを入力する(文法的に正しいバージョンであるために"a"をWiki変数に追加する)


 * For  enter the src info from the img link in the first anchor. You want to copy the badge to your own site instead of using the one from the Creative Commons site.


 * 著作権についてのRDFメタデータを使用するためには、LocalSettings.phpに次の行を追加する

独自の名前空間
$wgExtraNamespaces配列を宣言すること、$wgNamespacesWithSubpagesと$wgNamespacesToBeSearchedDefault'配列を宣言することで、MediaWikiインストールに追加の名前空間が追加される. より詳細なやり方についてはCustom namespacesを参照.

スキン
サイトのデフォルトスキンは$wgDefaultSkin変数経由で修正することが出来る.