ci/woodpecker/push/woodpecker Pipeline failed Details
SCSS compiler for lektor
SCSS compiler for Lektor that compiles css from sass.
How does it actually work?
- It uses libsass
- It looks for
.sassfiles (ignores part files that begin with a underscore e.g. '_testfile.scss') and compiles them as part of the build process.
- It only rebuilds the css when it's needed (file changed, a file it imports changed or the config changed).
- When starting the the development server it watches the files for changes in the background and rebuilds them when needed.
You can install the plugin with Lektor's installer:
lektor plugins add lektor-scss
Or by hand, adding the plugin to the packages section in your lektorproject file:
[packages] lektor-scss = 1.4.1
To enable the plugin, pass the
scss flag when starting the development
server or when running a build:
# build and compile css from scss lektor build -f scss # edit site with new generated css lektor server -f scss
It is highly recommended to use this plugin with a python3 version of lektor.
Since lektor can be used as a python module it is possible to enforce this (after lektor is installed eg. with
pip3 install --user --upgrade lektor) with the following command:
# run a python3 lektor server with new generated css python3 -m lektor server -f scss
The Plugin has the following settings you can adjust to your needs:
|source_dir||assets/scss/||the directory in which the plugin searchs for sass files (subdirectories are included)|
|output_dir||assets/css/||the directory the compiled css files get place at|
|output_style||compressed||coding style of the compiled result. choose one of: 'nested', 'expanded', 'compact', 'compressed'|
|source_comments||False||whether to add comments about source lines|
|precision||5||precision for numbers|
|include_paths||If you want to include SASS libraries from a different directory, libsass's compile function has a parameter called
An example file with the default config can be found at
configs/scss.ini. For every parameter that is not specified in the config file the default value is used by the plugin.
To test and/or develop on this plugin in your running lektor installation, simply place it in the
packages/ Folder and have a look at the Lektor Doku