Lektor plugin to compile css out of sass - based on libsass
Project description
SCSS compiler for lektor
SCSS compiler for Lektor that compiles css from sass.
How does it acutually work?
- It uses libsass
- It looks for
.scss
and.sass
files (ignores part files that begin with a underscore e.g. '_testfile.scss'), compiling 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 watchs the files for changes in the background and rebuilds them when needed.
Installation
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.3.3
Usage
To enable scsscompile, 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
Configuration
The Plugin has the following settings you can adjust to your needs:
parameter | default value | description |
---|---|---|
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 |
An example file with the default config can be found at configs/scsscompile.ini
Developement
To test and/or develope this plugin in your running lektor installation, simply put it in the packages/
Folder and have a look at the Lektor Doku
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for lektor_scss-1.3.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3b8d20de18a9c69efb6da3754e45f0cffb4b7aa7fe641e84cfb176c4662ee21b |
|
MD5 | 07b88c40588b8e2fa0b6d44a52c60023 |
|
BLAKE2b-256 | eb0a42cbc6b3471a8705e3f41cc95f6d5d89dd6783fce659658fed60436f45f2 |