Extension:CSS

MediaWiki 拡張機能マニュアル

CSS リリースの状態: 安定
実装	パーサー関数
説明	CSS ファイル、記事、インライン ルールをページに追加するためのパーサー機能を提供する
作者	Aran Dunkley Rusty Burchfield
最新バージョン	3.5.0
MediaWiki	>= 1.43.0
パラメーター $wgCSSIdentifier
使用するフック ParserFirstCallInit RawPageViewBeforeOutput
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード Git [?]: リポジトリを参照 (GitHub) Gerrit コード レビュー Git コミット ログ Download source tarball
例	organicdesign.nz
translatewiki.net で翻訳を利用できる場合は、CSS 拡張機能の翻訳にご協力ください
問題点	未解決のタスク · バグを報告

CSS 拡張機能は、特定の記事に対し、CSS スタイルシートによる表示を行えるようにするものです。CSS は、構文解析機能により、直接定義された規則、または他の記事やファイルともなりえます。

使用法

例えば、"MyFancyUserPage" という記事で使用するためのスタイルである "MyStyles.css" という CSS記事がある場合、後者に以下のパーサー関数構文を追加することになるでしょう。

{{#css:MyStyles.css}}

一方、"MyStyles.css" が/wiki/skinsディレクトリのファイルであった場合、以下のように含まれることになります。ファイルは、記事のタイトルと区別するために、スラッシュを先頭につけた絶対パスでなければならないことに注意してください。

{{#css:/skins/MyStyles.css}}

また、次の例のように、CSSルールをパーサー関数内に直接含めることもできます(inline)。

{{#css:
  body {
    background: yellow;
    color: red;
    font-size: 1.25rem;
  }
}}

インストール

• ダウンロードして、ファイルをextensions/フォルダー内のCSSという名前のディレクトリ内に配置します。
  開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CSS
  

• Gitでのインストールの場合のみ、PHPの依存関係をインストールするためComposerを実行します。 (合併症の可能性についてはT173141を参照。)
• 以下のコードを LocalSettings.php ファイルの末尾に追加します:

  wfLoadExtension( 'CSS' );
  

• 必要に応じて設定します。
• 完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

設定

オプションで、外部ファイルのベースURLを設定することができます。

$wgCSSPath = false;  # 既定値、$wgScriptPathの相対パス
$wgCSSPath = '';  # サーバーのルートに相対
$wgCSSPath = 'https://example.org/stylesheets';  # 別サイトとの相対比較

ヒント

特定のページの色や背景の変更

パーサー機能を使用して他のページのCSSを使用しても、ページの色や背景を変更することはできませんが、1つのページ単体でパーサー機能を使用すると、背景を変更することが可能です。 To overcome this problem, it is possible to load the CSS through transclusion, which does not cause the problem of failing to load the change to the page background.

関連項目

• Extension:NewPageCSS
• Extension:TemplateStyles - CSSをサニタイズして別のページに保存する似たような拡張機能です。