Extension:CSS

自由之民讨论 | 贡献2022年5月17日 (二) 15:33的版本 (建立内容为“{{main|mediawikiwiki:{{FULLPAGENAME}}/zh}} '''CSS'''扩展允许将CSS样式表载入到特定文章中。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;
    font-size: 20pt;
    color: red;
  }
}}

安装

  • 下载文件,并将其放置在您extensions/文件夹中的CSS目录内。
  • 将下列代码放置在您的LocalSettings.php的底部:
    :wfLoadExtension( 'CSS' );
  • 按需求配置
  • Yes.png 完成 – 在您的wiki上导航至Special:Version,以验证已成功安装扩展。

配置

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

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


作为页面CSS替代使用

此前有个 Extension:PageCSS(现已存档),其使用 ‎<css> 和‎ ‎</css> 标签而非#css:解析器函数。 此扩展可以完成PageCSS扩展提供的大部分功能,但语法不兼容。 避免破坏仍然使用旧的 ‎<css> 标签的现有页面的一种方法是在同一个wiki上同时使用 Extension:CSSExtension:NewPageCSS

另一个方案(如果你只想用这个扩展,但是已经有一些要求用 Extension:PageCSS 的内容)是保存这一小段函数为一个 PHP 文件,并且把它包含进你的 LocalSettings.php 来重映射 <css> 为 #css:

<?php

//  Stub to remap <css></css> tags to {{#css:}} parser function extension

//  For use when installing https://www.mediawiki.org/wiki/Extension:CSS to replace Extension:NewPageCSS on existing wikis

$wgHooks['ParserFirstCallInit'][] = 'wfCSSParserStubInit';
 
//  Hook our callback function into the parser
function wfCSSParserStubInit( Parser $parser ) {

        //  When the parser sees the <css> tag, it executes the stub wfCSSTagRender function (below) to invoke the {{#css:}} parser
        $parser->setHook( 'css', 'wfCSSTagRender' );
        return true;
}
//  Execute <css> tag
function wfCSSTagRender( $input, array $args, Parser $parser, PPFrame $frame ) {

        //  Stub function, just redirect the user-provided input text blindly to the {{#css:}} parser function to re-parse it as wikitext
        $output = $parser->recursiveTagParse('{{#css:' . $input . '}}', $frame);
        return $output;
}

这样,以前的 PageCSS(或者 NewPageCSS)扩展就能从你的配置中移除了; <css> 现在成了 #css: 而且(如果你已经上线运行这个 CSS 扩展)它的行为方式将与任何其他 CSS 扩展的相同。

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

使用解析器函数使用另一个页面的CSS不能够用于改变页面的颜色或背景,然而,使用解析器函数在页面自身可以允许改变背景。 若要解决这个问题,通过嵌入来加载CSS,就不会导致无法改变页面背景的问题。


漏洞

讨论页

参见