Manual:外装の設定
このページは管理者を対象に、ウィキに外装を設定する方法を解説します。
この説明文書は、MediaWiki 1.31+ 向けです。
外装の使用について、外装全般の情報は Help:外装 を参照してください。
新しい外装を作成したり既存の外装を編集したりしたい開発者は、技術的な情報については Manual:MediaWiki外装を作る方法 を参照してください。
外装のダウンロード
MediaWiki の tarball ダウンロードにはいくつかの外装が同梱されています。 一覧は同梱されている拡張機能と外装#外装を参照してください。
しかし、MediaWiki を Git からダウンロードした場合、あるいは追加の外装をインストールしたい場合は、単数または複数の追加の外装のコードを個別にダウンロードする必要があります。
多くの MediaWiki 外装は Wikimedia Git リポジトリに含まれています（外装リポジトリの完全な一覧を参照してください）。 外装のtarballをskin distributorからダウンロードできます。
このグループ内の外装のひとつを Git 経由でダウンロードするには、以下のような呼び出しを作成します。
git clone https://gerrit.wikimedia.org/r/mediawiki/skins/[外装の名前]
例: 既定のベクター外装を取得するには、MediaWiki インストレーション フォルダーの skins/ 下位ディレクトリから以下の内容を入力します:
git clone https://gerrit.wikimedia.org/r/mediawiki/skins/Vector
適切な外装のリリースをチェックアウトします。 新しいディレクトリに移動し、以下を実行:
git checkout REL1_45
（REL1_45を別のリリースブランチまたはタグで置き換える）
外装の有効化
/skins ディレクトリ内の任意の使いたい外装について、LocalSettings.php ファイルで有効化しなければなりません。
例えば、ベクター外装を有効にするには以下を追加します。
複数の外装がある場合は、それぞれを個別の文で有効化しなければなりません。
wfLoadSkin( 'Vector' );
(これは、ディレクトリが異なる点以外は、拡張機能の有効化と同じです。)
外装の選択によっては追加の段階が必要かもしれません。 mediawiki.org 内の各外装のページに詳細なインストールガイドがあります。例えば、ベクターについてはSkin:ベクター#インストールをご覧ください。他のすべての外装についての説明も同様です。
ウィキにおける既定の外装の設定
ウィキの新規利用者向けに既定の外装を設定するには、外装ファイルに記述のある名称をLocalSettings.phpの$wgDefaultSkin変数に小文字で入力します。その場合も他の外装をすべてアンインストールまたは非表示にするか、個人設定を完全に無効化（下記参照）しない限り、利用者は個人設定ページを開いて好みの外装に変更できます。例をあげます。
$wgDefaultSkin = 'vector';
既存のウィキでこの値を変更すると、以前の既定の外装を使用しているすべての利用者の設定が自動で更新されます。
利用者の個人設定を変更するメンテナンス スクリプトは存在するものの (userOptions.php)、使用する必要がある場面はほとんどありません。
この値を変更しない場合、既定の外装はベクターです。
外装のアンインストール
外装をアンインストールするには、wfLoadSkin の行を LocalSettings.php ファイルから除去します。
その後、skins/ ディレクトリから外装ファイルを削除することができます。
もしアンインストールした外装を使用していた利用者がいれば、MediaWikiは自動的にその利用者の外装をウィキの既定の外装に切り替えます。
外装をアンインストールせずに抑制する
管理者は非表示にする外装を$wgSkipSkins配列に列挙することによって、利用者の個人設定でサイト全体に提供される外装の選択肢を制限できます。利用者に表示することなく、新規の外装をテストしたい場合に便利かもしれません。これを行うには、LocalSettings.phpに以下のように記述します。
// To remove various skins from the User Preferences choices
$wgSkipSkins = [ "monobook", "timeless" ];
外装のプレビューには useskin URL パラメーターを使います。
サイト全体のCSSの変更
MediaWiki では、サイト全体でページをレンダリングするたびに追加されるCSSルールを管理者が指定できます。
$wgUseSiteCss が true に設定されていれば、自分のウィキで MediaWiki:Common.css ページを編集することによって、これらのルールを追加できます。
グローバルなスタイルシートに加えて、特定の外装にのみ有効な CSS 規則の設定もできます (Manual:インターフェイス/スタイルシート を参照)。
利用者CSSの変更
利用者はページ "User:利用者名/common.css" を作成することにより、自分用のCSSルールを指定することができます。
そのページのCSSは利用者がどの外装を使用していても適用されます。
もしウェブサイトの既定の外装が変更されても、利用者のカスタムCSSは以前と同じように引き続き有効に作用します。
この機能は LocalSettings.php 中の $wgAllowUserCss を true に設定することで有効化されます。
また、利用者はページ "User:利用者名/外装名.css" を作成することにより、特定の外装にCSSを適用することもできます。
例えばモノブック外装を利用しているなら、ページSpecial:MyPage/monobook.css を編集します。
利用者が個人設定で外装を変更できないようにする
| MediaWiki バージョン: | ≧ 1.16 |
システム管理者は「外装」オプションを完全に除去し、個人設定に表示されないようにすることができます。これは自分のサイトでカスタマイズされた外装を使用し、なおかつ他のいかなる外装も正しく表示されない場合には合理的です。
実行には LocalSettings.php 内に新しい行を追加して以下のコードを記入します。個人設定から「外装」オプションが除去され、URLで useskin パラメーターを使用できなくなります。
$wgHiddenPrefs[] = 'skin';