mediawiki-extensions-Templa.../README.md

54 lines
1.3 KiB
Markdown
Raw Normal View History

2021-03-19 20:00:11 +00:00
# TemplateStylesExtender
Extends Extension:TemplateStyles by the following new matchers:
* CSS Variables:
* Example: `color: var( --example-var )`
* `image-rendering`
* `ruby-position`
* `ruby-align`
* `scroll-margin-*`, `scroll-padding-*`
2021-05-21 19:51:07 +00:00
* `pointer-events`
2021-07-19 12:09:25 +00:00
## Installation
Download the zip file from the [latest release](https://github.com/octfx/mediawiki-extensions-TemplateStylesExtender/releases/latest) page.
Extract the folder to `extensions/TemplateStylesExtender`.
Add the following to `LocalSettings.php`:
```
wfLoadExtension( 'TemplateStyles' )
wfLoadExtension('TemplateStylesExtender')
```
## Configuration
`$wgTemplateStylesExtenderEnablePrefersColorScheme`
Default: `true`
Enables or disables `@media (prefers-color-scheme)` queries.
`$wgTemplateStylesExtenderEnableCssVars`
Default: `true`
Enables or disables css variable support.
2021-07-19 17:38:14 +00:00
## Notes on CSS vars
Currently using `:root` selectors won't work due to template styles prepending `.mw-parser-output`.
One possible fix is to wrap the entire content into a `div` element and adding the declarations to this, e.g.
```css
div#content-wrap {
--padding: 10px
}
.content {
padding: var( --padding )
}
```
Wikitext
```html
<div id="content-wrap">
<div class=".content">
The WikiText...
</div>
</div>
```