扩展:TemplateStylesExtender

MediaWiki扩展手册

TemplateStylesExtender 发行状态： 稳定版
实现	解析器扩展
描述	Extends Extension:TemplateStyles with new selectors
作者	Octfx留言
最新版本	1.2.0 (2023-07-19)
MediaWiki	1.39+
PHP	>=8.0
Composer	octfx/template-styles-extender
许可协议	GNU通用公眾授權條款2.0或更新版本
下載	GitHub: 项目页面 git存储库URL [帮助 ] 提交历史 注意： 无法由translatewiki.net 提供本地化更新。
参数 $wgTemplateStylesExtenderEnablePrefersColorScheme $wgTemplateStylesExtenderEnableCssVars $wgTemplateStylesExtenderEnableUnscopingSupport
使用的函数钩 EditPage::attemptSave ParserFirstCallInit TemplateStylesPropertySanitizer TemplateStylesStylesheetSanitizer

TemplateStylesExtender扩展对Extension:TemplateStyles 进行了扩展，支持新的选择器和匹配器。

功能

支持以下功能：

• CSS变量：

  示例 color: var( --color-base )

• image-rendering
• ruby-position
• ruby-align
• scroll-margin-* and scroll-padding-*
• @media (prefers-color-scheme: dark/light) media queries
• mask-image
• clamp
• revert / revert-layer
• aspect-ratio

安裝

• 下载文件，并将其放置在您extensions/文件夹中的TemplateStylesExtender目录内。
• 将下列代码放置在您的LocalSettings.php 的底部：

  wfLoadExtension( 'TemplateStyles' );
  wfLoadExtension( 'TemplateStylesExtender' );
  

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

配置

鍵	描述	示例	默认
$wgTemplateStylesExtenderEnablePrefersColorScheme	开关，用于启用@media (prefers-color-scheme: dark/light)媒体查询	false	true
$wgTemplateStylesExtenderEnableCssVars	开关，用于启用CSS变量	false	true
$wgTemplateStylesExtenderEnableUnscopingSupport	开关，用于为拥有editinterface（编辑界面）权限的用于启用CSS的unscoping	true	false

注意CSS变量

当然:root选择器不起作用，因为模板样式会在前面加上.mw-parser-output。

一种可行的修复方案是将整个内容包围在div中，并为其添加声明，例如

div#content-wrap {
   --padding: 10px
}

.content {
   padding: var( --padding )
}

Wikitext

<div id="content-wrap">
   <div class="content">
      The WikiText...
   </div>
</div>

CSS取消包围

例如：会导致CSS被包围在.mediawiki中，而不是在.mw-parser-output中。

要在页面内包括这样的调用时，用户需要有editinterface权限才能够编辑。 你也可以选择调用一个包括了此样式的模板。

參見

• Extension:TemplateStyles