Allows using SCSS files for MediaWiki styling
The MediaWiki SCSS library provides a ResourceLoader module capable of compiling SCSS.
An SCSS module is defined much like any other style module. See the manual for
It should also be possible to add the module definition to the
of a MediaWiki extension. See
There are some additional keys, that may be used:
class: This is mandatory. It selects the class to be used for the module. For SCSS the value has to be
styles: Not really an additional key, but it has extended semantics. This key contains the list of style files of the module. Each file can optionally be given a position to influence the order in which the files are compiled. Allowed values for the position are
If no position is given,
mainwill be assumed.
All files of one module will be compiled together, i.e. variables, mixins etc. will be shared between them.
variables: An array of variables and values to override the SCSS variables in the style files. This allows changing values (e.g. colors, fonts, margins) without having to modify the actual style files.
cacheTriggers: Compiling SCSS is expensive, so compiled results are cached. This option lists files that when changed will trigger a flushing of the cache and re-compiling the style files.
All files on this list will be checked for each web request. To minimizes the load on the file system and the time to build the page it is not advisable to just add all style files to this list.
Here is an example definition:
$wgResourceModules[ 'ext.MyExtension.styles' ] = [ 'class' => 'SCSS\\ResourceLoaderSCSSModule', 'localBasePath' => $localBasePath, 'remoteBasePath' => $remoteBasePath, 'position' => 'top', 'styles' => [ 'modules/ext.MyExtension.foo.scss' => 'main', 'modules/ext.MyExtension.bar.scss' ], 'variables' => [ 'red' => '#ff0000', 'green' => '#00ff00', 'blue' => '#0000ff', ], 'cacheTriggers' => [ 'LocalSettings.php', 'composer.lock', ], ];
$egScssCacheType can be set to request a specific cache type to be used for
the compiled styles. To disable caching of SCSS styles completely (e.g. during
$egScssCacheType = CACHE_NONE;. This should obviously never
be done on a production site.
The tests can only be run when the library is loaded within MediaWiki.
You can add it via
composer.local.json (probably using
Inside your MediaWiki root directory
php tests/phpunit/phpunit.php -c vendor/mediawiki/scss/phpunit.xml.dist
You can use the SCSS extension under the GNU General Public License, version 3 (or any later version).
Released on 2020-09-07
- Temporarily fixed the version of
scssphpto 1.1.1 to avoid 1.2 bug
Released on 2020-04-19
- Turned MediaWiki extension into a standard PHP/Composer library
- Switched to new version of