Extension:CSS

MediaWiki扩展手册

CSS 发行状态： 稳定版
实现	解析器函数
描述	提供一个用于添加CSS文件、條目、或行內规则到條目中的解析器函数。
作者	Aran Dunkley Rusty Burchfield
最新版本	3.5.0
MediaWiki	>= 1.43.0
许可协议	GNU通用公眾授權條款2.0或更新版本
下載	下載扩展 Git [?]: 浏览存储库 (GitHub) Gerrit代码复核 Git提交日誌 下載原始碼（tarball壓縮）
示例	organicdesign.nz
参数 $wgCSSIdentifier
使用的函数钩 ParserFirstCallInit RawPageViewBeforeOutput
前往translatewiki.net翻譯CSS扩展
問題	开启的任务 · 报告错误

CSS擴展允許將CSS樣式表載入到特定文章中。CSS樣式表可以是另一個文檔，也可以是直接在解析器函數中定義的規則。

用法

例如，如果你有一個名為“MyStyles.css”的CSS樣式表，它們是用於页面“MyFancyUserPage”的樣式，你可以為後者添加以下解析器函數語法：

{{#css:MyStyles.css}}

再者，如果“MyStyles.css”是位於/wiki/skins目錄之下的文件，那麼路徑應該也被寫進去，如下所示。請注意，檔案路徑必須是帶有文件根目錄斜杠的絕對路徑，以將其與檔名區分開來。

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

或者，CSS規則可以直接包含在解析器函數（inline）中，如下例所示：

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

安装

• 下载文件，并解压CSS文件夹到extensions/目录中。
  开发者和代码贡献人员应改从Git安装此扩展，输入：

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

• 只有是從Git安裝的才需运行Composer来安装PHP依赖，通过发行composer install --no-dev至扩展的目录。 （参见T173141了解潜在问题。）
• 請新增下列代码到您的LocalSettings.php 文件的底部：

  wfLoadExtension( 'CSS' );
  

• 按需求配置。
• 完成 – 請导航至您的wiki上的Special:Version，以验证此扩展已成功安装。

配置

你可以为扩展文件设置基本URL，可选。

$wgCSSPath = false;  # 默认，与$wgScriptPath有关
$wgCSSPath = '';  # 与服务器根基（root）有关
$wgCSSPath = 'https://example.org/stylesheets';  # 与不同的站点有关

小贴士

改变特定页面的颜色或背景

利用解析器函数去使用另一个页面的CSS，這並不能够用于改变页面的颜色或背景，然而，利用解析器函数在自身的页面是可以讓背景改变的。 若要解决这个问题，可通过嵌入来加载CSS，這就不会导致無法載入頁面背景的變更的问题。

參見

• Extension:NewPageCSS
• Extension:TemplateStyles（模板样式） - 类似的扩展，它会过滤CSS并將其存储在单独的页面。